@banzamel/mineralui 2.4.3 → 2.5.2

package/dist/useGhostText-CKsb8Ufa.js

@@ -0,0 +1,240 @@
+import { useCallback as e, useEffect as t, useId as n, useMemo as r, useRef as i, useState as a } from "react";
+//#region src/utils/useDebounce.ts
+function o(e, n) {
+	let [r, i] = a(e);
+	return t(() => {
+		let t = setTimeout(() => i(e), n);
+		return () => clearTimeout(t);
+	}, [e, n]), r;
+}
+function s(t, n) {
+	let r = i(t);
+	r.current = t;
+	let a = i(null);
+	return e(((...e) => {
+		a.current && clearTimeout(a.current), a.current = setTimeout(() => r.current(...e), n);
+	}), [n]);
+}
+//#endregion
+//#region src/utils/useKeyboardNav.ts
+var c = 500;
+function l(e) {
+	return e.replace(/[^a-zA-Z0-9_-]/g, "");
+}
+function u({ itemCount: r, onSelect: o, onClose: s, isOpen: u = !0, loop: d = !0, mode: f = "none", orientation: p = "vertical", rtl: m = !1, isItemDisabled: h, getItemLabel: g, selectOnSpace: _ = !1, idPrefix: v, initialIndex: y = -1 }) {
+	let [b, x] = a(y), S = n(), C = v ?? `m-kbnav-${l(S)}`, w = i([]), T = i(!1), E = i({
+		buffer: "",
+		timer: null
+	}), D = e(() => x(-1), []), O = e((e) => h ? h(e) : !1, [h]), k = e(() => {
+		for (let e = 0; e < r; e++) if (!O(e)) return e;
+		return -1;
+	}, [r, O]), A = e(() => {
+		for (let e = r - 1; e >= 0; e--) if (!O(e)) return e;
+		return -1;
+	}, [r, O]), j = e((e, t) => {
+		if (t === 1) {
+			for (let t = e + 1; t < r; t++) if (!O(t)) return t;
+			if (!d) return e;
+			let t = k();
+			return t === -1 ? e : t;
+		}
+		for (let t = Math.min(e, r) - 1; t >= 0; t--) if (!O(t)) return t;
+		if (!d) return e === -1 ? k() : e;
+		let n = A();
+		return n === -1 ? e : n;
+	}, [
+		r,
+		O,
+		d,
+		k,
+		A
+	]), M = e((e) => {
+		T.current = !0, x(e);
+	}, []);
+	t(() => {
+		if (f !== "roving" || !T.current) return;
+		T.current = !1;
+		let e = w.current[b];
+		e && typeof e.focus == "function" && e !== e.ownerDocument.activeElement && e.focus();
+	}, [f, b]), t(() => {
+		if (f !== "activedescendant" || !u || b < 0) return;
+		let e = w.current[b];
+		e && typeof e.scrollIntoView == "function" && e.scrollIntoView({ block: "nearest" });
+	}, [
+		f,
+		u,
+		b
+	]), t(() => {
+		let e = E.current;
+		return () => {
+			e.timer && clearTimeout(e.timer);
+		};
+	}, []);
+	let N = e((e) => {
+		if (!g || r === 0) return !1;
+		let t = E.current;
+		t.timer && clearTimeout(t.timer), t.buffer += e.toLowerCase(), t.timer = setTimeout(() => {
+			t.buffer = "", t.timer = null;
+		}, c);
+		let n = t.buffer, i = n.length > 1 && n.split("").every((e) => e === n[0]) ? n[0] : n, a = +(i.length === 1), o = b < 0 ? 0 : b;
+		for (let e = 0; e < r; e++) {
+			let t = (o + a + e) % r;
+			if (!O(t) && (g(t) ?? "").trim().toLowerCase().startsWith(i)) return M(t), !0;
+		}
+		return !1;
+	}, [
+		g,
+		r,
+		b,
+		O,
+		M
+	]), P = e((e) => {
+		if (!u || r === 0) return;
+		let t = p !== "horizontal", n = p !== "vertical", i = e.key;
+		if (n && m && (i === "ArrowLeft" || i === "ArrowRight") && (i = i === "ArrowLeft" ? "ArrowRight" : "ArrowLeft"), i === "ArrowDown" && t || i === "ArrowRight" && n) {
+			e.preventDefault(), M((e) => j(e, 1));
+			return;
+		}
+		if (i === "ArrowUp" && t || i === "ArrowLeft" && n) {
+			e.preventDefault(), M((e) => j(e, -1));
+			return;
+		}
+		switch (i) {
+			case "Enter":
+				e.preventDefault(), b >= 0 && b < r && !O(b) && o?.(b);
+				return;
+			case "Escape":
+				if (!s) return;
+				e.preventDefault(), s();
+				return;
+			case "Home":
+				e.preventDefault(), M(k());
+				return;
+			case "End":
+				e.preventDefault(), M(A());
+				return;
+		}
+		if (i === " " && _ && !E.current.buffer) {
+			e.preventDefault(), b >= 0 && b < r && !O(b) && o?.(b);
+			return;
+		}
+		if (g && i.length === 1 && !e.ctrlKey && !e.metaKey && !e.altKey) {
+			if (i === " " && !E.current.buffer) return;
+			N(i) && f === "roving" && e.preventDefault();
+		}
+	}, [
+		u,
+		r,
+		p,
+		m,
+		b,
+		o,
+		s,
+		_,
+		g,
+		f,
+		M,
+		j,
+		O,
+		k,
+		A,
+		N
+	]), F = e((e) => `${C}-item-${e}`, [C]), I = f === "activedescendant" && u && b >= 0 && b < r ? F(b) : void 0, L = b >= 0 && b < r && !O(b) ? b : k(), R = e((e) => {
+		if (e < 0 || e >= r) return;
+		M(e);
+		let t = w.current[e];
+		t && typeof t.focus == "function" && t.focus();
+	}, [r, M]);
+	return {
+		activeIndex: b,
+		setActiveIndex: x,
+		resetIndex: D,
+		onKeyDown: P,
+		activeDescendantId: I,
+		getItemId: F,
+		getItemProps: e((e) => {
+			let t = (t) => {
+				w.current[e] = t;
+			};
+			return f === "roving" ? {
+				id: F(e),
+				tabIndex: e === L ? 0 : -1,
+				ref: t,
+				onFocus: () => {
+					O(e) || x(e);
+				}
+			} : {
+				id: F(e),
+				ref: t
+			};
+		}, [
+			f,
+			F,
+			L,
+			O
+		]),
+		getContainerProps: e(() => f === "activedescendant" ? {
+			onKeyDown: P,
+			"aria-activedescendant": I
+		} : { onKeyDown: P }, [
+			f,
+			P,
+			I
+		]),
+		focusItem: R
+	};
+}
+//#endregion
+//#region src/utils/useGhostText.ts
+function d(e) {
+	return typeof e == "string" ? e : String(e);
+}
+function f(e, t, n) {
+	if (!t) return [];
+	let r = t.toLowerCase();
+	return e.filter((e) => n(e).toLowerCase().startsWith(r));
+}
+function p({ options: t, value: n, minChars: i = 2, getLabel: o = d, filter: s }) {
+	let [c, l] = a(0), [u, p] = a(null), m = r(() => n.length < i ? [] : s ? s(t, n) : f(t, n, o), [
+		t,
+		n,
+		i,
+		s,
+		o
+	]), h = m.length > 0 ? m[c % m.length] : null, g = h ? o(h) : "", _ = u !== n && g && g.toLowerCase().startsWith(n.toLowerCase()) ? g.slice(n.length) : "", v = e(() => !_ || !h ? {
+		value: n,
+		option: null
+	} : {
+		value: n + _,
+		option: h
+	}, [
+		_,
+		h,
+		n
+	]), y = e(() => {
+		m.length > 1 && l((e) => (e + 1) % m.length);
+	}, [m.length]), b = e(() => {
+		m.length > 1 && l((e) => (e - 1 + m.length) % m.length);
+	}, [m.length]), x = e(() => {
+		l(0), p(null);
+	}, []), S = e((e) => (e.key === "Tab" || e.key === "Enter") && _ ? (e.preventDefault(), !0) : e.key === "Escape" && _ ? (e.preventDefault(), p(n), !1) : e.key === "ArrowDown" && _ && m.length > 1 ? (e.preventDefault(), y(), !1) : e.key === "ArrowUp" && _ && m.length > 1 ? (e.preventDefault(), b(), !1) : !1, [
+		_,
+		n,
+		m.length,
+		y,
+		b
+	]);
+	return {
+		hint: _,
+		accept: v,
+		next: y,
+		prev: b,
+		reset: x,
+		matchCount: m.length,
+		onKeyDown: S
+	};
+}
+//#endregion
+export { s as i, u as n, o as r, p as t };
+
+//# sourceMappingURL=useGhostText-CKsb8Ufa.js.map

