@vitus-labs/elements 1.2.1 → 1.2.3-alpha.56

package/lib/vitus-labs-elements.native.js

@@ -1,1161 +1,1277 @@
-import { makeItResponsive, alignContent, extendCss, value } from '@vitus-labs/unistyle';
-export { Provider } from '@vitus-labs/unistyle';
-import React, { forwardRef, memo, useMemo, createRef, useCallback, Children, useState, useEffect, createContext, useContext, useRef } from 'react';
-import { config, render, get, isEmpty, pick, omit, context as context$1, throttle } from '@vitus-labs/core';
-import { isFragment } from 'react-is';
-import { createPortal } from 'react-dom';
+import { Provider, alignContent, extendCss, makeItResponsive, value } from "@vitus-labs/unistyle";
+import { config, context, isEmpty, omit, pick, render, throttle } from "@vitus-labs/core";
+import { Children, createContext, forwardRef, memo, useCallback, useContext, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { isFragment } from "react-is";
+import { createPortal } from "react-dom";
 
-const PKG_NAME = '@vitus-labs/elements';
+//#region src/constants.ts
+const PKG_NAME = "@vitus-labs/elements";
 
-const IS_DEVELOPMENT = process.env.NODE_ENV !== 'production';
+//#endregion
+//#region src/utils.ts
+const IS_DEVELOPMENT = process.env.NODE_ENV !== "production";
 
-const { styled: styled$2, css: css$2, component: component$3 } = config;
-const childFixCSS = `
-  display: flex;
+//#endregion
+//#region src/helpers/Content/styled.ts
+/**
+* Styled component for content areas (before/content/after). Applies
+* responsive flex alignment, gap spacing between slots based on parent
+* direction (margin-right for inline, margin-bottom for rows), and
+* equalCols flex distribution. The "content" slot gets `flex: 1` to
+* fill remaining space between before and after.
+*/
+const { styled: styled$2, css: css$2, component: component$2 } = config;
+const equalColsCSS = `
   flex: 1;
-  width: 100%;
-  height: 100%;
 `;
-const blockCSS = `
-  align-self: stretch;
+const typeContentCSS = `
+  flex: 1;
 `;
-const styles$2 = ({ theme: t, css, }) => css `
-  ${false};
-
+const gapDimensions = {
+	inline: {
+		before: "margin-right",
+		after: "margin-left"
+	},
+	reverseInline: {
+		before: "margin-right",
+		after: "margin-left"
+	},
+	rows: {
+		before: "margin-bottom",
+		after: "margin-top"
+	},
+	reverseRows: {
+		before: "margin-bottom",
+		after: "margin-top"
+	}
+};
+const calculateGap = ({ direction, type, value }) => {
+	if (!direction || !type || type === "content") return void 0;
+	return `${gapDimensions[direction][type]}: ${value};`;
+};
+const styles$2 = ({ css, theme: t, rootSize }) => css`
   ${alignContent({
-    direction: t.direction,
-    alignX: t.alignX,
-    alignY: t.alignY,
+	direction: t.direction,
+	alignX: t.alignX,
+	alignY: t.alignY
 })};
 
-  ${t.block && blockCSS};
+  ${t.equalCols && equalColsCSS};
 
-  ${false};
-  ${false};
-  ${false};
+  ${t.gap && t.contentType && calculateGap({
+	direction: t.parentDirection,
+	type: t.contentType,
+	value: value(t.gap, rootSize)
+})};
 
   ${t.extraStyles && extendCss(t.extraStyles)};
 `;
-const platformCSS$1 = `display: flex;`;
-var Styled$1 = styled$2(component$3) `
-  position: relative;
-  ${platformCSS$1};
+const StyledComponent = styled$2(component$2)`
+  ${""};
 
-  ${({ $childFix }) => $childFix && childFixCSS};
+  display: flex;
+  align-self: stretch;
+  flex-wrap: wrap;
+
+  ${({ $contentType }) => $contentType === "content" && typeContentCSS};
 
   ${makeItResponsive({
-    key: '$element',
-    styles: styles$2,
-    css: css$2,
-    normalize: true,
+	key: "$element",
+	styles: styles$2,
+	css: css$2,
+	normalize: true
 })};
 `;
 
-// eslint-disable-next-line react/display-name
-const Component$9 = forwardRef(({ children, tag, block, extendCss, direction, alignX, alignY, equalCols, isInline, ...props }, ref) => {
-    const debugProps = IS_DEVELOPMENT
-        ? {
-            'data-vl-element': 'Element',
-        }
-        : {};
-    const COMMON_PROPS = {
-        ...props,
-        ...debugProps,
-        ref,
-        as: tag,
-    };
-    {
-        return (React.createElement(Styled$1, { ...COMMON_PROPS, "$element": {
-                block,
-                direction,
-                alignX,
-                alignY,
-                equalCols,
-                extraStyles: extendCss,
-            } }, children));
-    }
-});
+//#endregion
+//#region src/helpers/Content/component.tsx
+const Component$9 = ({ contentType, tag, parentDirection, direction, alignX, alignY, equalCols, gap, extendCss, ...props }) => {
+	return /* @__PURE__ */ jsx(StyledComponent, {
+		as: tag,
+		$contentType: contentType,
+		$element: {
+			contentType,
+			parentDirection,
+			direction,
+			alignX,
+			alignY,
+			equalCols,
+			gap,
+			extraStyles: extendCss
+		},
+		...IS_DEVELOPMENT ? { "data-vl-element": contentType } : {},
+		...props
+	});
+};
+var component_default = memo(Component$9);
 
-const { styled: styled$1, css: css$1, component: component$2 } = config;
-const equalColsCSS = `
+//#endregion
+//#region src/helpers/Content/index.ts
+var Content_default = component_default;
+
+//#endregion
+//#region src/helpers/Wrapper/styled.ts
+/**
+* Styled component for the Element wrapper layer. Handles responsive
+* block/inline-flex display, direction, alignment, and custom CSS injection.
+* Includes special handling for the `parentFix` / `childFix` flags that
+* split flex behavior across two DOM nodes for button/fieldset/legend
+* elements where a single flex container is insufficient.
+*/
+const { styled: styled$1, css: css$1, component: component$1 } = config;
+const childFixCSS = `
+  display: flex;
   flex: 1;
+  width: 100%;
+  height: 100%;
 `;
-const typeContentCSS = `
-  flex: 1;
+const blockCSS = `
+  align-self: stretch;
 `;
-// --------------------------------------------------------
-// calculate spacing between before / content / after
-// --------------------------------------------------------
-const gapDimensions = {
-    inline: {
-        before: 'margin-right',
-        after: 'margin-left',
-    },
-    reverseInline: {
-        before: 'margin-right',
-        after: 'margin-left',
-    },
-    rows: {
-        before: 'margin-bottom',
-        after: 'margin-top',
-    },
-    reverseRows: {
-        before: 'margin-bottom',
-        after: 'margin-top',
-    },
-};
-const calculateGap = ({ direction, type, value, }) => {
-    if (!direction || !type)
-        return undefined;
-    const finalStyles = `${gapDimensions[direction][type]}: ${value};`;
-    return finalStyles;
-};
-// --------------------------------------------------------
-// calculations of styles to be rendered
-// --------------------------------------------------------
-const styles$1 = ({ css, theme: t, rootSize, }) => css `
+const styles$1 = ({ theme: t, css }) => css`
+  ${false};
+
   ${alignContent({
-    direction: t.direction,
-    alignX: t.alignX,
-    alignY: t.alignY,
+	direction: t.direction,
+	alignX: t.alignX,
+	alignY: t.alignY
 })};
 
-  ${t.equalCols && equalColsCSS};
+  ${t.block && blockCSS};
 
-  ${t.gap &&
-    t.contentType &&
-    calculateGap({
-        direction: t.parentDirection,
-        type: t.contentType,
-        value: value(t.gap, rootSize),
-    })};
+  ${false};
+  ${false};
+  ${false};
 
   ${t.extraStyles && extendCss(t.extraStyles)};
 `;
-const platformCSS = '';
-const StyledComponent = styled$1(component$2) `
+const platformCSS = `display: flex;`;
+var styled_default$1 = styled$1(component$1)`
+  position: relative;
   ${platformCSS};
 
-  display: flex;
-  align-self: stretch;
-  flex-wrap: wrap;
-
-  ${({ $contentType }) => $contentType === 'content' && typeContentCSS};
+  ${({ $childFix }) => $childFix && childFixCSS};
 
   ${makeItResponsive({
-    key: '$element',
-    styles: styles$1,
-    css: css$1,
-    normalize: true,
+	key: "$element",
+	styles: styles$1,
+	css: css$1,
+	normalize: true
 })};
 `;
 
-const Component$8 = ({ contentType, tag, parentDirection, direction, alignX, alignY, equalCols, gap, extendCss, ...props }) => {
-    const debugProps = IS_DEVELOPMENT
-        ? {
-            'data-vl-element': contentType,
-        }
-        : {};
-    const stylingProps = {
-        contentType,
-        parentDirection,
-        direction,
-        alignX,
-        alignY,
-        equalCols,
-        gap,
-        extraStyles: extendCss,
-    };
-    return (React.createElement(StyledComponent, { as: tag, "$contentType": contentType, "$element": stylingProps, ...debugProps, ...props }));
-};
-var component$1 = memo(Component$8);
+//#endregion
+//#region src/helpers/Wrapper/component.tsx
+/**
+* Wrapper component that serves as the outermost styled container for Element.
+* Uses forwardRef for ref forwarding to the underlying DOM node. On web, it
+* detects button/fieldset/legend tags and applies a two-layer flex fix
+* (parent + child Styled) because these HTML elements do not natively
+* support `display: flex` consistently across browsers.
+*/
+const DEV_PROPS = IS_DEVELOPMENT ? { "data-vl-element": "Element" } : {};
+const Component$8 = forwardRef(({ children, tag, block, extendCss, direction, alignX, alignY, equalCols, isInline, ...props }, ref) => {
+	return /* @__PURE__ */ jsx(styled_default$1, {
+		...props,
+		...DEV_PROPS,
+		ref,
+		as: tag,
+		$element: {
+			block,
+			direction,
+			alignX,
+			alignY,
+			equalCols,
+			extraStyles: extendCss
+		},
+		children
+	});
+});
+
+//#endregion
+//#region src/helpers/Wrapper/index.ts
+var Wrapper_default = Component$8;
 
-const defaultDirection = 'inline';
-const defaultContentDirection = 'rows';
-const defaultAlignX = 'left';
-const defaultAlignY = 'center';
+//#endregion
+//#region src/Element/component.tsx
+/**
+* Core building block of the elements package. Renders a three-section layout
+* (beforeContent / content / afterContent) inside a flex Wrapper. When only
+* content is present, the Wrapper inherits content-level alignment directly
+* to avoid an unnecessary nesting layer. Handles HTML-specific edge cases
+* like void elements (input, img) and inline elements (span, a) by
+* skipping children or switching sub-tags accordingly.
+*/
+const defaultDirection = "inline";
+const defaultContentDirection = "rows";
+const defaultAlignX = "left";
+const defaultAlignY = "center";
 const Component$7 = forwardRef(({ innerRef, tag, label, content, children, beforeContent, afterContent, block, equalCols, gap, direction, alignX = defaultAlignX, alignY = defaultAlignY, css, contentCss, beforeContentCss, afterContentCss, contentDirection = defaultContentDirection, contentAlignX = defaultAlignX, contentAlignY = defaultAlignY, beforeContentDirection = defaultDirection, beforeContentAlignX = defaultAlignX, beforeContentAlignY = defaultAlignY, afterContentDirection = defaultDirection, afterContentAlignX = defaultAlignX, afterContentAlignY = defaultAlignY, ...props }, ref) => {
-    // --------------------------------------------------------
-    // if not single element, calculate values
-    // --------------------------------------------------------
-    const isSimpleElement = !beforeContent && !afterContent;
-    const CHILDREN = children ?? content ?? label;
-    const isInline = false;
-    const SUB_TAG = undefined;
-    // --------------------------------------------------------
-    // direction & alignX & alignY calculations
-    // --------------------------------------------------------
-    const { wrapperDirection, wrapperAlignX, wrapperAlignY } = useMemo(() => {
-        let wrapperDirection = direction;
-        let wrapperAlignX = alignX;
-        let wrapperAlignY = alignY;
-        if (isSimpleElement) {
-            if (contentDirection)
-                wrapperDirection = contentDirection;
-            if (contentAlignX)
-                wrapperAlignX = contentAlignX;
-            if (contentAlignY)
-                wrapperAlignY = contentAlignY;
-        }
-        else if (direction) {
-            wrapperDirection = direction;
-        }
-        else {
-            wrapperDirection = defaultDirection;
-        }
-        return { wrapperDirection, wrapperAlignX, wrapperAlignY };
-    }, [
-        isSimpleElement,
-        contentDirection,
-        contentAlignX,
-        contentAlignY,
-        alignX,
-        alignY,
-        direction,
-    ]);
-    // --------------------------------------------------------
-    // common wrapper props
-    // --------------------------------------------------------
-    const WRAPPER_PROPS = {
-        ref: ref ?? innerRef,
-        extendCss: css,
-        tag,
-        block,
-        direction: wrapperDirection,
-        alignX: wrapperAlignX,
-        alignY: wrapperAlignY,
-        as: undefined, // reset styled-components `as` prop
-    };
-    const contentRenderOutput = render(CHILDREN);
-    return (React.createElement(Component$9, { ...props, ...WRAPPER_PROPS, isInline: isInline },
-        beforeContent && (React.createElement(component$1, { tag: SUB_TAG, contentType: "before", parentDirection: wrapperDirection, extendCss: beforeContentCss, direction: beforeContentDirection, alignX: beforeContentAlignX, alignY: beforeContentAlignY, equalCols: equalCols, gap: gap }, render(beforeContent))),
-        isSimpleElement ? (contentRenderOutput) : (React.createElement(component$1, { tag: SUB_TAG, contentType: "content", parentDirection: wrapperDirection, extendCss: contentCss, direction: contentDirection, alignX: contentAlignX, alignY: contentAlignY, equalCols: equalCols }, contentRenderOutput)),
-        afterContent && (React.createElement(component$1, { tag: SUB_TAG, contentType: "after", parentDirection: wrapperDirection, extendCss: afterContentCss, direction: afterContentDirection, alignX: afterContentAlignX, alignY: afterContentAlignY, equalCols: equalCols, gap: gap }, render(afterContent)))));
+	const isSimpleElement = !beforeContent && !afterContent;
+	const CHILDREN = children ?? content ?? label;
+	const isInline = false;
+	const SUB_TAG = void 0;
+	const { wrapperDirection, wrapperAlignX, wrapperAlignY } = useMemo(() => {
+		let wrapperDirection = direction;
+		let wrapperAlignX = alignX;
+		let wrapperAlignY = alignY;
+		if (isSimpleElement) {
+			if (contentDirection) wrapperDirection = contentDirection;
+			if (contentAlignX) wrapperAlignX = contentAlignX;
+			if (contentAlignY) wrapperAlignY = contentAlignY;
+		} else if (direction) wrapperDirection = direction;
+		else wrapperDirection = defaultDirection;
+		return {
+			wrapperDirection,
+			wrapperAlignX,
+			wrapperAlignY
+		};
+	}, [
+		isSimpleElement,
+		contentDirection,
+		contentAlignX,
+		contentAlignY,
+		alignX,
+		alignY,
+		direction
+	]);
+	const WRAPPER_PROPS = {
+		ref: ref ?? innerRef,
+		extendCss: css,
+		tag,
+		block,
+		direction: wrapperDirection,
+		alignX: wrapperAlignX,
+		alignY: wrapperAlignY,
+		as: void 0
+	};
+	const contentRenderOutput = render(CHILDREN);
+	return /* @__PURE__ */ jsxs(Wrapper_default, {
+		...props,
+		...WRAPPER_PROPS,
+		isInline,
+		children: [
+			beforeContent && /* @__PURE__ */ jsx(Content_default, {
+				tag: SUB_TAG,
+				contentType: "before",
+				parentDirection: wrapperDirection,
+				extendCss: beforeContentCss,
+				direction: beforeContentDirection,
+				alignX: beforeContentAlignX,
+				alignY: beforeContentAlignY,
+				equalCols,
+				gap,
+				children: render(beforeContent)
+			}),
+			isSimpleElement ? contentRenderOutput : /* @__PURE__ */ jsx(Content_default, {
+				tag: SUB_TAG,
+				contentType: "content",
+				parentDirection: wrapperDirection,
+				extendCss: contentCss,
+				direction: contentDirection,
+				alignX: contentAlignX,
+				alignY: contentAlignY,
+				equalCols,
+				children: contentRenderOutput
+			}),
+			afterContent && /* @__PURE__ */ jsx(Content_default, {
+				tag: SUB_TAG,
+				contentType: "after",
+				parentDirection: wrapperDirection,
+				extendCss: afterContentCss,
+				direction: afterContentDirection,
+				alignX: afterContentAlignX,
+				alignY: afterContentAlignY,
+				equalCols,
+				gap,
+				children: render(afterContent)
+			})
+		]
+	});
 });
 const name$5 = `${PKG_NAME}/Element`;
 Component$7.displayName = name$5;
 Component$7.pkgName = PKG_NAME;
 Component$7.VITUS_LABS__COMPONENT = name$5;
 
-const isNumber = (a, b) => Number.isInteger(a) && Number.isInteger(b);
+//#endregion
+//#region src/Element/withEqualSizeBeforeAfter.tsx
+/**
+* HOC that equalizes the dimensions of beforeContent and afterContent areas.
+* After render, it measures both DOM nodes via useLayoutEffect and sets the
+* larger dimension on both so they match. Uses width for inline direction
+* and height for rows direction. This is useful for centering the main
+* content when before/after slots have different intrinsic sizes.
+*/
 const types = {
-    height: 'offsetHeight',
-    width: 'offsetWidth',
+	height: "offsetHeight",
+	width: "offsetWidth"
 };
-const calculate = ({ beforeContent, afterContent }) => (type) => {
-    const beforeContentSize = get(beforeContent, types[type]);
-    const afterContentSize = get(afterContent, types[type]);
-    if (isNumber(beforeContentSize, afterContentSize)) {
-        if (beforeContentSize > afterContentSize) {
-            beforeContent.style[type] = `${beforeContentSize}px`;
-            afterContent.style[type] = `${beforeContentSize}px`;
-        }
-        else {
-            beforeContent.style[type] = `${afterContentSize}px`;
-            afterContent.style[type] = `${afterContentSize}px`;
-        }
-    }
+const equalize = (beforeEl, afterEl, type) => {
+	const prop = types[type];
+	const beforeSize = beforeEl[prop];
+	const afterSize = afterEl[prop];
+	if (Number.isInteger(beforeSize) && Number.isInteger(afterSize)) {
+		const maxSize = `${Math.max(beforeSize, afterSize)}px`;
+		beforeEl.style[type] = maxSize;
+		afterEl.style[type] = maxSize;
+	}
 };
 const withEqualBeforeAfter = (WrappedComponent) => {
-    const displayName = WrappedComponent.displayName ?? WrappedComponent.name ?? 'Component';
-    const Enhanced = (props) => {
-        const { equalBeforeAfter, direction, afterContent, beforeContent, ...rest } = props;
-        const elementRef = createRef();
-        const calculateSize = () => {
-            const beforeContent = get(elementRef, 'current.children[0]');
-            const afterContent = get(elementRef, 'current.children[2]');
-            if (beforeContent && afterContent) {
-                const updateElement = calculate({ beforeContent, afterContent });
-                if (direction === 'rows')
-                    updateElement('height');
-                else
-                    updateElement('width');
-            }
-        };
-        if (equalBeforeAfter)
-            calculateSize();
-        return (React.createElement(WrappedComponent, { ...rest, afterContent: afterContent, beforeContent: beforeContent, 
-            // @ts-ignore
-            ref: elementRef }));
-    };
-    Enhanced.displayName = `withEqualSizeBeforeAfter(${displayName})`;
-    return Enhanced;
+	const displayName = WrappedComponent.displayName ?? WrappedComponent.name ?? "Component";
+	const Enhanced = ({ equalBeforeAfter, direction, afterContent, beforeContent, ref, ...rest }) => {
+		const internalRef = useRef(null);
+		useImperativeHandle(ref, () => internalRef.current);
+		useLayoutEffect(() => {
+			if (!equalBeforeAfter || !beforeContent || !afterContent) return;
+			if (!internalRef.current) return;
+			const el = internalRef.current;
+			const beforeEl = el.firstElementChild;
+			const afterEl = el.lastElementChild;
+			if (beforeEl && afterEl && beforeEl !== afterEl) equalize(beforeEl, afterEl, direction === "rows" ? "height" : "width");
+		});
+		return /* @__PURE__ */ jsx(WrappedComponent, {
+			...rest,
+			afterContent,
+			beforeContent,
+			ref: internalRef
+		});
+	};
+	Enhanced.displayName = `withEqualSizeBeforeAfter(${displayName})`;
+	return Enhanced;
 };
 
+//#endregion
+//#region src/Element/index.ts
+var Element_default = Component$7;
+
+//#endregion
+//#region src/helpers/Iterator/component.tsx
+/**
+* Data-driven list renderer that supports three input modes: React children
+* (including fragments), an array of primitives, or an array of objects.
+* Each item receives positional metadata (first, last, odd, even, position)
+* and optional injected props via `itemProps`. Items can be individually
+* wrapped with `wrapComponent`. Children always take priority over the
+* component+data prop pattern.
+*/
+const classifyData = (data) => {
+	const items = data.filter((item) => item != null && !(typeof item === "object" && isEmpty(item)));
+	if (items.length === 0) return null;
+	let isSimple = true;
+	let isComplex = true;
+	for (const item of items) if (typeof item === "string" || typeof item === "number") isComplex = false;
+	else if (typeof item === "object") isSimple = false;
+	else {
+		isSimple = false;
+		isComplex = false;
+	}
+	if (isSimple) return {
+		type: "simple",
+		data: items
+	};
+	if (isComplex) return {
+		type: "complex",
+		data: items
+	};
+	return null;
+};
 const RESERVED_PROPS = [
-    'children',
-    'component',
-    'wrapComponent',
-    'data',
-    'itemKey',
-    'valueName',
-    'itemProps',
-    'wrapProps',
+	"children",
+	"component",
+	"wrapComponent",
+	"data",
+	"itemKey",
+	"valueName",
+	"itemProps",
+	"wrapProps"
 ];
-const attachItemProps = ({ i, length, }) => {
-    const position = i + 1;
-    return {
-        index: i,
-        first: position === 1,
-        last: position === length,
-        odd: position % 2 === 1,
-        even: position % 2 === 0,
-        position,
-    };
+const attachItemProps = ({ i, length }) => {
+	const position = i + 1;
+	return {
+		index: i,
+		first: position === 1,
+		last: position === length,
+		odd: position % 2 === 1,
+		even: position % 2 === 0,
+		position
+	};
 };
 const Component$6 = (props) => {
-    const { itemKey, valueName, children, component, data, wrapComponent: Wrapper, wrapProps, itemProps, } = props;
-    const injectItemProps = useMemo(() => (typeof itemProps === 'function' ? itemProps : () => itemProps), [itemProps]);
-    const injectWrapItemProps = useMemo(() => (typeof wrapProps === 'function' ? wrapProps : () => wrapProps), [wrapProps]);
-    const getKey = useCallback((item, index) => {
-        if (typeof itemKey === 'function')
-            return itemKey(item, index);
-        return index;
-    }, [itemKey]);
-    const renderChild = (child, total = 1, i = 0) => {
-        if (!itemProps && !Wrapper)
-            return child;
-        const extendedProps = attachItemProps({
-            i,
-            length: total,
-        });
-        const finalItemProps = itemProps ? injectItemProps({}, extendedProps) : {};
-        // if no props extension is required, just return children
-        if (Wrapper) {
-            const finalWrapProps = wrapProps
-                ? injectWrapItemProps({}, extendedProps)
-                : {};
-            return (React.createElement(Wrapper, { key: i, ...finalWrapProps }, render(child, finalItemProps)));
-        }
-        return render(child, {
-            key: i,
-            ...finalItemProps,
-        });
-    };
-    // --------------------------------------------------------
-    // render children
-    // --------------------------------------------------------
-    const renderChildren = () => {
-        if (!children)
-            return null;
-        // if children is Array
-        if (Array.isArray(children)) {
-            return Children.map(children, (item, i) => renderChild(item, children.length, i));
-        }
-        // if children is Fragment
-        if (isFragment(children)) {
-            const fragmentChildren = children?.props?.children;
-            const childrenLength = fragmentChildren.length;
-            return fragmentChildren.map((item, i) => renderChild(item, childrenLength, i));
-        }
-        // if single child
-        return renderChild(children);
-    };
-    // --------------------------------------------------------
-    // render array of strings or numbers
-    // --------------------------------------------------------
-    const renderSimpleArray = (data) => {
-        const { length } = data;
-        // if the data array is empty
-        if (length === 0)
-            return null;
-        return data.map((item, i) => {
-            const key = getKey(item, i);
-            const keyName = valueName ?? 'children';
-            const extendedProps = attachItemProps({
-                i,
-                length,
-            });
-            const finalItemProps = {
-                ...(itemProps
-                    ? injectItemProps({ [keyName]: item }, extendedProps)
-                    : {}),
-                [keyName]: item,
-            };
-            if (Wrapper) {
-                const finalWrapProps = wrapProps
-                    ? injectWrapItemProps({ [keyName]: item }, extendedProps)
-                    : {};
-                return (React.createElement(Wrapper, { key: key, ...finalWrapProps }, render(component, finalItemProps)));
-            }
-            return render(component, { key, ...finalItemProps });
-        });
-    };
-    // --------------------------------------------------------
-    // render array of objects
-    // --------------------------------------------------------
-    const renderComplexArray = (data) => {
-        const renderData = data.filter((item) => !isEmpty(item)); // remove empty objects
-        const { length } = renderData;
-        // if it's empty
-        if (renderData.length === 0)
-            return null;
-        const getKey = (item, index) => {
-            if (!itemKey)
-                return item.key ?? item.id ?? item.itemId ?? index;
-            if (typeof itemKey === 'function')
-                return itemKey(item, index);
-            if (typeof itemKey === 'string')
-                return item[itemKey];
-            return index;
-        };
-        return renderData.map((item, i) => {
-            const { component: itemComponent, ...restItem } = item;
-            const renderItem = itemComponent ?? component;
-            const key = getKey(restItem, i);
-            const extendedProps = attachItemProps({
-                i,
-                length,
-            });
-            const finalItemProps = {
-                ...(itemProps ? injectItemProps(item, extendedProps) : {}),
-                ...restItem,
-            };
-            if (Wrapper && !itemComponent) {
-                const finalWrapProps = wrapProps
-                    ? injectWrapItemProps(item, extendedProps)
-                    : {};
-                return (React.createElement(Wrapper, { key: key, ...finalWrapProps }, render(renderItem, finalItemProps)));
-            }
-            return render(renderItem, { key, ...finalItemProps });
-        });
-    };
-    // --------------------------------------------------------
-    // render list items
-    // --------------------------------------------------------
-    const renderItems = () => {
-        // --------------------------------------------------------
-        // children have priority over props component + data
-        // --------------------------------------------------------
-        if (children)
-            return renderChildren();
-        // --------------------------------------------------------
-        // render props component + data
-        // --------------------------------------------------------
-        if (component && Array.isArray(data)) {
-            const clearData = data.filter((item) => item !== null && item !== undefined);
-            const isSimpleArray = clearData.every((item) => typeof item === 'string' || typeof item === 'number');
-            if (isSimpleArray)
-                return renderSimpleArray(clearData);
-            const isComplexArray = clearData.every((item) => typeof item === 'object');
-            if (isComplexArray)
-                return renderComplexArray(clearData);
-            return null;
-        }
-        // --------------------------------------------------------
-        // if there are no children or valid react component and data as an array,
-        // return null to prevent error
-        // --------------------------------------------------------
-        return null;
-    };
-    return renderItems();
+	const { itemKey, valueName, children, component, data, wrapComponent: Wrapper, wrapProps, itemProps } = props;
+	const injectItemProps = useMemo(() => typeof itemProps === "function" ? itemProps : () => itemProps, [itemProps]);
+	const injectWrapItemProps = useMemo(() => typeof wrapProps === "function" ? wrapProps : () => wrapProps, [wrapProps]);
+	const getKey = useCallback((item, index) => {
+		if (typeof itemKey === "function") return itemKey(item, index);
+		return index;
+	}, [itemKey]);
+	const renderChild = (child, total = 1, i = 0) => {
+		if (!itemProps && !Wrapper) return child;
+		const extendedProps = attachItemProps({
+			i,
+			length: total
+		});
+		const finalItemProps = itemProps ? injectItemProps({}, extendedProps) : {};
+		if (Wrapper) return /* @__PURE__ */ jsx(Wrapper, {
+			...wrapProps ? injectWrapItemProps({}, extendedProps) : {},
+			children: render(child, finalItemProps)
+		}, i);
+		return render(child, {
+			key: i,
+			...finalItemProps
+		});
+	};
+	const renderChildren = () => {
+		if (!children) return null;
+		if (Array.isArray(children)) return Children.map(children, (item, i) => renderChild(item, children.length, i));
+		if (isFragment(children)) {
+			const fragmentChildren = children.props.children;
+			const childrenLength = fragmentChildren.length;
+			return fragmentChildren.map((item, i) => renderChild(item, childrenLength, i));
+		}
+		return renderChild(children);
+	};
+	const renderSimpleArray = (data) => {
+		const { length } = data;
+		if (length === 0) return null;
+		return data.map((item, i) => {
+			const key = getKey(item, i);
+			const keyName = valueName ?? "children";
+			const extendedProps = attachItemProps({
+				i,
+				length
+			});
+			const finalItemProps = {
+				...itemProps ? injectItemProps({ [keyName]: item }, extendedProps) : {},
+				[keyName]: item
+			};
+			if (Wrapper) return /* @__PURE__ */ jsx(Wrapper, {
+				...wrapProps ? injectWrapItemProps({ [keyName]: item }, extendedProps) : {},
+				children: render(component, finalItemProps)
+			}, key);
+			return render(component, {
+				key,
+				...finalItemProps
+			});
+		});
+	};
+	const getObjectKey = (item, index) => {
+		if (!itemKey) return item.key ?? item.id ?? item.itemId ?? index;
+		if (typeof itemKey === "function") return itemKey(item, index);
+		if (typeof itemKey === "string") return item[itemKey];
+		return index;
+	};
+	const renderComplexArray = (data) => {
+		const { length } = data;
+		if (length === 0) return null;
+		return data.map((item, i) => {
+			const { component: itemComponent, ...restItem } = item;
+			const renderItem = itemComponent ?? component;
+			const key = getObjectKey(restItem, i);
+			const extendedProps = attachItemProps({
+				i,
+				length
+			});
+			const finalItemProps = {
+				...itemProps ? injectItemProps(item, extendedProps) : {},
+				...restItem
+			};
+			if (Wrapper && !itemComponent) return /* @__PURE__ */ jsx(Wrapper, {
+				...wrapProps ? injectWrapItemProps(item, extendedProps) : {},
+				children: render(renderItem, finalItemProps)
+			}, key);
+			return render(renderItem, {
+				key,
+				...finalItemProps
+			});
+		});
+	};
+	const renderItems = () => {
+		if (children) return renderChildren();
+		if (component && Array.isArray(data)) {
+			const classified = classifyData(data);
+			if (!classified) return null;
+			if (classified.type === "simple") return renderSimpleArray(classified.data);
+			return renderComplexArray(classified.data);
+		}
+		return null;
+	};
+	return renderItems();
 };
 Component$6.isIterator = true;
 Component$6.RESERVED_PROPS = RESERVED_PROPS;
 
+//#endregion
+//#region src/helpers/Iterator/index.ts
+var Iterator_default = Component$6;
+
+//#endregion
+//#region src/List/component.tsx
+/**
+* List component that combines Iterator (data-driven rendering) with an
+* optional Element root wrapper. When `rootElement` is false (default),
+* it renders a bare Iterator as a fragment. When true, the Iterator output
+* is wrapped in an Element that receives all non-iterator props (e.g.,
+* layout, alignment, css), allowing the list to be styled as a single block.
+*/
 const Component$5 = forwardRef(({ rootElement = false, ...props }, ref) => {
-    const renderedList = React.createElement(Component$6, { ...pick(props, Component$6.RESERVED_PROPS) });
-    if (!rootElement)
-        return renderedList;
-    return (React.createElement(Component$7, { ref: ref, ...omit(props, Component$6.RESERVED_PROPS) }, renderedList));
+	const renderedList = /* @__PURE__ */ jsx(Iterator_default, { ...pick(props, Iterator_default.RESERVED_PROPS) });
+	if (!rootElement) return renderedList;
+	return /* @__PURE__ */ jsx(Element_default, {
+		ref,
+		...omit(props, Iterator_default.RESERVED_PROPS),
+		children: renderedList
+	});
 });
 const name$4 = `${PKG_NAME}/List`;
 Component$5.displayName = name$4;
 Component$5.pkgName = PKG_NAME;
 Component$5.VITUS_LABS__COMPONENT = name$4;
 
-// @ts-nocheck
+//#endregion
+//#region src/List/withActiveState.tsx
+/**
+* HOC that adds single or multi selection state management to a list component.
+* Tracks which items are active via a scalar key (single mode) or a Map of
+* key-to-boolean entries (multi mode). Injects `itemProps` callback that
+* provides each item with `active`, `handleItemActive`, `toggleItemActive`,
+* and other selection helpers. Supports `activeItemRequired` to prevent
+* deselecting the last active item.
+*/
 const RESERVED_KEYS = [
-    'type',
-    'activeItems',
-    'itemProps',
-    'activeItemRequired',
+	"type",
+	"activeItems",
+	"itemProps",
+	"activeItemRequired"
 ];
 const component = (WrappedComponent) => {
-    const displayName = WrappedComponent.displayName || WrappedComponent.name || 'Component';
-    const Enhanced = (props) => {
-        const { type = 'single', activeItemRequired, activeItems, itemProps = {}, ...rest } = props;
-        const initActiveItems = () => {
-            if (type === 'single') {
-                if (Array.isArray(activeItems)) {
-                    // eslint-disable-next-line no-console
-                    console.warn('Iterator is type of single. activeItems cannot be an array.');
-                }
-                else {
-                    return activeItems;
-                }
-            }
-            else if (type === 'multi') {
-                const activeItemsHelper = Array.isArray(activeItems)
-                    ? activeItems
-                    : [activeItems];
-                return new Map(activeItemsHelper.map((id) => [id, true]));
-            }
-            return undefined;
-        };
-        const [innerActiveItems, setActiveItems] = useState(initActiveItems());
-        const countActiveItems = (data) => {
-            let result = 0;
-            data.forEach((value) => {
-                if (value)
-                    result += 1;
-            });
-            return result;
-        };
-        const updateItemState = (key) => {
-            if (type === 'single') {
-                setActiveItems((prevState) => {
-                    if (activeItemRequired)
-                        return key;
-                    if (prevState === key)
-                        return undefined;
-                    return key;
-                });
-            }
-            else if (type === 'multi') {
-                setActiveItems((prevState) => {
-                    // TODO: add conditional type to fix this
-                    const activeItems = new Map(prevState);
-                    if (activeItemRequired &&
-                        activeItems.get(key) &&
-                        countActiveItems(activeItems) === 1) {
-                        return activeItems;
-                    }
-                    activeItems.set(key, !activeItems.get(key));
-                    return activeItems;
-                });
-            }
-            else {
-                setActiveItems(undefined);
-            }
-        };
-        const handleItemActive = (key) => {
-            updateItemState(key);
-        };
-        const updateAllItemsState = (status) => {
-            {
-                setActiveItems(new Map());
-            }
-        };
-        const setItemActive = (key) => {
-            updateItemState(key);
-        };
-        const unsetItemActive = (key) => {
-            updateItemState(key);
-        };
-        const toggleItemActive = (key) => {
-            updateItemState(key);
-        };
-        // const setAllItemsActive = () => {
-        //   updateAllItemsState(true)
-        // }
-        const unsetAllItemsActive = () => {
-            updateAllItemsState();
-        };
-        const isItemActive = (key) => {
-            if (!innerActiveItems)
-                return false;
-            if (type === 'single')
-                return innerActiveItems === key;
-            if (type === 'multi' && innerActiveItems instanceof Map) {
-                return !!innerActiveItems.get(key);
-            }
-            return false;
-        };
-        const attachMultipleProps = {
-            unsetAllItemsActive,
-        };
-        const attachItemProps = (props) => {
-            const { key } = props;
-            const defaultItemProps = typeof itemProps === 'object' ? itemProps : itemProps(props);
-            const result = {
-                ...defaultItemProps,
-                active: isItemActive(key),
-                handleItemActive: () => handleItemActive(key),
-                setItemActive,
-                unsetItemActive,
-                toggleItemActive,
-                ...(type === 'multi' ? attachMultipleProps : {}),
-            };
-            return result;
-        };
-        useEffect(() => {
-            if (type === 'single' && Array.isArray(activeItems)) {
-                if (process.env.NODE_ENV !== 'production') {
-                    // eslint-disable-next-line no-console
-                    console.error('When type=`single` activeItems must be a single value, not an array');
-                }
-            }
-        }, [type, activeItems]);
-        return React.createElement(WrappedComponent, { ...rest, itemProps: attachItemProps });
-    };
-    Enhanced.RESERVED_KEYS = RESERVED_KEYS;
-    Enhanced.displayName = `@vitus-labs/elements/List/withActiveState(${displayName})`;
-    return Enhanced;
+	const displayName = WrappedComponent.displayName || WrappedComponent.name || "Component";
+	const Enhanced = (props) => {
+		const { type = "single", activeItemRequired, activeItems, itemProps = {}, ...rest } = props;
+		const initActiveItems = () => {
+			if (type === "single") {
+				if (!Array.isArray(activeItems)) return activeItems;
+			} else if (type === "multi") {
+				const activeItemsHelper = Array.isArray(activeItems) ? activeItems : [activeItems];
+				return new Map(activeItemsHelper.map((id) => [id, true]));
+			}
+		};
+		const [innerActiveItems, setActiveItems] = useState(initActiveItems());
+		const countActiveItems = (data) => {
+			let result = 0;
+			data.forEach((value) => {
+				if (value) result += 1;
+			});
+			return result;
+		};
+		const updateItemState = (key) => {
+			if (type === "single") setActiveItems((prevState) => {
+				if (activeItemRequired) return key;
+				if (prevState === key) return void 0;
+				return key;
+			});
+			else if (type === "multi") setActiveItems((prevState) => {
+				const activeItems = new Map(prevState);
+				if (activeItemRequired && activeItems.get(key) && countActiveItems(activeItems) === 1) return activeItems;
+				activeItems.set(key, !activeItems.get(key));
+				return activeItems;
+			});
+			else setActiveItems(void 0);
+		};
+		const handleItemActive = (key) => {
+			updateItemState(key);
+		};
+		const updateAllItemsState = (status) => {
+			if (!status) setActiveItems(/* @__PURE__ */ new Map());
+		};
+		const setItemActive = (key) => {
+			updateItemState(key);
+		};
+		const unsetItemActive = (key) => {
+			updateItemState(key);
+		};
+		const toggleItemActive = (key) => {
+			updateItemState(key);
+		};
+		const unsetAllItemsActive = () => {
+			updateAllItemsState(false);
+		};
+		const isItemActive = (key) => {
+			if (!innerActiveItems) return false;
+			if (type === "single") return innerActiveItems === key;
+			if (type === "multi" && innerActiveItems instanceof Map) return !!innerActiveItems.get(key);
+			return false;
+		};
+		const attachMultipleProps = { unsetAllItemsActive };
+		const attachItemProps = (props) => {
+			const { key } = props;
+			return {
+				...typeof itemProps === "object" ? itemProps : itemProps(props),
+				active: isItemActive(key),
+				handleItemActive: () => handleItemActive(key),
+				setItemActive,
+				unsetItemActive,
+				toggleItemActive,
+				...type === "multi" ? attachMultipleProps : {}
+			};
+		};
+		useEffect(() => {
+			if (type === "single" && Array.isArray(activeItems)) {
+				if (process.env.NODE_ENV !== "production") console.warn("[@vitus-labs/elements] List/withActiveState: `activeItems` was passed as an array but `type` is \"single\". In single selection mode, `activeItems` should be a single key (string | number). The array value will be ignored.");
+			}
+		}, [type, activeItems]);
+		return /* @__PURE__ */ jsx(WrappedComponent, {
+			...rest,
+			itemProps: attachItemProps
+		});
+	};
+	Enhanced.RESERVED_KEYS = RESERVED_KEYS;
+	Enhanced.displayName = `@vitus-labs/elements/List/withActiveState(${displayName})`;
+	return Enhanced;
 };
 
-const Component$4 = ({ DOMLocation, tag = 'div', children, }) => {
-    const [element, setElement] = useState();
-    useEffect(() => {
-        if (!tag)
-            return undefined;
-        const position = DOMLocation ?? document.body;
-        const element = document.createElement(tag);
-        setElement(element);
-        position.appendChild(element);
-        return () => {
-            position.removeChild(element);
-        };
-    }, [tag, DOMLocation]);
-    if (!tag || !element)
-        return null;
-    return createPortal(children, element);
+//#endregion
+//#region src/List/index.ts
+var List_default = Component$5;
+
+//#endregion
+//#region src/Portal/component.ts
+/**
+* Portal component that creates a new DOM element on mount, appends it to
+* the target location (defaults to document.body), and uses React's
+* createPortal to render children into it. The DOM element is cleaned up
+* on unmount. Accepts a custom DOMLocation for rendering into specific
+* containers (e.g., a modal root).
+*/
+const Component$4 = ({ DOMLocation, tag = "div", children }) => {
+	const [element, setElement] = useState();
+	useEffect(() => {
+		if (!tag) return void 0;
+		const position = DOMLocation ?? document.body;
+		const element = document.createElement(tag);
+		setElement(element);
+		position.appendChild(element);
+		return () => {
+			position.removeChild(element);
+		};
+	}, [tag, DOMLocation]);
+	if (!tag || !element) return null;
+	return createPortal(children, element);
 };
-// ----------------------------------------------
-// DEFINE STATICS
-// ----------------------------------------------
 const name$3 = `${PKG_NAME}/Portal`;
 Component$4.displayName = name$3;
 Component$4.pkgName = PKG_NAME;
 Component$4.VITUS_LABS__COMPONENT = name$3;
 
-const context = createContext({});
-const { Provider } = context;
-const useOverlayContext = () => useContext(context);
-const Component$3 = ({ children, blocked, setBlocked, setUnblocked, }) => {
-    const ctx = useMemo(() => ({
-        blocked,
-        setBlocked,
-        setUnblocked,
-    }), [blocked, setBlocked, setUnblocked]);
-    return React.createElement(Provider, { value: ctx }, children);
+//#endregion
+//#region src/Portal/index.ts
+var Portal_default = Component$4;
+
+//#endregion
+//#region src/Overlay/context.tsx
+/**
+* Context for nested overlay coordination. When a child overlay opens, it
+* sets the parent's blocked state to true, preventing the parent from
+* closing in response to click/hover events that belong to the child.
+*/
+const context$1 = createContext({});
+const { Provider: Provider$1 } = context$1;
+const useOverlayContext = () => useContext(context$1);
+const Component = ({ children, blocked, setBlocked, setUnblocked }) => {
+	return /* @__PURE__ */ jsx(Provider$1, {
+		value: useMemo(() => ({
+			blocked,
+			setBlocked,
+			setUnblocked
+		}), [
+			blocked,
+			setBlocked,
+			setUnblocked
+		]),
+		children
+	});
 };
 
-/* eslint-disable no-console */
-const useOverlay = ({ isOpen = false, openOn = 'click', // click | hover
-closeOn = 'click', // click | 'clickOnTrigger' | 'clickOutsideContent' | hover | manual
-type = 'dropdown', // dropdown | tooltip | popover | modal
-position = 'fixed', // absolute | fixed | relative | static
-align = 'bottom', // main align prop top | left | bottom | right
-alignX = 'left', // left | center | right
-alignY = 'bottom', // top | center | bottom
-offsetX = 0, offsetY = 0, throttleDelay = 200, parentContainer, closeOnEsc = true, disabled, onOpen, onClose, } = {}) => {
-    const { rootSize } = useContext(context$1);
-    const ctx = useOverlayContext();
-    const [isContentLoaded, setContentLoaded] = useState(false);
-    const [innerAlignX, setInnerAlignX] = useState(alignX);
-    const [innerAlignY, setInnerAlignY] = useState(alignY);
-    const [blocked, handleBlocked] = useState(false);
-    const [active, handleActive] = useState(isOpen);
-    const triggerRef = useRef(null);
-    const contentRef = useRef(null);
-    const setBlocked = useCallback(() => handleBlocked(true), []);
-    const setUnblocked = useCallback(() => handleBlocked(false), []);
-    const showContent = useCallback(() => {
-        handleActive(true);
-    }, []);
-    const hideContent = useCallback(() => {
-        handleActive(false);
-    }, []);
-    const calculateContentPosition = useCallback(() => {
-        const overlayPosition = {};
-        if (!active || !isContentLoaded)
-            return overlayPosition;
-        if (type === 'modal' && !contentRef.current) {
-            if (IS_DEVELOPMENT) {
-                console.warn('Cannot access `ref` of `content` component.');
-            }
-            return overlayPosition;
-        }
-        if (['dropdown', 'tooltip', 'popover'].includes(type)) {
-            // return empty object when refs are not available
-            if (!triggerRef.current || !contentRef.current) {
-                if (IS_DEVELOPMENT) {
-                    console.warn('Cannot access `ref` of trigger or content component.');
-                }
-                return overlayPosition;
-            }
-            const c = contentRef.current.getBoundingClientRect();
-            const t = triggerRef.current.getBoundingClientRect();
-            // align is top or bottom
-            if (['top', 'bottom'].includes(align)) {
-                // axe Y position
-                // (assigned as top position)
-                const top = t.top - offsetY - c.height;
-                const bottom = t.bottom + offsetY;
-                // axe X position
-                // content position to trigger position
-                // (assigned as left position)
-                const left = t.left + offsetX;
-                const right = t.right - offsetX - c.width;
-                // calculate possible position
-                const isTop = top >= 0; // represents window.height = 0
-                const isBottom = bottom + c.height <= window.innerHeight;
-                const isLeft = left + c.width <= window.innerWidth;
-                const isRight = right >= 0; // represents window.width = 0
-                if (align === 'top') {
-                    setInnerAlignY(isTop ? 'top' : 'bottom');
-                    overlayPosition.top = isTop ? top : bottom;
-                }
-                else if (align === 'bottom') {
-                    setInnerAlignY(isBottom ? 'bottom' : 'top');
-                    overlayPosition.top = isBottom ? bottom : top;
-                }
-                // left
-                if (alignX === 'left') {
-                    setInnerAlignX(isLeft ? 'left' : 'right');
-                    overlayPosition.left = isLeft ? left : right;
-                }
-                // center
-                else if (alignX === 'center') {
-                    const center = t.left + (t.right - t.left) / 2 - c.width / 2;
-                    const isCenteredLeft = center >= 0;
-                    const isCenteredRight = center + c.width <= window.innerWidth;
-                    if (isCenteredLeft && isCenteredRight) {
-                        setInnerAlignX('center');
-                        overlayPosition.left = center;
-                    }
-                    else if (isCenteredLeft) {
-                        setInnerAlignX('left');
-                        overlayPosition.left = left;
-                    }
-                    else if (isCenteredRight) {
-                        setInnerAlignX('right');
-                        overlayPosition.left = right;
-                    }
-                }
-                // right
-                else if (alignX === 'right') {
-                    setInnerAlignX(isRight ? 'right' : 'left');
-                    overlayPosition.left = isRight ? right : left;
-                }
-            }
-            // align is left or right
-            else if (['left', 'right'].includes(align)) {
-                // axe X position
-                // (assigned as left position)
-                const left = t.left - offsetX - c.width;
-                const right = t.right + offsetX;
-                // axe Y position
-                // content position to trigger position
-                // (assigned as top position)
-                const top = t.top + offsetY;
-                const bottom = t.bottom - offsetY - c.height;
-                const isLeft = left >= 0;
-                const isRight = right + c.width <= window.innerWidth;
-                const isTop = top + c.height <= window.innerHeight;
-                const isBottom = bottom >= 0;
-                if (align === 'left') {
-                    setInnerAlignX(isLeft ? 'left' : 'right');
-                    overlayPosition.left = isLeft ? left : right;
-                }
-                else if (align === 'right') {
-                    setInnerAlignX(isRight ? 'right' : 'left');
-                    overlayPosition.left = isRight ? right : left;
-                }
-                // top
-                if (alignY === 'top') {
-                    setInnerAlignY(isTop ? 'top' : 'bottom');
-                    overlayPosition.top = isTop ? top : bottom;
-                }
-                // center
-                else if (alignY === 'center') {
-                    const center = t.top + (t.bottom - t.top) / 2 - c.height / 2;
-                    const isCenteredTop = center >= 0;
-                    const isCenteredBottom = center + c.height <= window.innerHeight;
-                    if (isCenteredTop && isCenteredBottom) {
-                        setInnerAlignY('center');
-                        overlayPosition.top = center;
-                    }
-                    else if (isCenteredTop) {
-                        setInnerAlignY('top');
-                        overlayPosition.top = top;
-                    }
-                    else if (isCenteredBottom) {
-                        setInnerAlignY('bottom');
-                        overlayPosition.top = bottom;
-                    }
-                }
-                // bottom
-                else if (alignY === 'bottom') {
-                    setInnerAlignY(isBottom ? 'bottom' : 'top');
-                    overlayPosition.top = isBottom ? bottom : top;
-                }
-            }
-        }
-        // modal type
-        else if (type === 'modal') {
-            // return empty object when ref is not available
-            // triggerRef is not needed in this case
-            if (!contentRef.current) {
-                if (IS_DEVELOPMENT) {
-                    console.warn('Cannot access `ref` of trigger or content component.');
-                }
-                return overlayPosition;
-            }
-            const c = contentRef.current.getBoundingClientRect();
-            switch (alignX) {
-                case 'right':
-                    overlayPosition.right = offsetX;
-                    break;
-                case 'left':
-                    overlayPosition.left = offsetX;
-                    break;
-                case 'center':
-                    overlayPosition.left = window.innerWidth / 2 - c.width / 2;
-                    break;
-                default:
-                    overlayPosition.right = offsetX;
-            }
-            switch (alignY) {
-                case 'top':
-                    overlayPosition.top = offsetY;
-                    break;
-                case 'center':
-                    overlayPosition.top = window.innerHeight / 2 - c.height / 2;
-                    break;
-                case 'bottom':
-                    overlayPosition.bottom = offsetY;
-                    break;
-                default:
-                    overlayPosition.top = offsetY;
-            }
-        }
-        return overlayPosition;
-    }, [
-        isContentLoaded,
-        active,
-        align,
-        alignX,
-        alignY,
-        offsetX,
-        offsetY,
-        type,
-        triggerRef,
-        contentRef,
-    ]);
-    const assignContentPosition = useCallback((values = {}) => {
-        if (!contentRef.current)
-            return;
-        const isValue = (value) => {
-            if (typeof value === 'number')
-                return true;
-            if (Number.isFinite(value))
-                return true;
-            return !!value;
-        };
-        const setValue = (param) => value(param, rootSize);
-        // ADD POSITION STYLES TO CONTENT
-        // eslint-disable-next-line no-param-reassign
-        if (isValue(position))
-            contentRef.current.style.position = position;
-        // eslint-disable-next-line no-param-reassign
-        if (isValue(values.top))
-            contentRef.current.style.top = setValue(values.top);
-        // eslint-disable-next-line no-param-reassign
-        if (isValue(values.bottom))
-            contentRef.current.style.bottom = setValue(values.bottom);
-        // eslint-disable-next-line no-param-reassign
-        if (isValue(values.left))
-            contentRef.current.style.left = setValue(values.left);
-        // eslint-disable-next-line no-param-reassign
-        if (isValue(values.right))
-            contentRef.current.style.right = setValue(values.right);
-    }, [position, rootSize, contentRef]);
-    const setContentPosition = useCallback(() => {
-        const currentPosition = calculateContentPosition();
-        assignContentPosition(currentPosition);
-    }, [assignContentPosition, calculateContentPosition]);
-    const isNodeOrChild = (ref /* | typeof contentRef */) => (e) => {
-        if (e?.target && ref.current) {
-            return (ref.current.contains(e.target) || e.target === ref.current);
-        }
-        return false;
-    };
-    const handleVisibilityByEventType = useCallback((e) => {
-        if (blocked || disabled)
-            return;
-        const isTrigger = isNodeOrChild(triggerRef);
-        const isContent = isNodeOrChild(contentRef);
-        // showing content observing
-        if (!active) {
-            if ((openOn === 'hover' && e.type === 'mousemove') ||
-                (openOn === 'click' && e.type === 'click')) {
-                if (isTrigger(e)) {
-                    showContent();
-                }
-            }
-        }
-        // hiding content observing
-        if (active) {
-            if (closeOn === 'hover' &&
-                e.type === 'mousemove' &&
-                !isTrigger(e) &&
-                !isContent(e)) {
-                hideContent();
-            }
-            if (closeOn === 'hover' && e.type === 'scroll') {
-                hideContent();
-            }
-            if (closeOn === 'click' && e.type === 'click') {
-                hideContent();
-            }
-            if (closeOn === 'clickOnTrigger' && e.type === 'click') {
-                if (isTrigger(e)) {
-                    hideContent();
-                }
-            }
-            if (closeOn === 'clickOutsideContent' && e.type === 'click') {
-                if (!isContent(e)) {
-                    hideContent();
-                }
-            }
-        }
-    }, [
-        active,
-        blocked,
-        disabled,
-        openOn,
-        closeOn,
-        hideContent,
-        showContent,
-        triggerRef,
-        contentRef,
-    ]);
-    const handleContentPosition = useCallback(throttle(setContentPosition, throttleDelay), 
-    // same deps as `setContentPosition`
-    [assignContentPosition, calculateContentPosition]);
-    const handleClick = handleVisibilityByEventType;
-    const handleVisibility = useCallback(throttle(handleVisibilityByEventType, throttleDelay), 
-    // same deps as `handleVisibilityByEventType`
-    [
-        active,
-        blocked,
-        disabled,
-        openOn,
-        closeOn,
-        hideContent,
-        showContent,
-        triggerRef,
-        contentRef,
-    ]);
-    // --------------------------------------------------------------------------
-    // useEffects
-    // --------------------------------------------------------------------------
-    useEffect(() => {
-        setInnerAlignX(alignX);
-        setInnerAlignY(alignY);
-        if (disabled) {
-            hideContent();
-        }
-    }, [disabled, alignX, alignY, hideContent]);
-    useEffect(() => {
-        if (!active || !isContentLoaded)
-            return undefined;
-        setContentPosition();
-        setContentPosition();
-        return undefined;
-    }, [active, isContentLoaded, setContentPosition]);
-    // if an Overlay has an Overlay child, this will prevent closing parent child
-    // and calculates correct position when an Overlay is opened
-    useEffect(() => {
-        if (active) {
-            if (onOpen)
-                onOpen();
-            if (ctx.setBlocked)
-                ctx.setBlocked();
-        }
-        else {
-            setContentLoaded(false);
-        }
-        return () => {
-            if (onClose)
-                onClose();
-            if (ctx.setUnblocked)
-                ctx.setUnblocked();
-        };
-    }, [active, showContent, ctx]);
-    // handle closing only when content is active
-    useEffect(() => {
-        if (!closeOnEsc || !active || blocked)
-            return undefined;
-        const handleEscKey = (e) => {
-            if (e.key === 'Escape') {
-                hideContent();
-            }
-        };
-        window.addEventListener('keydown', handleEscKey);
-        return () => {
-            window.removeEventListener('keydown', handleEscKey);
-        };
-    }, [active, blocked, closeOnEsc, hideContent]);
-    // handles repositioning of content on document events
-    useEffect(() => {
-        if (!active)
-            return undefined;
-        const shouldSetOverflow = type === 'modal';
-        const onScroll = (e) => {
-            handleContentPosition();
-            handleVisibility(e);
-        };
-        if (shouldSetOverflow)
-            document.body.style.overflow = 'hidden';
-        window.addEventListener('resize', handleContentPosition);
-        window.addEventListener('scroll', onScroll);
-        return () => {
-            if (shouldSetOverflow)
-                document.body.style.overflow = '';
-            window.removeEventListener('resize', handleContentPosition);
-            window.removeEventListener('scroll', onScroll);
-        };
-    }, [active, type, handleVisibility, handleContentPosition]);
-    // handles repositioning of content on a custom element if defined
-    useEffect(() => {
-        if (!active || !parentContainer)
-            return undefined;
-        // eslint-disable-next-line no-param-reassign
-        if (closeOn !== 'hover')
-            parentContainer.style.overflow = 'hidden';
-        const onScroll = (e) => {
-            handleContentPosition();
-            handleVisibility(e);
-        };
-        parentContainer.addEventListener('scroll', onScroll);
-        return () => {
-            // eslint-disable-next-line no-param-reassign
-            parentContainer.style.overflow = '';
-            parentContainer.removeEventListener('scroll', onScroll);
-        };
-    }, [
-        active,
-        parentContainer,
-        closeOn,
-        handleContentPosition,
-        handleVisibility,
-    ]);
-    // enable overlay manipulation only when the state is NOT blocked
-    // nor in disabled state
-    useEffect(() => {
-        if (blocked || disabled)
-            return undefined;
-        const enabledMouseMove = openOn === 'hover' || closeOn === 'hover';
-        const enabledClick = openOn === 'click' ||
-            ['click', 'clickOnTrigger', 'clickOutsideContent'].includes(closeOn);
-        if (enabledClick) {
-            window.addEventListener('click', handleClick);
-        }
-        if (enabledMouseMove) {
-            window.addEventListener('mousemove', handleVisibility);
-        }
-        return () => {
-            window.removeEventListener('click', handleClick);
-            window.removeEventListener('mousemove', handleVisibility);
-        };
-    }, [
-        openOn,
-        closeOn,
-        blocked,
-        disabled,
-        active,
-        handleClick,
-        handleVisibility,
-    ]);
-    // hack-ish way to load content correctly on the first load
-    // as `contentRef` is loaded dynamically
-    const contentRefCallback = useCallback((node) => {
-        if (node) {
-            contentRef.current = node;
-            setContentLoaded(true);
-        }
-    }, []);
-    return {
-        triggerRef,
-        contentRef: contentRefCallback,
-        active,
-        align,
-        alignX: innerAlignX,
-        alignY: innerAlignY,
-        showContent,
-        hideContent,
-        blocked,
-        setBlocked,
-        setUnblocked,
-        Provider: Component$3,
-    };
+//#endregion
+//#region src/Overlay/useOverlay.tsx
+/**
+* Core hook powering the Overlay component. Manages open/close state, DOM
+* event listeners (click, hover, scroll, resize, ESC key), and dynamic
+* positioning of overlay content relative to its trigger. Supports dropdown,
+* tooltip, popover, and modal types with automatic edge-of-viewport flipping.
+* Event handlers are throttled for performance, and nested overlay blocking
+* is coordinated through the overlay context.
+*/
+const sel = (cond, a, b) => cond ? a : b;
+const devWarn = (msg) => {
+	if (!IS_DEVELOPMENT) return;
+	console.warn(msg);
+};
+const calcDropdownVertical = (c, t, align, alignX, offsetX, offsetY) => {
+	const pos = {};
+	const topPos = t.top - offsetY - c.height;
+	const bottomPos = t.bottom + offsetY;
+	const leftPos = t.left + offsetX;
+	const rightPos = t.right - offsetX - c.width;
+	const fitsTop = topPos >= 0;
+	const fitsBottom = bottomPos + c.height <= window.innerHeight;
+	const fitsLeft = leftPos + c.width <= window.innerWidth;
+	const fitsRight = rightPos >= 0;
+	const useTop = sel(align === "top", fitsTop, !fitsBottom);
+	pos.top = sel(useTop, topPos, bottomPos);
+	const resolvedAlignY = sel(useTop, "top", "bottom");
+	let resolvedAlignX = alignX;
+	if (alignX === "left") {
+		pos.left = sel(fitsLeft, leftPos, rightPos);
+		resolvedAlignX = sel(fitsLeft, "left", "right");
+	} else if (alignX === "right") {
+		pos.left = sel(fitsRight, rightPos, leftPos);
+		resolvedAlignX = sel(fitsRight, "right", "left");
+	} else {
+		const center = t.left + (t.right - t.left) / 2 - c.width / 2;
+		const fitsCL = center >= 0;
+		const fitsCR = center + c.width <= window.innerWidth;
+		if (fitsCL && fitsCR) {
+			resolvedAlignX = "center";
+			pos.left = center;
+		} else if (fitsCL) {
+			resolvedAlignX = "left";
+			pos.left = leftPos;
+		} else if (fitsCR) {
+			resolvedAlignX = "right";
+			pos.left = rightPos;
+		}
+	}
+	return {
+		pos,
+		resolvedAlignX,
+		resolvedAlignY
+	};
+};
+const calcDropdownHorizontal = (c, t, align, alignY, offsetX, offsetY) => {
+	const pos = {};
+	const leftPos = t.left - offsetX - c.width;
+	const rightPos = t.right + offsetX;
+	const topPos = t.top + offsetY;
+	const bottomPos = t.bottom - offsetY - c.height;
+	const fitsLeft = leftPos >= 0;
+	const fitsRight = rightPos + c.width <= window.innerWidth;
+	const fitsTop = topPos + c.height <= window.innerHeight;
+	const fitsBottom = bottomPos >= 0;
+	const useLeft = sel(align === "left", fitsLeft, !fitsRight);
+	pos.left = sel(useLeft, leftPos, rightPos);
+	const resolvedAlignX = sel(useLeft, "left", "right");
+	let resolvedAlignY = alignY;
+	if (alignY === "top") {
+		pos.top = sel(fitsTop, topPos, bottomPos);
+		resolvedAlignY = sel(fitsTop, "top", "bottom");
+	} else if (alignY === "bottom") {
+		pos.top = sel(fitsBottom, bottomPos, topPos);
+		resolvedAlignY = sel(fitsBottom, "bottom", "top");
+	} else {
+		const center = t.top + (t.bottom - t.top) / 2 - c.height / 2;
+		const fitsCT = center >= 0;
+		const fitsCB = center + c.height <= window.innerHeight;
+		if (fitsCT && fitsCB) {
+			resolvedAlignY = "center";
+			pos.top = center;
+		} else if (fitsCT) {
+			resolvedAlignY = "top";
+			pos.top = topPos;
+		} else if (fitsCB) {
+			resolvedAlignY = "bottom";
+			pos.top = bottomPos;
+		}
+	}
+	return {
+		pos,
+		resolvedAlignX,
+		resolvedAlignY
+	};
+};
+const calcModalPos = (c, alignX, alignY, offsetX, offsetY) => {
+	const pos = {};
+	switch (alignX) {
+		case "right":
+			pos.right = offsetX;
+			break;
+		case "left":
+			pos.left = offsetX;
+			break;
+		case "center":
+			pos.left = window.innerWidth / 2 - c.width / 2;
+			break;
+		default: pos.right = offsetX;
+	}
+	switch (alignY) {
+		case "top":
+			pos.top = offsetY;
+			break;
+		case "center":
+			pos.top = window.innerHeight / 2 - c.height / 2;
+			break;
+		case "bottom":
+			pos.bottom = offsetY;
+			break;
+		default: pos.top = offsetY;
+	}
+	return pos;
+};
+const adjustForAncestor = (pos, ancestor) => {
+	if (ancestor.top === 0 && ancestor.left === 0) return pos;
+	const result = { ...pos };
+	if (typeof result.top === "number") result.top -= ancestor.top;
+	if (typeof result.bottom === "number") result.bottom += ancestor.top;
+	if (typeof result.left === "number") result.left -= ancestor.left;
+	if (typeof result.right === "number") result.right += ancestor.left;
+	return result;
+};
+const computePosition = (type, align, alignX, alignY, offsetX, offsetY, triggerEl, contentEl, ancestorOffset) => {
+	const isDropdown = [
+		"dropdown",
+		"tooltip",
+		"popover"
+	].includes(type);
+	if (isDropdown && (!triggerEl || !contentEl)) {
+		devWarn(`[@vitus-labs/elements] Overlay (${type}): ${triggerEl ? "contentRef" : "triggerRef"} is not attached. Position cannot be calculated without both refs.`);
+		return { pos: {} };
+	}
+	if (isDropdown && triggerEl && contentEl) {
+		const c = contentEl.getBoundingClientRect();
+		const t = triggerEl.getBoundingClientRect();
+		const result = align === "top" || align === "bottom" ? calcDropdownVertical(c, t, align, alignX, offsetX, offsetY) : calcDropdownHorizontal(c, t, align, alignY, offsetX, offsetY);
+		return {
+			pos: adjustForAncestor(result.pos, ancestorOffset),
+			resolvedAlignX: result.resolvedAlignX,
+			resolvedAlignY: result.resolvedAlignY
+		};
+	}
+	if (type === "modal") {
+		if (!contentEl) {
+			devWarn("[@vitus-labs/elements] Overlay (modal): contentRef is not attached. Modal position cannot be calculated without a content element.");
+			return { pos: {} };
+		}
+		return { pos: adjustForAncestor(calcModalPos(contentEl.getBoundingClientRect(), alignX, alignY, offsetX, offsetY), ancestorOffset) };
+	}
+	return { pos: {} };
+};
+const processVisibilityEvent = (e, active, openOn, closeOn, isTrigger, isContent, showContent, hideContent) => {
+	if (!active && openOn === "click" && e.type === "click" && isTrigger(e)) {
+		showContent();
+		return;
+	}
+	if (!active) return;
+	if (closeOn === "hover" && e.type === "scroll") {
+		hideContent();
+		return;
+	}
+	if (e.type !== "click") return;
+	if (closeOn === "click") hideContent();
+	else if (closeOn === "clickOnTrigger" && isTrigger(e)) hideContent();
+	else if (closeOn === "clickOutsideContent" && !isContent(e)) hideContent();
+};
+const useOverlay = ({ isOpen = false, openOn = "click", closeOn = "click", type = "dropdown", position = "fixed", align = "bottom", alignX = "left", alignY = "bottom", offsetX = 0, offsetY = 0, throttleDelay = 200, parentContainer, closeOnEsc = true, disabled, onOpen, onClose } = {}) => {
+	const { rootSize } = useContext(context);
+	const ctx = useOverlayContext();
+	const [isContentLoaded, setContentLoaded] = useState(false);
+	const [innerAlignX, setInnerAlignX] = useState(alignX);
+	const [innerAlignY, setInnerAlignY] = useState(alignY);
+	const [blocked, handleBlocked] = useState(false);
+	const [active, handleActive] = useState(isOpen);
+	const triggerRef = useRef(null);
+	const contentRef = useRef(null);
+	const setBlocked = useCallback(() => handleBlocked(true), []);
+	const setUnblocked = useCallback(() => handleBlocked(false), []);
+	const showContent = useCallback(() => {
+		handleActive(true);
+	}, []);
+	const hideContent = useCallback(() => {
+		handleActive(false);
+	}, []);
+	const getAncestorOffset = useCallback(() => {
+		if (position !== "absolute" || !contentRef.current) return {
+			top: 0,
+			left: 0
+		};
+		const offsetParent = contentRef.current.offsetParent;
+		if (!offsetParent || offsetParent === document.body) return {
+			top: 0,
+			left: 0
+		};
+		const rect = offsetParent.getBoundingClientRect();
+		return {
+			top: rect.top,
+			left: rect.left
+		};
+	}, [position]);
+	const calculateContentPosition = useCallback(() => {
+		if (!active || !isContentLoaded) return {};
+		const result = computePosition(type, align, alignX, alignY, offsetX, offsetY, triggerRef.current, contentRef.current, getAncestorOffset());
+		if (result.resolvedAlignX) setInnerAlignX(result.resolvedAlignX);
+		if (result.resolvedAlignY) setInnerAlignY(result.resolvedAlignY);
+		return result.pos;
+	}, [
+		isContentLoaded,
+		active,
+		align,
+		alignX,
+		alignY,
+		offsetX,
+		offsetY,
+		type,
+		getAncestorOffset
+	]);
+	const assignContentPosition = useCallback((values = {}) => {
+		if (!contentRef.current) return;
+		const el = contentRef.current;
+		const setValue = (param) => value(param, rootSize);
+		el.style.position = position;
+		el.style.top = values.top != null ? setValue(values.top) : "";
+		el.style.bottom = values.bottom != null ? setValue(values.bottom) : "";
+		el.style.left = values.left != null ? setValue(values.left) : "";
+		el.style.right = values.right != null ? setValue(values.right) : "";
+	}, [position, rootSize]);
+	const setContentPosition = useCallback(() => {
+		assignContentPosition(calculateContentPosition());
+	}, [assignContentPosition, calculateContentPosition]);
+	const isNodeOrChild = useCallback((ref) => (e) => {
+		if (e?.target && ref.current) return ref.current.contains(e.target) || e.target === ref.current;
+		return false;
+	}, []);
+	const handleVisibilityByEventType = useCallback((e) => {
+		if (blocked || disabled) return;
+		processVisibilityEvent(e, active, openOn, closeOn, isNodeOrChild(triggerRef), isNodeOrChild(contentRef), showContent, hideContent);
+	}, [
+		active,
+		blocked,
+		disabled,
+		openOn,
+		closeOn,
+		hideContent,
+		showContent,
+		isNodeOrChild
+	]);
+	const latestSetContentPosition = useRef(setContentPosition);
+	latestSetContentPosition.current = setContentPosition;
+	const latestHandleVisibility = useRef(handleVisibilityByEventType);
+	latestHandleVisibility.current = handleVisibilityByEventType;
+	const handleContentPosition = useMemo(() => throttle(() => latestSetContentPosition.current(), throttleDelay), [throttleDelay]);
+	const handleClick = handleVisibilityByEventType;
+	const handleVisibility = useMemo(() => throttle((e) => latestHandleVisibility.current(e), throttleDelay), [throttleDelay]);
+	useEffect(() => {
+		setInnerAlignX(alignX);
+		setInnerAlignY(alignY);
+		if (disabled) hideContent();
+	}, [
+		disabled,
+		alignX,
+		alignY,
+		hideContent
+	]);
+	useEffect(() => {
+		if (!active || !isContentLoaded) return void 0;
+		setContentPosition();
+		const rafId = requestAnimationFrame(() => setContentPosition());
+		return () => cancelAnimationFrame(rafId);
+	}, [
+		active,
+		isContentLoaded,
+		setContentPosition
+	]);
+	const prevActiveRef = useRef(false);
+	useEffect(() => {
+		const wasActive = prevActiveRef.current;
+		prevActiveRef.current = active;
+		if (active && !wasActive) {
+			onOpen?.();
+			ctx.setBlocked?.();
+		} else if (!active && wasActive) {
+			setContentLoaded(false);
+			onClose?.();
+			ctx.setUnblocked?.();
+		} else if (!active) setContentLoaded(false);
+		return () => {
+			if (active) {
+				onClose?.();
+				ctx.setUnblocked?.();
+			}
+		};
+	}, [
+		active,
+		ctx,
+		onClose,
+		onOpen
+	]);
+	useEffect(() => {
+		if (!closeOnEsc || !active || blocked) return void 0;
+		const handleEscKey = (e) => {
+			if (e.key === "Escape") hideContent();
+		};
+		window.addEventListener("keydown", handleEscKey);
+		return () => {
+			window.removeEventListener("keydown", handleEscKey);
+		};
+	}, [
+		active,
+		blocked,
+		closeOnEsc,
+		hideContent
+	]);
+	useEffect(() => {
+		if (!active) return void 0;
+		const shouldSetOverflow = type === "modal";
+		const onScroll = (e) => {
+			handleContentPosition();
+			handleVisibility(e);
+		};
+		if (shouldSetOverflow) document.body.style.overflow = "hidden";
+		window.addEventListener("resize", handleContentPosition);
+		window.addEventListener("scroll", onScroll, { passive: true });
+		return () => {
+			if (shouldSetOverflow) document.body.style.overflow = "";
+			window.removeEventListener("resize", handleContentPosition);
+			window.removeEventListener("scroll", onScroll);
+		};
+	}, [
+		active,
+		type,
+		handleVisibility,
+		handleContentPosition
+	]);
+	useEffect(() => {
+		if (!active || !parentContainer) return void 0;
+		if (closeOn !== "hover") parentContainer.style.overflow = "hidden";
+		const onScroll = (e) => {
+			handleContentPosition();
+			handleVisibility(e);
+		};
+		parentContainer.addEventListener("scroll", onScroll, { passive: true });
+		return () => {
+			parentContainer.style.overflow = "";
+			parentContainer.removeEventListener("scroll", onScroll);
+		};
+	}, [
+		active,
+		parentContainer,
+		closeOn,
+		handleContentPosition,
+		handleVisibility
+	]);
+	useEffect(() => {
+		if (blocked || disabled) return void 0;
+		if (openOn === "click" || [
+			"click",
+			"clickOnTrigger",
+			"clickOutsideContent"
+		].includes(closeOn)) window.addEventListener("click", handleClick);
+		return () => {
+			window.removeEventListener("click", handleClick);
+		};
+	}, [
+		openOn,
+		closeOn,
+		blocked,
+		disabled,
+		handleClick
+	]);
+	const hoverTimeoutRef = useRef(null);
+	useEffect(() => {
+		if (blocked || disabled || !(openOn === "hover" || closeOn === "hover")) return void 0;
+		const trigger = triggerRef.current;
+		const content = contentRef.current;
+		const clearHoverTimeout = () => {
+			if (hoverTimeoutRef.current != null) {
+				clearTimeout(hoverTimeoutRef.current);
+				hoverTimeoutRef.current = null;
+			}
+		};
+		const scheduleHide = () => {
+			clearHoverTimeout();
+			hoverTimeoutRef.current = setTimeout(hideContent, 100);
+		};
+		const onTriggerEnter = () => {
+			clearHoverTimeout();
+			if (openOn === "hover" && !active) showContent();
+		};
+		const onTriggerLeave = () => {
+			if (closeOn === "hover" && active) scheduleHide();
+		};
+		const onContentEnter = () => {
+			clearHoverTimeout();
+		};
+		const onContentLeave = () => {
+			if (closeOn === "hover" && active) scheduleHide();
+		};
+		if (trigger) {
+			trigger.addEventListener("mouseenter", onTriggerEnter);
+			trigger.addEventListener("mouseleave", onTriggerLeave);
+		}
+		if (content) {
+			content.addEventListener("mouseenter", onContentEnter);
+			content.addEventListener("mouseleave", onContentLeave);
+		}
+		return () => {
+			clearHoverTimeout();
+			if (trigger) {
+				trigger.removeEventListener("mouseenter", onTriggerEnter);
+				trigger.removeEventListener("mouseleave", onTriggerLeave);
+			}
+			if (content) {
+				content.removeEventListener("mouseenter", onContentEnter);
+				content.removeEventListener("mouseleave", onContentLeave);
+			}
+		};
+	}, [
+		active,
+		isContentLoaded,
+		blocked,
+		disabled,
+		openOn,
+		closeOn,
+		showContent,
+		hideContent
+	]);
+	return {
+		triggerRef,
+		contentRef: useCallback((node) => {
+			if (node) {
+				contentRef.current = node;
+				setContentLoaded(true);
+			}
+		}, []),
+		active,
+		align,
+		alignX: innerAlignX,
+		alignY: innerAlignY,
+		showContent,
+		hideContent,
+		blocked,
+		setBlocked,
+		setUnblocked,
+		Provider: Component
+	};
 };
 
-const IS_BROWSER = typeof window !== 'undefined';
-const Component$2 = ({ children, trigger, DOMLocation, triggerRefName = 'ref', contentRefName = 'ref', ...props }) => {
-    const { active, triggerRef, contentRef, showContent, hideContent, align, alignX, alignY, Provider, ...ctx } = useOverlay(props);
-    const { openOn, closeOn } = props;
-    const passHandlers = useMemo(() => openOn === 'manual' ||
-        closeOn === 'manual' ||
-        closeOn === 'clickOutsideContent', [openOn, closeOn]);
-    return (React.createElement(React.Fragment, null,
-        render(trigger, {
-            [triggerRefName]: triggerRef,
-            active,
-            ...(passHandlers ? { showContent, hideContent } : {}),
-        }),
-        IS_BROWSER && active && (React.createElement(Component$4, { DOMLocation: DOMLocation },
-            React.createElement(Provider, { ...ctx }, render(children, {
-                [contentRefName]: contentRef,
-                active,
-                align,
-                alignX,
-                alignY,
-                ...(passHandlers ? { showContent, hideContent } : {}),
-            }))))));
+//#endregion
+//#region src/Overlay/component.tsx
+/**
+* Overlay component that renders a trigger element and conditionally shows
+* content via a Portal. The trigger receives a ref and optional show/hide
+* callbacks; the content is positioned and managed by the useOverlay hook.
+* A context Provider wraps the content to support nested overlays (e.g.,
+* a dropdown inside another dropdown) via blocked-state propagation.
+*/
+const IS_BROWSER = typeof window !== "undefined";
+const Component$3 = ({ children, trigger, DOMLocation, triggerRefName = "ref", contentRefName = "ref", ...props }) => {
+	const { active, triggerRef, contentRef, showContent, hideContent, align, alignX, alignY, Provider, ...ctx } = useOverlay(props);
+	const { openOn, closeOn } = props;
+	const passHandlers = useMemo(() => openOn === "manual" || closeOn === "manual" || closeOn === "clickOutsideContent", [openOn, closeOn]);
+	return /* @__PURE__ */ jsxs(Fragment, { children: [render(trigger, {
+		[triggerRefName]: triggerRef,
+		active,
+		...passHandlers ? {
+			showContent,
+			hideContent
+		} : {}
+	}), IS_BROWSER && active && /* @__PURE__ */ jsx(Portal_default, {
+		DOMLocation,
+		children: /* @__PURE__ */ jsx(Provider, {
+			...ctx,
+			children: render(children, {
+				[contentRefName]: contentRef,
+				active,
+				align,
+				alignX,
+				alignY,
+				...passHandlers ? {
+					showContent,
+					hideContent
+				} : {}
+			})
+		})
+	})] });
 };
 const name$2 = `${PKG_NAME}/Overlay`;
-Component$2.displayName = name$2;
-Component$2.pkgName = PKG_NAME;
-Component$2.VITUS_LABS__COMPONENT = name$2;
+Component$3.displayName = name$2;
+Component$3.pkgName = PKG_NAME;
+Component$3.VITUS_LABS__COMPONENT = name$2;
 
+//#endregion
+//#region src/Overlay/index.ts
+var Overlay_default = Component$3;
+
+//#endregion
+//#region src/Text/styled.ts
+/**
+* Styled text primitive that inherits color, font-weight, and line-height
+* from its parent so it blends seamlessly into any context. Additional
+* styles can be injected via the responsive `extraStyles` prop processed
+* through makeItResponsive.
+*/
 const { styled, css, textComponent } = config;
-const styles = ({ css, theme: t }) => css `
+const styles = ({ css, theme: t }) => css`
   ${t.extraStyles && extendCss(t.extraStyles)};
 `;
-var Styled = styled(textComponent) `
+var styled_default = styled(textComponent)`
   color: inherit;
   font-weight: inherit;
   line-height: 1;
 
   ${makeItResponsive({
-    key: '$text',
-    styles,
-    css,
-    normalize: false,
+	key: "$text",
+	styles,
+	css,
+	normalize: false
 })};
 `;
 
-const Component$1 = forwardRef(({ paragraph, label, children, tag, css, ...props }, ref) => {
-    const renderContent = (as = undefined) => (React.createElement(Styled, { ref: ref, as: as, "$text": { extraStyles: css }, ...props }, children ?? label));
-    let finalTag;
-    return renderContent(finalTag);
+//#endregion
+//#region src/Text/component.tsx
+const Component$2 = forwardRef(({ paragraph, label, children, tag, css, ...props }, ref) => {
+	const renderContent = (as = void 0) => /* @__PURE__ */ jsx(styled_default, {
+		ref,
+		as,
+		$text: { extraStyles: css },
+		...props,
+		children: children ?? label
+	});
+	let finalTag;
+	return renderContent(finalTag);
 });
-// ----------------------------------------------
-// DEFINE STATICS
-// ----------------------------------------------
 const name$1 = `${PKG_NAME}/Text`;
-Component$1.displayName = name$1;
-Component$1.pkgName = PKG_NAME;
-Component$1.VITUS_LABS__COMPONENT = name$1;
-Component$1.isText = true;
+Component$2.displayName = name$1;
+Component$2.pkgName = PKG_NAME;
+Component$2.VITUS_LABS__COMPONENT = name$1;
+Component$2.isText = true;
+
+//#endregion
+//#region src/Text/index.ts
+var Text_default = Component$2;
 
-const Component = ({ children, className, style }) => {
-    const mergedClasses = useMemo(() => (Array.isArray(className) ? className.join(' ') : className), [className]);
-    const finalProps = {};
-    if (style)
-        finalProps.style = style;
-    if (mergedClasses)
-        finalProps.className = mergedClasses;
-    return render(children, finalProps);
+//#endregion
+//#region src/Util/component.tsx
+/**
+* Utility wrapper that injects className and/or style props into its
+* children without adding any DOM nodes of its own. Uses the core `render`
+* helper to clone children with the merged props.
+*/
+const Component$1 = ({ children, className, style }) => {
+	const mergedClasses = useMemo(() => Array.isArray(className) ? className.join(" ") : className, [className]);
+	const finalProps = {};
+	if (style) finalProps.style = style;
+	if (mergedClasses) finalProps.className = mergedClasses;
+	return render(children, finalProps);
 };
 const name = `${PKG_NAME}/Util`;
-Component.displayName = name;
-Component.pkgName = PKG_NAME;
-Component.VITUS_LABS__COMPONENT = name;
+Component$1.displayName = name;
+Component$1.pkgName = PKG_NAME;
+Component$1.VITUS_LABS__COMPONENT = name;
+
+//#endregion
+//#region src/Util/index.ts
+var Util_default = Component$1;
 
-export { Component$7 as Element, Component$5 as List, Component$2 as Overlay, Component$3 as OverlayProvider, Component$4 as Portal, Component$1 as Text, Component as Util, useOverlay, component as withActiveState, withEqualBeforeAfter as withEqualSizeBeforeAfter };
-//# sourceMappingURL=vitus-labs-elements.native.js.map
+//#endregion
+export { Element_default as Element, List_default as List, Overlay_default as Overlay, Component as OverlayProvider, Portal_default as Portal, Provider, Text_default as Text, Util_default as Util, useOverlay, component as withActiveState, withEqualBeforeAfter as withEqualSizeBeforeAfter };
+//# sourceMappingURL=vitus-labs-elements.native.js.map