@thewaver/ss-components 0.0.1 → 0.0.2

package/dist/Abstracts/ElementObserver/ElementObserver.js

@@ -0,0 +1,130 @@
+import { useViewportContext } from "../../Exotics/Viewport/Viewport.context.js";
+import { ViewportUtils } from "../../Exotics/Viewport/Viewport.utils.js";
+import { createEffect, createMemo, createSignal, onCleanup, onMount } from "solid-js";
+import { Bounds, Size2d } from "@thewaver/ss-utils";
+//#region src/Abstracts/ElementObserver/ElementObserver.ts
+var EMPTY_SIZES = [];
+var isSameSizeList = (a, b) => a.length === b.length && a.every((size, index) => Size2d.isSame(size, b[index]));
+var ElementObserver;
+(function(_ElementObserver) {
+	const createBorderBoxSizeObserver = _ElementObserver.createBorderBoxSizeObserver = (getRef, getIsEnabled) => {
+		const [getSize, setSize] = createSignal({
+			width: 0,
+			height: 0
+		}, { equals: Size2d.isSame });
+		createEffect(() => {
+			const ref = getRef();
+			if (!ref || getIsEnabled?.() === false) return;
+			setSize({
+				width: ref.offsetWidth,
+				height: ref.offsetHeight
+			});
+			const observer = new ResizeObserver(([entry]) => {
+				setSize({
+					width: entry.borderBoxSize[0].inlineSize,
+					height: entry.borderBoxSize[0].blockSize
+				});
+			});
+			observer.observe(ref);
+			onCleanup(() => {
+				observer.disconnect();
+			});
+		});
+		return getSize;
+	};
+	_ElementObserver.createBorderBoxSizeListObserver = (getRefs, getIsEnabled) => {
+		const [getSizes, setSizes] = createSignal(EMPTY_SIZES, { equals: isSameSizeList });
+		createEffect(() => {
+			const refs = getRefs();
+			if (getIsEnabled?.() === false) {
+				setSizes(EMPTY_SIZES);
+				return;
+			}
+			const measure = () => setSizes(refs.map((ref) => ({
+				width: ref?.offsetWidth ?? 0,
+				height: ref?.offsetHeight ?? 0
+			})));
+			measure();
+			const observer = new ResizeObserver(measure);
+			for (const ref of refs) if (ref) observer.observe(ref);
+			onCleanup(() => {
+				observer.disconnect();
+			});
+		});
+		return getSizes;
+	};
+	_ElementObserver.createBorderBoxHeightObserver = (getRef, getIsEnabled) => {
+		const getSize = createBorderBoxSizeObserver(getRef, getIsEnabled);
+		return createMemo(() => getSize().height);
+	};
+	_ElementObserver.createViewportIntersectionObserver = (getRef, getIsEnabled) => {
+		const [getIsIntersecting, setIsIntersecting] = createSignal(false);
+		createEffect(() => {
+			const ref = getRef();
+			setIsIntersecting(false);
+			if (!ref || getIsEnabled?.() === false) return;
+			const observer = new IntersectionObserver(([entry]) => {
+				setIsIntersecting(entry.isIntersecting);
+			});
+			observer.observe(ref);
+			onCleanup(() => {
+				observer.disconnect();
+			});
+		});
+		return getIsIntersecting;
+	};
+	_ElementObserver.createViewportRectObserver = (getRef, getIsVisible, opts) => {
+		const viewportContext = useViewportContext();
+		const updateSize = () => {
+			const ref = getRef();
+			if (!ref) return;
+			const elementRect = ViewportUtils.getAdjustedBoundingClientRect(ref, viewportContext);
+			const offset = opts.getOffset?.() ?? {
+				x: 0,
+				y: 0
+			};
+			const padding = opts.getPadding?.() ?? 0;
+			const spreadPadding = typeof padding === "number" ? Bounds.spread(padding) : padding;
+			opts.setElementRect({
+				x: elementRect.x - spreadPadding.left - offset.x,
+				y: elementRect.y - spreadPadding.top - offset.y,
+				width: elementRect.width + spreadPadding.left + spreadPadding.right,
+				height: elementRect.height + spreadPadding.top + spreadPadding.bottom
+			});
+		};
+		onMount(() => {
+			updateSize();
+		});
+		createEffect(() => {
+			onCleanup(() => {
+				document.removeEventListener("scroll", updateSize, true);
+				window.removeEventListener("resize", updateSize);
+			});
+			if (!getIsVisible()) return;
+			document.addEventListener("scroll", updateSize, {
+				capture: true,
+				passive: true
+			});
+			window.addEventListener("resize", updateSize);
+		});
+		createEffect(() => {
+			let frameId;
+			let isCancelled = false;
+			onCleanup(() => {
+				isCancelled = true;
+				cancelAnimationFrame(frameId);
+			});
+			if (!getIsVisible()) return;
+			const tick = () => {
+				if (isCancelled) return;
+				updateSize();
+				frameId = requestAnimationFrame(tick);
+			};
+			frameId = requestAnimationFrame(tick);
+		});
+	};
+})(ElementObserver || (ElementObserver = {}));
+//#endregion
+export { ElementObserver };
+
+//# sourceMappingURL=ElementObserver.js.map