package/dist/useGhostText-CKsb8Ufa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGhostText-CKsb8Ufa.js","names":[],"sources":["../src/utils/useDebounce.ts","../src/utils/useKeyboardNav.ts","../src/utils/useGhostText.ts"],"sourcesContent":["import {useState, useEffect, useRef, useCallback} from 'react'\n\n// Expose a value only after it stays stable for the given delay.\nexport function useDebounce<T>(value: T, delay: number): T {\n    const [debounced, setDebounced] = useState(value)\n\n    useEffect(() => {\n        const timer = setTimeout(() => setDebounced(value), delay)\n        return () => clearTimeout(timer)\n    }, [value, delay])\n\n    return debounced\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\n// Wrap a callback so repeated calls collapse into the latest invocation.\nexport function useDebouncedCallback<T extends (...args: any[]) => void>(callback: T, delay: number): T {\n    const callbackRef = useRef(callback)\n    callbackRef.current = callback\n    const timerRef = useRef<ReturnType<typeof setTimeout>>(null)\n\n    return useCallback(\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        ((...args: any[]) => {\n            if (timerRef.current) clearTimeout(timerRef.current)\n            timerRef.current = setTimeout(() => callbackRef.current(...args), delay)\n        }) as T,\n        [delay]\n    )\n}\n","import {useState, useCallback, useEffect, useId, useRef, type FocusEvent, type KeyboardEvent} from 'react'\n\n/**\n * Focus-management strategy (WAI-ARIA APG \"Managing focus within components\"):\n * - `none` (default) — the hook only tracks `activeIndex`; the caller renders the highlight itself.\n * - `activedescendant` — DOM focus stays on the container / input; the active item is exposed via\n *   `aria-activedescendant` (combobox, listbox, grid with a focused host).\n * - `roving` — exactly one item has `tabIndex=0`, the rest `-1`; arrow keys move real DOM focus\n *   (menu, toolbar, tablist, tree, radio group).\n */\nexport type UseKeyboardNavMode = 'none' | 'activedescendant' | 'roving'\n\n/** Which arrow keys move the active item. */\nexport type UseKeyboardNavOrientation = 'vertical' | 'horizontal' | 'both'\n\nexport interface UseKeyboardNavOptions {\n    itemCount: number\n    /** Called on Enter (and Space when `selectOnSpace`) with the active index. */\n    onSelect?: (index: number) => void\n    /** Called on Escape. When omitted Escape is not handled, so it can bubble to an outer layer. */\n    onClose?: () => void\n    /** Keys are ignored while `false`. Defaults to `true`. */\n    isOpen?: boolean\n    loop?: boolean\n    /** Focus strategy. Defaults to `'none'` (the original behaviour). */\n    mode?: UseKeyboardNavMode\n    /** Defaults to `'vertical'` (ArrowUp / ArrowDown). */\n    orientation?: UseKeyboardNavOrientation\n    /** Flip ArrowLeft / ArrowRight for right-to-left layouts. */\n    rtl?: boolean\n    /** Disabled items are skipped by arrows, Home / End and typeahead, and are never selected. */\n    isItemDisabled?: (index: number) => boolean\n    /** Enables first-letter typeahead (APG) when provided. */\n    getItemLabel?: (index: number) => string\n    /** Treat Space like Enter (menus, toolbars, listboxes without a text input). */\n    selectOnSpace?: boolean\n    /** Prefix for generated item ids. Defaults to a `useId()` based value. */\n    idPrefix?: string\n    /** Initial active index. Defaults to `-1` (nothing active). */\n    initialIndex?: number\n}\n\nexport interface UseKeyboardNavItemProps {\n    id: string\n    tabIndex?: number\n    ref?: (el: HTMLElement | null) => void\n    onFocus?: (e: FocusEvent<HTMLElement>) => void\n}\n\nexport interface UseKeyboardNavContainerProps {\n    onKeyDown: (e: KeyboardEvent) => void\n    'aria-activedescendant'?: string\n}\n\nconst TYPEAHEAD_RESET_MS = 500\n\nfunction sanitizeId(value: string) {\n    return value.replace(/[^a-zA-Z0-9_-]/g, '')\n}\n\n// Provide arrow-key navigation and selection state for list-like widgets.\nexport function useKeyboardNav({\n    itemCount,\n    onSelect,\n    onClose,\n    isOpen = true,\n    loop = true,\n    mode = 'none',\n    orientation = 'vertical',\n    rtl = false,\n    isItemDisabled,\n    getItemLabel,\n    selectOnSpace = false,\n    idPrefix,\n    initialIndex = -1,\n}: UseKeyboardNavOptions) {\n    const [activeIndex, setActiveIndex] = useState(initialIndex)\n    const reactId = useId()\n    const prefix = idPrefix ?? `m-kbnav-${sanitizeId(reactId)}`\n    const itemRefs = useRef<(HTMLElement | null)[]>([])\n    const focusPendingRef = useRef(false)\n    const typeaheadRef = useRef<{buffer: string; timer: ReturnType<typeof setTimeout> | null}>({\n        buffer: '',\n        timer: null,\n    })\n\n    // Reset highlight state when the owning widget closes or clears results.\n    const resetIndex = useCallback(() => setActiveIndex(-1), [])\n\n    const isDisabled = useCallback(\n        (index: number) => (isItemDisabled ? isItemDisabled(index) : false),\n        [isItemDisabled]\n    )\n\n    const firstEnabled = useCallback(() => {\n        for (let i = 0; i < itemCount; i++) if (!isDisabled(i)) return i\n        return -1\n    }, [itemCount, isDisabled])\n\n    const lastEnabled = useCallback(() => {\n        for (let i = itemCount - 1; i >= 0; i--) if (!isDisabled(i)) return i\n        return -1\n    }, [itemCount, isDisabled])\n\n    // Step to the next enabled item in `dir`, honouring `loop`. Returns `prev` when nothing qualifies.\n    const step = useCallback(\n        (prev: number, dir: 1 | -1) => {\n            if (dir === 1) {\n                for (let i = prev + 1; i < itemCount; i++) if (!isDisabled(i)) return i\n                if (!loop) return prev\n                const first = firstEnabled()\n                return first === -1 ? prev : first\n            }\n            for (let i = Math.min(prev, itemCount) - 1; i >= 0; i--) if (!isDisabled(i)) return i\n            if (!loop) return prev === -1 ? firstEnabled() : prev\n            const last = lastEnabled()\n            return last === -1 ? prev : last\n        },\n        [itemCount, isDisabled, loop, firstEnabled, lastEnabled]\n    )\n\n    const moveTo = useCallback((next: number | ((prev: number) => number)) => {\n        focusPendingRef.current = true\n        setActiveIndex(next)\n    }, [])\n\n    // Roving mode: move real DOM focus after a keyboard-driven index change.\n    useEffect(() => {\n        if (mode !== 'roving' || !focusPendingRef.current) return\n        focusPendingRef.current = false\n        const el = itemRefs.current[activeIndex]\n        if (el && typeof el.focus === 'function' && el !== el.ownerDocument.activeElement) el.focus()\n    }, [mode, activeIndex])\n\n    // Active-descendant mode: keep the virtually focused option visible inside scroll containers.\n    useEffect(() => {\n        if (mode !== 'activedescendant' || !isOpen || activeIndex < 0) return\n        const el = itemRefs.current[activeIndex]\n        if (el && typeof el.scrollIntoView === 'function') el.scrollIntoView({block: 'nearest'})\n    }, [mode, isOpen, activeIndex])\n\n    useEffect(() => {\n        const state = typeaheadRef.current\n        return () => {\n            if (state.timer) clearTimeout(state.timer)\n        }\n    }, [])\n\n    const handleTypeahead = useCallback(\n        (char: string) => {\n            if (!getItemLabel || itemCount === 0) return false\n            const state = typeaheadRef.current\n            if (state.timer) clearTimeout(state.timer)\n            state.buffer += char.toLowerCase()\n            state.timer = setTimeout(() => {\n                state.buffer = ''\n                state.timer = null\n            }, TYPEAHEAD_RESET_MS)\n\n            // Repeating the same letter cycles through matches; a longer prefix refines from the current item.\n            const buffer = state.buffer\n            const sameChar = buffer.length > 1 && buffer.split('').every((c) => c === buffer[0])\n            const search = sameChar ? buffer[0] : buffer\n            const startOffset = search.length === 1 ? 1 : 0\n            const start = activeIndex < 0 ? 0 : activeIndex\n            for (let n = 0; n < itemCount; n++) {\n                const i = (start + startOffset + n) % itemCount\n                if (isDisabled(i)) continue\n                const label = (getItemLabel(i) ?? '').trim().toLowerCase()\n                if (label.startsWith(search)) {\n                    moveTo(i)\n                    return true\n                }\n            }\n            return false\n        },\n        [getItemLabel, itemCount, activeIndex, isDisabled, moveTo]\n    )\n\n    const onKeyDown = useCallback(\n        (e: KeyboardEvent) => {\n            if (!isOpen || itemCount === 0) return\n\n            const vertical = orientation !== 'horizontal'\n            const horizontal = orientation !== 'vertical'\n            let key = e.key\n            if (horizontal && rtl && (key === 'ArrowLeft' || key === 'ArrowRight')) {\n                key = key === 'ArrowLeft' ? 'ArrowRight' : 'ArrowLeft'\n            }\n\n            if ((key === 'ArrowDown' && vertical) || (key === 'ArrowRight' && horizontal)) {\n                e.preventDefault()\n                moveTo((prev) => step(prev, 1))\n                return\n            }\n            if ((key === 'ArrowUp' && vertical) || (key === 'ArrowLeft' && horizontal)) {\n                e.preventDefault()\n                moveTo((prev) => step(prev, -1))\n                return\n            }\n\n            switch (key) {\n                case 'Enter': {\n                    e.preventDefault()\n                    if (activeIndex >= 0 && activeIndex < itemCount && !isDisabled(activeIndex)) {\n                        onSelect?.(activeIndex)\n                    }\n                    return\n                }\n                case 'Escape': {\n                    if (!onClose) return\n                    e.preventDefault()\n                    onClose()\n                    return\n                }\n                case 'Home': {\n                    e.preventDefault()\n                    moveTo(firstEnabled())\n                    return\n                }\n                case 'End': {\n                    e.preventDefault()\n                    moveTo(lastEnabled())\n                    return\n                }\n            }\n\n            if (key === ' ' && selectOnSpace && !typeaheadRef.current.buffer) {\n                e.preventDefault()\n                if (activeIndex >= 0 && activeIndex < itemCount && !isDisabled(activeIndex)) {\n                    onSelect?.(activeIndex)\n                }\n                return\n            }\n\n            if (getItemLabel && key.length === 1 && !e.ctrlKey && !e.metaKey && !e.altKey) {\n                if (key === ' ' && !typeaheadRef.current.buffer) return\n                if (handleTypeahead(key) && mode === 'roving') e.preventDefault()\n            }\n        },\n        [\n            isOpen,\n            itemCount,\n            orientation,\n            rtl,\n            activeIndex,\n            onSelect,\n            onClose,\n            selectOnSpace,\n            getItemLabel,\n            mode,\n            moveTo,\n            step,\n            isDisabled,\n            firstEnabled,\n            lastEnabled,\n            handleTypeahead,\n        ]\n    )\n\n    const getItemId = useCallback((index: number) => `${prefix}-item-${index}`, [prefix])\n\n    const activeDescendantId =\n        mode === 'activedescendant' && isOpen && activeIndex >= 0 && activeIndex < itemCount\n            ? getItemId(activeIndex)\n            : undefined\n\n    // Roving: the tab stop is the active item, falling back to the first enabled one.\n    const tabStopIndex =\n        activeIndex >= 0 && activeIndex < itemCount && !isDisabled(activeIndex) ? activeIndex : firstEnabled()\n\n    const focusItem = useCallback(\n        (index: number) => {\n            if (index < 0 || index >= itemCount) return\n            moveTo(index)\n            const el = itemRefs.current[index]\n            if (el && typeof el.focus === 'function') el.focus()\n        },\n        [itemCount, moveTo]\n    )\n\n    const getItemProps = useCallback(\n        (index: number): UseKeyboardNavItemProps => {\n            const ref = (el: HTMLElement | null) => {\n                itemRefs.current[index] = el\n            }\n            if (mode === 'roving') {\n                return {\n                    id: getItemId(index),\n                    tabIndex: index === tabStopIndex ? 0 : -1,\n                    ref,\n                    onFocus: () => {\n                        if (!isDisabled(index)) setActiveIndex(index)\n                    },\n                }\n            }\n            return {id: getItemId(index), ref}\n        },\n        [mode, getItemId, tabStopIndex, isDisabled]\n    )\n\n    const getContainerProps = useCallback(\n        (): UseKeyboardNavContainerProps =>\n            mode === 'activedescendant' ? {onKeyDown, 'aria-activedescendant': activeDescendantId} : {onKeyDown},\n        [mode, onKeyDown, activeDescendantId]\n    )\n\n    return {\n        activeIndex,\n        setActiveIndex,\n        resetIndex,\n        onKeyDown,\n        activeDescendantId,\n        getItemId,\n        getItemProps,\n        getContainerProps,\n        focusItem,\n    }\n}\n\nexport type UseKeyboardNavResult = ReturnType<typeof useKeyboardNav>\n","import {useState, useCallback, useMemo} from 'react'\nimport type * as React from 'react'\n\nexport interface GhostTextOptions<T = string> {\n    options: T[]\n    value: string\n    minChars?: number\n    getLabel?: (option: T) => string\n    filter?: (options: T[], input: string) => T[]\n}\n\nexport interface GhostTextReturn<T = string> {\n    /** The ghost suffix to render after the typed text. */\n    hint: string\n    /** Accept the current hint and return the full value. */\n    accept: () => {value: string; option: T | null}\n    /** Cycle to the next matching option. */\n    next: () => void\n    /** Cycle to the previous matching option. */\n    prev: () => void\n    /** Reset the hint index (call on value change). */\n    reset: () => void\n    /** Number of matching options. */\n    matchCount: number\n    /** Handle keyboard events — Tab/Enter accept, arrows cycle (only while a hint is shown), Escape hides the hint\n     *  until the value changes. */\n    onKeyDown: (e: React.KeyboardEvent) => boolean\n}\n\nfunction defaultGetLabel<T>(option: T): string {\n    return typeof option === 'string' ? option : String(option)\n}\n\nfunction defaultFilter<T>(options: T[], input: string, getLabel: (o: T) => string): T[] {\n    if (!input) return []\n    const lower = input.toLowerCase()\n    return options.filter((o) => getLabel(o).toLowerCase().startsWith(lower))\n}\n\n// Manage inline ghost-text suggestions for any text input.\nexport function useGhostText<T = string>({\n    options,\n    value,\n    minChars = 2,\n    getLabel = defaultGetLabel,\n    filter,\n}: GhostTextOptions<T>): GhostTextReturn<T> {\n    const [hintIndex, setHintIndex] = useState(0)\n    // Value for which the user dismissed the hint with Escape; typing anything else shows hints again.\n    const [dismissedFor, setDismissedFor] = useState<string | null>(null)\n\n    const filtered = useMemo(() => {\n        if (value.length < minChars) return []\n        if (filter) return filter(options, value)\n        return defaultFilter(options, value, getLabel)\n    }, [options, value, minChars, filter, getLabel])\n\n    const current = filtered.length > 0 ? filtered[hintIndex % filtered.length] : null\n    const fullLabel = current ? getLabel(current) : ''\n    const hint =\n        dismissedFor !== value && fullLabel && fullLabel.toLowerCase().startsWith(value.toLowerCase())\n            ? fullLabel.slice(value.length)\n            : ''\n\n    const accept = useCallback(() => {\n        if (!hint || !current) return {value, option: null}\n        return {value: value + hint, option: current}\n    }, [hint, current, value])\n\n    const next = useCallback(() => {\n        if (filtered.length > 1) setHintIndex((i) => (i + 1) % filtered.length)\n    }, [filtered.length])\n\n    const prev = useCallback(() => {\n        if (filtered.length > 1) setHintIndex((i) => (i - 1 + filtered.length) % filtered.length)\n    }, [filtered.length])\n\n    const reset = useCallback(() => {\n        setHintIndex(0)\n        setDismissedFor(null)\n    }, [])\n\n    const onKeyDown = useCallback(\n        (e: React.KeyboardEvent): boolean => {\n            if ((e.key === 'Tab' || e.key === 'Enter') && hint) {\n                e.preventDefault()\n                return true // signal: caller should accept\n            }\n            if (e.key === 'Escape' && hint) {\n                e.preventDefault()\n                setDismissedFor(value)\n                return false\n            }\n            // Arrows only cycle a visible hint; otherwise they keep moving the caret (e.g. in a textarea).\n            if (e.key === 'ArrowDown' && hint && filtered.length > 1) {\n                e.preventDefault()\n                next()\n                return false\n            }\n            if (e.key === 'ArrowUp' && hint && filtered.length > 1) {\n                e.preventDefault()\n                prev()\n                return false\n            }\n            return false\n        },\n        [hint, value, filtered.length, next, prev]\n    )\n\n    return {hint, accept, next, prev, reset, matchCount: filtered.length, onKeyDown}\n}\n"],"mappings":"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"}

