@coreui/react 5.7.1 → 5.8.0

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

@@ -1,4 +1,4 @@
-import { __rest, __assign } from '../../node_modules/tslib/tslib.es6.js';
+import { __rest } from '../../node_modules/tslib/tslib.es6.js';
 import React, { useContext } from 'react';
 import PropTypes from 'prop-types';
 import classNames from '../../_virtual/index.js';
@@ -6,11 +6,11 @@ import { CButton } from '../button/CButton.js';
 import { CDropdownContext } from './CDropdownContext.js';
 import { triggerPropType } from '../../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 = __rest(_a, ["children", "caret", "custom", "className", "navLink", "split", "trigger"]);
-    var _e = useContext(CDropdownContext), dropdownToggleRef = _e.dropdownToggleRef, handleHide = _e.handleHide, handleShow = _e.handleShow, variant = _e.variant, visible = _e.visible;
-    var triggers = __assign(__assign({}, ((trigger === 'click' || trigger.includes('click')) && {
-        onClick: function (event) {
+const CDropdownToggle = (_a) => {
+    var { children, caret = true, custom, className, navLink = true, split, trigger = 'click' } = _a, rest = __rest(_a, ["children", "caret", "custom", "className", "navLink", "split", "trigger"]);
+    const { dropdownToggleRef, handleHide, handleShow, variant, visible } = useContext(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();
@@ -20,22 +20,27 @@ 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 = __assign({ className: classNames({
+        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: classNames({
             'nav-link': variant === 'nav-item' && navLink,
             'dropdown-toggle': caret,
             'dropdown-toggle-split': split,
             show: visible,
-        }, className), 'aria-expanded': visible }, (!rest.disabled && __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, __assign(__assign({ 'aria-expanded': visible }, (!rest.disabled && __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", __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, __assign({}, togglerProps, { tabIndex: 0 }, rest, { ref: dropdownToggleRef }),
+    return (React.createElement(CButton, Object.assign({}, togglerProps, { tabIndex: 0 }, rest, { ref: dropdownToggleRef }),
         children,
         split && React.createElement("span", { className: "visually-hidden" }, "Toggle Dropdown")));
 };

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

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

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

@@ -1,17 +1,17 @@
-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';
     }

package/dist/esm/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":"AAIO,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;;;;"}

package/dist/esm/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/esm/components/focus-trap/CFocusTrap.js

@@ -0,0 +1,160 @@
+import React, { useRef, useEffect, cloneElement } from 'react';
+import { focusableChildren, mergeRefs } from './utils.js';
+
+const CFocusTrap = ({ active = true, additionalContainer, children, focusFirstElement = false, onActivate, onDeactivate, restoreFocus = true, }) => {
+    const containerRef = useRef(null);
+    const prevFocusedRef = useRef(null);
+    const isActiveRef = useRef(false);
+    const lastTabNavDirectionRef = useRef('forward');
+    const tabEventSourceRef = useRef(null);
+    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 = 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 = 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 = focusableChildren(container);
+            const additionalElements = 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 = mergeRefs(childRef, (node) => {
+        containerRef.current = node;
+    });
+    return cloneElement(onlyChild, { ref: mergedRef });
+};
+
+export { CFocusTrap };
+//# sourceMappingURL=CFocusTrap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CFocusTrap.js","sources":["../../../../src/components/focus-trap/CFocusTrap.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;AAmEO,MAAM,UAAU,GAAwB,CAAC,EAC9C,MAAM,GAAG,IAAI,EACb,mBAAmB,EACnB,QAAQ,EACR,iBAAiB,GAAG,KAAK,EACzB,UAAU,EACV,YAAY,EACZ,YAAY,GAAG,IAAI,GACpB,KAAI;AACH,IAAA,MAAM,YAAY,GAAG,MAAM,CAAqB,IAAI,CAAC;AACrD,IAAA,MAAM,cAAc,GAAG,MAAM,CAAqB,IAAI,CAAC;AACvD,IAAA,MAAM,WAAW,GAAG,MAAM,CAAU,KAAK,CAAC;AAC1C,IAAA,MAAM,sBAAsB,GAAG,MAAM,CAAyB,SAAS,CAAC;AACxE,IAAA,MAAM,iBAAiB,GAAG,MAAM,CAAqB,IAAI,CAAC;IAE1D,SAAS,CAAC,MAAK;;AACb,QAAA,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO;AACtC,QAAA,MAAM,oBAAoB,GAAG,CAAA,mBAAmB,KAAA,IAAA,IAAnB,mBAAmB,KAAA,MAAA,GAAA,MAAA,GAAnB,mBAAmB,CAAE,OAAO,KAAI,IAAI;AAEjE,QAAA,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE;AACzB,YAAA,IAAI,WAAW,CAAC,OAAO,EAAE;;gBAEvB,IAAI,YAAY,KAAI,CAAA,EAAA,GAAA,cAAc,CAAC,OAAO,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,WAAW,CAAA,EAAE;oBACvD,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;gBACvD;AAEA,gBAAA,YAAY,KAAA,IAAA,IAAZ,YAAY,KAAA,MAAA,GAAA,MAAA,GAAZ,YAAY,EAAI;AAChB,gBAAA,WAAW,CAAC,OAAO,GAAG,KAAK;AAC3B,gBAAA,cAAc,CAAC,OAAO,GAAG,IAAI;YAC/B;YAEA;QACF;;AAGA,QAAA,cAAc,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAmC;;AAGrE,QAAA,WAAW,CAAC,OAAO,GAAG,IAAI;;QAG1B,IAAI,iBAAiB,EAAE;AACrB,YAAA,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC;AAC7C,YAAA,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;AACvB,gBAAA,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;YAC5C;iBAAO;;gBAEL,SAAS,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;YAC1C;QACF;aAAO;YACL,SAAS,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QAC1C;AAEA,QAAA,UAAU,KAAA,IAAA,IAAV,UAAU,KAAA,MAAA,GAAA,MAAA,GAAV,UAAU,EAAI;AAEd,QAAA,MAAM,aAAa,GAAG,CAAC,KAAiB,KAAI;;;YAE1C,IAAI,YAAY,CAAC,OAAO,KAAK,iBAAiB,CAAC,OAAO,EAAE;gBACtD;YACF;AAEA,YAAA,MAAM,MAAM,GAAG,KAAK,CAAC,MAAc;;AAGnC,YAAA,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;gBAC7E;YACF;;AAGA,YAAA,IACE,oBAAoB;AACpB,iBAAC,MAAM,KAAK,oBAAoB,IAAI,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAC1E;gBACA;YACF;;AAGA,YAAA,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC;AAE7C,YAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;gBACzB,SAAS,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;YAC1C;AAAO,iBAAA,IAAI,sBAAsB,CAAC,OAAO,KAAK,UAAU,EAAE;AACxD,gBAAA,CAAA,EAAA,GAAA,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;YACjD;iBAAO;AACL,gBAAA,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;YAC5C;AACF,QAAA,CAAC;AAED,QAAA,MAAM,aAAa,GAAG,CAAC,KAAoB,KAAI;;AAC7C,YAAA,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,EAAE;gBACvB;YACF;AAEA,YAAA,iBAAiB,CAAC,OAAO,GAAG,SAAS;AACrC,YAAA,sBAAsB,CAAC,OAAO,GAAG,KAAK,CAAC,QAAQ,GAAG,UAAU,GAAG,SAAS;YAExE,IAAI,CAAC,oBAAoB,EAAE;gBACzB;YACF;AAEA,YAAA,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,SAAS,CAAC;AACtD,YAAA,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,oBAAoB,CAAC;AAElE,YAAA,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE;;gBAErE,KAAK,CAAC,cAAc,EAAE;gBACtB;YACF;AAEA,YAAA,MAAM,aAAa,GAAG,QAAQ,CAAC,aAA4B;YAC3D,MAAM,aAAa,GAAG,iBAAiB,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC/D,MAAM,cAAc,GAAG,kBAAkB,CAAC,QAAQ,CAAC,aAAa,CAAC;;YAGjE,IAAI,aAAa,EAAE;gBACjB,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,aAAa,CAAC;gBAEtD,IACE,CAAC,KAAK,CAAC,QAAQ;AACf,oBAAA,KAAK,KAAK,iBAAiB,CAAC,MAAM,GAAG,CAAC;AACtC,oBAAA,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAC7B;;oBAEA,KAAK,CAAC,cAAc,EAAE;AACtB,oBAAA,kBAAkB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;gBACtD;AAAO,qBAAA,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,KAAK,CAAC,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE;;oBAEzE,KAAK,CAAC,cAAc,EAAE;AACtB,oBAAA,CAAA,EAAA,GAAA,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;gBAC3D;YACF;iBAAO,IAAI,cAAc,EAAE;gBACzB,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,aAAa,CAAC;gBAEvD,IACE,CAAC,KAAK,CAAC,QAAQ;AACf,oBAAA,KAAK,KAAK,kBAAkB,CAAC,MAAM,GAAG,CAAC;AACvC,oBAAA,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAC5B;;oBAEA,KAAK,CAAC,cAAc,EAAE;AACtB,oBAAA,iBAAiB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;gBACrD;AAAO,qBAAA,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,KAAK,CAAC,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE;;oBAExE,KAAK,CAAC,cAAc,EAAE;AACtB,oBAAA,CAAA,EAAA,GAAA,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;gBAC1D;YACF;AACF,QAAA,CAAC;;QAGD,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC;QAC1D,IAAI,oBAAoB,EAAE;YACxB,oBAAoB,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC;QACvE;QACA,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC;;AAGzD,QAAA,OAAO,MAAK;;YACV,SAAS,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC;YAC7D,IAAI,oBAAoB,EAAE;gBACxB,oBAAoB,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC;YAC1E;YACA,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC;;YAG5D,IAAI,YAAY,KAAI,CAAA,EAAA,GAAA,cAAc,CAAC,OAAO,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,WAAW,CAAA,EAAE;gBACvD,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;YACvD;AAEA,YAAA,IAAI,WAAW,CAAC,OAAO,EAAE;AACvB,gBAAA,YAAY,KAAA,IAAA,IAAZ,YAAY,KAAA,MAAA,GAAA,MAAA,GAAZ,YAAY,EAAI;AAChB,gBAAA,WAAW,CAAC,OAAO,GAAG,KAAK;YAC7B;AAEA,YAAA,cAAc,CAAC,OAAO,GAAG,IAAI;AAC/B,QAAA,CAAC;AACH,IAAA,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;;IAG5F,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC/C,IAAA,MAAM,QAAQ,GAAI,SAAmE,CAAC,GAAG;IACzF,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAwB,KAAI;AACjE,QAAA,YAAY,CAAC,OAAO,GAAG,IAAI;AAC7B,IAAA,CAAC,CAAC;IAEF,OAAO,YAAY,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,SAAS,EAAqC,CAAC;AACvF;;;;"}

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

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

package/dist/esm/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/esm/components/focus-trap/utils.js

@@ -0,0 +1,107 @@
+/**
+ * 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;
+    }
+    // Handle jQuery objects
+    if ('jquery' in object && object.jquery !== undefined) {
+        const jQueryObject = object;
+        return isElement(jQueryObject[0]);
+    }
+    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
+            }
+        }
+    });
+};
+
+export { focusableChildren, isDisabled, isElement, isVisible, mergeRefs };
+//# sourceMappingURL=utils.js.map

package/dist/esm/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":"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"}

package/dist/esm/components/footer/CFooter.js

@@ -1,12 +1,11 @@
-import { __rest, __assign } from '../../node_modules/tslib/tslib.es6.js';
+import { __rest } from '../../node_modules/tslib/tslib.es6.js';
 import React, { forwardRef } from 'react';
 import PropTypes from 'prop-types';
 import classNames from '../../_virtual/index.js';
 
-var CFooter = forwardRef(function (_a, ref) {
-    var _b;
-    var children = _a.children, className = _a.className, position = _a.position, rest = __rest(_a, ["children", "className", "position"]);
-    return (React.createElement("div", __assign({ className: classNames('footer', (_b = {}, _b["footer-".concat(position)] = position, _b), className) }, rest, { ref: ref }), children));
+const CFooter = forwardRef((_a, ref) => {
+    var { children, className, position } = _a, rest = __rest(_a, ["children", "className", "position"]);
+    return (React.createElement("div", Object.assign({ className: classNames('footer', { [`footer-${position}`]: position }, className) }, rest, { ref: ref }), children));
 });
 CFooter.propTypes = {
     children: PropTypes.node,

package/dist/esm/components/footer/CFooter.js.map

@@ -1 +1 @@
-{"version":3,"file":"CFooter.js","sources":["../../../../src/components/footer/CFooter.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;IAea,OAAO,GAAG,UAAU,CAC/B,UAAC,EAA0C,EAAE,GAAG,EAAA;;AAA7C,IAAA,IAAA,QAAQ,GAAA,EAAA,CAAA,QAAA,EAAE,SAAS,GAAA,EAAA,CAAA,SAAA,EAAE,QAAQ,GAAA,EAAA,CAAA,QAAA,EAAK,IAAI,GAAA,MAAA,CAAA,EAAA,EAAxC,CAAA,UAAA,EAAA,WAAA,EAAA,UAAA,CAA0C,CAAF;IACvC,QACE,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,QAAA,CAAA,EACE,SAAS,EAAE,UAAU,CAAC,QAAQ,GAAA,EAAA,GAAA,EAAA,EAAI,EAAA,CAAC,SAAA,CAAA,MAAA,CAAU,QAAQ,CAAE,CAAA,GAAG,QAAQ,EAAA,EAAA,GAAI,SAAS,CAAC,EAAA,EAC5E,IAAI,EAAA,EACR,GAAG,EAAE,GAAG,EAAA,CAAA,EAEP,QAAQ,CACL;AAEV,CAAC;AAGH,OAAO,CAAC,SAAS,GAAG;IAClB,QAAQ,EAAE,SAAS,CAAC,IAAI;IACxB,SAAS,EAAE,SAAS,CAAC,MAAM;IAC3B,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;CAC/C;AAED,OAAO,CAAC,WAAW,GAAG,SAAS;;;;"}
+{"version":3,"file":"CFooter.js","sources":["../../../../src/components/footer/CFooter.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAeO,MAAM,OAAO,GAAG,UAAU,CAC/B,CAAC,EAA0C,EAAE,GAAG,KAAI;QAAnD,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,OAAW,EAAN,IAAI,GAAA,MAAA,CAAA,EAAA,EAAxC,CAAA,UAAA,EAAA,WAAA,EAAA,UAAA,CAA0C,CAAF;AACvC,IAAA,QACE,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,MAAA,CAAA,MAAA,CAAA,EACE,SAAS,EAAE,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA,OAAA,EAAU,QAAQ,EAAE,GAAG,QAAQ,EAAE,EAAE,SAAS,CAAC,EAAA,EAC5E,IAAI,EAAA,EACR,GAAG,EAAE,GAAG,EAAA,CAAA,EAEP,QAAQ,CACL;AAEV,CAAC;AAGH,OAAO,CAAC,SAAS,GAAG;IAClB,QAAQ,EAAE,SAAS,CAAC,IAAI;IACxB,SAAS,EAAE,SAAS,CAAC,MAAM;IAC3B,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;CAC/C;AAED,OAAO,CAAC,WAAW,GAAG,SAAS;;;;"}

package/dist/esm/components/form/CForm.js

@@ -1,11 +1,11 @@
-import { __rest, __assign } from '../../node_modules/tslib/tslib.es6.js';
+import { __rest } from '../../node_modules/tslib/tslib.es6.js';
 import React, { forwardRef } from 'react';
 import PropTypes from 'prop-types';
 import classNames from '../../_virtual/index.js';
 
-var CForm = forwardRef(function (_a, ref) {
-    var children = _a.children, className = _a.className, validated = _a.validated, rest = __rest(_a, ["children", "className", "validated"]);
-    return (React.createElement("form", __assign({ className: classNames({ 'was-validated': validated }, className) || undefined }, rest, { ref: ref }), children));
+const CForm = forwardRef((_a, ref) => {
+    var { children, className, validated } = _a, rest = __rest(_a, ["children", "className", "validated"]);
+    return (React.createElement("form", Object.assign({ className: classNames({ 'was-validated': validated }, className) || undefined }, rest, { ref: ref }), children));
 });
 CForm.propTypes = {
     children: PropTypes.node,

package/dist/esm/components/form/CForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"CForm.js","sources":["../../../../src/components/form/CForm.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;IAea,KAAK,GAAG,UAAU,CAC7B,UAAC,EAA2C,EAAE,GAAG,EAAA;AAA9C,IAAA,IAAA,QAAQ,GAAA,EAAA,CAAA,QAAA,EAAE,SAAS,GAAA,EAAA,CAAA,SAAA,EAAE,SAAS,GAAA,EAAA,CAAA,SAAA,EAAK,IAAI,GAAA,MAAA,CAAA,EAAA,EAAzC,CAAA,UAAA,EAAA,WAAA,EAAA,WAAA,CAA2C,CAAF;IACxC,QACE,KAAA,CAAA,aAAA,CAAA,MAAA,EAAA,QAAA,CAAA,EACE,SAAS,EAAE,UAAU,CAAC,EAAE,eAAe,EAAE,SAAS,EAAE,EAAE,SAAS,CAAC,IAAI,SAAS,EAAA,EACzE,IAAI,EAAA,EACR,GAAG,EAAE,GAAG,EAAA,CAAA,EAEP,QAAQ,CACJ;AAEX,CAAC;AAGH,KAAK,CAAC,SAAS,GAAG;IAChB,QAAQ,EAAE,SAAS,CAAC,IAAI;IACxB,SAAS,EAAE,SAAS,CAAC,MAAM;IAC3B,SAAS,EAAE,SAAS,CAAC,IAAI;CAC1B;AAED,KAAK,CAAC,WAAW,GAAG,OAAO;;;;"}
+{"version":3,"file":"CForm.js","sources":["../../../../src/components/form/CForm.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAeO,MAAM,KAAK,GAAG,UAAU,CAC7B,CAAC,EAA2C,EAAE,GAAG,KAAI;QAApD,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,OAAW,EAAN,IAAI,GAAA,MAAA,CAAA,EAAA,EAAzC,CAAA,UAAA,EAAA,WAAA,EAAA,WAAA,CAA2C,CAAF;IACxC,QACE,KAAA,CAAA,aAAA,CAAA,MAAA,EAAA,MAAA,CAAA,MAAA,CAAA,EACE,SAAS,EAAE,UAAU,CAAC,EAAE,eAAe,EAAE,SAAS,EAAE,EAAE,SAAS,CAAC,IAAI,SAAS,EAAA,EACzE,IAAI,EAAA,EACR,GAAG,EAAE,GAAG,EAAA,CAAA,EAEP,QAAQ,CACJ;AAEX,CAAC;AAGH,KAAK,CAAC,SAAS,GAAG;IAChB,QAAQ,EAAE,SAAS,CAAC,IAAI;IACxB,SAAS,EAAE,SAAS,CAAC,MAAM;IAC3B,SAAS,EAAE,SAAS,CAAC,IAAI;CAC1B;AAED,KAAK,CAAC,WAAW,GAAG,OAAO;;;;"}

package/dist/esm/components/form/CFormCheck.js

@@ -1,4 +1,4 @@
-import { __rest, __assign } from '../../node_modules/tslib/tslib.es6.js';
+import { __rest } from '../../node_modules/tslib/tslib.es6.js';
 import React, { forwardRef, useRef, useEffect } from 'react';
 import PropTypes from 'prop-types';
 import classNames from '../../_virtual/index.js';
@@ -7,30 +7,27 @@ import { CFormLabel } from './CFormLabel.js';
 import { useForkedRef } from '../../hooks/useForkedRef.js';
 import '@popperjs/core';
 
-var CFormCheck = forwardRef(function (_a, ref) {
-    var className = _a.className, button = _a.button, feedback = _a.feedback, feedbackInvalid = _a.feedbackInvalid, feedbackValid = _a.feedbackValid, floatingLabel = _a.floatingLabel, tooltipFeedback = _a.tooltipFeedback, hitArea = _a.hitArea, id = _a.id, indeterminate = _a.indeterminate, inline = _a.inline, invalid = _a.invalid, label = _a.label, reverse = _a.reverse, _b = _a.type, type = _b === void 0 ? 'checkbox' : _b, valid = _a.valid, rest = __rest(_a, ["className", "button", "feedback", "feedbackInvalid", "feedbackValid", "floatingLabel", "tooltipFeedback", "hitArea", "id", "indeterminate", "inline", "invalid", "label", "reverse", "type", "valid"]);
-    var inputRef = useRef(null);
-    var forkedRef = useForkedRef(ref, inputRef);
-    useEffect(function () {
+const CFormCheck = forwardRef((_a, ref) => {
+    var { className, button, feedback, feedbackInvalid, feedbackValid, floatingLabel, tooltipFeedback, hitArea, id, indeterminate, inline, invalid, label, reverse, type = 'checkbox', valid } = _a, rest = __rest(_a, ["className", "button", "feedback", "feedbackInvalid", "feedbackValid", "floatingLabel", "tooltipFeedback", "hitArea", "id", "indeterminate", "inline", "invalid", "label", "reverse", "type", "valid"]);
+    const inputRef = useRef(null);
+    const forkedRef = useForkedRef(ref, inputRef);
+    useEffect(() => {
         if (inputRef.current && indeterminate) {
             inputRef.current.indeterminate = indeterminate;
         }
     }, [indeterminate, inputRef.current]);
-    var FormControl = function () { return (React.createElement("input", __assign({ type: type, className: classNames(button ? 'btn-check' : 'form-check-input', {
+    const FormControl = () => (React.createElement("input", Object.assign({ type: type, className: classNames(button ? 'btn-check' : 'form-check-input', {
             'is-invalid': invalid,
             'is-valid': valid,
             'me-2': hitArea,
-        }), id: id }, rest, { ref: forkedRef }))); };
-    var FormValidation = function () { return (React.createElement(CFormControlValidation, { describedby: rest['aria-describedby'], feedback: feedback, feedbackInvalid: feedbackInvalid, feedbackValid: feedbackValid, floatingLabel: floatingLabel, invalid: invalid, tooltipFeedback: tooltipFeedback, valid: valid })); };
-    var FormLabel = function () {
-        var _a;
-        return (React.createElement(CFormLabel, __assign({ customClassName: classNames(button
-                ? classNames('btn', button.variant ? "btn-".concat(button.variant, "-").concat(button.color) : "btn-".concat(button.color), (_a = {},
-                    _a["btn-".concat(button.size)] = button.size,
-                    _a), "".concat(button.shape))
-                : 'form-check-label') }, (id && { htmlFor: id })), label));
-    };
-    var FormCheck = function () {
+        }), id: id }, rest, { ref: forkedRef })));
+    const FormValidation = () => (React.createElement(CFormControlValidation, { describedby: rest['aria-describedby'], feedback: feedback, feedbackInvalid: feedbackInvalid, feedbackValid: feedbackValid, floatingLabel: floatingLabel, invalid: invalid, tooltipFeedback: tooltipFeedback, valid: valid }));
+    const FormLabel = () => (React.createElement(CFormLabel, Object.assign({ customClassName: classNames(button
+            ? classNames('btn', button.variant ? `btn-${button.variant}-${button.color}` : `btn-${button.color}`, {
+                [`btn-${button.size}`]: button.size,
+            }, `${button.shape}`)
+            : 'form-check-label') }, (id && { htmlFor: id })), label));
+    const FormCheck = () => {
         if (button) {
             return (React.createElement(React.Fragment, null,
                 React.createElement(FormControl, null),
@@ -40,7 +37,7 @@ var CFormCheck = forwardRef(function (_a, ref) {
         if (label) {
             return hitArea ? (React.createElement(React.Fragment, null,
                 React.createElement(FormControl, null),
-                React.createElement(CFormLabel, __assign({ customClassName: classNames('form-check-label stretched-link', className) }, (id && { htmlFor: id })), label),
+                React.createElement(CFormLabel, Object.assign({ customClassName: classNames('form-check-label stretched-link', className) }, (id && { htmlFor: id })), label),
                 React.createElement(FormValidation, null))) : (React.createElement("div", { className: classNames('form-check', {
                     'form-check-inline': inline,
                     'form-check-reverse': reverse,
@@ -55,7 +52,7 @@ var CFormCheck = forwardRef(function (_a, ref) {
     };
     return React.createElement(FormCheck, null);
 });
-CFormCheck.propTypes = __assign({ button: PropTypes.object, className: PropTypes.string, hitArea: PropTypes.oneOf(['full']), id: PropTypes.string, indeterminate: PropTypes.bool, inline: PropTypes.bool, label: PropTypes.oneOfType([PropTypes.string, PropTypes.node]), reverse: PropTypes.bool, type: PropTypes.oneOf(['checkbox', 'radio']) }, CFormControlValidation.propTypes);
+CFormCheck.propTypes = Object.assign({ button: PropTypes.object, className: PropTypes.string, hitArea: PropTypes.oneOf(['full']), id: PropTypes.string, indeterminate: PropTypes.bool, inline: PropTypes.bool, label: PropTypes.oneOfType([PropTypes.string, PropTypes.node]), reverse: PropTypes.bool, type: PropTypes.oneOf(['checkbox', 'radio']) }, CFormControlValidation.propTypes);
 CFormCheck.displayName = 'CFormCheck';
 
 export { CFormCheck };