@sprawlify/primitives 0.0.1

package/dist/defineProperty-BoUOT9Ie.cjs

@@ -0,0 +1,49 @@
+
+//#region \0@oxc-project+runtime@0.101.0/helpers/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o$1) {
+		return typeof o$1;
+	} : function(o$1) {
+		return o$1 && "function" == typeof Symbol && o$1.constructor === Symbol && o$1 !== Symbol.prototype ? "symbol" : typeof o$1;
+	}, _typeof(o);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+
+//#endregion
+Object.defineProperty(exports, '_defineProperty', {
+  enumerable: true,
+  get: function () {
+    return _defineProperty;
+  }
+});

package/dist/defineProperty-DrXfyjd4.mjs

@@ -0,0 +1,43 @@
+//#region \0@oxc-project+runtime@0.101.0/helpers/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o$1) {
+		return typeof o$1;
+	} : function(o$1) {
+		return o$1 && "function" == typeof Symbol && o$1.constructor === Symbol && o$1 !== Symbol.prototype ? "symbol" : typeof o$1;
+	}, _typeof(o);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+
+//#endregion
+export { _defineProperty as t };

package/dist/dismissable-CTfKZ4OG.cjs

@@ -0,0 +1,282 @@
+const require_dom_query = require('./dom-query-CWZdWUGp.cjs');
+const require_utils = require('./utils-_6frwjgJ.cjs');
+const require_interact_outside = require('./interact-outside-C8-oFBpB.cjs');
+
+//#region src/shared/dismissable/escape-keydown.ts
+function trackEscapeKeydown(node, fn) {
+	const handleKeyDown = (event) => {
+		if (event.key !== "Escape") return;
+		if (event.isComposing) return;
+		fn?.(event);
+	};
+	return require_dom_query.addDomEvent(require_dom_query.getDocument(node), "keydown", handleKeyDown, { capture: true });
+}
+
+//#endregion
+//#region src/shared/dismissable/layer-stack.ts
+const LAYER_REQUEST_DISMISS_EVENT = "layer:request-dismiss";
+const layerStack = {
+	layers: [],
+	branches: [],
+	count() {
+		return this.layers.length;
+	},
+	pointerBlockingLayers() {
+		return this.layers.filter((layer) => layer.pointerBlocking);
+	},
+	topMostPointerBlockingLayer() {
+		return [...this.pointerBlockingLayers()].slice(-1)[0];
+	},
+	hasPointerBlockingLayer() {
+		return this.pointerBlockingLayers().length > 0;
+	},
+	isBelowPointerBlockingLayer(node) {
+		return this.indexOf(node) < (this.topMostPointerBlockingLayer() ? this.indexOf(this.topMostPointerBlockingLayer()?.node) : -1);
+	},
+	isTopMost(node) {
+		return this.layers[this.count() - 1]?.node === node;
+	},
+	getNestedLayers(node) {
+		return Array.from(this.layers).slice(this.indexOf(node) + 1);
+	},
+	getLayersByType(type) {
+		return this.layers.filter((layer) => layer.type === type);
+	},
+	getNestedLayersByType(node, type) {
+		const index = this.indexOf(node);
+		if (index === -1) return [];
+		return this.layers.slice(index + 1).filter((layer) => layer.type === type);
+	},
+	getParentLayerOfType(node, type) {
+		const index = this.indexOf(node);
+		if (index <= 0) return void 0;
+		return this.layers.slice(0, index).reverse().find((layer) => layer.type === type);
+	},
+	countNestedLayersOfType(node, type) {
+		return this.getNestedLayersByType(node, type).length;
+	},
+	isInNestedLayer(node, target) {
+		return this.getNestedLayers(node).some((layer) => require_dom_query.contains(layer.node, target));
+	},
+	isInBranch(target) {
+		return Array.from(this.branches).some((branch) => require_dom_query.contains(branch, target));
+	},
+	add(layer) {
+		this.layers.push(layer);
+		this.syncLayers();
+	},
+	addBranch(node) {
+		this.branches.push(node);
+	},
+	remove(node) {
+		const index = this.indexOf(node);
+		if (index < 0) return;
+		if (index < this.count() - 1) this.getNestedLayers(node).forEach((layer) => layerStack.dismiss(layer.node, node));
+		this.layers.splice(index, 1);
+		this.syncLayers();
+	},
+	removeBranch(node) {
+		const index = this.branches.indexOf(node);
+		if (index >= 0) this.branches.splice(index, 1);
+	},
+	syncLayers() {
+		this.layers.forEach((layer, index) => {
+			layer.node.style.setProperty("--layer-index", `${index}`);
+			layer.node.removeAttribute("data-nested");
+			layer.node.removeAttribute("data-has-nested");
+			if (this.getParentLayerOfType(layer.node, layer.type)) layer.node.setAttribute("data-nested", layer.type);
+			const nestedCount = this.countNestedLayersOfType(layer.node, layer.type);
+			if (nestedCount > 0) layer.node.setAttribute("data-has-nested", layer.type);
+			layer.node.style.setProperty("--nested-layer-count", `${nestedCount}`);
+		});
+	},
+	indexOf(node) {
+		return this.layers.findIndex((layer) => layer.node === node);
+	},
+	dismiss(node, parent) {
+		const index = this.indexOf(node);
+		if (index === -1) return;
+		const layer = this.layers[index];
+		addListenerOnce(node, LAYER_REQUEST_DISMISS_EVENT, (event) => {
+			layer.requestDismiss?.(event);
+			if (!event.defaultPrevented) layer?.dismiss();
+		});
+		fireCustomEvent(node, LAYER_REQUEST_DISMISS_EVENT, {
+			originalLayer: node,
+			targetLayer: parent,
+			originalIndex: index,
+			targetIndex: parent ? this.indexOf(parent) : -1
+		});
+		this.syncLayers();
+	},
+	clear() {
+		this.remove(this.layers[0].node);
+	}
+};
+function fireCustomEvent(el, type, detail) {
+	const event = new (el.ownerDocument.defaultView || window).CustomEvent(type, {
+		cancelable: true,
+		bubbles: true,
+		detail
+	});
+	return el.dispatchEvent(event);
+}
+function addListenerOnce(el, type, callback) {
+	el.addEventListener(type, callback, { once: true });
+}
+
+//#endregion
+//#region src/shared/dismissable/pointer-event-outside.ts
+let originalBodyPointerEvents;
+function assignPointerEventToLayers() {
+	layerStack.layers.forEach(({ node }) => {
+		node.style.pointerEvents = layerStack.isBelowPointerBlockingLayer(node) ? "none" : "auto";
+	});
+}
+function clearPointerEvent(node) {
+	node.style.pointerEvents = "";
+}
+function disablePointerEventsOutside(node, persistentElements) {
+	const doc = require_dom_query.getDocument(node);
+	const cleanups = [];
+	if (layerStack.hasPointerBlockingLayer() && !doc.body.hasAttribute("data-inert")) {
+		originalBodyPointerEvents = document.body.style.pointerEvents;
+		queueMicrotask(() => {
+			doc.body.style.pointerEvents = "none";
+			doc.body.setAttribute("data-inert", "");
+		});
+	}
+	persistentElements?.forEach((el) => {
+		const [promise, abort] = require_dom_query.waitForElement(() => {
+			const node$1 = el();
+			return require_dom_query.isHTMLElement(node$1) ? node$1 : null;
+		}, { timeout: 1e3 });
+		promise.then((el$1) => cleanups.push(require_dom_query.setStyle(el$1, { pointerEvents: "auto" })));
+		cleanups.push(abort);
+	});
+	return () => {
+		if (layerStack.hasPointerBlockingLayer()) return;
+		queueMicrotask(() => {
+			doc.body.style.pointerEvents = originalBodyPointerEvents;
+			doc.body.removeAttribute("data-inert");
+			if (doc.body.style.length === 0) doc.body.removeAttribute("style");
+		});
+		cleanups.forEach((fn) => fn());
+	};
+}
+
+//#endregion
+//#region src/shared/dismissable/dismissable-layer.ts
+function trackDismissableElementImpl(node, options) {
+	const { warnOnMissingNode = true } = options;
+	if (warnOnMissingNode && !node) {
+		require_utils.warn("[@sprawlify-js/dismissable] node is `null` or `undefined`");
+		return;
+	}
+	if (!node) return;
+	const { onDismiss, onRequestDismiss, pointerBlocking, exclude: excludeContainers, debug, type = "dialog" } = options;
+	const layer = {
+		dismiss: onDismiss,
+		node,
+		type,
+		pointerBlocking,
+		requestDismiss: onRequestDismiss
+	};
+	layerStack.add(layer);
+	assignPointerEventToLayers();
+	function onPointerDownOutside(event) {
+		const target = require_dom_query.getEventTarget(event.detail.originalEvent);
+		if (layerStack.isBelowPointerBlockingLayer(node) || layerStack.isInBranch(target)) return;
+		options.onPointerDownOutside?.(event);
+		options.onInteractOutside?.(event);
+		if (event.defaultPrevented) return;
+		if (debug) console.log("onPointerDownOutside:", event.detail.originalEvent);
+		onDismiss?.();
+	}
+	function onFocusOutside(event) {
+		const target = require_dom_query.getEventTarget(event.detail.originalEvent);
+		if (layerStack.isInBranch(target)) return;
+		options.onFocusOutside?.(event);
+		options.onInteractOutside?.(event);
+		if (event.defaultPrevented) return;
+		if (debug) console.log("onFocusOutside:", event.detail.originalEvent);
+		onDismiss?.();
+	}
+	function onEscapeKeyDown(event) {
+		if (!layerStack.isTopMost(node)) return;
+		options.onEscapeKeyDown?.(event);
+		if (!event.defaultPrevented && onDismiss) {
+			event.preventDefault();
+			onDismiss();
+		}
+	}
+	function exclude(target) {
+		if (!node) return false;
+		const containers = typeof excludeContainers === "function" ? excludeContainers() : excludeContainers;
+		const _containers = Array.isArray(containers) ? containers : [containers];
+		const persistentElements = options.persistentElements?.map((fn) => fn()).filter(require_dom_query.isHTMLElement);
+		if (persistentElements) _containers.push(...persistentElements);
+		return _containers.some((node$1) => require_dom_query.contains(node$1, target)) || layerStack.isInNestedLayer(node, target);
+	}
+	const cleanups = [
+		pointerBlocking ? disablePointerEventsOutside(node, options.persistentElements) : void 0,
+		trackEscapeKeydown(node, onEscapeKeyDown),
+		require_interact_outside.trackInteractOutside(node, {
+			exclude,
+			onFocusOutside,
+			onPointerDownOutside,
+			defer: options.defer
+		})
+	];
+	return () => {
+		layerStack.remove(node);
+		assignPointerEventToLayers();
+		clearPointerEvent(node);
+		cleanups.forEach((fn) => fn?.());
+	};
+}
+function trackDismissableElement(nodeOrFn, options) {
+	const { defer } = options;
+	const func = defer ? require_dom_query.raf : (v) => v();
+	const cleanups = [];
+	cleanups.push(func(() => {
+		const node = require_utils.isFunction(nodeOrFn) ? nodeOrFn() : nodeOrFn;
+		cleanups.push(trackDismissableElementImpl(node, options));
+	}));
+	return () => {
+		cleanups.forEach((fn) => fn?.());
+	};
+}
+function trackDismissableBranch(nodeOrFn, options = {}) {
+	const { defer } = options;
+	const func = defer ? require_dom_query.raf : (v) => v();
+	const cleanups = [];
+	cleanups.push(func(() => {
+		const node = require_utils.isFunction(nodeOrFn) ? nodeOrFn() : nodeOrFn;
+		if (!node) {
+			require_utils.warn("[@sprawlify-js/dismissable] branch node is `null` or `undefined`");
+			return;
+		}
+		layerStack.addBranch(node);
+		cleanups.push(() => {
+			layerStack.removeBranch(node);
+		});
+	}));
+	return () => {
+		cleanups.forEach((fn) => fn?.());
+	};
+}
+
+//#endregion
+Object.defineProperty(exports, 'trackDismissableBranch', {
+  enumerable: true,
+  get: function () {
+    return trackDismissableBranch;
+  }
+});
+Object.defineProperty(exports, 'trackDismissableElement', {
+  enumerable: true,
+  get: function () {
+    return trackDismissableElement;
+  }
+});