package/dist/useGhostText-DO-tfxS0.cjs

@@ -0,0 +1,2 @@
+require(`./core-w629c4ND.cjs`);let e=require(`react`);function t(t,n){let[r,i]=(0,e.useState)(t);return(0,e.useEffect)(()=>{let e=setTimeout(()=>i(t),n);return()=>clearTimeout(e)},[t,n]),r}function n(t,n){let r=(0,e.useRef)(t);r.current=t;let i=(0,e.useRef)(null);return(0,e.useCallback)(((...e)=>{i.current&&clearTimeout(i.current),i.current=setTimeout(()=>r.current(...e),n)}),[n])}var r=500;function i(e){return e.replace(/[^a-zA-Z0-9_-]/g,``)}function a({itemCount:t,onSelect:n,onClose:a,isOpen:o=!0,loop:s=!0,mode:c=`none`,orientation:l=`vertical`,rtl:u=!1,isItemDisabled:d,getItemLabel:f,selectOnSpace:p=!1,idPrefix:m,initialIndex:h=-1}){let[g,_]=(0,e.useState)(h),v=(0,e.useId)(),y=m??`m-kbnav-${i(v)}`,b=(0,e.useRef)([]),x=(0,e.useRef)(!1),S=(0,e.useRef)({buffer:``,timer:null}),C=(0,e.useCallback)(()=>_(-1),[]),w=(0,e.useCallback)(e=>d?d(e):!1,[d]),T=(0,e.useCallback)(()=>{for(let e=0;e<t;e++)if(!w(e))return e;return-1},[t,w]),E=(0,e.useCallback)(()=>{for(let e=t-1;e>=0;e--)if(!w(e))return e;return-1},[t,w]),D=(0,e.useCallback)((e,n)=>{if(n===1){for(let n=e+1;n<t;n++)if(!w(n))return n;if(!s)return e;let n=T();return n===-1?e:n}for(let n=Math.min(e,t)-1;n>=0;n--)if(!w(n))return n;if(!s)return e===-1?T():e;let r=E();return r===-1?e:r},[t,w,s,T,E]),O=(0,e.useCallback)(e=>{x.current=!0,_(e)},[]);(0,e.useEffect)(()=>{if(c!==`roving`||!x.current)return;x.current=!1;let e=b.current[g];e&&typeof e.focus==`function`&&e!==e.ownerDocument.activeElement&&e.focus()},[c,g]),(0,e.useEffect)(()=>{if(c!==`activedescendant`||!o||g<0)return;let e=b.current[g];e&&typeof e.scrollIntoView==`function`&&e.scrollIntoView({block:`nearest`})},[c,o,g]),(0,e.useEffect)(()=>{let e=S.current;return()=>{e.timer&&clearTimeout(e.timer)}},[]);let k=(0,e.useCallback)(e=>{if(!f||t===0)return!1;let n=S.current;n.timer&&clearTimeout(n.timer),n.buffer+=e.toLowerCase(),n.timer=setTimeout(()=>{n.buffer=``,n.timer=null},r);let i=n.buffer,a=i.length>1&&i.split(``).every(e=>e===i[0])?i[0]:i,o=+(a.length===1),s=g<0?0:g;for(let e=0;e<t;e++){let n=(s+o+e)%t;if(!w(n)&&(f(n)??``).trim().toLowerCase().startsWith(a))return O(n),!0}return!1},[f,t,g,w,O]),A=(0,e.useCallback)(e=>{if(!o||t===0)return;let r=l!==`horizontal`,i=l!==`vertical`,s=e.key;if(i&&u&&(s===`ArrowLeft`||s===`ArrowRight`)&&(s=s===`ArrowLeft`?`ArrowRight`:`ArrowLeft`),s===`ArrowDown`&&r||s===`ArrowRight`&&i){e.preventDefault(),O(e=>D(e,1));return}if(s===`ArrowUp`&&r||s===`ArrowLeft`&&i){e.preventDefault(),O(e=>D(e,-1));return}switch(s){case`Enter`:e.preventDefault(),g>=0&&g<t&&!w(g)&&n?.(g);return;case`Escape`:if(!a)return;e.preventDefault(),a();return;case`Home`:e.preventDefault(),O(T());return;case`End`:e.preventDefault(),O(E());return}if(s===` `&&p&&!S.current.buffer){e.preventDefault(),g>=0&&g<t&&!w(g)&&n?.(g);return}if(f&&s.length===1&&!e.ctrlKey&&!e.metaKey&&!e.altKey){if(s===` `&&!S.current.buffer)return;k(s)&&c===`roving`&&e.preventDefault()}},[o,t,l,u,g,n,a,p,f,c,O,D,w,T,E,k]),j=(0,e.useCallback)(e=>`${y}-item-${e}`,[y]),M=c===`activedescendant`&&o&&g>=0&&g<t?j(g):void 0,N=g>=0&&g<t&&!w(g)?g:T(),P=(0,e.useCallback)(e=>{if(e<0||e>=t)return;O(e);let n=b.current[e];n&&typeof n.focus==`function`&&n.focus()},[t,O]);return{activeIndex:g,setActiveIndex:_,resetIndex:C,onKeyDown:A,activeDescendantId:M,getItemId:j,getItemProps:(0,e.useCallback)(e=>{let t=t=>{b.current[e]=t};return c===`roving`?{id:j(e),tabIndex:e===N?0:-1,ref:t,onFocus:()=>{w(e)||_(e)}}:{id:j(e),ref:t}},[c,j,N,w]),getContainerProps:(0,e.useCallback)(()=>c===`activedescendant`?{onKeyDown:A,"aria-activedescendant":M}:{onKeyDown:A},[c,A,M]),focusItem:P}}function o(e){return typeof e==`string`?e:String(e)}function s(e,t,n){if(!t)return[];let r=t.toLowerCase();return e.filter(e=>n(e).toLowerCase().startsWith(r))}function c({options:t,value:n,minChars:r=2,getLabel:i=o,filter:a}){let[c,l]=(0,e.useState)(0),[u,d]=(0,e.useState)(null),f=(0,e.useMemo)(()=>n.length<r?[]:a?a(t,n):s(t,n,i),[t,n,r,a,i]),p=f.length>0?f[c%f.length]:null,m=p?i(p):``,h=u!==n&&m&&m.toLowerCase().startsWith(n.toLowerCase())?m.slice(n.length):``,g=(0,e.useCallback)(()=>!h||!p?{value:n,option:null}:{value:n+h,option:p},[h,p,n]),_=(0,e.useCallback)(()=>{f.length>1&&l(e=>(e+1)%f.length)},[f.length]),v=(0,e.useCallback)(()=>{f.length>1&&l(e=>(e-1+f.length)%f.length)},[f.length]),y=(0,e.useCallback)(()=>{l(0),d(null)},[]),b=(0,e.useCallback)(e=>(e.key===`Tab`||e.key===`Enter`)&&h?(e.preventDefault(),!0):e.key===`Escape`&&h?(e.preventDefault(),d(n),!1):e.key===`ArrowDown`&&h&&f.length>1?(e.preventDefault(),_(),!1):e.key===`ArrowUp`&&h&&f.length>1?(e.preventDefault(),v(),!1):!1,[h,n,f.length,_,v]);return{hint:h,accept:g,next:_,prev:v,reset:y,matchCount:f.length,onKeyDown:b}}Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return c}});
+//# sourceMappingURL=useGhostText-DO-tfxS0.cjs.map