package/dist/Abstracts/ElementObserver/ElementObserver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementObserver.js","names":[],"sources":["../../../src/Abstracts/ElementObserver/ElementObserver.ts"],"sourcesContent":["import type { Accessor, Setter } from \"solid-js\";\r\nimport { createEffect, createMemo, createSignal, onCleanup, onMount } from \"solid-js\";\r\n\r\nimport { Bounds, type Point2d, type Rect, Size2d } from \"@thewaver/ss-utils\";\r\n\r\nimport { useViewportContext } from \"../../Exotics/Viewport/Viewport.context\";\r\nimport { ViewportUtils } from \"../../Exotics/Viewport/Viewport.utils\";\r\n\r\nconst EMPTY_SIZES: Size2d[] = [];\r\n\r\nconst isSameSizeList = (a: Size2d[], b: Size2d[]) =>\r\n    a.length === b.length && a.every((size, index) => Size2d.isSame(size, b[index]));\r\n\r\nexport namespace ElementObserver {\r\n    export const createBorderBoxSizeObserver = (\r\n        getRef: Accessor<HTMLElement | undefined>,\r\n        getIsEnabled?: Accessor<boolean>,\r\n    ) => {\r\n        const [getSize, setSize] = createSignal<Size2d>({ width: 0, height: 0 }, { equals: Size2d.isSame });\r\n\r\n        createEffect(() => {\r\n            const ref = getRef();\r\n\r\n            if (!ref || getIsEnabled?.() === false) return;\r\n\r\n            setSize({ width: ref.offsetWidth, height: ref.offsetHeight });\r\n\r\n            const observer = new ResizeObserver(([entry]) => {\r\n                setSize({\r\n                    width: entry.borderBoxSize[0].inlineSize,\r\n                    height: entry.borderBoxSize[0].blockSize,\r\n                });\r\n            });\r\n\r\n            observer.observe(ref);\r\n\r\n            onCleanup(() => {\r\n                observer.disconnect();\r\n            });\r\n        });\r\n\r\n        return getSize;\r\n    };\r\n\r\n    export const createBorderBoxSizeListObserver = (\r\n        getRefs: Accessor<Array<HTMLElement | undefined>>,\r\n        getIsEnabled?: Accessor<boolean>,\r\n    ) => {\r\n        const [getSizes, setSizes] = createSignal<Size2d[]>(EMPTY_SIZES, { equals: isSameSizeList });\r\n\r\n        createEffect(() => {\r\n            const refs = getRefs();\r\n\r\n            if (getIsEnabled?.() === false) {\r\n                setSizes(EMPTY_SIZES);\r\n\r\n                return;\r\n            }\r\n\r\n            const measure = () =>\r\n                setSizes(refs.map((ref) => ({ width: ref?.offsetWidth ?? 0, height: ref?.offsetHeight ?? 0 })));\r\n\r\n            measure();\r\n\r\n            const observer = new ResizeObserver(measure);\r\n\r\n            for (const ref of refs) {\r\n                if (ref) observer.observe(ref);\r\n            }\r\n\r\n            onCleanup(() => {\r\n                observer.disconnect();\r\n            });\r\n        });\r\n\r\n        return getSizes;\r\n    };\r\n\r\n    export const createBorderBoxHeightObserver = (\r\n        getRef: Accessor<HTMLElement | undefined>,\r\n        getIsEnabled?: Accessor<boolean>,\r\n    ) => {\r\n        const getSize = createBorderBoxSizeObserver(getRef, getIsEnabled);\r\n\r\n        return createMemo(() => getSize().height);\r\n    };\r\n\r\n    export const createViewportIntersectionObserver = (\r\n        getRef: Accessor<HTMLElement | undefined>,\r\n        getIsEnabled?: Accessor<boolean>,\r\n    ) => {\r\n        const [getIsIntersecting, setIsIntersecting] = createSignal(false);\r\n\r\n        createEffect(() => {\r\n            const ref = getRef();\r\n\r\n            setIsIntersecting(false);\r\n\r\n            if (!ref || getIsEnabled?.() === false) return;\r\n\r\n            const observer = new IntersectionObserver(([entry]) => {\r\n                setIsIntersecting(entry.isIntersecting);\r\n            });\r\n\r\n            observer.observe(ref);\r\n\r\n            onCleanup(() => {\r\n                observer.disconnect();\r\n            });\r\n        });\r\n\r\n        return getIsIntersecting;\r\n    };\r\n\r\n    export const createViewportRectObserver = <T extends HTMLElement>(\r\n        getRef: Accessor<T | undefined>,\r\n        getIsVisible: Accessor<boolean>,\r\n        opts: {\r\n            setElementRect: Setter<Rect | undefined>;\r\n            getPadding?: () => Bounds | number;\r\n            getOffset?: () => Point2d;\r\n        },\r\n    ) => {\r\n        const viewportContext = useViewportContext();\r\n\r\n        const updateSize = () => {\r\n            const ref = getRef();\r\n\r\n            if (!ref) return;\r\n\r\n            const elementRect = ViewportUtils.getAdjustedBoundingClientRect(ref, viewportContext);\r\n            const offset = opts.getOffset?.() ?? { x: 0, y: 0 };\r\n            const padding = opts.getPadding?.() ?? 0;\r\n            const spreadPadding = typeof padding === \"number\" ? Bounds.spread(padding) : padding;\r\n\r\n            opts.setElementRect({\r\n                x: elementRect.x - spreadPadding.left - offset.x,\r\n                y: elementRect.y - spreadPadding.top - offset.y,\r\n                width: elementRect.width + spreadPadding.left + spreadPadding.right,\r\n                height: elementRect.height + spreadPadding.top + spreadPadding.bottom,\r\n            });\r\n        };\r\n\r\n        onMount(() => {\r\n            updateSize();\r\n        });\r\n\r\n        createEffect(() => {\r\n            onCleanup(() => {\r\n                document.removeEventListener(\"scroll\", updateSize, true);\r\n                window.removeEventListener(\"resize\", updateSize);\r\n            });\r\n\r\n            if (!getIsVisible()) return;\r\n\r\n            document.addEventListener(\"scroll\", updateSize, { capture: true, passive: true });\r\n            window.addEventListener(\"resize\", updateSize);\r\n        });\r\n\r\n        createEffect(() => {\r\n            let frameId: ReturnType<typeof requestAnimationFrame>;\r\n            let isCancelled = false;\r\n\r\n            onCleanup(() => {\r\n                isCancelled = true;\r\n                cancelAnimationFrame(frameId);\r\n            });\r\n\r\n            if (!getIsVisible()) return;\r\n\r\n            const tick = () => {\r\n                if (isCancelled) return;\r\n\r\n                updateSize();\r\n\r\n                frameId = requestAnimationFrame(tick);\r\n            };\r\n\r\n            frameId = requestAnimationFrame(tick);\r\n        });\r\n    };\r\n}\r\n"],"mappings":"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"}

