@carbon/ibm-products-web-components 0.21.1 → 0.22.0

package/es-custom/utilities/carousel/carousel.js

@@ -13,6 +13,12 @@ import { registerSwipeEvents } from './swipeEvents.js';
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
+/**
+ * Initializes a carousel with the given configuration.
+ * @param carouselContainer - The HTMLElement representing the carousel container.
+ * @param config - Optional configuration object.
+ * @returns An object containing methods to control the carousel.
+ */
 const initCarousel = (carouselContainer, config) => {
     const prefix = 'carousel';
     let viewIndexStack = [0];
@@ -20,9 +26,26 @@ const initCarousel = (carouselContainer, config) => {
     const refs = {};
     const minHeight = 10; // 10 rem
     const { onViewChangeStart, onViewChangeEnd, excludeSwipeSupport } = config || {};
+    /**
+     * Registers an HTMLElement at a specific index in the refs array.
+     *
+     * @param {number} index - The index at which to register the HTMLElement.
+     * @param {HTMLElement} ref - The HTMLElement to register.
+     *
+     * @example
+     * registerRef(0, document.getElementById('myElement'));
+     */
     const registerRef = (index, ref) => {
         refs[index] = ref;
     };
+    /**
+     * Wraps all child elements of a given container into a new div with the specified class.
+     * If an element with the specified class already exists as a child of the container, the function does nothing.
+     *
+     * @param {HTMLElement} container - The container element to wrap child elements of.
+     * @param {string} wrapperClass - The class name to apply to the new wrapper div.
+     * @returns {void}
+     */
     const wrapAllItems = (container, wrapperClass) => {
         if (container.querySelector(`.${wrapperClass}`)) {
             return;
@@ -40,6 +63,10 @@ const initCarousel = (carouselContainer, config) => {
             elem: refs[id],
         }));
     };
+    /**
+     * Retrieves the current carousel response based on the view index stack and reference objects.
+     * @returns {CarouselResponse} - An object containing carousel response details.
+     */
     const getCallbackResponse = () => {
         const totalRefs = Object.keys(refs).length;
         const lastElementRef = refs[totalRefs - 1];
@@ -51,11 +78,27 @@ const initCarousel = (carouselContainer, config) => {
             historyStack: historicalData,
         };
     };
+    /**
+     * Handles the start of a transition in the application.
+     * This function is responsible for capturing the current state of the view index stack
+     * and invoking a callback function if it exists.
+     *
+     * @function handleTransitionStart
+     * @returns {void}
+     */
     const handleTransitionStart = () => {
         previousViewIndexStack = [...viewIndexStack];
         const callbackData = getCallbackResponse();
         onViewChangeStart === null || onViewChangeStart === void 0 ? void 0 : onViewChangeStart(callbackData);
     };
+    /**
+     * Handles the 'transitionend' event for a given element.
+     * This function checks if the element has a 'data-index' attribute and if its value matches the current view index.
+     * If both conditions are met, it calls the 'onViewChangeEnd' callback with the response from 'getCallbackResponse'.
+     *
+     * @param {HTMLElement | null} el - The element to handle the 'transitionend' event for.
+     * @returns {void}
+     */
     const handleTransitionEnd = (el) => {
         if (!el) {
             return;
@@ -67,11 +110,24 @@ const initCarousel = (carouselContainer, config) => {
             onViewChangeEnd === null || onViewChangeEnd === void 0 ? void 0 : onViewChangeEnd(callbackData);
         }
     };
+    /**
+     * A utility function to sanitize an index value.
+     * This function ensures the index stays within the bounds of the refs array.
+     *
+     * @param {number} idx - The index to be sanitized.
+     * @returns {number} - The sanitized index.
+     */
     const sanitizeIndex = (idx) => {
         const floorVal = 0;
         const ceilVal = Object.keys(refs).length - 1;
         return Math.max(floorVal, Math.min(idx, ceilVal));
     };
+    /**
+     * Handles the 'transitionend' event for a given element.
+     * This function checks if the element has a 'data-index' attribute and if its value matches the current view index.
+     * If both conditions are met, it calls the 'onViewChangeEnd' callback with the response from 'getCallbackResponse'.
+     * @returns {void}
+     */
     const transitionToViewIndex = (idx) => {
         const sanitizedIndex = sanitizeIndex(idx);
         if (viewIndexStack[0] !== sanitizedIndex) {
@@ -83,6 +139,16 @@ const initCarousel = (carouselContainer, config) => {
     const transitionComplete = (ref) => {
         handleTransitionEnd(ref);
     };
+    /**
+     * Attaches class names to an HTMLElement based on given conditions.
+     *
+     * @param {HTMLElement} viewItem - The HTML element to which class names will be added.
+     * @param {boolean} isInViewStack - Indicates if the view item is in the view stack.
+     * @param {boolean} isActive - Indicates if the view item is active.
+     * @param {boolean} isBeingRecycledOut - Indicates if the view item is being recycled out.
+     * @param {boolean} isBeingRecycledIn - Indicates if the view item is being recycled in.
+     * @returns {void}
+     */
     const attachClassNames = (viewItem, isInViewStack, isActive, isBeingRecycledOut, isBeingRecycledIn) => {
         viewItem.classList.add(`${prefix}__view`);
         viewItem.classList.toggle(`${prefix}__view-in-stack`, isInViewStack && !isActive);
@@ -100,6 +166,12 @@ const initCarousel = (carouselContainer, config) => {
     const remToPx = (rem) => {
         return (rem * parseFloat(getComputedStyle(document.documentElement).fontSize));
     };
+    /**
+     * Updates the height of the items wrapper in a carousel based on the smallest item height and a threshold height.
+     * This function ensures that the items wrapper does not have a height smaller than the threshold, adjusting the item height if necessary.
+     *
+     * @param {number} itemHeightSmallest - The smallest height of an item in pixels.
+     */
     const updateHeightForWrapper = (itemHeightSmallest) => {
         const thresholdHeight = remToPx(minHeight);
         const containerHeight = carouselContainer.clientHeight;
@@ -113,6 +185,10 @@ const initCarousel = (carouselContainer, config) => {
             }
         }
     };
+    /**
+     * Performs animation on view items based on their state in the view index stack.
+     * @param {boolean} isInitial - A flag indicating if this is the initial animation.
+     */
     const performAnimation = (isInitial) => {
         let itemHeightSmallest = 0;
         Array.from(viewItems).forEach((viewItem, index) => {
@@ -145,6 +221,8 @@ const initCarousel = (carouselContainer, config) => {
                         transitionComplete(viewItem);
                     }
                 };
+                // store reference on the element for later removal
+                viewItem._carouselListener = listener;
                 viewItem.addEventListener('animationend', listener);
                 viewItem.addEventListener('transitionend', listener);
                 viewItem.setAttribute('data-index', index.toString());
@@ -154,10 +232,22 @@ const initCarousel = (carouselContainer, config) => {
             handleTransitionEnd(Array.from(viewItems)[0]);
         }
     };
+    /**
+     * A utility function to navigate to the next view in the stack.
+     * This function increments the current view index and transitions to the new index.
+     *
+     * @returns {void} - This function does not return any value.
+     */
     const navigateNext = () => {
         const targetViewIndex = viewIndexStack[0] + 1;
         transitionToViewIndex(targetViewIndex);
     };
+    /**
+     * Navigates to the previous view in the view stack.
+     * @function navigatePrev
+     * @description This function checks if there is a previous view in the stack. If so, it triggers a transition start, removes the current view from the stack, and performs an animation to transition to the previous view.
+     * @returns {void} - This function does not return a value.
+     */
     const navigatePrev = () => {
         if (viewIndexStack.length - 1 >= 1) {
             handleTransitionStart();
@@ -165,22 +255,62 @@ const initCarousel = (carouselContainer, config) => {
             performAnimation(false);
         }
     };
+    /**
+     * A function that transitions the view to a specified index.
+     *
+     * @param {number} index - The index to transition to.
+     * @returns {void} - This function does not return a value.
+     */
     const goToIndex = (index) => {
         transitionToViewIndex(index);
     };
+    /**
+     * Retrieves the currently active item and its index from the view index stack and references.
+     * @returns An object containing the index and the corresponding item reference.
+     */
     const getActiveItem = () => {
         return {
             index: viewIndexStack[0],
             item: refs[viewIndexStack[0]],
         };
     };
+    /**
+     * Resets the view index stack and performs an animation.
+     *
+     * @returns {void}
+     */
     const reset = () => {
         viewIndexStack = [0];
         performAnimation(false);
     };
+    /**
+     * Removes event listeners for 'animationend' and 'transitionend' events from all elements with references stored in the `refs` object.
+     * Also registers swipe events if `excludeSwipeSupport` is false.
+     */
     const destroyEvents = () => {
-        registerSwipeEvents(carouselContainer, navigateNext, navigatePrev, true);
+        Object.values(refs).forEach((el) => {
+            if (el && el._carouselListener) {
+                el.removeEventListener('animationend', el._carouselListener);
+                el.removeEventListener('transitionend', el._carouselListener);
+            }
+        });
+        if (!excludeSwipeSupport) {
+            registerSwipeEvents(carouselContainer, navigateNext, navigatePrev, true);
+        }
     };
+    /**
+     * Retrieves carousel items from a given container element.
+     * If the container has a 'slot' element, it fetches all elements assigned to that slot.
+     * Otherwise, it fetches all direct children of the container.
+     *
+     * @param {HTMLElement} container - The container element from which to extract carousel items.
+     * @returns {HTMLElement[]} An array of HTMLElements representing the carousel items.
+     *
+     * @example
+     * const carouselContainer = document.querySelector('.carousel-container');
+     * const carouselItems = getCarouselItems(carouselContainer);
+     * console.log(carouselItems); // Logs the carousel items as HTMLElements
+     */
     const getCarouselItems = (container) => {
         const slot = container.querySelector('slot');
         return slot
@@ -202,7 +332,8 @@ const initCarousel = (carouselContainer, config) => {
         reset,
         goToIndex,
         getActiveItem,
-        destroyEvents: !excludeSwipeSupport ? destroyEvents : null,
+        destroyEvents,
+        allViews: refs,
     };
 };
 

package/es-custom/utilities/carousel/carousel.js.map

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

package/es-custom/utilities/carousel/types.d.ts

@@ -32,5 +32,6 @@ interface InitCarousel {
     goToIndex: (index: number) => void;
     getActiveItem: () => ActiveItem;
     destroyEvents: (() => void) | null;
+    allViews: Record<number, HTMLElement | null>;
 }
 export type { CarouselStackHistory, CarouselResponse, InitCarousel };

package/lib/components/about-modal/about-modal.d.ts

@@ -39,9 +39,11 @@ declare const CDSAboutModal_base: {
         hidePopover(): void;
         showPopover(): void;
         togglePopover(force?: boolean): boolean;
-        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options? /**
-         * A visual symbol used to represent the product.
-         */: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options
+        /**
+         * Determines if About Modal is open or not.
+         */
+        ?: boolean | AddEventListenerOptions): void;
         addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
         removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
         removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
@@ -366,6 +368,9 @@ declare const CDSAboutModal_base: {
  * @csspart dialog The dialog.
  *   The custom event fired before this about modal is being closed upon a user gesture.
  *   Cancellation of this event stops the user-initiated action of closing this about modal.
+ * @fires c4p-about-modal-beingclosed
+ *   The custom event fired before this about modal is being closed upon a user gesture.
+ *   Cancellation of this event stops the user-initiated action of closing this about modal.
  * @fires c4p-about-modal-closed - The custom event fired after this about modal is closed upon a user gesture.
  */
 declare class CDSAboutModal extends CDSAboutModal_base {
@@ -414,6 +419,12 @@ declare class CDSAboutModal extends CDSAboutModal_base {
     updated(): void;
     render(): import("lit-html").TemplateResult<1>;
     private _handleKeydown;
+    /**
+     * Handles `click` event on this element.
+     *
+     * @param event The event.
+     */
+    private _handleOutsideClick;
     /**
      * Handles user-initiated close request of this About Modal.
      *
@@ -425,6 +436,11 @@ declare class CDSAboutModal extends CDSAboutModal_base {
      * The name of the custom event fired after this About Modal is closed upon a user gesture.
      */
     static get eventClose(): string;
+    /**
+     * The name of the custom event fired before this About modal is being closed upon a user gesture.
+     * Cancellation of this event stops the user-initiated action of closing this About modal.
+     */
+    static get eventBeforeClose(): string;
     static styles: any;
 }
 export default CDSAboutModal;

package/lib/components/interstitial-screen/interstitial-screen-body.d.ts

@@ -363,6 +363,7 @@ declare const CDSInterstitialScreenBody_base: {
  * @fires c4p-on-after-step-change -  The name of the custom event fired at the end of  the step change.
  */
 declare class CDSInterstitialScreenBody extends CDSInterstitialScreenBody_base {
+    slot: string;
     stepType: 'single' | 'multi';
     private carouselAPI;
     private carouselElement;
@@ -370,6 +371,7 @@ declare class CDSInterstitialScreenBody extends CDSInterstitialScreenBody_base {
     private _initCarousel;
     private onViewChangeStart;
     private onViewChangeEnd;
+    private updateAriaHiddenTabIndex;
     render(): import("lit-html").TemplateResult<1>;
     static styles: any;
     /**

package/lib/components/interstitial-screen/interstitial-screen-footer.d.ts

@@ -6,6 +6,7 @@
  * 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 { PropertyValues } from 'lit';
 import '@carbon/web-components/es/components/button/index.js';
 import '@carbon/web-components/es/components/inline-loading/inline-loading.js';
 import { CDSModalFooter } from '@carbon/web-components/es/index.js';
@@ -383,6 +384,7 @@ declare class CDSInterstitialScreenFooter extends CDSInterstitialScreenFooter_ba
      * The label for the start button.
      */
     startButtonLabel: string;
+    slot: string;
     /**
      * Enables support for asynchronous validation or user confirmation before proceeding
      * to the next interstitial step. When set to true, the component will wait for an external
@@ -392,6 +394,7 @@ declare class CDSInterstitialScreenFooter extends CDSInterstitialScreenFooter_ba
      */
     asyncAction: any;
     loadingAction: any;
+    protected updated(_changedProperties: PropertyValues): void;
     private _handleUserInitiatedClose;
     private handleSkip;
     private handleStart;

package/lib/components/interstitial-screen/interstitial-screen-header.d.ts

@@ -365,6 +365,7 @@ declare class CDSInterstitialScreenHeader extends CDSInterstitialScreenHeader_ba
      * Provide an optional title to be applied to the header.
      */
     headerTitle: string;
+    slot: string;
     /**
      * Tooltip text and aria label for the Close button icon.
      */
@@ -384,6 +385,7 @@ declare class CDSInterstitialScreenHeader extends CDSInterstitialScreenHeader_ba
      * @param triggeredBy The element that triggered this close request.
      */
     private _handleUserInitiatedClose;
+    getElementForAriaLive: () => import("lit-html").TemplateResult<1>;
     getProgressIndicatorContent(stepDetails: any): import("lit-html").TemplateResult<1>;
     getTitleContent(): import("lit-html").TemplateResult<1>;
     getHeaderContent(): import("lit-html").TemplateResult<1>;

package/lib/components/interstitial-screen/interstitial-screen.d.ts

@@ -391,19 +391,23 @@ declare class CDSInterstitialScreen extends CDSInterstitialScreen_base {
      * @ignore
      */
     modalBody: HTMLElement;
-    private header;
-    private body;
-    private footer;
     private _wasOpen;
     connectedCallback(): void;
+    disconnectedCallback(): void;
     firstUpdated(): void;
     updated(changedProps: Map<string | number | symbol, unknown>): void;
     private dispatchInItializeEvent;
+    /**
+     * Handles `click` event on this element.
+     *
+     * @param event The event.
+     */
+    private _handleOutsideClick;
     private setDisableActionButtons;
     _handleClose(e: any): void;
-    renderFullScreen(): import("lit-html").TemplateResult<1> | typeof nothing;
+    renderFullScreen(): import("lit-html").TemplateResult<1>;
     renderModal(): import("lit-html").TemplateResult<1>;
-    render(): import("lit-html").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1> | typeof nothing;
     static styles: any;
     static get eventOnInterstitialOpened(): string;
     /**

package/lib/components/interstitial-screen/interstitial-screen.test.d.ts

@@ -0,0 +1 @@
+import './index';

package/lib/components/notification-panel/notification-panel.d.ts

@@ -10,6 +10,7 @@ import { LitElement } from 'lit';
 import '@carbon/web-components/es/components/button/index.js';
 import '@carbon/web-components/es/components/toggle/index.js';
 import '@carbon/web-components/es/components/icon-button/index.js';
+import '@carbon-labs/wc-empty-state/es/index.js';
 declare const CDSNotificationPanel_base: {
     new (...args: any[]): {
         _handles: Set<import("@carbon/web-components/es/globals/internal/handle").default>;
@@ -392,6 +393,10 @@ declare class CDSNotificationPanel extends CDSNotificationPanel_base {
      * Sets the label text for the "Dismiss all" button in the Notification panel
      */
     dismissAllLabel: any;
+    /**
+     * Sets the empty state label text when there are no notifications
+     */
+    emptyStateLabel: any;
     /**
      * Sets the label text for the "Do Not Disturb" toggle in the Notification panel
      */
@@ -446,7 +451,7 @@ declare class CDSNotificationPanel extends CDSNotificationPanel_base {
      */
     static get eventClickOutside(): string;
     /**
-     * The name of the custom event fired after this notification-panel is closed upon a user gesture.
+     * The name of the custom event fired after dismiss all button click
      */
     static get eventDismissAll(): string;
     /**

package/lib/components/options-tile/options-tile.d.ts

@@ -8,6 +8,7 @@
  */
 import { LitElement } from 'lit';
 import '@carbon/web-components/es/components/button/index.js';
+import '@carbon/web-components/es/components/layer/index.js';
 export declare const blockClass = "c4p--options-tile";
 declare const CDSOptionsTile_base: {
     new (...args: any[]): {
@@ -367,9 +368,9 @@ declare const CDSOptionsTile_base: {
  * */
 declare class CDSOptionsTile extends CDSOptionsTile_base {
     /**
-     * If `true` the body of the component is shown
+     * Determines if the tile is open by default
      */
-    open: boolean;
+    defaultOpen?: boolean;
     /**
      * Determines the size of the header
      */
@@ -382,6 +383,12 @@ declare class CDSOptionsTile extends CDSOptionsTile_base {
      * Text for the title
      */
     titleText: string;
+    /**
+     * Using the native toggle event handler in details can cause an infinite loop
+     * when setting the native open attribute. To combat this, the open state is kept
+     * here and only referenced internally.
+     */
+    private _open;
     static get eventOpen(): string;
     static get eventClose(): string;
     private _toggle;

package/lib/components/page-header/_story-assets/set-of-tags/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ *
+ * 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.
+ */
+import './set-of-tags';

package/lib/components/page-header/_story-assets/set-of-tags/set-of-tags.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license
+ *
+ * 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.
+ */
+import { LitElement } from 'lit';
+import '@carbon/web-components/es/components/tag/index.js';
+import '@carbon/web-components/es/components/link/index.js';
+import '@carbon/web-components/es/components/modal/index.js';
+import '@carbon/web-components/es/components/search/index.js';
+import { TagType } from './utils';
+export default class SetOfTags extends LitElement {
+    hiddenTags: TagType[];
+    tagsData: TagType[];
+    private container;
+    private offset;
+    private isPopoverOpen;
+    private modalOpen;
+    private searchString;
+    private overflowHandler;
+    private resizeObserver;
+    connectedCallback(): void;
+    firstUpdated(): void;
+    updated(changedProperties: Map<string, unknown>): void;
+    disconnectedCallback(): void;
+    private setupOverflowHandler;
+    private handleTogglePopover;
+    private handleDocumentClick;
+    private handleDismiss;
+    render(): import("lit-html").TemplateResult<1>;
+    static styles: any;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'set-of-tags': SetOfTags;
+    }
+}

package/lib/components/page-header/_story-assets/set-of-tags/utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ *
+ * 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.
+ */
+import { TAG_TYPE, TAG_SIZE } from '@carbon/web-components/es/components/tag/defs';
+export interface TagType {
+    type: TAG_TYPE;
+    text: string;
+    size: TAG_SIZE;
+    onClose?: () => void;
+}
+interface GenerateTagsOptions {
+    count: number;
+    size?: TAG_SIZE;
+    dismissible?: boolean;
+}
+export declare function generateTags({ count, size, dismissible, }: GenerateTagsOptions): TagType[];
+export declare const tagsData: TagType[];
+export {};

package/lib/components/page-header/context.d.ts

@@ -11,4 +11,5 @@ export declare const pageHeaderContext: import("@lit/context").Context<{
     breadcrumbOffset: number;
     fullyCollapsed: boolean;
     root: null;
+    titleClipped: boolean;
 }, unknown>;

package/lib/components/page-header/page-header-breadcrumb.d.ts

@@ -29,6 +29,7 @@ declare class CDSPageHeaderBreadcrumb extends LitElement {
      * Set to `true` if content actions should be flush (no padding)
      */
     contentActionsFlush: boolean;
+    context: any;
     render(): import("lit-html").TemplateResult<1>;
     static styles: any;
 }

package/lib/components/page-header/page-header-content.d.ts

@@ -34,6 +34,7 @@ declare class CDSPageHeaderContent extends LitElement {
      * (ie. when used in tandem with page-header-hero-image)
      */
     withinGrid: boolean;
+    context: any;
     updated(): void;
     render(): import("lit-html").TemplateResult<1>;
     static styles: any;

package/lib/components/page-header/page-header.d.ts

@@ -11,6 +11,8 @@ export interface pageHeaderContextType {
     breadcrumbOffset?: number;
     headerOffset?: number;
     fullyCollapsed?: boolean;
+    titleClipped?: boolean;
+    contentActionsClipped?: boolean;
     root?: CDSPageHeader | null;
     withContent?: boolean;
 }

package/lib/components/side-panel/side-panel.d.ts

@@ -381,14 +381,6 @@ declare class CDSSidePanel extends CDSSidePanel_base {
      * The element that had focus before this side-panel gets open.
      */
     private _launcher;
-    /**
-     * Node to track focus going outside of side-panel content.
-     */
-    private _startSentinelNode;
-    /**
-     * Node to track focus going outside of side-panel content.
-     */
-    private _endSentinelNode;
     /**
      * Node to track side panel.
      */
@@ -408,13 +400,20 @@ declare class CDSSidePanel extends CDSSidePanel_base {
     _actionsCount: number;
     _slugCloseSize: string;
     /**
-     * Handles `blur` event on this element.
+     * Get focusable elements.
      *
-     * @param event The event.
-     * @param event.target The event target.
-     * @param event.relatedTarget The event relatedTarget.
+     * Querying all tabbable items.
+     *
+     * @returns {{first: HTMLElement, last: HTMLElement, all: HTMLElement[]}} Returns an object with various elements.
+     */
+    private getFocusable;
+    /**
+     * Handle the keydown event.
+     * Trap the focus inside the side-panel by tracking keydown.key == `Tab`
+     *
+     * @param {KeyboardEvent} event The keyboard event object.
      */
-    private _handleBlur;
+    protected _handleHostKeydown: (event: KeyboardEvent) => void;
     private _handleKeydown;
     private _reducedMotion;
     /**

package/lib/utilities/carousel/carousel.d.ts

@@ -5,4 +5,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { InitCarousel, Config } from './types';
+/**
+ * Initializes a carousel with the given configuration.
+ * @param carouselContainer - The HTMLElement representing the carousel container.
+ * @param config - Optional configuration object.
+ * @returns An object containing methods to control the carousel.
+ */
 export declare const initCarousel: (carouselContainer: HTMLElement, config?: Config) => InitCarousel;