package/dist/useGhostText-DO-tfxS0.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGhostText-DO-tfxS0.cjs","names":[],"sources":["../src/utils/useDebounce.ts","../src/utils/useKeyboardNav.ts","../src/utils/useGhostText.ts"],"sourcesContent":["import {useState, useEffect, useRef, useCallback} from 'react'\n\n// Expose a value only after it stays stable for the given delay.\nexport function useDebounce<T>(value: T, delay: number): T {\n    const [debounced, setDebounced] = useState(value)\n\n    useEffect(() => {\n        const timer = setTimeout(() => setDebounced(value), delay)\n        return () => clearTimeout(timer)\n    }, [value, delay])\n\n    return debounced\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\n// Wrap a callback so repeated calls collapse into the latest invocation.\nexport function useDebouncedCallback<T extends (...args: any[]) => void>(callback: T, delay: number): T {\n    const callbackRef = useRef(callback)\n    callbackRef.current = callback\n    const timerRef = useRef<ReturnType<typeof setTimeout>>(null)\n\n    return useCallback(\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        ((...args: any[]) => {\n            if (timerRef.current) clearTimeout(timerRef.current)\n            timerRef.current = setTimeout(() => callbackRef.current(...args), delay)\n        }) as T,\n        [delay]\n    )\n}\n","import {useState, useCallback, useEffect, useId, useRef, type FocusEvent, type KeyboardEvent} from 'react'\n\n/**\n * Focus-management strategy (WAI-ARIA APG \"Managing focus within components\"):\n * - `none` (default) — the hook only tracks `activeIndex`; the caller renders the highlight itself.\n * - `activedescendant` — DOM focus stays on the container / input; the active item is exposed via\n *   `aria-activedescendant` (combobox, listbox, grid with a focused host).\n * - `roving` — exactly one item has `tabIndex=0`, the rest `-1`; arrow keys move real DOM focus\n *   (menu, toolbar, tablist, tree, radio group).\n */\nexport type UseKeyboardNavMode = 'none' | 'activedescendant' | 'roving'\n\n/** Which arrow keys move the active item. */\nexport type UseKeyboardNavOrientation = 'vertical' | 'horizontal' | 'both'\n\nexport interface UseKeyboardNavOptions {\n    itemCount: number\n    /** Called on Enter (and Space when `selectOnSpace`) with the active index. */\n    onSelect?: (index: number) => void\n    /** Called on Escape. When omitted Escape is not handled, so it can bubble to an outer layer. */\n    onClose?: () => void\n    /** Keys are ignored while `false`. Defaults to `true`. */\n    isOpen?: boolean\n    loop?: boolean\n    /** Focus strategy. Defaults to `'none'` (the original behaviour). */\n    mode?: UseKeyboardNavMode\n    /** Defaults to `'vertical'` (ArrowUp / ArrowDown). */\n    orientation?: UseKeyboardNavOrientation\n    /** Flip ArrowLeft / ArrowRight for right-to-left layouts. */\n    rtl?: boolean\n    /** Disabled items are skipped by arrows, Home / End and typeahead, and are never selected. */\n    isItemDisabled?: (index: number) => boolean\n    /** Enables first-letter typeahead (APG) when provided. */\n    getItemLabel?: (index: number) => string\n    /** Treat Space like Enter (menus, toolbars, listboxes without a text input). */\n    selectOnSpace?: boolean\n    /** Prefix for generated item ids. Defaults to a `useId()` based value. */\n    idPrefix?: string\n    /** Initial active index. Defaults to `-1` (nothing active). */\n    initialIndex?: number\n}\n\nexport interface UseKeyboardNavItemProps {\n    id: string\n    tabIndex?: number\n    ref?: (el: HTMLElement | null) => void\n    onFocus?: (e: FocusEvent<HTMLElement>) => void\n}\n\nexport interface UseKeyboardNavContainerProps {\n    onKeyDown: (e: KeyboardEvent) => void\n    'aria-activedescendant'?: string\n}\n\nconst TYPEAHEAD_RESET_MS = 500\n\nfunction sanitizeId(value: string) {\n    return value.replace(/[^a-zA-Z0-9_-]/g, '')\n}\n\n// Provide arrow-key navigation and selection state for list-like widgets.\nexport function useKeyboardNav({\n    itemCount,\n    onSelect,\n    onClose,\n    isOpen = true,\n    loop = true,\n    mode = 'none',\n    orientation = 'vertical',\n    rtl = false,\n    isItemDisabled,\n    getItemLabel,\n    selectOnSpace = false,\n    idPrefix,\n    initialIndex = -1,\n}: UseKeyboardNavOptions) {\n    const [activeIndex, setActiveIndex] = useState(initialIndex)\n    const reactId = useId()\n    const prefix = idPrefix ?? `m-kbnav-${sanitizeId(reactId)}`\n    const itemRefs = useRef<(HTMLElement | null)[]>([])\n    const focusPendingRef = useRef(false)\n    const typeaheadRef = useRef<{buffer: string; timer: ReturnType<typeof setTimeout> | null}>({\n        buffer: '',\n        timer: null,\n    })\n\n    // Reset highlight state when the owning widget closes or clears results.\n    const resetIndex = useCallback(() => setActiveIndex(-1), [])\n\n    const isDisabled = useCallback(\n        (index: number) => (isItemDisabled ? isItemDisabled(index) : false),\n        [isItemDisabled]\n    )\n\n    const firstEnabled = useCallback(() => {\n        for (let i = 0; i < itemCount; i++) if (!isDisabled(i)) return i\n        return -1\n    }, [itemCount, isDisabled])\n\n    const lastEnabled = useCallback(() => {\n        for (let i = itemCount - 1; i >= 0; i--) if (!isDisabled(i)) return i\n        return -1\n    }, [itemCount, isDisabled])\n\n    // Step to the next enabled item in `dir`, honouring `loop`. Returns `prev` when nothing qualifies.\n    const step = useCallback(\n        (prev: number, dir: 1 | -1) => {\n            if (dir === 1) {\n                for (let i = prev + 1; i < itemCount; i++) if (!isDisabled(i)) return i\n                if (!loop) return prev\n                const first = firstEnabled()\n                return first === -1 ? prev : first\n            }\n            for (let i = Math.min(prev, itemCount) - 1; i >= 0; i--) if (!isDisabled(i)) return i\n            if (!loop) return prev === -1 ? firstEnabled() : prev\n            const last = lastEnabled()\n            return last === -1 ? prev : last\n        },\n        [itemCount, isDisabled, loop, firstEnabled, lastEnabled]\n    )\n\n    const moveTo = useCallback((next: number | ((prev: number) => number)) => {\n        focusPendingRef.current = true\n        setActiveIndex(next)\n    }, [])\n\n    // Roving mode: move real DOM focus after a keyboard-driven index change.\n    useEffect(() => {\n        if (mode !== 'roving' || !focusPendingRef.current) return\n        focusPendingRef.current = false\n        const el = itemRefs.current[activeIndex]\n        if (el && typeof el.focus === 'function' && el !== el.ownerDocument.activeElement) el.focus()\n    }, [mode, activeIndex])\n\n    // Active-descendant mode: keep the virtually focused option visible inside scroll containers.\n    useEffect(() => {\n        if (mode !== 'activedescendant' || !isOpen || activeIndex < 0) return\n        const el = itemRefs.current[activeIndex]\n        if (el && typeof el.scrollIntoView === 'function') el.scrollIntoView({block: 'nearest'})\n    }, [mode, isOpen, activeIndex])\n\n    useEffect(() => {\n        const state = typeaheadRef.current\n        return () => {\n            if (state.timer) clearTimeout(state.timer)\n        }\n    }, [])\n\n    const handleTypeahead = useCallback(\n        (char: string) => {\n            if (!getItemLabel || itemCount === 0) return false\n            const state = typeaheadRef.current\n            if (state.timer) clearTimeout(state.timer)\n            state.buffer += char.toLowerCase()\n            state.timer = setTimeout(() => {\n                state.buffer = ''\n                state.timer = null\n            }, TYPEAHEAD_RESET_MS)\n\n            // Repeating the same letter cycles through matches; a longer prefix refines from the current item.\n            const buffer = state.buffer\n            const sameChar = buffer.length > 1 && buffer.split('').every((c) => c === buffer[0])\n            const search = sameChar ? buffer[0] : buffer\n            const startOffset = search.length === 1 ? 1 : 0\n            const start = activeIndex < 0 ? 0 : activeIndex\n            for (let n = 0; n < itemCount; n++) {\n                const i = (start + startOffset + n) % itemCount\n                if (isDisabled(i)) continue\n                const label = (getItemLabel(i) ?? '').trim().toLowerCase()\n                if (label.startsWith(search)) {\n                    moveTo(i)\n                    return true\n                }\n            }\n            return false\n        },\n        [getItemLabel, itemCount, activeIndex, isDisabled, moveTo]\n    )\n\n    const onKeyDown = useCallback(\n        (e: KeyboardEvent) => {\n            if (!isOpen || itemCount === 0) return\n\n            const vertical = orientation !== 'horizontal'\n            const horizontal = orientation !== 'vertical'\n            let key = e.key\n            if (horizontal && rtl && (key === 'ArrowLeft' || key === 'ArrowRight')) {\n                key = key === 'ArrowLeft' ? 'ArrowRight' : 'ArrowLeft'\n            }\n\n            if ((key === 'ArrowDown' && vertical) || (key === 'ArrowRight' && horizontal)) {\n                e.preventDefault()\n                moveTo((prev) => step(prev, 1))\n                return\n            }\n            if ((key === 'ArrowUp' && vertical) || (key === 'ArrowLeft' && horizontal)) {\n                e.preventDefault()\n                moveTo((prev) => step(prev, -1))\n                return\n            }\n\n            switch (key) {\n                case 'Enter': {\n                    e.preventDefault()\n                    if (activeIndex >= 0 && activeIndex < itemCount && !isDisabled(activeIndex)) {\n                        onSelect?.(activeIndex)\n                    }\n                    return\n                }\n                case 'Escape': {\n                    if (!onClose) return\n                    e.preventDefault()\n                    onClose()\n                    return\n                }\n                case 'Home': {\n                    e.preventDefault()\n                    moveTo(firstEnabled())\n                    return\n                }\n                case 'End': {\n                    e.preventDefault()\n                    moveTo(lastEnabled())\n                    return\n                }\n            }\n\n            if (key === ' ' && selectOnSpace && !typeaheadRef.current.buffer) {\n                e.preventDefault()\n                if (activeIndex >= 0 && activeIndex < itemCount && !isDisabled(activeIndex)) {\n                    onSelect?.(activeIndex)\n                }\n                return\n            }\n\n            if (getItemLabel && key.length === 1 && !e.ctrlKey && !e.metaKey && !e.altKey) {\n                if (key === ' ' && !typeaheadRef.current.buffer) return\n                if (handleTypeahead(key) && mode === 'roving') e.preventDefault()\n            }\n        },\n        [\n            isOpen,\n            itemCount,\n            orientation,\n            rtl,\n            activeIndex,\n            onSelect,\n            onClose,\n            selectOnSpace,\n            getItemLabel,\n            mode,\n            moveTo,\n            step,\n            isDisabled,\n            firstEnabled,\n            lastEnabled,\n            handleTypeahead,\n        ]\n    )\n\n    const getItemId = useCallback((index: number) => `${prefix}-item-${index}`, [prefix])\n\n    const activeDescendantId =\n        mode === 'activedescendant' && isOpen && activeIndex >= 0 && activeIndex < itemCount\n            ? getItemId(activeIndex)\n            : undefined\n\n    // Roving: the tab stop is the active item, falling back to the first enabled one.\n    const tabStopIndex =\n        activeIndex >= 0 && activeIndex < itemCount && !isDisabled(activeIndex) ? activeIndex : firstEnabled()\n\n    const focusItem = useCallback(\n        (index: number) => {\n            if (index < 0 || index >= itemCount) return\n            moveTo(index)\n            const el = itemRefs.current[index]\n            if (el && typeof el.focus === 'function') el.focus()\n        },\n        [itemCount, moveTo]\n    )\n\n    const getItemProps = useCallback(\n        (index: number): UseKeyboardNavItemProps => {\n            const ref = (el: HTMLElement | null) => {\n                itemRefs.current[index] = el\n            }\n            if (mode === 'roving') {\n                return {\n                    id: getItemId(index),\n                    tabIndex: index === tabStopIndex ? 0 : -1,\n                    ref,\n                    onFocus: () => {\n                        if (!isDisabled(index)) setActiveIndex(index)\n                    },\n                }\n            }\n            return {id: getItemId(index), ref}\n        },\n        [mode, getItemId, tabStopIndex, isDisabled]\n    )\n\n    const getContainerProps = useCallback(\n        (): UseKeyboardNavContainerProps =>\n            mode === 'activedescendant' ? {onKeyDown, 'aria-activedescendant': activeDescendantId} : {onKeyDown},\n        [mode, onKeyDown, activeDescendantId]\n    )\n\n    return {\n        activeIndex,\n        setActiveIndex,\n        resetIndex,\n        onKeyDown,\n        activeDescendantId,\n        getItemId,\n        getItemProps,\n        getContainerProps,\n        focusItem,\n    }\n}\n\nexport type UseKeyboardNavResult = ReturnType<typeof useKeyboardNav>\n","import {useState, useCallback, useMemo} from 'react'\nimport type * as React from 'react'\n\nexport interface GhostTextOptions<T = string> {\n    options: T[]\n    value: string\n    minChars?: number\n    getLabel?: (option: T) => string\n    filter?: (options: T[], input: string) => T[]\n}\n\nexport interface GhostTextReturn<T = string> {\n    /** The ghost suffix to render after the typed text. */\n    hint: string\n    /** Accept the current hint and return the full value. */\n    accept: () => {value: string; option: T | null}\n    /** Cycle to the next matching option. */\n    next: () => void\n    /** Cycle to the previous matching option. */\n    prev: () => void\n    /** Reset the hint index (call on value change). */\n    reset: () => void\n    /** Number of matching options. */\n    matchCount: number\n    /** Handle keyboard events — Tab/Enter accept, arrows cycle (only while a hint is shown), Escape hides the hint\n     *  until the value changes. */\n    onKeyDown: (e: React.KeyboardEvent) => boolean\n}\n\nfunction defaultGetLabel<T>(option: T): string {\n    return typeof option === 'string' ? option : String(option)\n}\n\nfunction defaultFilter<T>(options: T[], input: string, getLabel: (o: T) => string): T[] {\n    if (!input) return []\n    const lower = input.toLowerCase()\n    return options.filter((o) => getLabel(o).toLowerCase().startsWith(lower))\n}\n\n// Manage inline ghost-text suggestions for any text input.\nexport function useGhostText<T = string>({\n    options,\n    value,\n    minChars = 2,\n    getLabel = defaultGetLabel,\n    filter,\n}: GhostTextOptions<T>): GhostTextReturn<T> {\n    const [hintIndex, setHintIndex] = useState(0)\n    // Value for which the user dismissed the hint with Escape; typing anything else shows hints again.\n    const [dismissedFor, setDismissedFor] = useState<string | null>(null)\n\n    const filtered = useMemo(() => {\n        if (value.length < minChars) return []\n        if (filter) return filter(options, value)\n        return defaultFilter(options, value, getLabel)\n    }, [options, value, minChars, filter, getLabel])\n\n    const current = filtered.length > 0 ? filtered[hintIndex % filtered.length] : null\n    const fullLabel = current ? getLabel(current) : ''\n    const hint =\n        dismissedFor !== value && fullLabel && fullLabel.toLowerCase().startsWith(value.toLowerCase())\n            ? fullLabel.slice(value.length)\n            : ''\n\n    const accept = useCallback(() => {\n        if (!hint || !current) return {value, option: null}\n        return {value: value + hint, option: current}\n    }, [hint, current, value])\n\n    const next = useCallback(() => {\n        if (filtered.length > 1) setHintIndex((i) => (i + 1) % filtered.length)\n    }, [filtered.length])\n\n    const prev = useCallback(() => {\n        if (filtered.length > 1) setHintIndex((i) => (i - 1 + filtered.length) % filtered.length)\n    }, [filtered.length])\n\n    const reset = useCallback(() => {\n        setHintIndex(0)\n        setDismissedFor(null)\n    }, [])\n\n    const onKeyDown = useCallback(\n        (e: React.KeyboardEvent): boolean => {\n            if ((e.key === 'Tab' || e.key === 'Enter') && hint) {\n                e.preventDefault()\n                return true // signal: caller should accept\n            }\n            if (e.key === 'Escape' && hint) {\n                e.preventDefault()\n                setDismissedFor(value)\n                return false\n            }\n            // Arrows only cycle a visible hint; otherwise they keep moving the caret (e.g. in a textarea).\n            if (e.key === 'ArrowDown' && hint && filtered.length > 1) {\n                e.preventDefault()\n                next()\n                return false\n            }\n            if (e.key === 'ArrowUp' && hint && filtered.length > 1) {\n                e.preventDefault()\n                prev()\n                return false\n            }\n            return false\n        },\n        [hint, value, filtered.length, next, prev]\n    )\n\n    return {hint, accept, next, prev, reset, matchCount: filtered.length, onKeyDown}\n}\n"],"mappings":"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"}