package/dist/Abstracts/Elevation/Elevation.js

@@ -0,0 +1,40 @@
+import { createEffect, createSignal, onCleanup } from "solid-js";
+//#region src/Abstracts/Elevation/Elevation.ts
+var NO_ELEVATION = 0;
+var entries = [];
+var [getRevision, setRevision] = createSignal(0);
+var bumpRevision = () => {
+	setRevision((previous) => previous + 1);
+};
+var Elevation;
+(function(_Elevation) {
+	_Elevation.createElevation = (getElement, getIsActive, getZIndex) => {
+		createEffect(() => {
+			const element = getElement();
+			const zIndex = getZIndex();
+			if (!getIsActive() || !element) return;
+			const entry = {
+				element,
+				zIndex
+			};
+			entries.push(entry);
+			bumpRevision();
+			onCleanup(() => {
+				const index = entries.indexOf(entry);
+				if (index >= 0) entries.splice(index, 1);
+				bumpRevision();
+			});
+		});
+	};
+	_Elevation.getBase = (element) => {
+		getRevision();
+		if (!element) return NO_ELEVATION;
+		let base = NO_ELEVATION;
+		for (const entry of entries) if (entry.element.contains(element)) base = Math.max(base, entry.zIndex);
+		return base;
+	};
+})(Elevation || (Elevation = {}));
+//#endregion
+export { Elevation };
+
+//# sourceMappingURL=Elevation.js.map

package/dist/Abstracts/Elevation/Elevation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Elevation.js","names":[],"sources":["../../../src/Abstracts/Elevation/Elevation.ts"],"sourcesContent":["import { type Accessor, createEffect, createSignal, onCleanup } from \"solid-js\";\n\ntype ElevationEntry = {\n    element: HTMLElement;\n    zIndex: number;\n};\n\nconst NO_ELEVATION = 0;\n\nconst entries: ElevationEntry[] = [];\n\nconst [getRevision, setRevision] = createSignal(0);\n\nconst bumpRevision = () => {\n    setRevision((previous) => previous + 1);\n};\n\nexport namespace Elevation {\n    export const createElevation = (\n        getElement: Accessor<HTMLElement | undefined>,\n        getIsActive: Accessor<boolean>,\n        getZIndex: Accessor<number>,\n    ) => {\n        createEffect(() => {\n            const element = getElement();\n            const zIndex = getZIndex();\n\n            if (!getIsActive() || !element) return;\n\n            const entry: ElevationEntry = { element, zIndex };\n\n            entries.push(entry);\n            bumpRevision();\n\n            onCleanup(() => {\n                const index = entries.indexOf(entry);\n\n                if (index >= 0) entries.splice(index, 1);\n\n                bumpRevision();\n            });\n        });\n    };\n\n    export const getBase = (element: HTMLElement | undefined) => {\n        getRevision();\n\n        if (!element) return NO_ELEVATION;\n\n        let base = NO_ELEVATION;\n\n        for (const entry of entries) {\n            if (entry.element.contains(element)) base = Math.max(base, entry.zIndex);\n        }\n\n        return base;\n    };\n}\n"],"mappings":";;AAOA,IAAM,eAAe;AAErB,IAAM,UAA4B,CAAC;AAEnC,IAAM,CAAC,aAAa,eAAe,aAAa,CAAC;AAEjD,IAAM,qBAAqB;CACvB,aAAa,aAAa,WAAW,CAAC;AAC1C;AAEO,IAAU;CAAV,SAAA,YAAA;CACU,WAAA,mBACT,YACA,aACA,cACC;EACD,mBAAmB;GACf,MAAM,UAAU,WAAW;GAC3B,MAAM,SAAS,UAAU;GAEzB,IAAI,CAAC,YAAY,KAAK,CAAC,SAAS;GAEhC,MAAM,QAAwB;IAAE;IAAS;GAAO;GAEhD,QAAQ,KAAK,KAAK;GAClB,aAAa;GAEb,gBAAgB;IACZ,MAAM,QAAQ,QAAQ,QAAQ,KAAK;IAEnC,IAAI,SAAS,GAAG,QAAQ,OAAO,OAAO,CAAC;IAEvC,aAAa;GACjB,CAAC;EACL,CAAC;CACL;CAEa,WAAA,WAAW,YAAqC;EACzD,YAAY;EAEZ,IAAI,CAAC,SAAS,OAAO;EAErB,IAAI,OAAO;EAEX,KAAK,MAAM,SAAS,SAChB,IAAI,MAAM,QAAQ,SAAS,OAAO,GAAG,OAAO,KAAK,IAAI,MAAM,MAAM,MAAM;EAG3E,OAAO;CACX;AACH,EAAA,CAAA,cAAA,YAAA,CAAA,EAAD"}

