@coreui/react-pro 5.20.0 → 5.22.0

package/dist/cjs/components/dropdown/CDropdownToggle.js

@@ -8,11 +8,11 @@ var CButton = require('../button/CButton.js');
 var CDropdownContext = require('./CDropdownContext.js');
 var props = require('../../props.js');
 
-var CDropdownToggle = function (_a) {
-    var children = _a.children, _b = _a.caret, caret = _b === void 0 ? true : _b, custom = _a.custom, className = _a.className, _c = _a.navLink, navLink = _c === void 0 ? true : _c, split = _a.split, _d = _a.trigger, trigger = _d === void 0 ? 'click' : _d, rest = tslib_es6.__rest(_a, ["children", "caret", "custom", "className", "navLink", "split", "trigger"]);
-    var _e = React.useContext(CDropdownContext.CDropdownContext), dropdownToggleRef = _e.dropdownToggleRef, handleHide = _e.handleHide, handleShow = _e.handleShow, variant = _e.variant, visible = _e.visible;
-    var triggers = tslib_es6.__assign(tslib_es6.__assign({}, ((trigger === 'click' || trigger.includes('click')) && {
-        onClick: function (event) {
+const CDropdownToggle = (_a) => {
+    var { children, caret = true, custom, className, navLink = true, split, splitLabel = 'Toggle Dropdown', trigger = 'click' } = _a, rest = tslib_es6.__rest(_a, ["children", "caret", "custom", "className", "navLink", "split", "splitLabel", "trigger"]);
+    const { dropdownToggleRef, handleHide, handleShow, variant, visible } = React.useContext(CDropdownContext.CDropdownContext);
+    const triggers = Object.assign(Object.assign(Object.assign({}, ((trigger === 'click' || trigger.includes('click')) && {
+        onClick: (event) => {
             event.preventDefault();
             if (visible) {
                 handleHide === null || handleHide === void 0 ? void 0 : handleHide();
@@ -22,24 +22,29 @@ var CDropdownToggle = function (_a) {
             }
         },
     })), ((trigger === 'focus' || trigger.includes('focus')) && {
-        onFocus: function () { return handleShow === null || handleShow === void 0 ? void 0 : handleShow(); },
-        onBlur: function () { return handleHide === null || handleHide === void 0 ? void 0 : handleHide(); },
-    }));
-    var togglerProps = tslib_es6.__assign({ className: index.default({
+        onFocus: () => handleShow === null || handleShow === void 0 ? void 0 : handleShow(),
+        onBlur: () => handleHide === null || handleHide === void 0 ? void 0 : handleHide(),
+    })), { onKeyDown: (event) => {
+            if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+                event.preventDefault();
+                handleShow === null || handleShow === void 0 ? void 0 : handleShow(event.nativeEvent);
+            }
+        } });
+    const togglerProps = Object.assign({ className: index.default({
             'nav-link': variant === 'nav-item' && navLink,
             'dropdown-toggle': caret,
             'dropdown-toggle-split': split,
             show: visible,
-        }, className), 'aria-expanded': visible }, (!rest.disabled && tslib_es6.__assign({}, triggers)));
+        }, className), 'aria-expanded': visible }, (!rest.disabled && Object.assign({}, triggers)));
     if (custom && React.isValidElement(children)) {
-        return (React.createElement(React.Fragment, null, React.cloneElement(children, tslib_es6.__assign(tslib_es6.__assign({ 'aria-expanded': visible }, (!rest.disabled && tslib_es6.__assign({}, triggers))), { ref: dropdownToggleRef }))));
+        return (React.createElement(React.Fragment, null, React.cloneElement(children, Object.assign(Object.assign({ 'aria-expanded': visible }, (!rest.disabled && Object.assign({}, triggers))), { ref: dropdownToggleRef }))));
     }
     if (variant === 'nav-item' && navLink) {
-        return (React.createElement("a", tslib_es6.__assign({ href: "#" }, togglerProps, { role: "button" }, rest, { ref: dropdownToggleRef }), children));
+        return (React.createElement("a", Object.assign({ href: "#" }, togglerProps, { role: "button" }, rest, { ref: dropdownToggleRef }), children));
     }
-    return (React.createElement(CButton.CButton, tslib_es6.__assign({}, togglerProps, { tabIndex: 0 }, rest, { ref: dropdownToggleRef }),
+    return (React.createElement(CButton.CButton, Object.assign({}, togglerProps, { tabIndex: 0 }, rest, { ref: dropdownToggleRef }),
         children,
-        split && React.createElement("span", { className: "visually-hidden" }, "Toggle Dropdown")));
+        split && React.createElement("span", { className: "visually-hidden" }, splitLabel)));
 };
 CDropdownToggle.propTypes = {
     caret: PropTypes.bool,
@@ -47,6 +52,7 @@ CDropdownToggle.propTypes = {
     className: PropTypes.string,
     custom: PropTypes.bool,
     split: PropTypes.bool,
+    splitLabel: PropTypes.string,
     trigger: props.triggerPropType,
 };
 CDropdownToggle.displayName = 'CDropdownToggle';

package/dist/cjs/components/dropdown/CDropdownToggle.js.map

@@ -1 +1 @@
-{"version":3,"file":"CDropdownToggle.js","sources":["../../../../src/components/dropdown/CDropdownToggle.tsx"],"sourcesContent":[null],"names":["__rest","useContext","CDropdownContext","__assign","classNames","CButton","triggerPropType"],"mappings":"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"}
+{"version":3,"file":"CDropdownToggle.js","sources":["../../../../src/components/dropdown/CDropdownToggle.tsx"],"sourcesContent":[null],"names":["__rest","useContext","CDropdownContext","classNames","CButton","triggerPropType"],"mappings":"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"}

package/dist/cjs/components/dropdown/utils.d.ts

@@ -1,5 +1,7 @@
+import React from 'react';
 import type { Placement } from '@popperjs/core';
 import type { Placements } from '../../types';
 import type { Alignments } from './types';
 export declare const getAlignmentClassNames: (alignment: Alignments) => string[];
 export declare const getPlacement: (placement: Placement, direction: string | undefined, alignment: Alignments | string | undefined, isRTL: boolean) => Placements;
+export declare const getReferenceElement: (reference: "parent" | "toggle" | React.RefObject<HTMLElement | null> | HTMLElement, dropdownToggleElement: HTMLElement | null, dropdownRef: React.RefObject<HTMLElement | null>) => HTMLElement | null;

package/dist/cjs/components/dropdown/utils.js

@@ -1,19 +1,19 @@
 'use strict';
 
-var getAlignmentClassNames = function (alignment) {
-    var classNames = [];
+const getAlignmentClassNames = (alignment) => {
+    const classNames = [];
     if (typeof alignment === 'object') {
-        for (var key in alignment) {
-            classNames.push("dropdown-menu".concat(key === 'xs' ? '' : "-".concat(key), "-").concat(alignment[key]));
+        for (const key in alignment) {
+            classNames.push(`dropdown-menu${key === 'xs' ? '' : `-${key}`}-${alignment[key]}`);
         }
     }
     if (typeof alignment === 'string') {
-        classNames.push("dropdown-menu-".concat(alignment));
+        classNames.push(`dropdown-menu-${alignment}`);
     }
     return classNames;
 };
-var getPlacement = function (placement, direction, alignment, isRTL) {
-    var _placement = placement;
+const getPlacement = (placement, direction, alignment, isRTL) => {
+    let _placement = placement;
     if (direction === 'dropup') {
         _placement = isRTL ? 'top-end' : 'top-start';
     }
@@ -31,7 +31,20 @@ var getPlacement = function (placement, direction, alignment, isRTL) {
     }
     return _placement;
 };
+const getReferenceElement = (reference, dropdownToggleElement, dropdownRef) => {
+    if (reference === 'parent') {
+        return dropdownRef.current;
+    }
+    if (reference instanceof HTMLElement) {
+        return reference;
+    }
+    if (reference instanceof Object && 'current' in reference) {
+        return reference.current;
+    }
+    return dropdownToggleElement;
+};
 
 exports.getAlignmentClassNames = getAlignmentClassNames;
 exports.getPlacement = getPlacement;
+exports.getReferenceElement = getReferenceElement;
 //# sourceMappingURL=utils.js.map

package/dist/cjs/components/dropdown/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sources":["../../../../src/components/dropdown/utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIO,IAAM,sBAAsB,GAAG,UAAC,SAAqB,EAAA;IAC1D,IAAM,UAAU,GAAa,EAAE;AAC/B,IAAA,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE;AACjC,QAAA,KAAK,IAAM,GAAG,IAAI,SAAS,EAAE;YAC3B,UAAU,CAAC,IAAI,CACb,eAAA,CAAA,MAAA,CAAgB,GAAG,KAAK,IAAI,GAAG,EAAE,GAAG,GAAA,CAAA,MAAA,CAAI,GAAG,CAAE,EAAA,GAAA,CAAA,CAAA,MAAA,CAAI,SAAS,CAAC,GAAwB,CAAC,CAAE,CACvF;QACH;IACF;AAEA,IAAA,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE;AACjC,QAAA,UAAU,CAAC,IAAI,CAAC,wBAAiB,SAAS,CAAE,CAAC;IAC/C;AAEA,IAAA,OAAO,UAAU;AACnB;AAEO,IAAM,YAAY,GAAG,UAC1B,SAAoB,EACpB,SAA6B,EAC7B,SAA0C,EAC1C,KAAc,EAAA;IAEd,IAAI,UAAU,GAAG,SAAS;AAE1B,IAAA,IAAI,SAAS,KAAK,QAAQ,EAAE;QAC1B,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW;IAC9C;AAEA,IAAA,IAAI,SAAS,KAAK,eAAe,EAAE;QACjC,UAAU,GAAG,KAAK;IACpB;AAEA,IAAA,IAAI,SAAS,KAAK,SAAS,EAAE;QAC3B,UAAU,GAAG,KAAK,GAAG,YAAY,GAAG,aAAa;IACnD;AAEA,IAAA,IAAI,SAAS,KAAK,WAAW,EAAE;QAC7B,UAAU,GAAG,KAAK,GAAG,aAAa,GAAG,YAAY;IACnD;AAEA,IAAA,IAAI,SAAS,KAAK,KAAK,EAAE;QACvB,UAAU,GAAG,KAAK,GAAG,cAAc,GAAG,YAAY;IACpD;AAEA,IAAA,OAAO,UAAU;AACnB;;;;;"}
+{"version":3,"file":"utils.js","sources":["../../../../src/components/dropdown/utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKO,MAAM,sBAAsB,GAAG,CAAC,SAAqB,KAAI;IAC9D,MAAM,UAAU,GAAa,EAAE;AAC/B,IAAA,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE;AACjC,QAAA,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE;YAC3B,UAAU,CAAC,IAAI,CACb,CAAA,aAAA,EAAgB,GAAG,KAAK,IAAI,GAAG,EAAE,GAAG,CAAA,CAAA,EAAI,GAAG,CAAA,CAAE,CAAA,CAAA,EAAI,SAAS,CAAC,GAAwB,CAAC,CAAA,CAAE,CACvF;QACH;IACF;AAEA,IAAA,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE;AACjC,QAAA,UAAU,CAAC,IAAI,CAAC,iBAAiB,SAAS,CAAA,CAAE,CAAC;IAC/C;AAEA,IAAA,OAAO,UAAU;AACnB;AAEO,MAAM,YAAY,GAAG,CAC1B,SAAoB,EACpB,SAA6B,EAC7B,SAA0C,EAC1C,KAAc,KACA;IACd,IAAI,UAAU,GAAG,SAAS;AAE1B,IAAA,IAAI,SAAS,KAAK,QAAQ,EAAE;QAC1B,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW;IAC9C;AAEA,IAAA,IAAI,SAAS,KAAK,eAAe,EAAE;QACjC,UAAU,GAAG,KAAK;IACpB;AAEA,IAAA,IAAI,SAAS,KAAK,SAAS,EAAE;QAC3B,UAAU,GAAG,KAAK,GAAG,YAAY,GAAG,aAAa;IACnD;AAEA,IAAA,IAAI,SAAS,KAAK,WAAW,EAAE;QAC7B,UAAU,GAAG,KAAK,GAAG,aAAa,GAAG,YAAY;IACnD;AAEA,IAAA,IAAI,SAAS,KAAK,KAAK,EAAE;QACvB,UAAU,GAAG,KAAK,GAAG,cAAc,GAAG,YAAY;IACpD;AAEA,IAAA,OAAO,UAAU;AACnB;AAEO,MAAM,mBAAmB,GAAG,CACjC,SAAkF,EAClF,qBAAyC,EACzC,WAAgD,KAC1B;AACtB,IAAA,IAAI,SAAS,KAAK,QAAQ,EAAE;QAC1B,OAAO,WAAW,CAAC,OAAO;IAC5B;AAEA,IAAA,IAAI,SAAS,YAAY,WAAW,EAAE;AACpC,QAAA,OAAO,SAAS;IAClB;IAEA,IAAI,SAAS,YAAY,MAAM,IAAI,SAAS,IAAI,SAAS,EAAE;QACzD,OAAO,SAAS,CAAC,OAAO;IAC1B;AAEA,IAAA,OAAO,qBAAqB;AAC9B;;;;;;"}

package/dist/cjs/components/element-cover/CElementCover.js

@@ -8,42 +8,41 @@ require('@popperjs/core');
 var useForkedRef = require('../../hooks/useForkedRef.js');
 var CSpinner = require('../spinner/CSpinner.js');
 
-var CElementCover = React.forwardRef(function (_a, ref) {
-    var children = _a.children, className = _a.className, boundaries = _a.boundaries, _b = _a.opacity, opacity = _b === void 0 ? 0.4 : _b, rest = tslib_es6.__rest(_a, ["children", "className", "boundaries", "opacity"]);
-    var elementCoverRef = React.useRef(null);
-    var forkedRef = useForkedRef.useForkedRef(ref, elementCoverRef);
-    var _c = React.useState({}), customBoundaries = _c[0], setCustomBoundaries = _c[1];
-    var getCustomBoundaries = function () {
+const CElementCover = React.forwardRef((_a, ref) => {
+    var { children, className, boundaries, opacity = 0.4 } = _a, rest = tslib_es6.__rest(_a, ["children", "className", "boundaries", "opacity"]);
+    const elementCoverRef = React.useRef(null);
+    const forkedRef = useForkedRef.useForkedRef(ref, elementCoverRef);
+    const [customBoundaries, setCustomBoundaries] = React.useState({});
+    const getCustomBoundaries = () => {
         if (!elementCoverRef || !elementCoverRef.current || !boundaries) {
             return {};
         }
-        var parent = elementCoverRef.current.parentElement;
+        const parent = elementCoverRef.current.parentElement;
         if (!parent) {
             return {};
         }
-        var parentCoords = parent.getBoundingClientRect();
-        var customBoundaries = {};
-        boundaries.forEach(function (_a) {
-            var sides = _a.sides, query = _a.query;
-            var element = parent.querySelector(query);
+        const parentCoords = parent.getBoundingClientRect();
+        const customBoundaries = {};
+        boundaries.forEach(({ sides, query }) => {
+            const element = parent.querySelector(query);
             if (!element || !sides) {
                 return;
             }
-            var coords = element.getBoundingClientRect();
-            sides.forEach(function (side) {
-                var sideMargin = Math.abs(coords[side] - parentCoords[side]);
-                customBoundaries[side] = "".concat(sideMargin, "px");
+            const coords = element.getBoundingClientRect();
+            sides.forEach((side) => {
+                const sideMargin = Math.abs(coords[side] - parentCoords[side]);
+                customBoundaries[side] = `${sideMargin}px`;
             });
         });
         return customBoundaries;
     };
-    React.useEffect(function () {
+    React.useEffect(() => {
         setCustomBoundaries(getCustomBoundaries());
     }, [JSON.stringify(getCustomBoundaries())]);
-    var classes = index.default(className);
-    var containerCoords = tslib_es6.__assign({ top: 0, left: 0, right: 0, bottom: 0 }, customBoundaries);
-    var coverStyles = tslib_es6.__assign(tslib_es6.__assign({}, containerCoords), { position: 'absolute', zIndex: 2, backgroundColor: "rgba(255,255,255,".concat(opacity, ")") });
-    return (React.createElement("div", tslib_es6.__assign({ className: classes, style: coverStyles }, rest, { ref: forkedRef }),
+    const classes = index.default(className);
+    const containerCoords = Object.assign({ top: 0, left: 0, right: 0, bottom: 0 }, customBoundaries);
+    const coverStyles = Object.assign(Object.assign({}, containerCoords), { position: 'absolute', zIndex: 2, backgroundColor: `rgba(255,255,255,${opacity})` });
+    return (React.createElement("div", Object.assign({ className: classes, style: coverStyles }, rest, { ref: forkedRef }),
         React.createElement("div", { style: {
                 position: 'absolute',
                 top: '50%',

package/dist/cjs/components/element-cover/CElementCover.js.map

@@ -1 +1 @@
-{"version":3,"file":"CElementCover.js","sources":["../../../../src/components/element-cover/CElementCover.tsx"],"sourcesContent":[null],"names":["forwardRef","__rest","useRef","useForkedRef","useState","useEffect","classNames","__assign","CSpinner"],"mappings":"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"}
+{"version":3,"file":"CElementCover.js","sources":["../../../../src/components/element-cover/CElementCover.tsx"],"sourcesContent":[null],"names":["forwardRef","__rest","useRef","useForkedRef","useState","useEffect","classNames","CSpinner"],"mappings":"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"}

package/dist/cjs/components/focus-trap/CFocusTrap.d.ts

@@ -0,0 +1,59 @@
+import React, { FC, ReactElement } from 'react';
+export interface CFocusTrapProps {
+    /**
+     * Controls whether the focus trap is active or inactive.
+     * When `true`, focus will be trapped within the child element.
+     * When `false`, normal focus behavior is restored.
+     *
+     * @default true
+     */
+    active?: boolean;
+    /**
+     * Additional container elements to include in the focus trap.
+     * Useful for floating elements like tooltips or popovers that are
+     * rendered outside the main container but should be part of the trap.
+     */
+    additionalContainer?: React.RefObject<HTMLElement | null>;
+    /**
+     * Single React element that renders a DOM node and forwards refs properly.
+     * The focus trap will be applied to this element and all its focusable descendants.
+     *
+     * Requirements:
+     * - Must be a single ReactElement (not an array or fragment)
+     * - Must forward the ref to a DOM element
+     * - Should contain focusable elements for proper trap behavior
+     */
+    children: ReactElement;
+    /**
+     * Controls whether to focus the first selectable element or the container itself.
+     * When `true`, focuses the first tabbable element within the container.
+     * When `false`, focuses the container element directly.
+     *
+     * This is useful for containers that should receive focus themselves,
+     * such as scrollable regions or custom interactive components.
+     *
+     * @default false
+     */
+    focusFirstElement?: boolean;
+    /**
+     * Callback function invoked when the focus trap becomes active.
+     * Useful for triggering additional accessibility announcements or analytics.
+     */
+    onActivate?: () => void;
+    /**
+     * Callback function invoked when the focus trap is deactivated.
+     * Can be used for cleanup, analytics, or triggering state changes.
+     */
+    onDeactivate?: () => void;
+    /**
+     * Automatically restores focus to the previously focused element when the trap is deactivated.
+     * This is crucial for accessibility as it maintains the user's place in the document
+     * when returning from modal dialogs or overlay components.
+     *
+     * Recommended to be `true` for modal dialogs and popover components.
+     *
+     * @default true
+     */
+    restoreFocus?: boolean;
+}
+export declare const CFocusTrap: FC<CFocusTrapProps>;

package/dist/cjs/components/focus-trap/CFocusTrap.js

@@ -0,0 +1,162 @@
+'use strict';
+
+var React = require('react');
+var utils = require('./utils.js');
+
+const CFocusTrap = ({ active = true, additionalContainer, children, focusFirstElement = false, onActivate, onDeactivate, restoreFocus = true, }) => {
+    const containerRef = React.useRef(null);
+    const prevFocusedRef = React.useRef(null);
+    const isActiveRef = React.useRef(false);
+    const lastTabNavDirectionRef = React.useRef('forward');
+    const tabEventSourceRef = React.useRef(null);
+    React.useEffect(() => {
+        var _a;
+        const container = containerRef.current;
+        const _additionalContainer = (additionalContainer === null || additionalContainer === void 0 ? void 0 : additionalContainer.current) || null;
+        if (!active || !container) {
+            if (isActiveRef.current) {
+                // Deactivate cleanup
+                if (restoreFocus && ((_a = prevFocusedRef.current) === null || _a === void 0 ? void 0 : _a.isConnected)) {
+                    prevFocusedRef.current.focus({ preventScroll: true });
+                }
+                onDeactivate === null || onDeactivate === void 0 ? void 0 : onDeactivate();
+                isActiveRef.current = false;
+                prevFocusedRef.current = null;
+            }
+            return;
+        }
+        // Remember focused element BEFORE we move focus into the trap
+        prevFocusedRef.current = document.activeElement;
+        // Activating…
+        isActiveRef.current = true;
+        // Set initial focus
+        if (focusFirstElement) {
+            const elements = utils.focusableChildren(container);
+            if (elements.length > 0) {
+                elements[0].focus({ preventScroll: true });
+            }
+            else {
+                // Fallback to container if no focusable elements
+                container.focus({ preventScroll: true });
+            }
+        }
+        else {
+            container.focus({ preventScroll: true });
+        }
+        onActivate === null || onActivate === void 0 ? void 0 : onActivate();
+        const handleFocusIn = (event) => {
+            var _a;
+            // Only handle focus events from tab navigation
+            if (containerRef.current !== tabEventSourceRef.current) {
+                return;
+            }
+            const target = event.target;
+            // Allow focus within container
+            if (target === document || target === container || container.contains(target)) {
+                return;
+            }
+            // Allow focus within additional elements
+            if (_additionalContainer &&
+                (target === _additionalContainer || _additionalContainer.contains(target))) {
+                return;
+            }
+            // Focus escaped, bring it back
+            const elements = utils.focusableChildren(container);
+            if (elements.length === 0) {
+                container.focus({ preventScroll: true });
+            }
+            else if (lastTabNavDirectionRef.current === 'backward') {
+                (_a = elements.at(-1)) === null || _a === void 0 ? void 0 : _a.focus({ preventScroll: true });
+            }
+            else {
+                elements[0].focus({ preventScroll: true });
+            }
+        };
+        const handleKeyDown = (event) => {
+            var _a, _b;
+            if (event.key !== 'Tab') {
+                return;
+            }
+            tabEventSourceRef.current = container;
+            lastTabNavDirectionRef.current = event.shiftKey ? 'backward' : 'forward';
+            if (!_additionalContainer) {
+                return;
+            }
+            const containerElements = utils.focusableChildren(container);
+            const additionalElements = utils.focusableChildren(_additionalContainer);
+            if (containerElements.length === 0 && additionalElements.length === 0) {
+                // No focusable elements, prevent tab
+                event.preventDefault();
+                return;
+            }
+            const activeElement = document.activeElement;
+            const isInContainer = containerElements.includes(activeElement);
+            const isInAdditional = additionalElements.includes(activeElement);
+            // Handle tab navigation between container and additional elements
+            if (isInContainer) {
+                const index = containerElements.indexOf(activeElement);
+                if (!event.shiftKey &&
+                    index === containerElements.length - 1 &&
+                    additionalElements.length > 0) {
+                    // Tab forward from last container element to first additional element
+                    event.preventDefault();
+                    additionalElements[0].focus({ preventScroll: true });
+                }
+                else if (event.shiftKey && index === 0 && additionalElements.length > 0) {
+                    // Tab backward from first container element to last additional element
+                    event.preventDefault();
+                    (_a = additionalElements.at(-1)) === null || _a === void 0 ? void 0 : _a.focus({ preventScroll: true });
+                }
+            }
+            else if (isInAdditional) {
+                const index = additionalElements.indexOf(activeElement);
+                if (!event.shiftKey &&
+                    index === additionalElements.length - 1 &&
+                    containerElements.length > 0) {
+                    // Tab forward from last additional element to first container element
+                    event.preventDefault();
+                    containerElements[0].focus({ preventScroll: true });
+                }
+                else if (event.shiftKey && index === 0 && containerElements.length > 0) {
+                    // Tab backward from first additional element to last container element
+                    event.preventDefault();
+                    (_b = containerElements.at(-1)) === null || _b === void 0 ? void 0 : _b.focus({ preventScroll: true });
+                }
+            }
+        };
+        // Add event listeners
+        container.addEventListener('keydown', handleKeyDown, true);
+        if (_additionalContainer) {
+            _additionalContainer.addEventListener('keydown', handleKeyDown, true);
+        }
+        document.addEventListener('focusin', handleFocusIn, true);
+        // Cleanup function
+        return () => {
+            var _a;
+            container.removeEventListener('keydown', handleKeyDown, true);
+            if (_additionalContainer) {
+                _additionalContainer.removeEventListener('keydown', handleKeyDown, true);
+            }
+            document.removeEventListener('focusin', handleFocusIn, true);
+            // On unmount (also considered deactivation)
+            if (restoreFocus && ((_a = prevFocusedRef.current) === null || _a === void 0 ? void 0 : _a.isConnected)) {
+                prevFocusedRef.current.focus({ preventScroll: true });
+            }
+            if (isActiveRef.current) {
+                onDeactivate === null || onDeactivate === void 0 ? void 0 : onDeactivate();
+                isActiveRef.current = false;
+            }
+            prevFocusedRef.current = null;
+        };
+    }, [active, additionalContainer, focusFirstElement, onActivate, onDeactivate, restoreFocus]);
+    // Attach our ref to the ONLY child — no extra wrappers
+    const onlyChild = React.Children.only(children);
+    const childRef = onlyChild.ref;
+    const mergedRef = utils.mergeRefs(childRef, (node) => {
+        containerRef.current = node;
+    });
+    return React.cloneElement(onlyChild, { ref: mergedRef });
+};
+
+exports.CFocusTrap = CFocusTrap;
+//# sourceMappingURL=CFocusTrap.js.map

package/dist/cjs/components/focus-trap/CFocusTrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CFocusTrap.js","sources":["../../../../src/components/focus-trap/CFocusTrap.tsx"],"sourcesContent":[null],"names":["useRef","useEffect","focusableChildren","mergeRefs","cloneElement"],"mappings":"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"}

package/dist/cjs/components/focus-trap/index.d.ts

@@ -0,0 +1,2 @@
+import { CFocusTrap } from './CFocusTrap';
+export { CFocusTrap };

package/dist/cjs/components/focus-trap/utils.d.ts

@@ -0,0 +1,36 @@
+import React from 'react';
+/**
+ * Gets all focusable child elements within a container.
+ * Uses a comprehensive selector to find elements that can receive focus.
+ * @param element - The container element to search within
+ * @returns Array of focusable HTML elements
+ */
+export declare const focusableChildren: (element: HTMLElement) => HTMLElement[];
+/**
+ * Checks if an element is disabled.
+ * Considers various ways an element can be disabled including CSS classes and attributes.
+ * @param element - The HTML element to check
+ * @returns True if the element is disabled, false otherwise
+ */
+export declare const isDisabled: (element: HTMLElement) => boolean;
+/**
+ * Type guard to check if an object is an Element.
+ * Handles edge cases including jQuery objects.
+ * @param object - The object to check
+ * @returns True if the object is an Element, false otherwise
+ */
+export declare const isElement: (object: unknown) => object is Element;
+/**
+ * Checks if an element is visible in the DOM.
+ * Considers client rects and computed visibility styles, handling edge cases like details elements.
+ * @param element - The HTML element to check for visibility
+ * @returns True if the element is visible, false otherwise
+ */
+export declare const isVisible: (element: HTMLElement) => boolean;
+/**
+ * Merges multiple React refs into a single ref callback.
+ * Handles both function refs and ref objects, gracefully ignoring failures.
+ * @param refs - Array of React refs to merge
+ * @returns A ref callback that applies to all provided refs
+ */
+export declare const mergeRefs: <T>(...refs: (React.Ref<T> | undefined)[]) => (node: T) => void;

package/dist/cjs/components/focus-trap/utils.js

@@ -0,0 +1,108 @@
+'use strict';
+
+/**
+ * Gets all focusable child elements within a container.
+ * Uses a comprehensive selector to find elements that can receive focus.
+ * @param element - The container element to search within
+ * @returns Array of focusable HTML elements
+ */
+const focusableChildren = (element) => {
+    const focusableSelectors = [
+        'a[href]',
+        'button:not([disabled])',
+        'input:not([disabled])',
+        'textarea:not([disabled])',
+        'select:not([disabled])',
+        'details',
+        '[tabindex]:not([tabindex="-1"])',
+        '[contenteditable="true"]',
+    ].join(',');
+    const elements = [...element.querySelectorAll(focusableSelectors)];
+    return elements.filter((el) => !isDisabled(el) && isVisible(el));
+};
+/**
+ * Checks if an element is disabled.
+ * Considers various ways an element can be disabled including CSS classes and attributes.
+ * @param element - The HTML element to check
+ * @returns True if the element is disabled, false otherwise
+ */
+const isDisabled = (element) => {
+    if (!element || element.nodeType !== Node.ELEMENT_NODE) {
+        return true;
+    }
+    if (element.classList.contains('disabled')) {
+        return true;
+    }
+    if ('disabled' in element && typeof element.disabled === 'boolean') {
+        return element.disabled;
+    }
+    return element.hasAttribute('disabled') && element.getAttribute('disabled') !== 'false';
+};
+/**
+ * Type guard to check if an object is an Element.
+ * Handles edge cases including jQuery objects.
+ * @param object - The object to check
+ * @returns True if the object is an Element, false otherwise
+ */
+const isElement = (object) => {
+    if (!object || typeof object !== 'object') {
+        return false;
+    }
+    return 'nodeType' in object && typeof object.nodeType === 'number';
+};
+/**
+ * Checks if an element is visible in the DOM.
+ * Considers client rects and computed visibility styles, handling edge cases like details elements.
+ * @param element - The HTML element to check for visibility
+ * @returns True if the element is visible, false otherwise
+ */
+const isVisible = (element) => {
+    if (!isElement(element) || element.getClientRects().length === 0) {
+        return false;
+    }
+    const elementIsVisible = getComputedStyle(element).getPropertyValue('visibility') === 'visible';
+    // Handle `details` element as its content may falsely appear visible when it is closed
+    const closedDetails = element.closest('details:not([open])');
+    if (!closedDetails) {
+        return elementIsVisible;
+    }
+    if (closedDetails !== element) {
+        const summary = element.closest('summary');
+        // Check if summary is a direct child of the closed details
+        if ((summary === null || summary === void 0 ? void 0 : summary.parentNode) !== closedDetails) {
+            return false;
+        }
+    }
+    return elementIsVisible;
+};
+/**
+ * Merges multiple React refs into a single ref callback.
+ * Handles both function refs and ref objects, gracefully ignoring failures.
+ * @param refs - Array of React refs to merge
+ * @returns A ref callback that applies to all provided refs
+ */
+const mergeRefs = (...refs) => (node) => {
+    refs.forEach((ref) => {
+        if (!ref)
+            return;
+        if (typeof ref === 'function') {
+            ref(node);
+        }
+        else {
+            try {
+                ;
+                ref.current = node;
+            }
+            catch (_a) {
+                // Ignore assignment failures for read-only refs
+            }
+        }
+    });
+};
+
+exports.focusableChildren = focusableChildren;
+exports.isDisabled = isDisabled;
+exports.isElement = isElement;
+exports.isVisible = isVisible;
+exports.mergeRefs = mergeRefs;
+//# sourceMappingURL=utils.js.map

package/dist/cjs/components/focus-trap/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../../../src/components/focus-trap/utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;AAKG;AACI,MAAM,iBAAiB,GAAG,CAAC,OAAoB,KAAmB;AACvE,IAAA,MAAM,kBAAkB,GAAG;QACzB,SAAS;QACT,wBAAwB;QACxB,uBAAuB;QACvB,0BAA0B;QAC1B,wBAAwB;QACxB,SAAS;QACT,iCAAiC;QACjC,0BAA0B;AAC3B,KAAA,CAAC,IAAI,CAAC,GAAG,CAAC;IAEX,MAAM,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAc,kBAAkB,CAAC,CAAkB;IAEhG,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,SAAS,CAAC,EAAE,CAAC,CAAC;AAClE;AAEA;;;;;AAKG;AACI,MAAM,UAAU,GAAG,CAAC,OAAoB,KAAa;IAC1D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,YAAY,EAAE;AACtD,QAAA,OAAO,IAAI;IACb;IAEA,IAAI,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE;AAC1C,QAAA,OAAO,IAAI;IACb;IAEA,IAAI,UAAU,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE;QAClE,OAAO,OAAO,CAAC,QAAQ;IACzB;AAEA,IAAA,OAAO,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,OAAO;AACzF;AAEA;;;;;AAKG;AACI,MAAM,SAAS,GAAG,CAAC,MAAe,KAAuB;IAC9D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;AACzC,QAAA,OAAO,KAAK;IACd;IAEA,OAAO,UAAU,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;AACpE;AAEA;;;;;AAKG;AACI,MAAM,SAAS,GAAG,CAAC,OAAoB,KAAa;AACzD,IAAA,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE;AAChE,QAAA,OAAO,KAAK;IACd;AAEA,IAAA,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,gBAAgB,CAAC,YAAY,CAAC,KAAK,SAAS;;IAG/F,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC;IAE5D,IAAI,CAAC,aAAa,EAAE;AAClB,QAAA,OAAO,gBAAgB;IACzB;AAEA,IAAA,IAAI,aAAa,KAAK,OAAO,EAAE;QAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;;QAG1C,IAAI,CAAA,OAAO,KAAA,IAAA,IAAP,OAAO,KAAA,MAAA,GAAA,MAAA,GAAP,OAAO,CAAE,UAAU,MAAK,aAAa,EAAE;AACzC,YAAA,OAAO,KAAK;QACd;IACF;AAEA,IAAA,OAAO,gBAAgB;AACzB;AAEA;;;;;AAKG;AACI,MAAM,SAAS,GACpB,CAAI,GAAG,IAAkC,KACzC,CAAC,IAAO,KAAI;AACV,IAAA,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,KAAI;AACnB,QAAA,IAAI,CAAC,GAAG;YAAE;AACV,QAAA,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE;YAC7B,GAAG,CAAC,IAAI,CAAC;QACX;aAAO;AACL,YAAA,IAAI;gBACF;AAAE,gBAAA,GAA0B,CAAC,OAAO,GAAG,IAAI;YAC7C;AAAE,YAAA,OAAA,EAAA,EAAM;;YAER;QACF;AACF,IAAA,CAAC,CAAC;AACJ;;;;;;;;"}