package/dist/useModalLayer-CpOPSDbf.js

@@ -0,0 +1,128 @@
+import { useEffect as e, useRef as t } from "react";
+import { createPortal as n } from "react-dom";
+//#region src/components/primitives/MPortal/MPortal.tsx
+function r({ children: e, container: t }) {
+	let r = t ?? (typeof document < "u" ? document.body : null);
+	return r ? n(e, r) : null;
+}
+//#endregion
+//#region src/components/primitives/MPopover/popoverStack.ts
+var i = [], a = 1;
+function o() {
+	return a++;
+}
+function s(e) {
+	return i.push(e), () => {
+		let t = i.indexOf(e);
+		t !== -1 && i.splice(t, 1);
+	};
+}
+function c() {
+	return i.length > 0;
+}
+function l(e) {
+	let t = e.getAnchorEl();
+	if (!t) return null;
+	for (let n of i) {
+		if (n.id === e.id) continue;
+		let r = n.getPopoverEl();
+		if (r && r.contains(t)) return n.id;
+	}
+	return null;
+}
+function u(e, t) {
+	if (!t) return !1;
+	for (let n of i) {
+		if (n.id === e) continue;
+		let r = n.getPopoverEl();
+		if (!r || !r.contains(t)) continue;
+		let a = /* @__PURE__ */ new Set(), o = l(n);
+		for (; o !== null && !a.has(o);) {
+			if (o === e) return !0;
+			a.add(o);
+			let t = i.find((e) => e.id === o);
+			o = t ? l(t) : null;
+		}
+	}
+	return !1;
+}
+function d(e) {
+	for (let t of i) {
+		if (t.id === e) continue;
+		let n = /* @__PURE__ */ new Set(), r = l(t);
+		for (; r !== null && !n.has(r);) {
+			if (r === e) return !0;
+			n.add(r);
+			let t = i.find((e) => e.id === r);
+			r = t ? l(t) : null;
+		}
+	}
+	return !1;
+}
+function f(e) {
+	for (let t = i.length - 1; t >= 0; t--) {
+		let n = i[t];
+		if (!d(n.id)) return n.id === e;
+	}
+	return !1;
+}
+//#endregion
+//#region src/utils/useModalLayer.ts
+var p = [], m = [
+	"a[href]",
+	"area[href]",
+	"button:not([disabled])",
+	"input:not([disabled]):not([type=\"hidden\"])",
+	"select:not([disabled])",
+	"textarea:not([disabled])",
+	"iframe",
+	"audio[controls]",
+	"video[controls]",
+	"[contenteditable]:not([contenteditable=\"false\"])",
+	"[tabindex]:not([tabindex=\"-1\"])"
+].join(",");
+function h(e) {
+	return Array.from(e.querySelectorAll(m)).filter((e) => !e.closest("[inert]") && (typeof e.checkVisibility == "function" ? e.checkVisibility() : !0));
+}
+function g(e) {
+	return h(e).filter((e) => e.tabIndex >= 0);
+}
+function _({ active: n, containerRef: r, onEscape: i }) {
+	let a = t(i);
+	e(() => {
+		a.current = i;
+	}, [i]), e(() => {
+		if (!n || typeof document > "u") return;
+		let e = {};
+		p.push(e);
+		let t = () => p[p.length - 1] === e, i = document.activeElement instanceof HTMLElement ? document.activeElement : null, o = r.current, s = o?.querySelector("[role=\"dialog\"]") ?? o;
+		s && !s.contains(document.activeElement) && (s.hasAttribute("tabindex") || s.setAttribute("tabindex", "-1"), (s.querySelector("[autofocus], [data-autofocus]") ?? s).focus({ preventScroll: !0 }));
+		let l = (e) => {
+			if (!t() || e.defaultPrevented) return;
+			if (e.key === "Escape") {
+				if (c() || !a.current) return;
+				a.current();
+				return;
+			}
+			if (e.key !== "Tab" || !s) return;
+			let n = document.activeElement;
+			if (n && !s.contains(n) && n.closest(".popover")) return;
+			let r = h(s);
+			if (r.length === 0) {
+				e.preventDefault(), s.focus({ preventScroll: !0 });
+				return;
+			}
+			let i = r[0], o = r[r.length - 1], l = !n || !s.contains(n) || n === s;
+			e.shiftKey && (l || n === i) ? (e.preventDefault(), o.focus()) : !e.shiftKey && (l || n === o) && (e.preventDefault(), i.focus());
+		};
+		return document.addEventListener("keydown", l), () => {
+			document.removeEventListener("keydown", l);
+			let t = p.indexOf(e);
+			t !== -1 && p.splice(t, 1), i && i.isConnected && i.focus({ preventScroll: !0 });
+		};
+	}, [n, r]);
+}
+//#endregion
+export { f as a, r as c, u as i, g as n, o, _ as r, s, h as t };
+
+//# sourceMappingURL=useModalLayer-CpOPSDbf.js.map