package/dist/Abstracts/Flattener/Flattener.utils.js

@@ -0,0 +1,37 @@
+//#region src/Abstracts/Flattener/Flattener.utils.ts
+var EMPTY_ROWS = [];
+var EMPTY_NODES = [];
+var FlattenerUtils;
+(function(_FlattenerUtils) {
+	const getIsBranch = _FlattenerUtils.getIsBranch = (node, defs) => defs.computeIsBranch?.(node) ?? (defs.computeChildren(node)?.length ?? 0) > 0;
+	_FlattenerUtils.getRows = (nodes, defs) => {
+		let index = 0;
+		let entryOffset = 0;
+		const build = (siblings, depth, parentIndex) => siblings.map((node, position) => {
+			const isExpanded = getIsBranch(node, defs) && (defs.computeIsExpanded?.(node) ?? true);
+			const isEntry = defs.computeIsEntry?.(node) ?? true;
+			const rowIndex = index++;
+			const rowEntryOffset = entryOffset;
+			if (isEntry) entryOffset++;
+			return {
+				node,
+				index: rowIndex,
+				parentIndex,
+				depth,
+				position,
+				setSize: siblings.length,
+				isExpanded,
+				isEntry,
+				entryOffset: rowEntryOffset,
+				rows: isExpanded ? build(defs.computeChildren(node) ?? EMPTY_NODES, depth + 1, rowIndex) : EMPTY_ROWS
+			};
+		});
+		return build(nodes, 0, void 0);
+	};
+	const getFlatRows = _FlattenerUtils.getFlatRows = (rows) => rows.flatMap((row) => [row, ...getFlatRows(row.rows)]);
+	_FlattenerUtils.getEntryRowIndex = (rows, entryIndex) => rows.findIndex((row) => row.isEntry && row.entryOffset === entryIndex);
+})(FlattenerUtils || (FlattenerUtils = {}));
+//#endregion
+export { FlattenerUtils };
+
+//# sourceMappingURL=Flattener.utils.js.map

