@carbon/ibm-products-web-components 0.0.1-canary.3564

package/es/components/side-panel/side-panel.js

@@ -0,0 +1,837 @@
+/**
+ * Copyright IBM Corp. 2024
+ *
+ * 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 { __decorate } from '../../node_modules/tslib/tslib.es6.js';
+import { LitElement, html } from 'lit';
+import { query, queryAssignedElements, state, property } from 'lit/decorators.js';
+import { prefix, carbonPrefix } from '../../globals/settings.js';
+import HostListener from '@carbon/web-components/es/globals/decorators/host-listener.js';
+import HostListenerMixin from '@carbon/web-components/es/globals/mixins/host-listener.js';
+import { SIDE_PANEL_PLACEMENT, SIDE_PANEL_SIZE } from './defs.js';
+import styles from './side-panel.scss.js';
+import { selectorTabbable } from '@carbon/web-components/es/globals/settings.js';
+import { carbonElement } from '@carbon/web-components/es/globals/decorators/carbon-element.js';
+import ArrowLeft16 from '../../icons/arrow--left/16';
+import Close20 from '../../icons/close/20';
+import { moderate02 } from '@carbon/motion';
+import '@carbon/web-components/es/components/button/index.js';
+import '@carbon/web-components/es/components/button/button-set-base.js';
+import '@carbon/web-components/es/components/icon-button/index.js';
+import '@carbon/web-components/es/components/layer/index.js';
+
+/**
+ * @license
+ *
+ * Copyright IBM Corp. 2023, 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+const blockClass = `${prefix}--side-panel`;
+const blockClassActionSet = `${prefix}--action-set`;
+/**
+ * Observes resize of the given element with the given resize observer.
+ *
+ * @param observer The resize observer.
+ * @param elem The element to observe the resize.
+ */
+const observeResize = (observer, elem) => {
+    if (!elem) {
+        return null;
+    }
+    observer.observe(elem);
+    return {
+        release() {
+            observer.unobserve(elem);
+            return null;
+        },
+    };
+};
+/**
+ * Tries to focus on the given elements and bails out if one of them is successful.
+ *
+ * @param elements The elements.
+ * @param reverse `true` to go through the list in reverse order.
+ * @returns `true` if one of the attempts is successful, `false` otherwise.
+ */
+function tryFocusElements(elements, reverse) {
+    if (!reverse) {
+        for (let i = 0; i < elements.length; ++i) {
+            const elem = elements[i];
+            elem.focus();
+            if (elem.ownerDocument.activeElement === elem) {
+                return true;
+            }
+        }
+    }
+    else {
+        for (let i = elements.length - 1; i >= 0; --i) {
+            const elem = elements[i];
+            elem.focus();
+            if (elem.ownerDocument.activeElement === elem) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * SidePanel.
+ *
+ * @element cds-side-panel
+ * @csspart dialog The dialog.
+ * @fires cds-side-panel-beingclosed
+ *   The custom event fired before this side-panel is being closed upon a user gesture.
+ *   Cancellation of this event stops the user-initiated action of closing this side-panel.
+ * @fires cds-side-panel-closed - The custom event fired after this side-panel is closed upon a user gesture.
+ * @fires cds-side-panel-navigate-back - custom event fired when clicking navigate back (available when step > 0)
+ */
+let CDSSidePanel = class CDSSidePanel extends HostListenerMixin(LitElement) {
+    constructor() {
+        super(...arguments);
+        /**
+         * The handle for observing resize of the parent element of this element.
+         */
+        this._hObserveResize = null;
+        /**
+         * The element that had focus before this side-panel gets open.
+         */
+        this._launcher = null;
+        this._doAnimateTitle = true;
+        this._isOpen = false;
+        this._containerScrollTop = -16;
+        this._hasSubtitle = false;
+        this._hasSlug = false;
+        this._hasActionToolbar = false;
+        this._actionsCount = 0;
+        this._slugCloseSize = 'sm';
+        /**
+         * Handles `blur` event on this element.
+         *
+         * @param event The event.
+         * @param event.target The event target.
+         * @param event.relatedTarget The event relatedTarget.
+         */
+        this._handleBlur = async ({ target, relatedTarget }) => {
+            var _a;
+            const { open, _startSentinelNode: startSentinelNode, _endSentinelNode: endSentinelNode, } = this;
+            const oldContains = target !== this && this.contains(target);
+            const currentContains = relatedTarget !== this &&
+                (this.contains(relatedTarget) ||
+                    (((_a = this.shadowRoot) === null || _a === void 0 ? void 0 : _a.contains(relatedTarget)) &&
+                        relatedTarget !== startSentinelNode &&
+                        relatedTarget !== endSentinelNode));
+            // Performs focus wrapping if _all_ of the following is met:
+            // * This side-panel is open
+            // * The viewport still has focus
+            // * SidePanel body used to have focus but no longer has focus
+            const { selectorTabbable: selectorTabbableForSidePanel } = this
+                .constructor;
+            if (open && relatedTarget && oldContains && !currentContains) {
+                const comparisonResult = target.compareDocumentPosition(relatedTarget);
+                // eslint-disable-next-line no-bitwise
+                if (relatedTarget === startSentinelNode || comparisonResult) {
+                    await this.constructor._delay();
+                    if (!tryFocusElements(this.querySelectorAll(selectorTabbableForSidePanel), true) &&
+                        relatedTarget !== this) {
+                        this.focus();
+                    }
+                }
+                // eslint-disable-next-line no-bitwise
+                else if (relatedTarget === endSentinelNode || comparisonResult) {
+                    await this.constructor._delay();
+                    if (!tryFocusElements(this.querySelectorAll(selectorTabbableForSidePanel), true)) {
+                        this.focus();
+                    }
+                }
+            }
+        };
+        this._handleKeydown = ({ key, target }) => {
+            if (key === 'Esc' || key === 'Escape') {
+                this._handleUserInitiatedClose(target);
+            }
+        };
+        this._reducedMotion = typeof window !== 'undefined' && (window === null || window === void 0 ? void 0 : window.matchMedia)
+            ? window.matchMedia('(prefers-reduced-motion: reduce)')
+            : { matches: true };
+        this._adjustPageContent = () => {
+            var _a, _b;
+            // sets/resets styles based on slideIn property and selectorPageContent;
+            if (this.selectorPageContent) {
+                const pageContentEl = document.querySelector(this.selectorPageContent);
+                if (pageContentEl) {
+                    const newValues = {
+                        marginInlineStart: '',
+                        marginInlineEnd: '',
+                        inlineSize: '',
+                        transition: this._reducedMotion.matches
+                            ? 'none'
+                            : `all ${moderate02}`,
+                        transitionProperty: 'margin-inline-start, margin-inline-end',
+                    };
+                    if (this.open) {
+                        newValues.inlineSize = 'auto';
+                        if (this.placement === 'left') {
+                            newValues.marginInlineStart = `${(_a = this === null || this === void 0 ? void 0 : this._sidePanel) === null || _a === void 0 ? void 0 : _a.offsetWidth}px`;
+                        }
+                        else {
+                            newValues.marginInlineEnd = `${(_b = this === null || this === void 0 ? void 0 : this._sidePanel) === null || _b === void 0 ? void 0 : _b.offsetWidth}px`;
+                        }
+                    }
+                    Object.keys(newValues).forEach((key) => {
+                        pageContentEl.style[key] = newValues[key];
+                    });
+                }
+            }
+        };
+        this._checkSetOpen = () => {
+            const { _sidePanel: sidePanel } = this;
+            if (sidePanel && this._isOpen) {
+                if (this._reducedMotion) {
+                    this._isOpen = false;
+                }
+                else {
+                    // wait until the side panel has transitioned off the screen to remove
+                    sidePanel.addEventListener('transitionend', () => {
+                        this._isOpen = false;
+                    });
+                }
+            }
+            else {
+                // allow the html to render before animating in the side panel
+                this._isOpen = this.open;
+            }
+        };
+        this._checkUpdateIconButtonSizes = () => {
+            var _a, _b;
+            const slug = this.querySelector(`${prefix}-slug`);
+            const otherButtons = (_a = this === null || this === void 0 ? void 0 : this.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelectorAll('#nav-back-button, #close-button');
+            let iconButtonSize = 'sm';
+            if (slug || (otherButtons === null || otherButtons === void 0 ? void 0 : otherButtons.length)) {
+                const actions = (_b = this === null || this === void 0 ? void 0 : this.querySelectorAll) === null || _b === void 0 ? void 0 : _b.call(this, `${prefix}-button[slot='actions']`);
+                if ((actions === null || actions === void 0 ? void 0 : actions.length) && /l/.test(this.size)) {
+                    iconButtonSize = 'md';
+                }
+            }
+            if (slug) {
+                slug === null || slug === void 0 ? void 0 : slug.setAttribute('size', iconButtonSize);
+            }
+            if (otherButtons) {
+                [...otherButtons].forEach((btn) => {
+                    btn.setAttribute('size', iconButtonSize);
+                });
+            }
+        };
+        this._checkUpdateActionSizes = () => {
+            if (this._actions) {
+                for (let i = 0; i < this._actions.length; i++) {
+                    this._actions[i].setAttribute('size', this.condensedActions ? 'lg' : 'xl');
+                }
+            }
+        };
+        this._maxActions = 3;
+        this._checkSetDoAnimateTitle = () => {
+            var _a, _b, _c;
+            let canDoAnimateTitle = false;
+            if (this._sidePanel &&
+                this.open &&
+                this.animateTitle &&
+                ((_a = this === null || this === void 0 ? void 0 : this.title) === null || _a === void 0 ? void 0 : _a.length) &&
+                !this._reducedMotion.matches) {
+                const scrollAnimationDistance = this._getScrollAnimationDistance();
+                // used to calculate the header moves
+                (_c = (_b = this === null || this === void 0 ? void 0 : this._sidePanel) === null || _b === void 0 ? void 0 : _b.style) === null || _c === void 0 ? void 0 : _c.setProperty(`--${blockClass}--scroll-animation-distance`, `${scrollAnimationDistance}`);
+                let scrollEl = this._animateScrollWrapper;
+                if (!scrollEl && this.animateTitle && !this._doAnimateTitle) {
+                    scrollEl = this._innerContent;
+                }
+                if (scrollEl) {
+                    const innerComputed = window === null || window === void 0 ? void 0 : window.getComputedStyle(this._innerContent);
+                    const innerPaddingHeight = innerComputed
+                        ? parseFloat(innerComputed === null || innerComputed === void 0 ? void 0 : innerComputed.paddingTop) +
+                            parseFloat(innerComputed === null || innerComputed === void 0 ? void 0 : innerComputed.paddingBottom)
+                        : 0;
+                    canDoAnimateTitle =
+                        (!!this.labelText || !!this._hasActionToolbar || this._hasSubtitle) &&
+                            scrollEl.scrollHeight - scrollEl.clientHeight >=
+                                scrollAnimationDistance + innerPaddingHeight;
+                }
+            }
+            this._doAnimateTitle = canDoAnimateTitle;
+        };
+        /**
+         * The `ResizeObserver` instance for observing element resizes for re-positioning floating menu position.
+         */
+        // TODO: Wait for `.d.ts` update to support `ResizeObserver`
+        // @ts-ignore
+        this._resizeObserver = new ResizeObserver(() => {
+            if (this._sidePanel) {
+                this._checkSetDoAnimateTitle();
+            }
+        });
+        this._getScrollAnimationDistance = () => {
+            var _a, _b, _c, _d;
+            const labelHeight = (_b = (_a = this === null || this === void 0 ? void 0 : this._label) === null || _a === void 0 ? void 0 : _a.offsetHeight) !== null && _b !== void 0 ? _b : 0;
+            const subtitleHeight = (_d = (_c = this === null || this === void 0 ? void 0 : this._subtitle) === null || _c === void 0 ? void 0 : _c.offsetHeight) !== null && _d !== void 0 ? _d : 0;
+            const titleVerticalBorder = this._hasActionToolbar
+                ? this._title.offsetHeight - this._title.clientHeight
+                : 0;
+            return labelHeight + subtitleHeight + titleVerticalBorder;
+        };
+        this._scrollObserver = () => {
+            var _a, _b, _c, _d;
+            const scrollTop = (_b = (_a = this._animateScrollWrapper) === null || _a === void 0 ? void 0 : _a.scrollTop) !== null && _b !== void 0 ? _b : 0;
+            const scrollAnimationDistance = this._getScrollAnimationDistance();
+            (_d = (_c = this === null || this === void 0 ? void 0 : this._sidePanel) === null || _c === void 0 ? void 0 : _c.style) === null || _d === void 0 ? void 0 : _d.setProperty(`--${blockClass}--scroll-animation-progress`, `${Math.min(scrollTop, scrollAnimationDistance) / scrollAnimationDistance}`);
+        };
+        this._handleCurrentStepUpdate = () => {
+            var _a;
+            const scrollable = (_a = this._animateScrollWrapper) !== null && _a !== void 0 ? _a : this._innerContent;
+            if (scrollable) {
+                scrollable.scrollTop = 0;
+            }
+        };
+        /**
+         * Determines if the title will animate on scroll
+         */
+        this.animateTitle = true;
+        /**
+         * Sets the close button icon description
+         */
+        this.closeIconDescription = 'Close';
+        /**
+         * Determines whether the side panel should render the condensed version (affects action buttons primarily)
+         */
+        this.condensedActions = false;
+        /**
+         * Determines whether the side panel should render with an overlay
+         */
+        this.includeOverlay = false;
+        /**
+         * Sets the icon description for the navigation back icon button
+         */
+        this.navigationBackIconDescription = 'Back';
+        /**
+         * `true` if the side-panel should be open.
+         */
+        this.open = false;
+        /**
+         * SidePanel placement.
+         */
+        this.placement = SIDE_PANEL_PLACEMENT.RIGHT;
+        /**
+         * Prevent closing on click outside of side-panel
+         */
+        this.preventCloseOnClickOutside = false;
+        /**
+         * Selector for page content, used to push content to side except
+         */
+        this.selectorPageContent = '';
+        /**
+         * SidePanel size.
+         */
+        this.size = SIDE_PANEL_SIZE.MEDIUM;
+        /**
+         * Determines if this panel slides in
+         */
+        this.slideIn = false;
+    }
+    /**
+     * Handles `click` event on the side-panel container.
+     *
+     * @param event The event.
+     */
+    _handleClickOnOverlay(event) {
+        if (!this.preventCloseOnClickOutside) {
+            this._handleUserInitiatedClose(event.target);
+        }
+    }
+    /**
+     * Handles `click` event on the side-panel container.
+     *
+     * @param event The event.
+     */
+    _handleCloseClick(event) {
+        this._handleUserInitiatedClose(event.target);
+    }
+    /**
+     * Handles user-initiated close request of this side-panel.
+     *
+     * @param triggeredBy The element that triggered this close request.
+     */
+    _handleUserInitiatedClose(triggeredBy) {
+        if (this.open) {
+            const init = {
+                bubbles: true,
+                cancelable: true,
+                composed: true,
+                detail: {
+                    triggeredBy,
+                },
+            };
+            if (this.dispatchEvent(new CustomEvent(this.constructor.eventBeforeClose, init))) {
+                this.open = false;
+                this.dispatchEvent(new CustomEvent(this.constructor.eventClose, init));
+            }
+        }
+    }
+    _handleNavigateBack(triggeredBy) {
+        this.dispatchEvent(new CustomEvent(this.constructor.eventNavigateBack, {
+            composed: true,
+            detail: {
+                triggeredBy,
+            },
+        }));
+    }
+    _handleSlugChange(e) {
+        this._checkUpdateIconButtonSizes();
+        const childItems = e.target.assignedElements();
+        this._hasSlug = childItems.length > 0;
+    }
+    _handleSubtitleChange(e) {
+        const target = e.target;
+        const subtitle = target === null || target === void 0 ? void 0 : target.assignedElements();
+        this._hasSubtitle = subtitle.length > 0;
+    }
+    // eslint-disable-next-line class-methods-use-this
+    _handleActionToolbarChange(e) {
+        const target = e.target;
+        const toolbarActions = target === null || target === void 0 ? void 0 : target.assignedElements();
+        this._hasActionToolbar = toolbarActions && toolbarActions.length > 0;
+        if (this._hasActionToolbar) {
+            for (const toolbarAction of toolbarActions) {
+                // toolbar actions size should always be sm
+                toolbarAction.setAttribute('size', 'sm');
+            }
+        }
+    }
+    _handleActionsChange(e) {
+        var _a;
+        const target = e.target;
+        const actions = target === null || target === void 0 ? void 0 : target.assignedElements();
+        // update slug size
+        this._checkUpdateIconButtonSizes();
+        const actionsCount = (_a = actions === null || actions === void 0 ? void 0 : actions.length) !== null && _a !== void 0 ? _a : 0;
+        if (actionsCount > this._maxActions) {
+            this._actionsCount = this._maxActions;
+            if (process.env.NODE_ENV === 'development') {
+                console.error(`Too many side-panel actions, max ${this._maxActions}.`);
+            }
+        }
+        else {
+            this._actionsCount = actionsCount;
+        }
+        for (let i = 0; i < (actions === null || actions === void 0 ? void 0 : actions.length); i++) {
+            if (i + 1 > this._maxActions) {
+                // hide excessive side panel actions
+                actions[i].setAttribute('hidden', 'true');
+                actions[i].setAttribute(`data-actions-limit-${this._maxActions}-exceeded`, `${actions.length}`);
+            }
+            else {
+                actions[i].classList.add(`${blockClassActionSet}__action-button`);
+            }
+        }
+        this._checkUpdateActionSizes();
+    }
+    async connectObservers() {
+        await this.updateComplete;
+        this._hObserveResize = observeResize(this._resizeObserver, this._sidePanel);
+    }
+    disconnectObservers() {
+        if (this._hObserveResize) {
+            this._hObserveResize = this._hObserveResize.release();
+        }
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.disconnectObservers();
+        this.connectObservers();
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.disconnectObservers();
+    }
+    render() {
+        const { closeIconDescription, condensedActions, currentStep, includeOverlay, labelText, navigationBackIconDescription, open, placement, size, slideIn, title, } = this;
+        if (!open && !this._isOpen) {
+            return html ``;
+        }
+        const actionsMultiple = ['', 'single', 'double', 'triple'][this._actionsCount];
+        const titleTemplate = html `<div
+      class=${`${blockClass}__title`}
+      ?no-label=${!!labelText}
+    >
+      <h2 class=${title ? `${blockClass}__title-text` : ''} title=${title}>
+        ${title}
+      </h2>
+
+      ${this._doAnimateTitle
+            ? html `<h2
+            class=${`${blockClass}__collapsed-title-text`}
+            title=${title}
+            aria-hidden="true"
+          >
+            ${title}
+          </h2>`
+            : ''}
+    </div>`;
+        const headerHasTitleClass = this.title
+            ? ` ${blockClass}__header--has-title `
+            : '';
+        const headerTemplate = html `
+      <div
+        class=${`${blockClass}__header${headerHasTitleClass}`}
+        ?detail-step=${currentStep > 0}
+        ?no-title-animation=${!this._doAnimateTitle}
+        ?reduced-motion=${this._reducedMotion.matches}
+      >
+        <!-- render back button -->
+        ${currentStep > 0
+            ? html `<cds-icon-button
+              align="bottom-left"
+              aria-label=${navigationBackIconDescription}
+              kind="ghost"
+              size="sm"
+              class=${`${prefix}--btn ${blockClass}__navigation-back-button`}
+              @click=${this._handleNavigateBack}
+            >
+              ${ArrowLeft16({ slot: 'icon' })}
+              <span slot="tooltip-content">
+                ${navigationBackIconDescription}
+              </span>
+            </cds-icon-button>`
+            : ''}
+
+        <!-- render title label -->
+        ${(title === null || title === void 0 ? void 0 : title.length) && (labelText === null || labelText === void 0 ? void 0 : labelText.length)
+            ? html ` <p class=${`${blockClass}__label-text`}>${labelText}</p>`
+            : ''}
+
+        <!-- title -->
+        ${title ? titleTemplate : ''}
+
+        <!-- render slug and close button area -->
+        <div class=${`${blockClass}__slug-and-close`}>
+          <slot name="slug" @slotchange=${this._handleSlugChange}></slot>
+          <!-- {normalizedSlug} -->
+          <cds-icon-button
+            align="bottom-right"
+            aria-label=${closeIconDescription}
+            kind="ghost"
+            size="sm"
+            class=${`${blockClass}__close-button`}
+            @click=${this._handleCloseClick}
+          >
+            ${Close20({ slot: 'icon' })}
+            <span slot="tooltip-content"> ${closeIconDescription} </span>
+          </cds-icon-button>
+        </div>
+
+        <!-- render sub title -->
+        <p
+          class=${this._hasSubtitle ? `${blockClass}__subtitle-text` : ''}
+          ?hidden=${!this._hasSubtitle}
+          ?no-title-animation=${!this._doAnimateTitle}
+          ?no-action-toolbar=${!this._hasActionToolbar}
+          ?no-title=${!title}
+        >
+          <slot
+            name="subtitle"
+            @slotchange=${this._handleSubtitleChange}
+          ></slot>
+        </p>
+
+        <div
+          class=${this._hasActionToolbar ? `${blockClass}__action-toolbar` : ''}
+          ?hidden=${!this._hasActionToolbar}
+          ?no-title-animation=${!this._doAnimateTitle}
+        >
+          <slot
+            name="action-toolbar"
+            @slotchange=${this._handleActionToolbarChange}
+          ></slot>
+        </div>
+      </div>
+    `;
+        const mainTemplate = html `<div
+      class=${`${blockClass}__inner-content`}
+      ?scrolls=${!this._doAnimateTitle}
+    >
+      <cds-layer level="1">
+        <slot></slot>
+      </cds-layer>
+    </div> `;
+        const sidePanelAnimateTitleClass = this._doAnimateTitle
+            ? ` ${blockClass}--animated-title`
+            : '';
+        return html `
+      <div
+        class=${`${blockClass}${sidePanelAnimateTitleClass}`}
+        part="dialog"
+        role="complementary"
+        placement="${placement}"
+        ?has-slug=${this._hasSlug}
+        ?open=${this._isOpen}
+        ?opening=${open && !this._isOpen}
+        ?closing=${!open && this._isOpen}
+        ?condensed-actions=${condensedActions}
+        ?overlay=${includeOverlay || slideIn}
+        ?slide-in=${slideIn}
+        size=${size}
+      >
+        <a
+          id="start-sentinel"
+          class="sentinel"
+          hidden
+          href="javascript:void 0"
+          role="navigation"
+        ></a>
+
+        ${this._doAnimateTitle
+            ? html `<div class=${`${blockClass}__animated-scroll-wrapper`} scrolls>
+              ${headerTemplate} ${mainTemplate}
+            </div>`
+            : html ` ${headerTemplate} ${mainTemplate}`}
+
+        <cds-button-set-base
+          class=${`${blockClass}__actions-container`}
+          ?hidden=${this._actionsCount === 0}
+          ?condensed=${condensedActions}
+          actions-multiple=${actionsMultiple}
+          size=${size}
+        >
+          <slot name="actions" @slotchange=${this._handleActionsChange}></slot>
+        </cds-button-set-base>
+
+        <a
+          id="end-sentinel"
+          class="sentinel"
+          hidden
+          href="javascript:void 0"
+          role="navigation"
+        ></a>
+      </div>
+
+      ${includeOverlay
+            ? html `<div
+            ?slide-in=${slideIn}
+            class=${`${blockClass}__overlay`}
+            ?open=${this.open}
+            ?opening=${open && !this._isOpen}
+            ?closing=${!open && this._isOpen}
+            tabindex="-1"
+            @click=${this._handleClickOnOverlay}
+          ></div>`
+            : ''}
+    `;
+    }
+    async updated(changedProperties) {
+        var _a, _b, _c, _d;
+        if (changedProperties.has('condensedActions')) {
+            this._checkUpdateActionSizes();
+        }
+        if (changedProperties.has('currentStep')) {
+            this._handleCurrentStepUpdate();
+        }
+        if (changedProperties.has('_doAnimateTitle')) {
+            (_a = this === null || this === void 0 ? void 0 : this._animateScrollWrapper) === null || _a === void 0 ? void 0 : _a.removeEventListener('scroll', this._scrollObserver);
+            if (this._doAnimateTitle) {
+                (_b = this === null || this === void 0 ? void 0 : this._animateScrollWrapper) === null || _b === void 0 ? void 0 : _b.addEventListener('scroll', this._scrollObserver);
+            }
+            else {
+                (_d = (_c = this === null || this === void 0 ? void 0 : this._sidePanel) === null || _c === void 0 ? void 0 : _c.style) === null || _d === void 0 ? void 0 : _d.setProperty(`--${blockClass}--scroll-animation-progress`, '0');
+            }
+        }
+        if (changedProperties.has('_isOpen') ||
+            changedProperties.has('animateTitle')) {
+            /* @state property changed */
+            this._checkSetDoAnimateTitle();
+        }
+        if (changedProperties.has('slideIn') ||
+            changedProperties.has('open') ||
+            changedProperties.has('includeOverlay')) {
+            this._adjustPageContent();
+        }
+        if (changedProperties.has('open')) {
+            this._checkSetOpen();
+            this.disconnectObservers();
+            if (this.open) {
+                this.connectObservers();
+                this._launcher = this.ownerDocument.activeElement;
+                const focusNode = this.selectorInitialFocus &&
+                    this.querySelector(this.selectorInitialFocus);
+                await this.constructor._delay();
+                if (focusNode) {
+                    // For cases where a `carbon-web-components` component (e.g. `<cds-button>`) being `primaryFocusNode`,
+                    // where its first update/render cycle that makes it focusable happens after `<cds-side-panel>`'s first update/render cycle
+                    focusNode.focus();
+                }
+                else if (!tryFocusElements(this.querySelectorAll(this.constructor.selectorTabbable), true)) {
+                    this.focus();
+                }
+            }
+            else if (this._launcher &&
+                typeof this._launcher.focus === 'function') {
+                this._launcher.focus();
+                this._launcher = null;
+            }
+        }
+    }
+    /**
+     * @param ms The number of milliseconds.
+     * @returns A promise that is resolves after the given milliseconds.
+     */
+    static _delay(ms = 0) {
+        return new Promise((resolve) => {
+            setTimeout(resolve, ms);
+        });
+    }
+    /**
+     * A selector selecting tabbable nodes.
+     */
+    static get selectorTabbable() {
+        return selectorTabbable;
+    }
+    /**
+     * The name of the custom event fired before this side-panel is being closed upon a user gesture.
+     * Cancellation of this event stops the user-initiated action of closing this side-panel.
+     */
+    static get eventBeforeClose() {
+        return `${prefix}-side-panel-beingclosed`;
+    }
+    /**
+     * The name of the custom event fired after this side-panel is closed upon a user gesture.
+     */
+    static get eventClose() {
+        return `${prefix}-side-panel-closed`;
+    }
+    /**
+     * The name of the custom event fired on clicking the navigate back button
+     */
+    static get eventNavigateBack() {
+        return `${prefix}-side-panel-navigate-back`;
+    }
+};
+CDSSidePanel.styles = styles; // `styles` here is a `CSSResult` generated by custom WebPack loader
+__decorate([
+    query('#start-sentinel')
+], CDSSidePanel.prototype, "_startSentinelNode", void 0);
+__decorate([
+    query('#end-sentinel')
+], CDSSidePanel.prototype, "_endSentinelNode", void 0);
+__decorate([
+    query(`.${blockClass}`)
+], CDSSidePanel.prototype, "_sidePanel", void 0);
+__decorate([
+    query(`.${blockClass}__animated-scroll-wrapper`)
+], CDSSidePanel.prototype, "_animateScrollWrapper", void 0);
+__decorate([
+    query(`.${blockClass}__label-text`)
+], CDSSidePanel.prototype, "_label", void 0);
+__decorate([
+    query(`.${blockClass}__title-text`)
+], CDSSidePanel.prototype, "_title", void 0);
+__decorate([
+    query(`.${blockClass}__subtitle-text`)
+], CDSSidePanel.prototype, "_subtitle", void 0);
+__decorate([
+    query(`.${blockClass}__inner-content`)
+], CDSSidePanel.prototype, "_innerContent", void 0);
+__decorate([
+    queryAssignedElements({
+        slot: 'actions',
+        selector: `${carbonPrefix}-button`,
+    })
+], CDSSidePanel.prototype, "_actions", void 0);
+__decorate([
+    state()
+], CDSSidePanel.prototype, "_doAnimateTitle", void 0);
+__decorate([
+    state()
+], CDSSidePanel.prototype, "_isOpen", void 0);
+__decorate([
+    state()
+], CDSSidePanel.prototype, "_containerScrollTop", void 0);
+__decorate([
+    state()
+], CDSSidePanel.prototype, "_hasSubtitle", void 0);
+__decorate([
+    state()
+], CDSSidePanel.prototype, "_hasSlug", void 0);
+__decorate([
+    state()
+], CDSSidePanel.prototype, "_hasActionToolbar", void 0);
+__decorate([
+    state()
+], CDSSidePanel.prototype, "_actionsCount", void 0);
+__decorate([
+    state()
+], CDSSidePanel.prototype, "_slugCloseSize", void 0);
+__decorate([
+    HostListener('shadowRoot:focusout')
+    // @ts-ignore: The decorator refers to this method but TS thinks this method is not referred to
+], CDSSidePanel.prototype, "_handleBlur", void 0);
+__decorate([
+    HostListener('document:keydown')
+    // @ts-ignore: The decorator refers to this method but TS thinks this method is not referred to
+], CDSSidePanel.prototype, "_handleKeydown", void 0);
+__decorate([
+    property({ reflect: true, attribute: 'animate-title', type: Boolean })
+], CDSSidePanel.prototype, "animateTitle", void 0);
+__decorate([
+    property({ reflect: true, attribute: 'close-icon-description' })
+], CDSSidePanel.prototype, "closeIconDescription", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true, attribute: 'condensed-actions' })
+], CDSSidePanel.prototype, "condensedActions", void 0);
+__decorate([
+    property({ reflect: true, attribute: 'current-step', type: Number })
+], CDSSidePanel.prototype, "currentStep", void 0);
+__decorate([
+    property({ attribute: 'include-overlay', type: Boolean, reflect: true })
+], CDSSidePanel.prototype, "includeOverlay", void 0);
+__decorate([
+    property({ reflect: true, attribute: 'label-text' })
+], CDSSidePanel.prototype, "labelText", void 0);
+__decorate([
+    property({ reflect: true, attribute: 'navigation-back-icon-description' })
+], CDSSidePanel.prototype, "navigationBackIconDescription", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], CDSSidePanel.prototype, "open", void 0);
+__decorate([
+    property({ reflect: true, type: String })
+], CDSSidePanel.prototype, "placement", void 0);
+__decorate([
+    property({ type: Boolean, attribute: 'prevent-close-on-click-outside' })
+], CDSSidePanel.prototype, "preventCloseOnClickOutside", void 0);
+__decorate([
+    property({
+        reflect: true,
+        attribute: 'selector-initial-focus',
+        type: String,
+    })
+], CDSSidePanel.prototype, "selectorInitialFocus", void 0);
+__decorate([
+    property({ reflect: true, attribute: 'selector-page-content' })
+], CDSSidePanel.prototype, "selectorPageContent", void 0);
+__decorate([
+    property({ reflect: true, type: String })
+], CDSSidePanel.prototype, "size", void 0);
+__decorate([
+    property({ attribute: 'slide-in', type: Boolean, reflect: true })
+], CDSSidePanel.prototype, "slideIn", void 0);
+__decorate([
+    property({ reflect: false, type: String })
+], CDSSidePanel.prototype, "title", void 0);
+CDSSidePanel = __decorate([
+    carbonElement(`${prefix}-side-panel`)
+], CDSSidePanel);
+var CDSSidePanel$1 = CDSSidePanel;
+
+export { SIDE_PANEL_PLACEMENT, SIDE_PANEL_SIZE, CDSSidePanel$1 as default };
+//# sourceMappingURL=side-panel.js.map