package/dist/dismissable-DDrx0xnH.mjs

@@ -0,0 +1,271 @@
+import { Qt as getDocument, U as raf, Xt as contains, ft as getEventTarget, l as setStyle, ln as isHTMLElement, st as addDomEvent, t as waitForElement } from "./dom-query-DFCRhyj1.mjs";
+import { i as warn, it as isFunction } from "./utils-BZyrxWWR.mjs";
+import { t as trackInteractOutside } from "./interact-outside-BplxR9cR.mjs";
+
+//#region src/shared/dismissable/escape-keydown.ts
+function trackEscapeKeydown(node, fn) {
+	const handleKeyDown = (event) => {
+		if (event.key !== "Escape") return;
+		if (event.isComposing) return;
+		fn?.(event);
+	};
+	return addDomEvent(getDocument(node), "keydown", handleKeyDown, { capture: true });
+}
+
+//#endregion
+//#region src/shared/dismissable/layer-stack.ts
+const LAYER_REQUEST_DISMISS_EVENT = "layer:request-dismiss";
+const layerStack = {
+	layers: [],
+	branches: [],
+	count() {
+		return this.layers.length;
+	},
+	pointerBlockingLayers() {
+		return this.layers.filter((layer) => layer.pointerBlocking);
+	},
+	topMostPointerBlockingLayer() {
+		return [...this.pointerBlockingLayers()].slice(-1)[0];
+	},
+	hasPointerBlockingLayer() {
+		return this.pointerBlockingLayers().length > 0;
+	},
+	isBelowPointerBlockingLayer(node) {
+		return this.indexOf(node) < (this.topMostPointerBlockingLayer() ? this.indexOf(this.topMostPointerBlockingLayer()?.node) : -1);
+	},
+	isTopMost(node) {
+		return this.layers[this.count() - 1]?.node === node;
+	},
+	getNestedLayers(node) {
+		return Array.from(this.layers).slice(this.indexOf(node) + 1);
+	},
+	getLayersByType(type) {
+		return this.layers.filter((layer) => layer.type === type);
+	},
+	getNestedLayersByType(node, type) {
+		const index = this.indexOf(node);
+		if (index === -1) return [];
+		return this.layers.slice(index + 1).filter((layer) => layer.type === type);
+	},
+	getParentLayerOfType(node, type) {
+		const index = this.indexOf(node);
+		if (index <= 0) return void 0;
+		return this.layers.slice(0, index).reverse().find((layer) => layer.type === type);
+	},
+	countNestedLayersOfType(node, type) {
+		return this.getNestedLayersByType(node, type).length;
+	},
+	isInNestedLayer(node, target) {
+		return this.getNestedLayers(node).some((layer) => contains(layer.node, target));
+	},
+	isInBranch(target) {
+		return Array.from(this.branches).some((branch) => contains(branch, target));
+	},
+	add(layer) {
+		this.layers.push(layer);
+		this.syncLayers();
+	},
+	addBranch(node) {
+		this.branches.push(node);
+	},
+	remove(node) {
+		const index = this.indexOf(node);
+		if (index < 0) return;
+		if (index < this.count() - 1) this.getNestedLayers(node).forEach((layer) => layerStack.dismiss(layer.node, node));
+		this.layers.splice(index, 1);
+		this.syncLayers();
+	},
+	removeBranch(node) {
+		const index = this.branches.indexOf(node);
+		if (index >= 0) this.branches.splice(index, 1);
+	},
+	syncLayers() {
+		this.layers.forEach((layer, index) => {
+			layer.node.style.setProperty("--layer-index", `${index}`);
+			layer.node.removeAttribute("data-nested");
+			layer.node.removeAttribute("data-has-nested");
+			if (this.getParentLayerOfType(layer.node, layer.type)) layer.node.setAttribute("data-nested", layer.type);
+			const nestedCount = this.countNestedLayersOfType(layer.node, layer.type);
+			if (nestedCount > 0) layer.node.setAttribute("data-has-nested", layer.type);
+			layer.node.style.setProperty("--nested-layer-count", `${nestedCount}`);
+		});
+	},
+	indexOf(node) {
+		return this.layers.findIndex((layer) => layer.node === node);
+	},
+	dismiss(node, parent) {
+		const index = this.indexOf(node);
+		if (index === -1) return;
+		const layer = this.layers[index];
+		addListenerOnce(node, LAYER_REQUEST_DISMISS_EVENT, (event) => {
+			layer.requestDismiss?.(event);
+			if (!event.defaultPrevented) layer?.dismiss();
+		});
+		fireCustomEvent(node, LAYER_REQUEST_DISMISS_EVENT, {
+			originalLayer: node,
+			targetLayer: parent,
+			originalIndex: index,
+			targetIndex: parent ? this.indexOf(parent) : -1
+		});
+		this.syncLayers();
+	},
+	clear() {
+		this.remove(this.layers[0].node);
+	}
+};
+function fireCustomEvent(el, type, detail) {
+	const event = new (el.ownerDocument.defaultView || window).CustomEvent(type, {
+		cancelable: true,
+		bubbles: true,
+		detail
+	});
+	return el.dispatchEvent(event);
+}
+function addListenerOnce(el, type, callback) {
+	el.addEventListener(type, callback, { once: true });
+}
+
+//#endregion
+//#region src/shared/dismissable/pointer-event-outside.ts
+let originalBodyPointerEvents;
+function assignPointerEventToLayers() {
+	layerStack.layers.forEach(({ node }) => {
+		node.style.pointerEvents = layerStack.isBelowPointerBlockingLayer(node) ? "none" : "auto";
+	});
+}
+function clearPointerEvent(node) {
+	node.style.pointerEvents = "";
+}
+function disablePointerEventsOutside(node, persistentElements) {
+	const doc = getDocument(node);
+	const cleanups = [];
+	if (layerStack.hasPointerBlockingLayer() && !doc.body.hasAttribute("data-inert")) {
+		originalBodyPointerEvents = document.body.style.pointerEvents;
+		queueMicrotask(() => {
+			doc.body.style.pointerEvents = "none";
+			doc.body.setAttribute("data-inert", "");
+		});
+	}
+	persistentElements?.forEach((el) => {
+		const [promise, abort] = waitForElement(() => {
+			const node$1 = el();
+			return isHTMLElement(node$1) ? node$1 : null;
+		}, { timeout: 1e3 });
+		promise.then((el$1) => cleanups.push(setStyle(el$1, { pointerEvents: "auto" })));
+		cleanups.push(abort);
+	});
+	return () => {
+		if (layerStack.hasPointerBlockingLayer()) return;
+		queueMicrotask(() => {
+			doc.body.style.pointerEvents = originalBodyPointerEvents;
+			doc.body.removeAttribute("data-inert");
+			if (doc.body.style.length === 0) doc.body.removeAttribute("style");
+		});
+		cleanups.forEach((fn) => fn());
+	};
+}
+
+//#endregion
+//#region src/shared/dismissable/dismissable-layer.ts
+function trackDismissableElementImpl(node, options) {
+	const { warnOnMissingNode = true } = options;
+	if (warnOnMissingNode && !node) {
+		warn("[@sprawlify-js/dismissable] node is `null` or `undefined`");
+		return;
+	}
+	if (!node) return;
+	const { onDismiss, onRequestDismiss, pointerBlocking, exclude: excludeContainers, debug, type = "dialog" } = options;
+	const layer = {
+		dismiss: onDismiss,
+		node,
+		type,
+		pointerBlocking,
+		requestDismiss: onRequestDismiss
+	};
+	layerStack.add(layer);
+	assignPointerEventToLayers();
+	function onPointerDownOutside(event) {
+		const target = getEventTarget(event.detail.originalEvent);
+		if (layerStack.isBelowPointerBlockingLayer(node) || layerStack.isInBranch(target)) return;
+		options.onPointerDownOutside?.(event);
+		options.onInteractOutside?.(event);
+		if (event.defaultPrevented) return;
+		if (debug) console.log("onPointerDownOutside:", event.detail.originalEvent);
+		onDismiss?.();
+	}
+	function onFocusOutside(event) {
+		const target = getEventTarget(event.detail.originalEvent);
+		if (layerStack.isInBranch(target)) return;
+		options.onFocusOutside?.(event);
+		options.onInteractOutside?.(event);
+		if (event.defaultPrevented) return;
+		if (debug) console.log("onFocusOutside:", event.detail.originalEvent);
+		onDismiss?.();
+	}
+	function onEscapeKeyDown(event) {
+		if (!layerStack.isTopMost(node)) return;
+		options.onEscapeKeyDown?.(event);
+		if (!event.defaultPrevented && onDismiss) {
+			event.preventDefault();
+			onDismiss();
+		}
+	}
+	function exclude(target) {
+		if (!node) return false;
+		const containers = typeof excludeContainers === "function" ? excludeContainers() : excludeContainers;
+		const _containers = Array.isArray(containers) ? containers : [containers];
+		const persistentElements = options.persistentElements?.map((fn) => fn()).filter(isHTMLElement);
+		if (persistentElements) _containers.push(...persistentElements);
+		return _containers.some((node$1) => contains(node$1, target)) || layerStack.isInNestedLayer(node, target);
+	}
+	const cleanups = [
+		pointerBlocking ? disablePointerEventsOutside(node, options.persistentElements) : void 0,
+		trackEscapeKeydown(node, onEscapeKeyDown),
+		trackInteractOutside(node, {
+			exclude,
+			onFocusOutside,
+			onPointerDownOutside,
+			defer: options.defer
+		})
+	];
+	return () => {
+		layerStack.remove(node);
+		assignPointerEventToLayers();
+		clearPointerEvent(node);
+		cleanups.forEach((fn) => fn?.());
+	};
+}
+function trackDismissableElement(nodeOrFn, options) {
+	const { defer } = options;
+	const func = defer ? raf : (v) => v();
+	const cleanups = [];
+	cleanups.push(func(() => {
+		const node = isFunction(nodeOrFn) ? nodeOrFn() : nodeOrFn;
+		cleanups.push(trackDismissableElementImpl(node, options));
+	}));
+	return () => {
+		cleanups.forEach((fn) => fn?.());
+	};
+}
+function trackDismissableBranch(nodeOrFn, options = {}) {
+	const { defer } = options;
+	const func = defer ? raf : (v) => v();
+	const cleanups = [];
+	cleanups.push(func(() => {
+		const node = isFunction(nodeOrFn) ? nodeOrFn() : nodeOrFn;
+		if (!node) {
+			warn("[@sprawlify-js/dismissable] branch node is `null` or `undefined`");
+			return;
+		}
+		layerStack.addBranch(node);
+		cleanups.push(() => {
+			layerStack.removeBranch(node);
+		});
+	}));
+	return () => {
+		cleanups.forEach((fn) => fn?.());
+	};
+}
+
+//#endregion
+export { trackDismissableElement as n, trackDismissableBranch as t };

