@carbon/ibm-products-web-components 0.35.0 → 0.36.0

package/es/utilities/makeDraggable/makeDraggable.js

@@ -1,145 +1,108 @@
 /**
- * Copyright IBM Corp. 2024
+ * Copyright IBM Corp. 2020, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
+//#region src/utilities/makeDraggable/makeDraggable.ts
 /**
- * Copyright IBM Corp. 2025, 2025
- *
- * This source code is licensed under the Apache-2.0 license found in the
- * LICENSE file in the root directory of this source tree.
- */
-/**
- * Makes a given element draggable using a handle element.
- *@param draggable - object which accepts el and optional attributes handle,focusableInHandle,dragStep and shiftDragStep
- */
-const makeDraggable = ({ el, dragHandle, focusableDragHandle, dragStep, shiftDragStep, }) => {
-    if (dragHandle) {
-        dragHandle.style.cursor = 'move';
-        el.style.cursor = 'default';
-    }
-    else {
-        el.style.cursor = 'move';
-    }
-    let isDragging = false;
-    let currentX = 0;
-    let currentY = 0;
-    let initialMouseX = 0;
-    let initialMouseY = 0;
-    const dispatch = (type, detail) => {
-        const eventInit = {
-            detail,
-            bubbles: true,
-        };
-        el.dispatchEvent(new CustomEvent(type, eventInit));
-    };
-    const onKeyDown = (e) => {
-        if (e.key === 'Enter') {
-            isDragging = !isDragging;
-            if (isDragging) {
-                // Get current transform values when starting keyboard drag
-                const style = window.getComputedStyle(el);
-                const matrix = new DOMMatrix(style.transform);
-                currentX = matrix.m41;
-                currentY = matrix.m42;
-                dispatch('dragstart', { keyboard: true });
-            }
-            else {
-                dispatch('dragend', { keyboard: true });
-            }
-        }
-        if (!isDragging) {
-            return;
-        }
-        const distance = e.shiftKey ? (shiftDragStep !== null && shiftDragStep !== void 0 ? shiftDragStep : 32) : (dragStep !== null && dragStep !== void 0 ? dragStep : 8);
-        switch (e.key) {
-            case 'Enter':
-            case ' ':
-                e.preventDefault();
-                break;
-            case 'ArrowLeft':
-                currentX -= distance;
-                el.style.transform = `translate(${currentX}px, ${currentY}px)`;
-                break;
-            case 'ArrowRight':
-                currentX += distance;
-                el.style.transform = `translate(${currentX}px, ${currentY}px)`;
-                break;
-            case 'ArrowUp':
-                currentY -= distance;
-                el.style.transform = `translate(${currentX}px, ${currentY}px)`;
-                break;
-            case 'ArrowDown':
-                currentY += distance;
-                el.style.transform = `translate(${currentX}px, ${currentY}px)`;
-                break;
-        }
-    };
-    const onMouseDown = (e) => {
-        const target = e.target;
-        if (!(target instanceof Node)) {
-            return;
-        }
-        const isTargetInHandle = dragHandle
-            ? dragHandle.contains(target)
-            : el.contains(target);
-        if (!isTargetInHandle) {
-            return;
-        }
-        const style = window.getComputedStyle(el);
-        const matrix = new DOMMatrix(style.transform);
-        currentX = matrix.m41;
-        currentY = matrix.m42;
-        // Store the mouse position at the start of the drag
-        initialMouseX = e.clientX;
-        initialMouseY = e.clientY;
-        isDragging = true;
-        dispatch('dragstart', { mouse: true });
-        document.addEventListener('mousemove', onMouseMove);
-        document.addEventListener('mouseup', onMouseUp, { once: true });
-    };
-    const onMouseMove = (e) => {
-        if (!isDragging) {
-            return;
-        }
-        // Calculate the change in mouse position from the start
-        const dx = e.clientX - initialMouseX;
-        const dy = e.clientY - initialMouseY;
-        // Add that change to the element's original translation
-        el.style.transform = `translate(${currentX + dx}px, ${currentY + dy}px)`;
-    };
-    const onMouseUp = () => {
-        if (!isDragging) {
-            return;
-        }
-        isDragging = false;
-        dispatch('dragend', { mouse: true });
-        document.removeEventListener('mousemove', onMouseMove);
-    };
-    if (dragHandle) {
-        dragHandle.addEventListener('mousedown', onMouseDown);
-    }
-    else {
-        el.addEventListener('mousedown', onMouseDown);
-    }
-    focusableDragHandle === null || focusableDragHandle === void 0 ? void 0 : focusableDragHandle.addEventListener('keydown', onKeyDown);
-    const draggableCleanup = () => {
-        if (dragHandle) {
-            dragHandle.removeEventListener('mousedown', onMouseDown);
-        }
-        else {
-            el.removeEventListener('mousedown', onMouseDown);
-        }
-        focusableDragHandle === null || focusableDragHandle === void 0 ? void 0 : focusableDragHandle.removeEventListener('keydown', onKeyDown);
-        document.removeEventListener('mousemove', onMouseMove);
-        document.removeEventListener('mouseup', onMouseUp);
-    };
-    return {
-        cleanup: draggableCleanup,
-    };
+* Makes a given element draggable using a handle element.
+*@param draggable - object which accepts el and optional attributes handle,focusableInHandle,dragStep and shiftDragStep
+*/
+const makeDraggable = ({ el, dragHandle, focusableDragHandle, dragStep, shiftDragStep }) => {
+	if (dragHandle) {
+		dragHandle.style.cursor = "move";
+		el.style.cursor = "default";
+	} else el.style.cursor = "move";
+	let isDragging = false;
+	let currentX = 0;
+	let currentY = 0;
+	let initialMouseX = 0;
+	let initialMouseY = 0;
+	const dispatch = (type, detail) => {
+		const eventInit = {
+			detail,
+			bubbles: true
+		};
+		el.dispatchEvent(new CustomEvent(type, eventInit));
+	};
+	const onKeyDown = (e) => {
+		if (e.key === "Enter") {
+			isDragging = !isDragging;
+			if (isDragging) {
+				const style = window.getComputedStyle(el);
+				const matrix = new DOMMatrix(style.transform);
+				currentX = matrix.m41;
+				currentY = matrix.m42;
+				dispatch("dragstart", { keyboard: true });
+			} else dispatch("dragend", { keyboard: true });
+		}
+		if (!isDragging) return;
+		const distance = e.shiftKey ? shiftDragStep ?? 32 : dragStep ?? 8;
+		switch (e.key) {
+			case "Enter":
+			case " ":
+				e.preventDefault();
+				break;
+			case "ArrowLeft":
+				currentX -= distance;
+				el.style.transform = `translate(${currentX}px, ${currentY}px)`;
+				break;
+			case "ArrowRight":
+				currentX += distance;
+				el.style.transform = `translate(${currentX}px, ${currentY}px)`;
+				break;
+			case "ArrowUp":
+				currentY -= distance;
+				el.style.transform = `translate(${currentX}px, ${currentY}px)`;
+				break;
+			case "ArrowDown":
+				currentY += distance;
+				el.style.transform = `translate(${currentX}px, ${currentY}px)`;
+				break;
+		}
+	};
+	const onMouseDown = (e) => {
+		const target = e.target;
+		if (!(target instanceof Node)) return;
+		if (!(dragHandle ? dragHandle.contains(target) : el.contains(target))) return;
+		const style = window.getComputedStyle(el);
+		const matrix = new DOMMatrix(style.transform);
+		currentX = matrix.m41;
+		currentY = matrix.m42;
+		initialMouseX = e.clientX;
+		initialMouseY = e.clientY;
+		isDragging = true;
+		dispatch("dragstart", { mouse: true });
+		document.addEventListener("mousemove", onMouseMove);
+		document.addEventListener("mouseup", onMouseUp, { once: true });
+	};
+	const onMouseMove = (e) => {
+		if (!isDragging) return;
+		const dx = e.clientX - initialMouseX;
+		const dy = e.clientY - initialMouseY;
+		el.style.transform = `translate(${currentX + dx}px, ${currentY + dy}px)`;
+	};
+	const onMouseUp = () => {
+		if (!isDragging) return;
+		isDragging = false;
+		dispatch("dragend", { mouse: true });
+		document.removeEventListener("mousemove", onMouseMove);
+	};
+	if (dragHandle) dragHandle.addEventListener("mousedown", onMouseDown);
+	else el.addEventListener("mousedown", onMouseDown);
+	focusableDragHandle?.addEventListener("keydown", onKeyDown);
+	const draggableCleanup = () => {
+		if (dragHandle) dragHandle.removeEventListener("mousedown", onMouseDown);
+		else el.removeEventListener("mousedown", onMouseDown);
+		focusableDragHandle?.removeEventListener("keydown", onKeyDown);
+		document.removeEventListener("mousemove", onMouseMove);
+		document.removeEventListener("mouseup", onMouseUp);
+	};
+	return { cleanup: draggableCleanup };
 };
 
+//#endregion
 export { makeDraggable };
-//# sourceMappingURL=makeDraggable.js.map
+//# sourceMappingURL=makeDraggable.js.map

package/es/utilities/makeDraggable/makeDraggable.js.map

@@ -1 +1 @@
-{"version":3,"file":"makeDraggable.js","sources":["../../../src/utilities/makeDraggable/makeDraggable.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"makeDraggable.js","names":[],"sources":["../../../src/utilities/makeDraggable/makeDraggable.ts"],"sourcesContent":["/**\n * Copyright IBM Corp. 2025, 2025\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n/* eslint-disable jsdoc/check-param-names */\ninterface DraggableProps {\n  /**\n   * HTML element to move.\n   */\n  el: HTMLElement;\n  /**\n   * HTML element to initiate the drag (e.g., header).\n   */\n  dragHandle?: HTMLElement;\n  /**\n   * HTML element to focus on drag for keyboard interaction (e.g., Drag Icon).\n   */\n  focusableDragHandle?: HTMLElement;\n  /**\n   * Pixel value that defines the distance to move when dragging with arrow\n   * keys.\n   */\n  dragStep?: number;\n  /**\n   * Pixel value that defines the distance to move when dragging with\n   * shift+arrow keys.\n   */\n  shiftDragStep?: number;\n}\n\ninterface EventDetail {\n  dragstart: { keyboard?: boolean; mouse?: boolean };\n  dragend: { keyboard?: boolean; mouse?: boolean };\n}\n\n/**\n * Makes a given element draggable using a handle element.\n *@param draggable - object which accepts el and optional attributes handle,focusableInHandle,dragStep and shiftDragStep\n */\nexport const makeDraggable = ({\n  el,\n  dragHandle,\n  focusableDragHandle,\n  dragStep,\n  shiftDragStep,\n}: DraggableProps) => {\n  if (dragHandle) {\n    dragHandle.style.cursor = 'move';\n    el.style.cursor = 'default';\n  } else {\n    el.style.cursor = 'move';\n  }\n\n  let isDragging = false;\n  let currentX = 0;\n  let currentY = 0;\n  let initialMouseX = 0;\n  let initialMouseY = 0;\n\n  const dispatch = <T extends keyof EventDetail>(\n    type: T,\n    detail: EventDetail[T]\n  ) => {\n    const eventInit: CustomEventInit<EventDetail[T]> = {\n      detail,\n      bubbles: true,\n    };\n    el.dispatchEvent(new CustomEvent(type, eventInit));\n  };\n\n  const onKeyDown = (e: KeyboardEvent) => {\n    if (e.key === 'Enter') {\n      isDragging = !isDragging;\n      if (isDragging) {\n        // Get current transform values when starting keyboard drag\n        const style = window.getComputedStyle(el);\n        const matrix = new DOMMatrix(style.transform);\n        currentX = matrix.m41;\n        currentY = matrix.m42;\n        dispatch('dragstart', { keyboard: true });\n      } else {\n        dispatch('dragend', { keyboard: true });\n      }\n    }\n\n    if (!isDragging) {\n      return;\n    }\n    const distance = e.shiftKey ? (shiftDragStep ?? 32) : (dragStep ?? 8);\n    switch (e.key) {\n      case 'Enter':\n      case ' ':\n        e.preventDefault();\n        break;\n      case 'ArrowLeft':\n        currentX -= distance;\n        el.style.transform = `translate(${currentX}px, ${currentY}px)`;\n        break;\n      case 'ArrowRight':\n        currentX += distance;\n        el.style.transform = `translate(${currentX}px, ${currentY}px)`;\n        break;\n      case 'ArrowUp':\n        currentY -= distance;\n        el.style.transform = `translate(${currentX}px, ${currentY}px)`;\n        break;\n      case 'ArrowDown':\n        currentY += distance;\n        el.style.transform = `translate(${currentX}px, ${currentY}px)`;\n        break;\n    }\n  };\n\n  const onMouseDown = (e: MouseEvent) => {\n    const target = e.target;\n    if (!(target instanceof Node)) {\n      return;\n    }\n\n    const isTargetInHandle = dragHandle\n      ? dragHandle.contains(target)\n      : el.contains(target);\n\n    if (!isTargetInHandle) {\n      return;\n    }\n    const style = window.getComputedStyle(el);\n    const matrix = new DOMMatrix(style.transform);\n    currentX = matrix.m41;\n    currentY = matrix.m42;\n\n    // Store the mouse position at the start of the drag\n    initialMouseX = e.clientX;\n    initialMouseY = e.clientY;\n    isDragging = true;\n    dispatch('dragstart', { mouse: true });\n\n    document.addEventListener('mousemove', onMouseMove);\n    document.addEventListener('mouseup', onMouseUp, { once: true });\n  };\n\n  const onMouseMove = (e: MouseEvent) => {\n    if (!isDragging) {\n      return;\n    }\n\n    // Calculate the change in mouse position from the start\n    const dx = e.clientX - initialMouseX;\n    const dy = e.clientY - initialMouseY;\n\n    // Add that change to the element's original translation\n    el.style.transform = `translate(${currentX + dx}px, ${currentY + dy}px)`;\n  };\n\n  const onMouseUp = () => {\n    if (!isDragging) {\n      return;\n    }\n    isDragging = false;\n    dispatch('dragend', { mouse: true });\n\n    document.removeEventListener('mousemove', onMouseMove);\n  };\n  if (dragHandle) {\n    dragHandle.addEventListener('mousedown', onMouseDown);\n  } else {\n    el.addEventListener('mousedown', onMouseDown);\n  }\n  focusableDragHandle?.addEventListener('keydown', onKeyDown);\n\n  const draggableCleanup = () => {\n    if (dragHandle) {\n      dragHandle.removeEventListener('mousedown', onMouseDown);\n    } else {\n      el.removeEventListener('mousedown', onMouseDown);\n    }\n    focusableDragHandle?.removeEventListener('keydown', onKeyDown);\n    document.removeEventListener('mousemove', onMouseMove);\n    document.removeEventListener('mouseup', onMouseUp);\n  };\n  return {\n    cleanup: draggableCleanup,\n  };\n};\n"],"mappings":";;;;;;;;;;;;AA0CA,MAAa,iBAAiB,EAC5B,IACA,YACA,qBACA,UACA,oBACoB;AACpB,KAAI,YAAY;AACd,aAAW,MAAM,SAAS;AAC1B,KAAG,MAAM,SAAS;OAElB,IAAG,MAAM,SAAS;CAGpB,IAAI,aAAa;CACjB,IAAI,WAAW;CACf,IAAI,WAAW;CACf,IAAI,gBAAgB;CACpB,IAAI,gBAAgB;CAEpB,MAAM,YACJ,MACA,WACG;EACH,MAAM,YAA6C;GACjD;GACA,SAAS;GACV;AACD,KAAG,cAAc,IAAI,YAAY,MAAM,UAAU,CAAC;;CAGpD,MAAM,aAAa,MAAqB;AACtC,MAAI,EAAE,QAAQ,SAAS;AACrB,gBAAa,CAAC;AACd,OAAI,YAAY;IAEd,MAAM,QAAQ,OAAO,iBAAiB,GAAG;IACzC,MAAM,SAAS,IAAI,UAAU,MAAM,UAAU;AAC7C,eAAW,OAAO;AAClB,eAAW,OAAO;AAClB,aAAS,aAAa,EAAE,UAAU,MAAM,CAAC;SAEzC,UAAS,WAAW,EAAE,UAAU,MAAM,CAAC;;AAI3C,MAAI,CAAC,WACH;EAEF,MAAM,WAAW,EAAE,WAAY,iBAAiB,KAAO,YAAY;AACnE,UAAQ,EAAE,KAAV;GACE,KAAK;GACL,KAAK;AACH,MAAE,gBAAgB;AAClB;GACF,KAAK;AACH,gBAAY;AACZ,OAAG,MAAM,YAAY,aAAa,SAAS,MAAM,SAAS;AAC1D;GACF,KAAK;AACH,gBAAY;AACZ,OAAG,MAAM,YAAY,aAAa,SAAS,MAAM,SAAS;AAC1D;GACF,KAAK;AACH,gBAAY;AACZ,OAAG,MAAM,YAAY,aAAa,SAAS,MAAM,SAAS;AAC1D;GACF,KAAK;AACH,gBAAY;AACZ,OAAG,MAAM,YAAY,aAAa,SAAS,MAAM,SAAS;AAC1D;;;CAIN,MAAM,eAAe,MAAkB;EACrC,MAAM,SAAS,EAAE;AACjB,MAAI,EAAE,kBAAkB,MACtB;AAOF,MAAI,EAJqB,aACrB,WAAW,SAAS,OAAO,GAC3B,GAAG,SAAS,OAAO,EAGrB;EAEF,MAAM,QAAQ,OAAO,iBAAiB,GAAG;EACzC,MAAM,SAAS,IAAI,UAAU,MAAM,UAAU;AAC7C,aAAW,OAAO;AAClB,aAAW,OAAO;AAGlB,kBAAgB,EAAE;AAClB,kBAAgB,EAAE;AAClB,eAAa;AACb,WAAS,aAAa,EAAE,OAAO,MAAM,CAAC;AAEtC,WAAS,iBAAiB,aAAa,YAAY;AACnD,WAAS,iBAAiB,WAAW,WAAW,EAAE,MAAM,MAAM,CAAC;;CAGjE,MAAM,eAAe,MAAkB;AACrC,MAAI,CAAC,WACH;EAIF,MAAM,KAAK,EAAE,UAAU;EACvB,MAAM,KAAK,EAAE,UAAU;AAGvB,KAAG,MAAM,YAAY,aAAa,WAAW,GAAG,MAAM,WAAW,GAAG;;CAGtE,MAAM,kBAAkB;AACtB,MAAI,CAAC,WACH;AAEF,eAAa;AACb,WAAS,WAAW,EAAE,OAAO,MAAM,CAAC;AAEpC,WAAS,oBAAoB,aAAa,YAAY;;AAExD,KAAI,WACF,YAAW,iBAAiB,aAAa,YAAY;KAErD,IAAG,iBAAiB,aAAa,YAAY;AAE/C,sBAAqB,iBAAiB,WAAW,UAAU;CAE3D,MAAM,yBAAyB;AAC7B,MAAI,WACF,YAAW,oBAAoB,aAAa,YAAY;MAExD,IAAG,oBAAoB,aAAa,YAAY;AAElD,uBAAqB,oBAAoB,WAAW,UAAU;AAC9D,WAAS,oBAAoB,aAAa,YAAY;AACtD,WAAS,oBAAoB,WAAW,UAAU;;AAEpD,QAAO,EACL,SAAS,kBACV"}

package/es/utilities/manageFocusTrap/manageFocusTrap.d.ts

@@ -11,3 +11,4 @@ export declare const clearFocusableContainers: () => void;
 export declare const trapFocus: (containers?: HTMLElement[]) => {
     cleanup: () => void;
 };
+//# sourceMappingURL=manageFocusTrap.d.ts.map

package/es/utilities/manageFocusTrap/manageFocusTrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manageFocusTrap.d.ts","sourceRoot":"","sources":["../../../src/utilities/manageFocusTrap/manageFocusTrap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,eAAO,MAAM,2BAA2B,GAAI,cAAS,SAIpD,CAAC;AACF,eAAO,MAAM,wBAAwB,YAEpC,CAAC;AACF,eAAO,MAAM,SAAS,GAAI,aAAa,WAAW,EAAE;;CA0HnD,CAAC"}

package/es/utilities/manageFocusTrap/manageFocusTrap.js

@@ -1,138 +1,101 @@
 /**
- * Copyright IBM Corp. 2024
+ * Copyright IBM Corp. 2020, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-import { selectorTabbable, prefix } from '@carbon/web-components/es/globals/settings';
+import { prefix, selectorTabbable } from "@carbon/web-components/es/globals/settings";
 
+//#region src/utilities/manageFocusTrap/manageFocusTrap.ts
 /**
- * @license
- *
- * Copyright IBM Corp. 2025
- *
- * This source code is licensed under the Apache-2.0 license found in the
- * LICENSE file in the root directory of this source tree.
- */
+* @license
+*
+* Copyright IBM Corp. 2025
+*
+* This source code is licensed under the Apache-2.0 license found in the
+* LICENSE file in the root directory of this source tree.
+*/
 /**
- * Traps focus within a set of containers, ensuring it stays within focusable elements.
- * @param {NodeListOf<Element>} containers - The containers to trap focus within.
- * @returns {object} An object with a `cleanup` method to remove event listeners.
- */
+* Traps focus within a set of containers, ensuring it stays within focusable elements.
+* @param {NodeListOf<Element>} containers - The containers to trap focus within.
+* @returns {object} An object with a `cleanup` method to remove event listeners.
+*/
 let _containers = [];
 const registerFocusableContainers = (container) => {
-    if (container) {
-        _containers.push(container);
-    }
+	if (container) _containers.push(container);
 };
 const clearFocusableContainers = () => {
-    _containers.length = 0;
+	_containers.length = 0;
 };
 const trapFocus = (containers) => {
-    const selectorTabbable$1 = selectorTabbable.replace(`${prefix}-button`, `${prefix}-button:not([disabled]), ${prefix}-selectable-tag`);
-    if (containers && containers.length > 0) {
-        _containers = containers;
-    }
-    if (!_containers.length) {
-        return { cleanup: () => { } };
-    }
-    /**
-     * Given a container element, return the best candidate to focus.
-     * - If element itself is tabbable, return it.
-     * - Otherwise, find the first tabbable descendant.
-     */
-    const getFocusTarget = (el) => {
-        if (!el) {
-            return null;
-        }
-        if (el.tagName === 'BUTTON' || el.tabIndex >= 0) {
-            return el;
-        }
-        const inner = el.querySelector('button, [tabindex]:not([tabindex="-1"])');
-        return inner || el;
-    };
-    /**
-  
-   * Returns the "real" active element in the document, resolving through
-   * Shadow DOM and slot boundaries when necessary.
-   *
-   * In some cases `document.activeElement` may not reflect the actual
-   * tabbable node that has focus:
-   *   - If focus is inside a shadow root, `document.activeElement` is the host,
-   *     not the element inside. This utility dives into the shadowRoot to find
-   *     the inner active element.
-   *   - If focus is on a `<slot>` element, this function resolves to the first
-   *     tabbable assigned element within the slot.
-     */
-    const getRealActiveElement = () => {
-        var _a;
-        let activeElement = document.activeElement;
-        // If inside shadow DOM
-        if (activeElement &&
-            selectorTabbable$1.indexOf(activeElement.tagName.toLocaleLowerCase()) ==
-                -1 &&
-            ((_a = activeElement === null || activeElement === void 0 ? void 0 : activeElement.shadowRoot) === null || _a === void 0 ? void 0 : _a.activeElement)) {
-            activeElement = activeElement.shadowRoot.activeElement;
-        }
-        // If active element is a slot
-        if ((activeElement === null || activeElement === void 0 ? void 0 : activeElement.tagName) === 'SLOT') {
-            let assigned;
-            if (activeElement instanceof HTMLSlotElement) {
-                assigned = activeElement.assignedElements({ flatten: true });
-            }
-            const candidate = assigned === null || assigned === void 0 ? void 0 : assigned.find((node) => node.matches('button, [tabindex]:not([tabindex="-1"])'));
-            if (candidate) {
-                activeElement = candidate;
-            }
-        }
-        return activeElement;
-    };
-    //Optionally focus first element immediately
-    requestAnimationFrame(() => {
-        var _a;
-        const elements = getAllFocusableElements(_containers);
-        (_a = getFocusTarget(elements[0])) === null || _a === void 0 ? void 0 : _a.focus({ preventScroll: true });
-    });
-    function onKeyDown(e) {
-        var _a, _b;
-        if (e.key !== 'Tab') {
-            return;
-        }
-        // Flatten all focusable elements from all containers
-        const elements = getAllFocusableElements(_containers);
-        const first = elements[0];
-        const last = elements[elements.length - 1];
-        const active = getRealActiveElement();
-        if (e.shiftKey) {
-            // Shift+Tab wrap
-            if (active === first || first.contains(active)) {
-                e.preventDefault();
-                (_a = getFocusTarget(last)) === null || _a === void 0 ? void 0 : _a.focus();
-            }
-        }
-        else {
-            // Tab wrap
-            if (active === last || last.contains(active)) {
-                e.preventDefault();
-                (_b = getFocusTarget(first)) === null || _b === void 0 ? void 0 : _b.focus();
-            }
-        }
-    }
-    /**
-     * Retrieves all focusable elements within the provided containers.
-     **/
-    const getAllFocusableElements = (containers) => containers
-        .flatMap((container) => [...container.querySelectorAll(selectorTabbable$1)])
-        .filter(Boolean);
-    document.addEventListener('keydown', onKeyDown, true);
-    return {
-        cleanup: () => {
-            document.removeEventListener('keydown', onKeyDown, true);
-            _containers.length = 0;
-        },
-    };
+	const selectorTabbable$1 = selectorTabbable.replace(`${prefix}-button`, `${prefix}-button:not([disabled]), ${prefix}-selectable-tag`);
+	if (containers && containers.length > 0) _containers = containers;
+	if (!_containers.length) return { cleanup: () => {} };
+	/**
+	* Given a container element, return the best candidate to focus.
+	* - If element itself is tabbable, return it.
+	* - Otherwise, find the first tabbable descendant.
+	*/
+	const getFocusTarget = (el) => {
+		if (!el) return null;
+		if (el.tagName === "BUTTON" || el.tabIndex >= 0) return el;
+		return el.querySelector("button, [tabindex]:not([tabindex=\"-1\"])") || el;
+	};
+	/**
+	
+	* Returns the "real" active element in the document, resolving through
+	* Shadow DOM and slot boundaries when necessary.
+	*
+	* In some cases `document.activeElement` may not reflect the actual
+	* tabbable node that has focus:
+	*   - If focus is inside a shadow root, `document.activeElement` is the host,
+	*     not the element inside. This utility dives into the shadowRoot to find
+	*     the inner active element.
+	*   - If focus is on a `<slot>` element, this function resolves to the first
+	*     tabbable assigned element within the slot.
+	*/
+	const getRealActiveElement = () => {
+		let activeElement = document.activeElement;
+		if (activeElement && selectorTabbable$1.indexOf(activeElement.tagName.toLocaleLowerCase()) == -1 && activeElement?.shadowRoot?.activeElement) activeElement = activeElement.shadowRoot.activeElement;
+		if (activeElement?.tagName === "SLOT") {
+			let assigned;
+			if (activeElement instanceof HTMLSlotElement) assigned = activeElement.assignedElements({ flatten: true });
+			const candidate = assigned?.find((node) => node.matches("button, [tabindex]:not([tabindex=\"-1\"])"));
+			if (candidate) activeElement = candidate;
+		}
+		return activeElement;
+	};
+	requestAnimationFrame(() => {
+		getFocusTarget(getAllFocusableElements(_containers)[0])?.focus({ preventScroll: true });
+	});
+	function onKeyDown(e) {
+		if (e.key !== "Tab") return;
+		const elements = getAllFocusableElements(_containers);
+		const first = elements[0];
+		const last = elements[elements.length - 1];
+		const active = getRealActiveElement();
+		if (e.shiftKey) {
+			if (active === first || first.contains(active)) {
+				e.preventDefault();
+				getFocusTarget(last)?.focus();
+			}
+		} else if (active === last || last.contains(active)) {
+			e.preventDefault();
+			getFocusTarget(first)?.focus();
+		}
+	}
+	/**
+	* Retrieves all focusable elements within the provided containers.
+	**/
+	const getAllFocusableElements = (containers) => containers.flatMap((container) => [...container.querySelectorAll(selectorTabbable$1)]).filter(Boolean);
+	document.addEventListener("keydown", onKeyDown, true);
+	return { cleanup: () => {
+		document.removeEventListener("keydown", onKeyDown, true);
+		_containers.length = 0;
+	} };
 };
 
+//#endregion
 export { clearFocusableContainers, registerFocusableContainers, trapFocus };
-//# sourceMappingURL=manageFocusTrap.js.map
+//# sourceMappingURL=manageFocusTrap.js.map

package/es/utilities/manageFocusTrap/manageFocusTrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"manageFocusTrap.js","sources":["../../../src/utilities/manageFocusTrap/manageFocusTrap.ts"],"sourcesContent":[null],"names":["selectorTabbable","selectorTabbableCarbon","carbonPrefix"],"mappings":"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"}
+{"version":3,"file":"manageFocusTrap.js","names":["selectorTabbable","selectorTabbableCarbon","carbonPrefix"],"sources":["../../../src/utilities/manageFocusTrap/manageFocusTrap.ts"],"sourcesContent":["/**\n * @license\n *\n * Copyright IBM Corp. 2025\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\nimport {\n  selectorTabbable as selectorTabbableCarbon,\n  prefix as carbonPrefix,\n} from '@carbon/web-components/es/globals/settings';\n/**\n * Traps focus within a set of containers, ensuring it stays within focusable elements.\n * @param {NodeListOf<Element>} containers - The containers to trap focus within.\n * @returns {object} An object with a `cleanup` method to remove event listeners.\n */\nlet _containers: HTMLElement[] = [];\n\nexport const registerFocusableContainers = (container) => {\n  if (container) {\n    _containers.push(container);\n  }\n};\nexport const clearFocusableContainers = () => {\n  _containers.length = 0;\n};\nexport const trapFocus = (containers?: HTMLElement[]) => {\n  const selectorTabbable = selectorTabbableCarbon.replace(\n    `${carbonPrefix}-button`,\n    `${carbonPrefix}-button:not([disabled]), ${carbonPrefix}-selectable-tag`\n  );\n\n  if (containers && containers.length > 0) {\n    _containers = containers;\n  }\n  if (!_containers.length) {\n    return { cleanup: () => {} };\n  }\n\n  /**\n   * Given a container element, return the best candidate to focus.\n   * - If element itself is tabbable, return it.\n   * - Otherwise, find the first tabbable descendant.\n   */\n  const getFocusTarget = (el) => {\n    if (!el) {\n      return null;\n    }\n    if (el.tagName === 'BUTTON' || el.tabIndex >= 0) {\n      return el;\n    }\n    const inner = el.querySelector('button, [tabindex]:not([tabindex=\"-1\"])');\n    return inner || el;\n  };\n\n  /**\n\n * Returns the \"real\" active element in the document, resolving through\n * Shadow DOM and slot boundaries when necessary.\n *\n * In some cases `document.activeElement` may not reflect the actual\n * tabbable node that has focus:\n *   - If focus is inside a shadow root, `document.activeElement` is the host,\n *     not the element inside. This utility dives into the shadowRoot to find\n *     the inner active element.\n *   - If focus is on a `<slot>` element, this function resolves to the first\n *     tabbable assigned element within the slot.\n   */\n  const getRealActiveElement = () => {\n    let activeElement = document.activeElement;\n\n    // If inside shadow DOM\n    if (\n      activeElement &&\n      selectorTabbable.indexOf(activeElement.tagName.toLocaleLowerCase()) ==\n        -1 &&\n      activeElement?.shadowRoot?.activeElement\n    ) {\n      activeElement = activeElement.shadowRoot.activeElement;\n    }\n\n    // If active element is a slot\n    if (activeElement?.tagName === 'SLOT') {\n      let assigned: Element[] | undefined;\n\n      if (activeElement instanceof HTMLSlotElement) {\n        assigned = activeElement.assignedElements({ flatten: true });\n      }\n      const candidate = assigned?.find((node) =>\n        node.matches('button, [tabindex]:not([tabindex=\"-1\"])')\n      );\n      if (candidate) {\n        activeElement = candidate;\n      }\n    }\n\n    return activeElement;\n  };\n\n  //Optionally focus first element immediately\n  requestAnimationFrame(() => {\n    const elements = getAllFocusableElements(_containers);\n    getFocusTarget(elements[0])?.focus({ preventScroll: true });\n  });\n\n  function onKeyDown(e) {\n    if (e.key !== 'Tab') {\n      return;\n    }\n\n    // Flatten all focusable elements from all containers\n    const elements = getAllFocusableElements(_containers);\n\n    const first = elements[0];\n    const last = elements[elements.length - 1];\n    const active = getRealActiveElement();\n\n    if (e.shiftKey) {\n      // Shift+Tab wrap\n      if (active === first || first.contains(active)) {\n        e.preventDefault();\n        getFocusTarget(last)?.focus();\n      }\n    } else {\n      // Tab wrap\n      if (active === last || last.contains(active)) {\n        e.preventDefault();\n        getFocusTarget(first)?.focus();\n      }\n    }\n  }\n\n  /**\n   * Retrieves all focusable elements within the provided containers.\n   **/\n  const getAllFocusableElements = (containers) =>\n    containers\n      .flatMap((container) => [...container.querySelectorAll(selectorTabbable)])\n      .filter(Boolean);\n\n  document.addEventListener('keydown', onKeyDown, true);\n\n  return {\n    cleanup: () => {\n      document.removeEventListener('keydown', onKeyDown, true);\n      _containers.length = 0;\n    },\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAkBA,IAAI,cAA6B,EAAE;AAEnC,MAAa,+BAA+B,cAAc;AACxD,KAAI,UACF,aAAY,KAAK,UAAU;;AAG/B,MAAa,iCAAiC;AAC5C,aAAY,SAAS;;AAEvB,MAAa,aAAa,eAA+B;CACvD,MAAMA,qBAAmBC,iBAAuB,QAC9C,GAAGC,OAAa,UAChB,GAAGA,OAAa,2BAA2BA,OAAa,iBACzD;AAED,KAAI,cAAc,WAAW,SAAS,EACpC,eAAc;AAEhB,KAAI,CAAC,YAAY,OACf,QAAO,EAAE,eAAe,IAAI;;;;;;CAQ9B,MAAM,kBAAkB,OAAO;AAC7B,MAAI,CAAC,GACH,QAAO;AAET,MAAI,GAAG,YAAY,YAAY,GAAG,YAAY,EAC5C,QAAO;AAGT,SADc,GAAG,cAAc,4CAA0C,IACzD;;;;;;;;;;;;;;;CAgBlB,MAAM,6BAA6B;EACjC,IAAI,gBAAgB,SAAS;AAG7B,MACE,iBACAF,mBAAiB,QAAQ,cAAc,QAAQ,mBAAmB,CAAC,IACjE,MACF,eAAe,YAAY,cAE3B,iBAAgB,cAAc,WAAW;AAI3C,MAAI,eAAe,YAAY,QAAQ;GACrC,IAAI;AAEJ,OAAI,yBAAyB,gBAC3B,YAAW,cAAc,iBAAiB,EAAE,SAAS,MAAM,CAAC;GAE9D,MAAM,YAAY,UAAU,MAAM,SAChC,KAAK,QAAQ,4CAA0C,CACxD;AACD,OAAI,UACF,iBAAgB;;AAIpB,SAAO;;AAIT,6BAA4B;AAE1B,iBADiB,wBAAwB,YAAY,CAC7B,GAAG,EAAE,MAAM,EAAE,eAAe,MAAM,CAAC;GAC3D;CAEF,SAAS,UAAU,GAAG;AACpB,MAAI,EAAE,QAAQ,MACZ;EAIF,MAAM,WAAW,wBAAwB,YAAY;EAErD,MAAM,QAAQ,SAAS;EACvB,MAAM,OAAO,SAAS,SAAS,SAAS;EACxC,MAAM,SAAS,sBAAsB;AAErC,MAAI,EAAE,UAEJ;OAAI,WAAW,SAAS,MAAM,SAAS,OAAO,EAAE;AAC9C,MAAE,gBAAgB;AAClB,mBAAe,KAAK,EAAE,OAAO;;aAI3B,WAAW,QAAQ,KAAK,SAAS,OAAO,EAAE;AAC5C,KAAE,gBAAgB;AAClB,kBAAe,MAAM,EAAE,OAAO;;;;;;CAQpC,MAAM,2BAA2B,eAC/B,WACG,SAAS,cAAc,CAAC,GAAG,UAAU,iBAAiBA,mBAAiB,CAAC,CAAC,CACzE,OAAO,QAAQ;AAEpB,UAAS,iBAAiB,WAAW,WAAW,KAAK;AAErD,QAAO,EACL,eAAe;AACb,WAAS,oBAAoB,WAAW,WAAW,KAAK;AACxD,cAAY,SAAS;IAExB"}

package/es/utilities/snapscroll/index.d.ts

@@ -5,3 +5,4 @@
  * LICENSE file in the root directory of this source tree.
  */
 export { snapScroll, scrollNext, scrollPrevious, blockClass, getNextSibling, getPreviousSibling, hasNextSiblingNotInView, hasPreviousSiblingNotInView, } from './snapscroll';
+//# sourceMappingURL=index.d.ts.map

package/es/utilities/snapscroll/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utilities/snapscroll/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,cAAc,CAAC"}

package/es/utilities/snapscroll/index.js

@@ -1,9 +1,10 @@
 /**
- * Copyright IBM Corp. 2024
+ * Copyright IBM Corp. 2020, 2026
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
 
-export { blockClass, getNextSibling, getPreviousSibling, hasNextSiblingNotInView, hasPreviousSiblingNotInView, scrollNext, scrollPrevious, snapScroll } from './snapscroll.js';
-//# sourceMappingURL=index.js.map
+import { blockClass, getNextSibling, getPreviousSibling, hasNextSiblingNotInView, hasPreviousSiblingNotInView, scrollNext, scrollPrevious, snapScroll } from "./snapscroll.js";
+
+export { blockClass, getNextSibling, getPreviousSibling, hasNextSiblingNotInView, hasPreviousSiblingNotInView, scrollNext, scrollPrevious, snapScroll };

package/es/utilities/snapscroll/snapscroll.d.ts

@@ -37,3 +37,4 @@ export declare function hasNextSiblingNotInView(): boolean;
  * @returns true if there are more items to scroll to in the previous direction
  */
 export declare function hasPreviousSiblingNotInView(): boolean;
+//# sourceMappingURL=snapscroll.d.ts.map

package/es/utilities/snapscroll/snapscroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapscroll.d.ts","sourceRoot":"","sources":["../../../src/utilities/snapscroll/snapscroll.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;;;GAKG;AAEH,eAAO,MAAM,UAAU,gBAAsB,CAAC;AAI9C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAwErD;AAED;;;GAGG;AACH,wBAAgB,cAAc,mBAE7B;AA0FD;;GAEG;AACH,wBAAgB,UAAU,SAKzB;AAED;;GAEG;AACH,wBAAgB,cAAc,SAK7B;AAED,wBAAgB,cAAc,+BAO7B;AAED,wBAAgB,kBAAkB,+BAOjC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAejD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAerD"}