package/dist/Abstracts/Flattener/Flattener.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Flattener.utils.js","names":[],"sources":["../../../src/Abstracts/Flattener/Flattener.utils.ts"],"sourcesContent":["import type { FlatRow, FlattenerDefs } from \"./Flattener.types\";\n\nconst EMPTY_ROWS: never[] = [];\nconst EMPTY_NODES: never[] = [];\n\nexport namespace FlattenerUtils {\n    export const getIsBranch = <T>(node: T, defs: FlattenerDefs<T>) =>\n        defs.computeIsBranch?.(node) ?? (defs.computeChildren(node)?.length ?? 0) > 0;\n\n    export const getRows = <T>(nodes: T[], defs: FlattenerDefs<T>): FlatRow<T>[] => {\n        let index = 0;\n        let entryOffset = 0;\n\n        const build = (siblings: T[], depth: number, parentIndex: number | undefined): FlatRow<T>[] =>\n            siblings.map((node, position) => {\n                const isExpanded = getIsBranch(node, defs) && (defs.computeIsExpanded?.(node) ?? true);\n                const isEntry = defs.computeIsEntry?.(node) ?? true;\n                const rowIndex = index++;\n                const rowEntryOffset = entryOffset;\n\n                if (isEntry) entryOffset++;\n\n                return {\n                    node,\n                    index: rowIndex,\n                    parentIndex,\n                    depth,\n                    position,\n                    setSize: siblings.length,\n                    isExpanded,\n                    isEntry,\n                    entryOffset: rowEntryOffset,\n                    rows: isExpanded\n                        ? build(defs.computeChildren(node) ?? EMPTY_NODES, depth + 1, rowIndex)\n                        : EMPTY_ROWS,\n                };\n            });\n\n        return build(nodes, 0, undefined);\n    };\n\n    export const getFlatRows = <T>(rows: FlatRow<T>[]): FlatRow<T>[] =>\n        rows.flatMap((row) => [row, ...getFlatRows(row.rows)]);\n\n    export const getEntryRowIndex = <T>(rows: FlatRow<T>[], entryIndex: number) =>\n        rows.findIndex((row) => row.isEntry && row.entryOffset === entryIndex);\n}\n"],"mappings":";AAEA,IAAM,aAAsB,CAAC;AAC7B,IAAM,cAAuB,CAAC;AAEvB,IAAU;CAAV,SAAA,iBAAA;CACI,MAAM,cAAA,gBAAA,eAAkB,MAAS,SACpC,KAAK,kBAAkB,IAAI,MAAM,KAAK,gBAAgB,IAAI,CAAC,EAAE,UAAU,KAAK;CAEnE,gBAAA,WAAc,OAAY,SAAyC;EAC5E,IAAI,QAAQ;EACZ,IAAI,cAAc;EAElB,MAAM,SAAS,UAAe,OAAe,gBACzC,SAAS,KAAK,MAAM,aAAa;GAC7B,MAAM,aAAa,YAAY,MAAM,IAAI,MAAM,KAAK,oBAAoB,IAAI,KAAK;GACjF,MAAM,UAAU,KAAK,iBAAiB,IAAI,KAAK;GAC/C,MAAM,WAAW;GACjB,MAAM,iBAAiB;GAEvB,IAAI,SAAS;GAEb,OAAO;IACH;IACA,OAAO;IACP;IACA;IACA;IACA,SAAS,SAAS;IAClB;IACA;IACA,aAAa;IACb,MAAM,aACA,MAAM,KAAK,gBAAgB,IAAI,KAAK,aAAa,QAAQ,GAAG,QAAQ,IACpE;GACV;EACJ,CAAC;EAEL,OAAO,MAAM,OAAO,GAAG,KAAA,CAAS;CACpC;CAEO,MAAM,cAAA,gBAAA,eAAkB,SAC3B,KAAK,SAAS,QAAQ,CAAC,KAAK,GAAG,YAAY,IAAI,IAAI,CAAC,CAAC;CAE5C,gBAAA,oBAAuB,MAAoB,eACpD,KAAK,WAAW,QAAQ,IAAI,WAAW,IAAI,gBAAgB,UAAU;AAC5E,EAAA,CAAA,mBAAA,iBAAA,CAAA,EAAD"}

package/dist/Abstracts/FocusManager/FocusManager.js

@@ -0,0 +1,76 @@
+import { createEffect, onCleanup, untrack } from "solid-js";
+//#region src/Abstracts/FocusManager/FocusManager.ts
+var FOCUSABLE_SELECTOR = [
+	"a[href]",
+	"area[href]",
+	"button:not([disabled])",
+	"input:not([disabled])",
+	"select:not([disabled])",
+	"textarea:not([disabled])",
+	"audio[controls]",
+	"video[controls]",
+	"details > summary:first-of-type",
+	"iframe",
+	"object",
+	"embed",
+	"[contenteditable]:not([contenteditable='false'])",
+	"[tabindex]:not([tabindex='-1'])"
+].join(",");
+var isReachable = (element) => {
+	if (element.getAttribute("tabindex") === "-1") return false;
+	if (element.closest("[inert]")) return false;
+	if (element.closest("[aria-hidden='true']")) return false;
+	if (element.offsetParent === null && element.getClientRects().length === 0) return false;
+	return getComputedStyle(element).visibility !== "hidden";
+};
+var restoreDepth = 0;
+var FocusManager;
+(function(_FocusManager) {
+	_FocusManager.getIsRestoringFocus = () => restoreDepth > 0;
+	const runFocusRestore = _FocusManager.runFocusRestore = (restore) => {
+		restoreDepth++;
+		try {
+			restore();
+		} finally {
+			setTimeout(() => {
+				restoreDepth--;
+			}, 0);
+		}
+	};
+	const getFocusableChildren = _FocusManager.getFocusableChildren = (root) => Array.from((root ?? document.body).querySelectorAll(FOCUSABLE_SELECTOR)).filter(isReachable);
+	const getFirstFocusableChild = _FocusManager.getFirstFocusableChild = (root) => getFocusableChildren(root)[0] ?? null;
+	_FocusManager.getLastFocusableChild = (root) => {
+		return getFocusableChildren(root).at(-1) ?? null;
+	};
+	_FocusManager.focusTrapKeyDown = (e, ref) => {
+		if (e.key !== "Tab") return;
+		const children = FocusManager.getFocusableChildren(ref);
+		const first = children[0];
+		const last = children.at(-1);
+		if (!first || !last) return;
+		if (e.shiftKey && document.activeElement === first) {
+			e.preventDefault();
+			last.focus();
+		} else if (!e.shiftKey && document.activeElement === last) {
+			e.preventDefault();
+			first.focus();
+		}
+	};
+	_FocusManager.autoFocus = (getRef, getIsVisible, opts) => createEffect(() => {
+		const ref = getRef();
+		const isVisible = getIsVisible();
+		if (!ref || !isVisible) return;
+		const previouslyFocused = document.activeElement ?? void 0;
+		(untrack(() => opts?.getInitialRef?.()) ?? getFirstFocusableChild(ref))?.focus({ preventScroll: true });
+		onCleanup(() => {
+			if (!previouslyFocused?.isConnected) return;
+			runFocusRestore(() => {
+				previouslyFocused.focus();
+			});
+		});
+	});
+})(FocusManager || (FocusManager = {}));
+//#endregion
+export { FocusManager };
+
+//# sourceMappingURL=FocusManager.js.map