package/dist/dismissable-layer-C7pZU2wi.d.cts

@@ -0,0 +1,39 @@
+import { i as InteractOutsideHandlers } from "./index-C9-feK5c.cjs";
+import { t as MaybeFunction } from "./functions-BOkTDEFM.cjs";
+
+//#region src/shared/dismissable/layer-stack.d.ts
+type LayerType = "dialog" | "popover" | "menu" | "listbox" | (string & {});
+type LayerDismissEventDetail = {
+  originalLayer: HTMLElement;
+  targetLayer: HTMLElement | undefined;
+  originalIndex: number;
+  targetIndex: number;
+};
+type LayerDismissEvent = CustomEvent<LayerDismissEventDetail>;
+//#endregion
+//#region src/shared/dismissable/dismissable-layer.d.ts
+type MaybeElement = HTMLElement | null;
+type Container = MaybeElement | Array<MaybeElement>;
+type NodeOrFn = MaybeFunction<MaybeElement>;
+interface DismissableElementHandlers extends InteractOutsideHandlers {
+  onEscapeKeyDown?: ((event: KeyboardEvent) => void) | undefined;
+  onRequestDismiss?: ((event: LayerDismissEvent) => void) | undefined;
+}
+interface PersistentElementOptions {
+  persistentElements?: Array<() => Element | null> | undefined;
+}
+interface DismissableElementOptions extends DismissableElementHandlers, PersistentElementOptions {
+  debug?: boolean | undefined;
+  pointerBlocking?: boolean | undefined;
+  onDismiss: VoidFunction;
+  exclude?: MaybeFunction<Container> | undefined;
+  defer?: boolean | undefined;
+  warnOnMissingNode?: boolean | undefined;
+  type?: LayerType | undefined;
+}
+declare function trackDismissableElement(nodeOrFn: NodeOrFn, options: DismissableElementOptions): () => void;
+declare function trackDismissableBranch(nodeOrFn: NodeOrFn, options?: {
+  defer?: boolean | undefined;
+}): () => void;
+//#endregion
+export { trackDismissableElement as a, trackDismissableBranch as i, DismissableElementOptions as n, LayerType as o, PersistentElementOptions as r, DismissableElementHandlers as t };