package/dist/useModalLayer-CpOPSDbf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModalLayer-CpOPSDbf.js","names":[],"sources":["../src/components/primitives/MPortal/MPortal.tsx","../src/components/primitives/MPopover/popoverStack.ts","../src/utils/useModalLayer.ts"],"sourcesContent":["import {createPortal} from 'react-dom'\nimport type {MPortalProps} from './MPortal.types'\n\n// Mount children into a detached DOM target while defaulting to document.body.\nexport function MPortal({children, container}: MPortalProps) {\n    const target = container ?? (typeof document !== 'undefined' ? document.body : null)\n    if (!target) return null\n    return createPortal(children, target)\n}\n","/**\n * Registry of currently-open MPopover instances.\n *\n * Every popover portals its content to `document.body`, so a popover opened\n * from inside another popover is NOT a DOM descendant of its parent. That\n * breaks the naive outside-click test (`parent.contains(target)`): pressing a\n * nested dropdown item looks like an outside click to the parent, the parent\n * closes, React unmounts the nested menu mid-gesture, and the browser never\n * gets to fire `click` because mousedown and mouseup landed on different\n * elements. The action silently does nothing.\n *\n * This registry restores the nesting relation the DOM lost. Nesting is derived\n * from where each popover's ANCHOR lives, not from open order: a popover whose\n * anchor sits inside another popover's element is that popover's child. Open\n * order would misclassify two independent popovers that happen to be open at\n * the same time — clicking the newer one must still close the older one.\n */\n\nexport interface PopoverRegistration {\n    id: number\n    getPopoverEl: () => HTMLElement | null\n    getAnchorEl: () => HTMLElement | null\n}\n\nconst registrations: PopoverRegistration[] = []\nlet nextId = 1\n\nexport function nextPopoverId(): number {\n    return nextId++\n}\n\nexport function registerPopover(registration: PopoverRegistration): () => void {\n    registrations.push(registration)\n    return () => {\n        const index = registrations.indexOf(registration)\n        if (index !== -1) registrations.splice(index, 1)\n    }\n}\n\n/** True while any popover is open — modal layers leave Escape to it. */\nexport function hasOpenPopovers(): boolean {\n    return registrations.length > 0\n}\n\n/** The registered popover whose element contains `entry`'s anchor, if any. */\nfunction parentIdOf(entry: PopoverRegistration): number | null {\n    const anchor = entry.getAnchorEl()\n    if (!anchor) return null\n\n    for (const other of registrations) {\n        if (other.id === entry.id) continue\n        const element = other.getPopoverEl()\n        if (element && element.contains(anchor)) return other.id\n    }\n\n    return null\n}\n\n/**\n * True when `target` lies inside a popover that is nested (at any depth) within\n * the popover identified by `id`. Callers use it to keep a parent open while\n * the interaction belongs to one of its descendants.\n */\nexport function isInsideDescendantPopover(id: number, target: Node | null): boolean {\n    if (!target) return false\n\n    for (const entry of registrations) {\n        if (entry.id === id) continue\n\n        const element = entry.getPopoverEl()\n        if (!element || !element.contains(target)) continue\n\n        // Walk the ancestor chain of the popover that was actually hit.\n        // `seen` guards against a cycle if a malformed tree ever produces one.\n        const seen = new Set<number>()\n        let cursor = parentIdOf(entry)\n\n        while (cursor !== null && !seen.has(cursor)) {\n            if (cursor === id) return true\n            seen.add(cursor)\n            const parent = registrations.find((candidate) => candidate.id === cursor)\n            cursor = parent ? parentIdOf(parent) : null\n        }\n    }\n\n    return false\n}\n\n/** True when the popover identified by `id` has an open popover nested inside it. */\nfunction hasDescendant(id: number): boolean {\n    for (const entry of registrations) {\n        if (entry.id === id) continue\n\n        const seen = new Set<number>()\n        let cursor = parentIdOf(entry)\n        while (cursor !== null && !seen.has(cursor)) {\n            if (cursor === id) return true\n            seen.add(cursor)\n            const parent = registrations.find((candidate) => candidate.id === cursor)\n            cursor = parent ? parentIdOf(parent) : null\n        }\n    }\n\n    return false\n}\n\n/**\n * True when the popover identified by `id` is the top layer: the most recently\n * opened popover that has no open popover nested inside it. Only the top layer\n * reacts to Escape, so one key press peels off exactly one layer.\n */\nexport function isTopPopover(id: number): boolean {\n    for (let index = registrations.length - 1; index >= 0; index--) {\n        const entry = registrations[index]\n        if (hasDescendant(entry.id)) continue\n        return entry.id === id\n    }\n\n    return false\n}\n\n/** Test-only helper — the registry is module state that outlives a render. */\nexport function __resetPopoverStack(): void {\n    registrations.length = 0\n    nextId = 1\n}\n","import {useEffect, useRef} from 'react'\nimport type {RefObject} from 'react'\nimport {hasOpenPopovers} from '../components/primitives/MPopover/popoverStack'\n\n/**\n * Shared behaviour of blocking overlays (MModal, MDrawer, MSheet, MMediaLightbox).\n *\n * Open layers form a stack, so with a drawer opened from a modal only the top one\n * reacts to Escape and owns the Tab cycle. Focus moves into the dialog on open,\n * stays inside it while it is the top layer and returns to the opener on close.\n */\n\nconst layers: object[] = []\n\nconst FOCUSABLE = [\n    'a[href]',\n    'area[href]',\n    'button:not([disabled])',\n    'input:not([disabled]):not([type=\"hidden\"])',\n    'select:not([disabled])',\n    'textarea:not([disabled])',\n    'iframe',\n    'audio[controls]',\n    'video[controls]',\n    '[contenteditable]:not([contenteditable=\"false\"])',\n    '[tabindex]:not([tabindex=\"-1\"])',\n].join(',')\n\n/** Focusable, visible descendants of `container` in DOM order (shared with MPopover). */\nexport function getFocusable(container: HTMLElement): HTMLElement[] {\n    return Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE)).filter(\n        (element) =>\n            !element.closest('[inert]') &&\n            (typeof element.checkVisibility === 'function' ? element.checkVisibility() : true)\n    )\n}\n\n/** Like `getFocusable`, minus elements taken out of the Tab order (`tabindex=\"-1\"`, e.g. roving items). */\nexport function getTabbable(container: HTMLElement): HTMLElement[] {\n    return getFocusable(container).filter((element) => element.tabIndex >= 0)\n}\n\nexport interface UseModalLayerOptions {\n    /** True while the overlay is mounted and open (not while it animates out). */\n    active: boolean\n    /** Element wrapping the whole overlay; the dialog is the `[role=\"dialog\"]` inside it. */\n    containerRef: RefObject<HTMLElement | null>\n    /** Called on Escape when this is the top layer. Omit to ignore Escape. */\n    onEscape?: () => void\n}\n\nexport function useModalLayer({active, containerRef, onEscape}: UseModalLayerOptions): void {\n    const onEscapeRef = useRef(onEscape)\n    useEffect(() => {\n        onEscapeRef.current = onEscape\n    }, [onEscape])\n\n    useEffect(() => {\n        if (!active || typeof document === 'undefined') return\n\n        const token = {}\n        layers.push(token)\n        const isTop = () => layers[layers.length - 1] === token\n\n        const opener = document.activeElement instanceof HTMLElement ? document.activeElement : null\n        const container = containerRef.current\n        const dialog = container?.querySelector<HTMLElement>('[role=\"dialog\"]') ?? container\n\n        if (dialog && !dialog.contains(document.activeElement)) {\n            if (!dialog.hasAttribute('tabindex')) dialog.setAttribute('tabindex', '-1')\n            const preferred = dialog.querySelector<HTMLElement>('[autofocus], [data-autofocus]')\n            ;(preferred ?? dialog).focus({preventScroll: true})\n        }\n\n        const handleKeyDown = (event: KeyboardEvent) => {\n            if (!isTop() || event.defaultPrevented) return\n\n            if (event.key === 'Escape') {\n                // An open select/menu inside the dialog closes first.\n                if (hasOpenPopovers() || !onEscapeRef.current) return\n                onEscapeRef.current()\n                return\n            }\n\n            if (event.key !== 'Tab' || !dialog) return\n\n            const activeElement = document.activeElement as HTMLElement | null\n            // Popovers portal outside the dialog; leave their own Tab handling alone.\n            if (activeElement && !dialog.contains(activeElement) && activeElement.closest('.popover')) return\n\n            const focusable = getFocusable(dialog)\n            if (focusable.length === 0) {\n                event.preventDefault()\n                dialog.focus({preventScroll: true})\n                return\n            }\n\n            const first = focusable[0]\n            const last = focusable[focusable.length - 1]\n            const outside = !activeElement || !dialog.contains(activeElement) || activeElement === dialog\n\n            if (event.shiftKey && (outside || activeElement === first)) {\n                event.preventDefault()\n                last.focus()\n            } else if (!event.shiftKey && (outside || activeElement === last)) {\n                event.preventDefault()\n                first.focus()\n            }\n        }\n\n        document.addEventListener('keydown', handleKeyDown)\n\n        return () => {\n            document.removeEventListener('keydown', handleKeyDown)\n            const index = layers.indexOf(token)\n            if (index !== -1) layers.splice(index, 1)\n            if (opener && opener.isConnected) opener.focus({preventScroll: true})\n        }\n    }, [active, containerRef])\n}\n"],"mappings":"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"}