package/dist/Abstracts/FocusManager/FocusManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusManager.js","names":[],"sources":["../../../src/Abstracts/FocusManager/FocusManager.ts"],"sourcesContent":["import { createEffect, onCleanup, untrack } from \"solid-js\";\n\nconst FOCUSABLE_SELECTOR = [\n    \"a[href]\",\n    \"area[href]\",\n    \"button:not([disabled])\",\n    \"input:not([disabled])\",\n    \"select:not([disabled])\",\n    \"textarea:not([disabled])\",\n    \"audio[controls]\",\n    \"video[controls]\",\n    \"details > summary:first-of-type\",\n    \"iframe\",\n    \"object\",\n    \"embed\",\n    \"[contenteditable]:not([contenteditable='false'])\",\n    \"[tabindex]:not([tabindex='-1'])\",\n].join(\",\");\n\nconst isReachable = (element: HTMLElement) => {\n    if (element.getAttribute(\"tabindex\") === \"-1\") return false;\n    if (element.closest(\"[inert]\")) return false;\n    if (element.closest(\"[aria-hidden='true']\")) return false;\n    if (element.offsetParent === null && element.getClientRects().length === 0) return false;\n\n    return getComputedStyle(element).visibility !== \"hidden\";\n};\n\nlet restoreDepth = 0;\n\nexport namespace FocusManager {\n    export const getIsRestoringFocus = () => restoreDepth > 0;\n\n    export const runFocusRestore = (restore: () => void) => {\n        restoreDepth++;\n\n        try {\n            restore();\n        } finally {\n            setTimeout(() => {\n                restoreDepth--;\n            }, 0);\n        }\n    };\n\n    export const getFocusableChildren = (root?: HTMLElement): HTMLElement[] =>\n        Array.from((root ?? document.body).querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter(isReachable);\n\n    export const getFirstFocusableChild = (root?: HTMLElement): HTMLElement | null =>\n        getFocusableChildren(root)[0] ?? null;\n\n    export const getLastFocusableChild = (root?: HTMLElement): HTMLElement | null => {\n        const focusableChildren = getFocusableChildren(root);\n\n        return focusableChildren.at(-1) ?? null;\n    };\n\n    export const focusTrapKeyDown = (\n        e: KeyboardEvent & {\n            currentTarget: HTMLDivElement;\n            target: Element;\n        },\n        ref: HTMLElement | undefined,\n    ) => {\n        if (e.key !== \"Tab\") return;\n\n        const children = FocusManager.getFocusableChildren(ref);\n        const first = children[0];\n        const last = children.at(-1);\n\n        if (!first || !last) return;\n\n        if (e.shiftKey && document.activeElement === first) {\n            e.preventDefault();\n            last.focus();\n        } else if (!e.shiftKey && document.activeElement === last) {\n            e.preventDefault();\n            first.focus();\n        }\n    };\n\n    export const autoFocus = (\n        getRef: () => HTMLElement | undefined,\n        getIsVisible: () => boolean,\n        opts?: { getInitialRef?: () => HTMLElement | undefined },\n    ) =>\n        createEffect(() => {\n            const ref = getRef();\n            const isVisible = getIsVisible();\n\n            if (!ref || !isVisible) return;\n\n            const previouslyFocused = (document.activeElement as HTMLElement | null) ?? undefined;\n            const initialRef = untrack(() => opts?.getInitialRef?.());\n\n            (initialRef ?? getFirstFocusableChild(ref))?.focus({ preventScroll: true });\n\n            onCleanup(() => {\n                if (!previouslyFocused?.isConnected) return;\n\n                runFocusRestore(() => {\n                    previouslyFocused.focus();\n                });\n            });\n        });\n}\n"],"mappings":";;AAEA,IAAM,qBAAqB;CACvB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ,CAAC,CAAC,KAAK,GAAG;AAEV,IAAM,eAAe,YAAyB;CAC1C,IAAI,QAAQ,aAAa,UAAU,MAAM,MAAM,OAAO;CACtD,IAAI,QAAQ,QAAQ,SAAS,GAAG,OAAO;CACvC,IAAI,QAAQ,QAAQ,sBAAsB,GAAG,OAAO;CACpD,IAAI,QAAQ,iBAAiB,QAAQ,QAAQ,eAAe,CAAC,CAAC,WAAW,GAAG,OAAO;CAEnF,OAAO,iBAAiB,OAAO,CAAC,CAAC,eAAe;AACpD;AAEA,IAAI,eAAe;AAEZ,IAAU;CAAV,SAAA,eAAA;CACU,cAAA,4BAA4B,eAAe;CAEjD,MAAM,kBAAA,cAAA,mBAAmB,YAAwB;EACpD;EAEA,IAAI;GACA,QAAQ;EACZ,UAAU;GACN,iBAAiB;IACb;GACJ,GAAG,CAAC;EACR;CACJ;CAEO,MAAM,uBAAA,cAAA,wBAAwB,SACjC,MAAM,MAAM,QAAQ,SAAS,KAAA,CAAM,iBAA8B,kBAAkB,CAAC,CAAC,CAAC,OAAO,WAAW;CAErG,MAAM,yBAAA,cAAA,0BAA0B,SACnC,qBAAqB,IAAI,CAAC,CAAC,MAAM;CAExB,cAAA,yBAAyB,SAA2C;EAG7E,OAF0B,qBAAqB,IAExC,CAAA,CAAkB,GAAG,EAAE,KAAK;CACvC;CAEa,cAAA,oBACT,GAIA,QACC;EACD,IAAI,EAAE,QAAQ,OAAO;EAErB,MAAM,WAAW,aAAa,qBAAqB,GAAG;EACtD,MAAM,QAAQ,SAAS;EACvB,MAAM,OAAO,SAAS,GAAG,EAAE;EAE3B,IAAI,CAAC,SAAS,CAAC,MAAM;EAErB,IAAI,EAAE,YAAY,SAAS,kBAAkB,OAAO;GAChD,EAAE,eAAe;GACjB,KAAK,MAAM;EACf,OAAO,IAAI,CAAC,EAAE,YAAY,SAAS,kBAAkB,MAAM;GACvD,EAAE,eAAe;GACjB,MAAM,MAAM;EAChB;CACJ;CAEa,cAAA,aACT,QACA,cACA,SAEA,mBAAmB;EACf,MAAM,MAAM,OAAO;EACnB,MAAM,YAAY,aAAa;EAE/B,IAAI,CAAC,OAAO,CAAC,WAAW;EAExB,MAAM,oBAAqB,SAAS,iBAAwC,KAAA;EAG5E,CAFmB,cAAc,MAAM,gBAAgB,CAEtD,KAAc,uBAAuB,GAAG,EAAA,EAAI,MAAM,EAAE,eAAe,KAAK,CAAC;EAE1E,gBAAgB;GACZ,IAAI,CAAC,mBAAmB,aAAa;GAErC,sBAAsB;IAClB,kBAAkB,MAAM;GAC5B,CAAC;EACL,CAAC;CACL,CAAC;AACR,EAAA,CAAA,iBAAA,eAAA,CAAA,EAAD"}