package/dist/useModalLayer-Cyt93Prs.cjs

@@ -0,0 +1,2 @@
+require(`./core-w629c4ND.cjs`);let e=require(`react`),t=require(`react-dom`);function n({children:e,container:n}){let r=n??(typeof document<`u`?document.body:null);return r?(0,t.createPortal)(e,r):null}var r=[],i=1;function a(){return i++}function o(e){return r.push(e),()=>{let t=r.indexOf(e);t!==-1&&r.splice(t,1)}}function s(){return r.length>0}function c(e){let t=e.getAnchorEl();if(!t)return null;for(let n of r){if(n.id===e.id)continue;let r=n.getPopoverEl();if(r&&r.contains(t))return n.id}return null}function l(e,t){if(!t)return!1;for(let n of r){if(n.id===e)continue;let i=n.getPopoverEl();if(!i||!i.contains(t))continue;let a=new Set,o=c(n);for(;o!==null&&!a.has(o);){if(o===e)return!0;a.add(o);let t=r.find(e=>e.id===o);o=t?c(t):null}}return!1}function u(e){for(let t of r){if(t.id===e)continue;let n=new Set,i=c(t);for(;i!==null&&!n.has(i);){if(i===e)return!0;n.add(i);let t=r.find(e=>e.id===i);i=t?c(t):null}}return!1}function d(e){for(let t=r.length-1;t>=0;t--){let n=r[t];if(!u(n.id))return n.id===e}return!1}var f=[],p=[`a[href]`,`area[href]`,`button:not([disabled])`,`input:not([disabled]):not([type="hidden"])`,`select:not([disabled])`,`textarea:not([disabled])`,`iframe`,`audio[controls]`,`video[controls]`,`[contenteditable]:not([contenteditable="false"])`,`[tabindex]:not([tabindex="-1"])`].join(`,`);function m(e){return Array.from(e.querySelectorAll(p)).filter(e=>!e.closest(`[inert]`)&&(typeof e.checkVisibility==`function`?e.checkVisibility():!0))}function h(e){return m(e).filter(e=>e.tabIndex>=0)}function g({active:t,containerRef:n,onEscape:r}){let i=(0,e.useRef)(r);(0,e.useEffect)(()=>{i.current=r},[r]),(0,e.useEffect)(()=>{if(!t||typeof document>`u`)return;let e={};f.push(e);let r=()=>f[f.length-1]===e,a=document.activeElement instanceof HTMLElement?document.activeElement:null,o=n.current,c=o?.querySelector(`[role="dialog"]`)??o;c&&!c.contains(document.activeElement)&&(c.hasAttribute(`tabindex`)||c.setAttribute(`tabindex`,`-1`),(c.querySelector(`[autofocus], [data-autofocus]`)??c).focus({preventScroll:!0}));let l=e=>{if(!r()||e.defaultPrevented)return;if(e.key===`Escape`){if(s()||!i.current)return;i.current();return}if(e.key!==`Tab`||!c)return;let t=document.activeElement;if(t&&!c.contains(t)&&t.closest(`.popover`))return;let n=m(c);if(n.length===0){e.preventDefault(),c.focus({preventScroll:!0});return}let a=n[0],o=n[n.length-1],l=!t||!c.contains(t)||t===c;e.shiftKey&&(l||t===a)?(e.preventDefault(),o.focus()):!e.shiftKey&&(l||t===o)&&(e.preventDefault(),a.focus())};return document.addEventListener(`keydown`,l),()=>{document.removeEventListener(`keydown`,l);let t=f.indexOf(e);t!==-1&&f.splice(t,1),a&&a.isConnected&&a.focus({preventScroll:!0})}},[t,n])}Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return m}});
+//# sourceMappingURL=useModalLayer-Cyt93Prs.cjs.map