package/dist/Abstracts/FrameRateMonitor/FrameRateMonitor.js

@@ -0,0 +1,67 @@
+import { createEffect, createSignal, onCleanup, onMount } from "solid-js";
+//#region src/Abstracts/FrameRateMonitor/FrameRateMonitor.ts
+var SAMPLE_INTERVAL_MS = 1e3;
+var FrameRateMonitor;
+(function(_FrameRateMonitor) {
+	_FrameRateMonitor.create = (getIsDisabled, opts) => {
+		const [getFrameRate, setFrameRate] = createSignal({
+			current: 0,
+			average: 0
+		});
+		const [getIsWindowVisible, setIsWindowVisible] = createSignal(true);
+		createEffect(() => {
+			let cycleFrameCount = 0;
+			let totalFrameCount = 0;
+			let lastTime;
+			let firstTime;
+			let rafId;
+			let timeoutHandle;
+			onCleanup(() => {
+				clearTimeout(timeoutHandle);
+				cancelAnimationFrame(rafId);
+				setFrameRate({
+					current: 0,
+					average: 0
+				});
+			});
+			const isVisible = getIsWindowVisible();
+			const isDisabled = getIsDisabled();
+			if (!isVisible || isDisabled) return;
+			const updateFrameRate = () => {
+				const now = performance.now();
+				cycleFrameCount++;
+				totalFrameCount++;
+				if (now - lastTime >= SAMPLE_INTERVAL_MS) {
+					const current = cycleFrameCount * SAMPLE_INTERVAL_MS / (now - lastTime);
+					const average = totalFrameCount * SAMPLE_INTERVAL_MS / (now - firstTime);
+					cycleFrameCount = 0;
+					lastTime = now;
+					setFrameRate({
+						current,
+						average
+					});
+				}
+				rafId = requestAnimationFrame(updateFrameRate);
+			};
+			timeoutHandle = setTimeout(() => {
+				lastTime = performance.now();
+				firstTime = lastTime;
+				rafId = requestAnimationFrame(updateFrameRate);
+			}, opts?.startupTimeMs ?? 0);
+		});
+		onMount(() => {
+			const handleVisibilityChange = () => {
+				setIsWindowVisible(document.visibilityState === "visible");
+			};
+			document.addEventListener("visibilitychange", handleVisibilityChange);
+			onCleanup(() => {
+				document.removeEventListener("visibilitychange", handleVisibilityChange);
+			});
+		});
+		return { getFrameRate };
+	};
+})(FrameRateMonitor || (FrameRateMonitor = {}));
+//#endregion
+export { FrameRateMonitor };
+
+//# sourceMappingURL=FrameRateMonitor.js.map