package/dist/useModalLayer-Cyt93Prs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useModalLayer-Cyt93Prs.cjs","names":[],"sources":["../src/components/primitives/MPortal/MPortal.tsx","../src/components/primitives/MPopover/popoverStack.ts","../src/utils/useModalLayer.ts"],"sourcesContent":["import {createPortal} from 'react-dom'\nimport type {MPortalProps} from './MPortal.types'\n\n// Mount children into a detached DOM target while defaulting to document.body.\nexport function MPortal({children, container}: MPortalProps) {\n    const target = container ?? (typeof document !== 'undefined' ? document.body : null)\n    if (!target) return null\n    return createPortal(children, target)\n}\n","/**\n * Registry of currently-open MPopover instances.\n *\n * Every popover portals its content to `document.body`, so a popover opened\n * from inside another popover is NOT a DOM descendant of its parent. That\n * breaks the naive outside-click test (`parent.contains(target)`): pressing a\n * nested dropdown item looks like an outside click to the parent, the parent\n * closes, React unmounts the nested menu mid-gesture, and the browser never\n * gets to fire `click` because mousedown and mouseup landed on different\n * elements. The action silently does nothing.\n *\n * This registry restores the nesting relation the DOM lost. Nesting is derived\n * from where each popover's ANCHOR lives, not from open order: a popover whose\n * anchor sits inside another popover's element is that popover's child. Open\n * order would misclassify two independent popovers that happen to be open at\n * the same time — clicking the newer one must still close the older one.\n */\n\nexport interface PopoverRegistration {\n    id: number\n    getPopoverEl: () => HTMLElement | null\n    getAnchorEl: () => HTMLElement | null\n}\n\nconst registrations: PopoverRegistration[] = []\nlet nextId = 1\n\nexport function nextPopoverId(): number {\n    return nextId++\n}\n\nexport function registerPopover(registration: PopoverRegistration): () => void {\n    registrations.push(registration)\n    return () => {\n        const index = registrations.indexOf(registration)\n        if (index !== -1) registrations.splice(index, 1)\n    }\n}\n\n/** True while any popover is open — modal layers leave Escape to it. */\nexport function hasOpenPopovers(): boolean {\n    return registrations.length > 0\n}\n\n/** The registered popover whose element contains `entry`'s anchor, if any. */\nfunction parentIdOf(entry: PopoverRegistration): number | null {\n    const anchor = entry.getAnchorEl()\n    if (!anchor) return null\n\n    for (const other of registrations) {\n        if (other.id === entry.id) continue\n        const element = other.getPopoverEl()\n        if (element && element.contains(anchor)) return other.id\n    }\n\n    return null\n}\n\n/**\n * True when `target` lies inside a popover that is nested (at any depth) within\n * the popover identified by `id`. Callers use it to keep a parent open while\n * the interaction belongs to one of its descendants.\n */\nexport function isInsideDescendantPopover(id: number, target: Node | null): boolean {\n    if (!target) return false\n\n    for (const entry of registrations) {\n        if (entry.id === id) continue\n\n        const element = entry.getPopoverEl()\n        if (!element || !element.contains(target)) continue\n\n        // Walk the ancestor chain of the popover that was actually hit.\n        // `seen` guards against a cycle if a malformed tree ever produces one.\n        const seen = new Set<number>()\n        let cursor = parentIdOf(entry)\n\n        while (cursor !== null && !seen.has(cursor)) {\n            if (cursor === id) return true\n            seen.add(cursor)\n            const parent = registrations.find((candidate) => candidate.id === cursor)\n            cursor = parent ? parentIdOf(parent) : null\n        }\n    }\n\n    return false\n}\n\n/** True when the popover identified by `id` has an open popover nested inside it. */\nfunction hasDescendant(id: number): boolean {\n    for (const entry of registrations) {\n        if (entry.id === id) continue\n\n        const seen = new Set<number>()\n        let cursor = parentIdOf(entry)\n        while (cursor !== null && !seen.has(cursor)) {\n            if (cursor === id) return true\n            seen.add(cursor)\n            const parent = registrations.find((candidate) => candidate.id === cursor)\n            cursor = parent ? parentIdOf(parent) : null\n        }\n    }\n\n    return false\n}\n\n/**\n * True when the popover identified by `id` is the top layer: the most recently\n * opened popover that has no open popover nested inside it. Only the top layer\n * reacts to Escape, so one key press peels off exactly one layer.\n */\nexport function isTopPopover(id: number): boolean {\n    for (let index = registrations.length - 1; index >= 0; index--) {\n        const entry = registrations[index]\n        if (hasDescendant(entry.id)) continue\n        return entry.id === id\n    }\n\n    return false\n}\n\n/** Test-only helper — the registry is module state that outlives a render. */\nexport function __resetPopoverStack(): void {\n    registrations.length = 0\n    nextId = 1\n}\n","import {useEffect, useRef} from 'react'\nimport type {RefObject} from 'react'\nimport {hasOpenPopovers} from '../components/primitives/MPopover/popoverStack'\n\n/**\n * Shared behaviour of blocking overlays (MModal, MDrawer, MSheet, MMediaLightbox).\n *\n * Open layers form a stack, so with a drawer opened from a modal only the top one\n * reacts to Escape and owns the Tab cycle. Focus moves into the dialog on open,\n * stays inside it while it is the top layer and returns to the opener on close.\n */\n\nconst layers: object[] = []\n\nconst FOCUSABLE = [\n    'a[href]',\n    'area[href]',\n    'button:not([disabled])',\n    'input:not([disabled]):not([type=\"hidden\"])',\n    'select:not([disabled])',\n    'textarea:not([disabled])',\n    'iframe',\n    'audio[controls]',\n    'video[controls]',\n    '[contenteditable]:not([contenteditable=\"false\"])',\n    '[tabindex]:not([tabindex=\"-1\"])',\n].join(',')\n\n/** Focusable, visible descendants of `container` in DOM order (shared with MPopover). */\nexport function getFocusable(container: HTMLElement): HTMLElement[] {\n    return Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE)).filter(\n        (element) =>\n            !element.closest('[inert]') &&\n            (typeof element.checkVisibility === 'function' ? element.checkVisibility() : true)\n    )\n}\n\n/** Like `getFocusable`, minus elements taken out of the Tab order (`tabindex=\"-1\"`, e.g. roving items). */\nexport function getTabbable(container: HTMLElement): HTMLElement[] {\n    return getFocusable(container).filter((element) => element.tabIndex >= 0)\n}\n\nexport interface UseModalLayerOptions {\n    /** True while the overlay is mounted and open (not while it animates out). */\n    active: boolean\n    /** Element wrapping the whole overlay; the dialog is the `[role=\"dialog\"]` inside it. */\n    containerRef: RefObject<HTMLElement | null>\n    /** Called on Escape when this is the top layer. Omit to ignore Escape. */\n    onEscape?: () => void\n}\n\nexport function useModalLayer({active, containerRef, onEscape}: UseModalLayerOptions): void {\n    const onEscapeRef = useRef(onEscape)\n    useEffect(() => {\n        onEscapeRef.current = onEscape\n    }, [onEscape])\n\n    useEffect(() => {\n        if (!active || typeof document === 'undefined') return\n\n        const token = {}\n        layers.push(token)\n        const isTop = () => layers[layers.length - 1] === token\n\n        const opener = document.activeElement instanceof HTMLElement ? document.activeElement : null\n        const container = containerRef.current\n        const dialog = container?.querySelector<HTMLElement>('[role=\"dialog\"]') ?? container\n\n        if (dialog && !dialog.contains(document.activeElement)) {\n            if (!dialog.hasAttribute('tabindex')) dialog.setAttribute('tabindex', '-1')\n            const preferred = dialog.querySelector<HTMLElement>('[autofocus], [data-autofocus]')\n            ;(preferred ?? dialog).focus({preventScroll: true})\n        }\n\n        const handleKeyDown = (event: KeyboardEvent) => {\n            if (!isTop() || event.defaultPrevented) return\n\n            if (event.key === 'Escape') {\n                // An open select/menu inside the dialog closes first.\n                if (hasOpenPopovers() || !onEscapeRef.current) return\n                onEscapeRef.current()\n                return\n            }\n\n            if (event.key !== 'Tab' || !dialog) return\n\n            const activeElement = document.activeElement as HTMLElement | null\n            // Popovers portal outside the dialog; leave their own Tab handling alone.\n            if (activeElement && !dialog.contains(activeElement) && activeElement.closest('.popover')) return\n\n            const focusable = getFocusable(dialog)\n            if (focusable.length === 0) {\n                event.preventDefault()\n                dialog.focus({preventScroll: true})\n                return\n            }\n\n            const first = focusable[0]\n            const last = focusable[focusable.length - 1]\n            const outside = !activeElement || !dialog.contains(activeElement) || activeElement === dialog\n\n            if (event.shiftKey && (outside || activeElement === first)) {\n                event.preventDefault()\n                last.focus()\n            } else if (!event.shiftKey && (outside || activeElement === last)) {\n                event.preventDefault()\n                first.focus()\n            }\n        }\n\n        document.addEventListener('keydown', handleKeyDown)\n\n        return () => {\n            document.removeEventListener('keydown', handleKeyDown)\n            const index = layers.indexOf(token)\n            if (index !== -1) layers.splice(index, 1)\n            if (opener && opener.isConnected) opener.focus({preventScroll: true})\n        }\n    }, [active, containerRef])\n}\n"],"mappings":"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"}

package/dist/utils/calendarDates.d.ts

@@ -12,6 +12,11 @@ export declare function isValidDate(value: Date): boolean;
 export declare function parseHmToMinutes(value?: string): number | null;
 export declare function startOfDay(date: Date): Date;
 export declare function stripTime(date: Date): Date;
+/**
+ * Calendar day of `value` at local midnight. A date-only string (`yyyy-MM-dd`) is read as a
+ * local day — `new Date('2026-09-24')` would read it as UTC midnight, which is the previous
+ * day in every UTC−x zone.
+ */
 export declare function normalizeDate(value?: Date | string | null): Date | null;
 /** Adds calendar days (DST-safe, keeps the wall-clock time). */
 export declare function addDays(date: Date, amount: number): Date;

package/dist/utils/radioGroupKeys.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Arrow-key target for an APG radio group (roving tabindex, selection follows focus).
+ * ArrowRight / ArrowDown move forward, ArrowLeft / ArrowUp move back, both wrap; Home / End jump
+ * to the ends. In right-to-left layouts ArrowLeft / ArrowRight are flipped. Returns `null` for
+ * keys the group does not handle. Internal helper, not re-exported.
+ */
+export declare function getRadioGroupTarget(key: string, index: number, count: number, rtl?: boolean): number | null;
+/** True when the element is laid out right-to-left. */
+export declare function isRtlElement(element: Element | null): boolean;

package/dist/utils/useDateGridNav.d.ts

@@ -0,0 +1,39 @@
+import { KeyboardEvent } from 'react';
+import { CalendarWeekStart } from './calendarDates';
+/**
+ * Internal (not re-exported from the package root): WAI-ARIA APG date-grid keyboard model shared
+ * by MDatePicker and MDateRangePicker.
+ *
+ * One roving tab stop across every visible month; arrows move by day / week, PageUp / PageDown by
+ * month (Shift: year), Home / End to the edges of the week, Enter / Space select. Moving past the
+ * visible months scrolls the view. Unavailable days stay focusable (`aria-disabled`) so the
+ * arrows never get stuck, but they are never selected.
+ */
+export interface UseDateGridNavOptions {
+    /** First visible month (any day inside it). */
+    viewMonth: Date;
+    /** Number of months rendered side by side. Defaults to 1. */
+    monthsShown?: number;
+    onViewMonthChange: (month: Date) => void;
+    selectedDate: Date | null;
+    weekStartsOn: CalendarWeekStart;
+    onSelect: (date: Date) => void;
+    isDisabled: (date: Date) => boolean;
+    /** Called whenever the keyboard moves the focused day (e.g. a range preview). */
+    onFocusDate?: (date: Date) => void;
+}
+export interface DateGridCellProps {
+    'data-date': string;
+    tabIndex: number;
+    ref: (el: HTMLElement | null) => void;
+    onFocus: () => void;
+}
+export declare function getDateGridTarget(key: string, current: Date, shiftKey: boolean, weekStartsOn: CalendarWeekStart): Date | null;
+export declare function useDateGridNav({ viewMonth, monthsShown, onViewMonthChange, selectedDate, weekStartsOn, onSelect, isDisabled, onFocusDate, }: UseDateGridNavOptions): {
+    tabStop: Date;
+    containerRef: import('react').RefObject<HTMLElement | null>;
+    tabStopRef: import('react').RefObject<HTMLElement | null>;
+    getCellProps: (date: Date) => DateGridCellProps;
+    onGridKeyDown: (event: KeyboardEvent) => void;
+    focusTabStop: () => void;
+};