package/dist/Abstracts/FrameRateMonitor/FrameRateMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrameRateMonitor.js","names":[],"sources":["../../../src/Abstracts/FrameRateMonitor/FrameRateMonitor.ts"],"sourcesContent":["import { type Accessor, createEffect, createSignal, onCleanup, onMount } from \"solid-js\";\n\nconst SAMPLE_INTERVAL_MS = 1000;\n\nexport namespace FrameRateMonitor {\n    export const create = (\n        getIsDisabled: Accessor<boolean>,\n        opts?: {\n            startupTimeMs?: number;\n        },\n    ) => {\n        const [getFrameRate, setFrameRate] = createSignal({ current: 0, average: 0 });\n        const [getIsWindowVisible, setIsWindowVisible] = createSignal(true);\n\n        createEffect(() => {\n            let cycleFrameCount = 0;\n            let totalFrameCount = 0;\n            let lastTime: number;\n            let firstTime: number;\n            let rafId: ReturnType<typeof requestAnimationFrame>;\n            let timeoutHandle: ReturnType<typeof setTimeout>;\n\n            onCleanup(() => {\n                clearTimeout(timeoutHandle);\n                cancelAnimationFrame(rafId);\n                setFrameRate({ current: 0, average: 0 });\n            });\n\n            const isVisible = getIsWindowVisible();\n            const isDisabled = getIsDisabled();\n\n            if (!isVisible || isDisabled) return;\n\n            const updateFrameRate = () => {\n                const now = performance.now();\n\n                cycleFrameCount++;\n                totalFrameCount++;\n\n                if (now - lastTime >= SAMPLE_INTERVAL_MS) {\n                    const current = (cycleFrameCount * SAMPLE_INTERVAL_MS) / (now - lastTime);\n                    const average = (totalFrameCount * SAMPLE_INTERVAL_MS) / (now - firstTime);\n\n                    cycleFrameCount = 0;\n                    lastTime = now;\n\n                    setFrameRate({ current, average });\n                }\n\n                rafId = requestAnimationFrame(updateFrameRate);\n            };\n\n            timeoutHandle = setTimeout(() => {\n                lastTime = performance.now();\n                firstTime = lastTime;\n\n                rafId = requestAnimationFrame(updateFrameRate);\n            }, opts?.startupTimeMs ?? 0);\n        });\n\n        onMount(() => {\n            const handleVisibilityChange = () => {\n                setIsWindowVisible(document.visibilityState === \"visible\");\n            };\n\n            document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n            onCleanup(() => {\n                document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n            });\n        });\n\n        return { getFrameRate };\n    };\n}\n"],"mappings":";;AAEA,IAAM,qBAAqB;AAEpB,IAAU;CAAV,SAAA,mBAAA;CACU,kBAAA,UACT,eACA,SAGC;EACD,MAAM,CAAC,cAAc,gBAAgB,aAAa;GAAE,SAAS;GAAG,SAAS;EAAE,CAAC;EAC5E,MAAM,CAAC,oBAAoB,sBAAsB,aAAa,IAAI;EAElE,mBAAmB;GACf,IAAI,kBAAkB;GACtB,IAAI,kBAAkB;GACtB,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GAEJ,gBAAgB;IACZ,aAAa,aAAa;IAC1B,qBAAqB,KAAK;IAC1B,aAAa;KAAE,SAAS;KAAG,SAAS;IAAE,CAAC;GAC3C,CAAC;GAED,MAAM,YAAY,mBAAmB;GACrC,MAAM,aAAa,cAAc;GAEjC,IAAI,CAAC,aAAa,YAAY;GAE9B,MAAM,wBAAwB;IAC1B,MAAM,MAAM,YAAY,IAAI;IAE5B;IACA;IAEA,IAAI,MAAM,YAAY,oBAAoB;KACtC,MAAM,UAAW,kBAAkB,sBAAuB,MAAM;KAChE,MAAM,UAAW,kBAAkB,sBAAuB,MAAM;KAEhE,kBAAkB;KAClB,WAAW;KAEX,aAAa;MAAE;MAAS;KAAQ,CAAC;IACrC;IAEA,QAAQ,sBAAsB,eAAe;GACjD;GAEA,gBAAgB,iBAAiB;IAC7B,WAAW,YAAY,IAAI;IAC3B,YAAY;IAEZ,QAAQ,sBAAsB,eAAe;GACjD,GAAG,MAAM,iBAAiB,CAAC;EAC/B,CAAC;EAED,cAAc;GACV,MAAM,+BAA+B;IACjC,mBAAmB,SAAS,oBAAoB,SAAS;GAC7D;GAEA,SAAS,iBAAiB,oBAAoB,sBAAsB;GAEpE,gBAAgB;IACZ,SAAS,oBAAoB,oBAAoB,sBAAsB;GAC3E,CAAC;EACL,CAAC;EAED,OAAO,EAAE,aAAa;CAC1B;AACH,EAAA,CAAA,qBAAA,mBAAA,CAAA,EAAD"}