lightning-base-components 1.27.5-alpha → 1.28.4-alpha

package/src/lightning/modalBody/modalBody.d.ts

@@ -0,0 +1,47 @@
+import LightningShadowBaseClass from 'lightning/shadowBaseClassPrivate';
+interface ModalValues {
+    headerHeight: number;
+    footerHeight: number;
+    backdropHeight: number;
+    paddingTop?: number;
+    paddingBottom?: number;
+    modalBodyMinHeight?: number;
+    minModalBodyHeightStyle?: string;
+    maxModalBodyHeightStyle?: string | null;
+    modalBodyUsableHeight?: number | null;
+    modalUsableHeight?: number | null;
+    backdropWidth?: number;
+    sizeSetFull?: boolean;
+    isSmallScreenSize?: boolean;
+    size?: string;
+}
+export default class LightningModalBody extends LightningShadowBaseClass {
+    initialRender: boolean;
+    initialSlotRender: boolean;
+    unregisterCallback: (() => void) | null;
+    headerPresent: boolean;
+    footerPresent: boolean;
+    handleDefaultSlotChange(): void;
+    handleScrollableContainerRepositionEvent(event: CustomEvent): void;
+    get modalBodyCssClasses(): string;
+    get contentElem(): HTMLElement | null;
+    get modalContentId(): string | null;
+    get defaultSlotElement(): HTMLSlotElement | null;
+    get isDefaultSlotPopulated(): boolean;
+    get firstTabbableElement(): HTMLElement | null;
+    calculateModalUsableHeight(values: ModalValues): ModalValues;
+    calculateModalBodyUsableHeight({ modalUsableHeight, headerHeight, footerHeight, }: ModalValues): number;
+    updateModalBodyHeightValues(values: ModalValues): ModalValues;
+    setModalBodyHeight(values: ModalValues, shouldUseFullHeight: boolean): void;
+    updateValues(values: ModalValues): ModalValues;
+    handleUpdateModalBodyHeight(values: ModalValues): void;
+    registerWithParent(): void;
+    handleModalBodyFocusin: any;
+    initState(): void;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    renderedCallback(): void;
+}
+export {};
+//# sourceMappingURL=modalBody.d.ts.map

package/src/lightning/modalBody/modalBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modalBody.d.ts","sourceRoot":"","sources":["../../../../../modules/lightning/modalBody/modalBody.ts"],"names":[],"mappings":"AAAA,OAAO,wBAAwB,MAAM,kCAAkC,CAAC;AAUxE,UAAU,WAAW;IAEjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IAGvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,wBAAwB;IAEpE,aAAa,EAAE,OAAO,CAAQ;IAC9B,iBAAiB,EAAE,OAAO,CAAQ;IAClC,kBAAkB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAC/C,aAAa,EAAE,OAAO,CAAS;IAC/B,aAAa,EAAE,OAAO,CAAS;IAO/B,uBAAuB,IAAI,IAAI;IAc/B,wCAAwC,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAYlE,IAAI,mBAAmB,IAAI,MAAM,CAOhC;IAOD,IAAI,WAAW,IAAI,WAAW,GAAG,IAAI,CAEpC;IAOD,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAElC;IAOD,IAAI,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAE/C;IAOD,IAAI,sBAAsB,IAAI,OAAO,CAMpC;IAQD,IAAI,oBAAoB,IAAI,WAAW,GAAG,IAAI,CAY7C;IASD,0BAA0B,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW;IAc5D,8BAA8B,CAAC,EAC3B,iBAAiB,EACjB,YAAY,EACZ,YAAY,GACf,EAAE,WAAW,GAAG,MAAM;IAavB,2BAA2B,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW;IAgB7D,kBAAkB,CACd,MAAM,EAAE,WAAW,EACnB,mBAAmB,EAAE,OAAO,GAC7B,IAAI;IA8BP,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW;IAwC9C,2BAA2B,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAsCtD,kBAAkB,IAAI,IAAI;IAqB1B,sBAAsB,MAAuC;IAO7D,SAAS,IAAI,IAAI;;IAajB,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAM5B,gBAAgB,IAAI,IAAI;CAM3B"}

package/src/lightning/modalBody/modalBody.js

@@ -0,0 +1,172 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import LightningShadowBaseClass from 'lightning/shadowBaseClassPrivate';
+import { classSet } from 'lightning/utils';
+import { getRealDOMId } from 'lightning/utilsPrivate';
+import { privateContext } from 'lightning/utilsInternal';
+import { findAllTabbableElements, filterTooltips } from 'lightning/focusUtils';
+import { modalFocusinEventHandler } from 'lightning/modalUtils';
+const { setContext, assertContext } = privateContext;
+export default class LightningModalBody extends LightningShadowBaseClass {
+    initialRender = true;
+    initialSlotRender = true;
+    unregisterCallback = null;
+    headerPresent = false;
+    footerPresent = false;
+    handleDefaultSlotChange() {
+        if (this.initialSlotRender) {
+            this.initialSlotRender = false;
+        }
+        this.registerWithParent();
+    }
+    handleScrollableContainerRepositionEvent(event) {
+        const { callback: repositionCallback } = event.detail;
+        repositionCallback(event.composedPath());
+        event.stopPropagation();
+    }
+    get modalBodyCssClasses() {
+        const classes = classSet('slds-modal__content slds-p-around_medium');
+        classes.add({
+            'slds-modal__content_headless': !this.headerPresent,
+            'slds-modal__content_footless': !this.footerPresent,
+        });
+        return classes.toString();
+    }
+    get contentElem() {
+        return this.template.querySelector('[data-content-container]');
+    }
+    get modalContentId() {
+        return getRealDOMId(this.contentElem);
+    }
+    get defaultSlotElement() {
+        return this.template.querySelector('[data-default-slot]');
+    }
+    get isDefaultSlotPopulated() {
+        const slotElement = this.defaultSlotElement;
+        if (slotElement && slotElement.assignedNodes) {
+            return slotElement.assignedNodes().length > 0;
+        }
+        return false;
+    }
+    get firstTabbableElement() {
+        let firstElem = null;
+        if (this.isDefaultSlotPopulated) {
+            const tabbableElements = findAllTabbableElements(this.defaultSlotElement);
+            const filteredElements = filterTooltips(tabbableElements);
+            if (filteredElements.length > 0) {
+                firstElem = filteredElements[0];
+            }
+        }
+        return firstElem;
+    }
+    calculateModalUsableHeight(values) {
+        const { backdropHeight, paddingTop, paddingBottom } = values;
+        const modalUsableHeight = backdropHeight - paddingTop - paddingBottom;
+        values.modalUsableHeight = modalUsableHeight;
+        return values;
+    }
+    calculateModalBodyUsableHeight({ modalUsableHeight, headerHeight, footerHeight, }) {
+        return modalUsableHeight - headerHeight - footerHeight;
+    }
+    updateModalBodyHeightValues(values) {
+        const updatedValues = this.calculateModalUsableHeight(values);
+        const modalBodyUsableHeight = this.calculateModalBodyUsableHeight(updatedValues);
+        values.modalBodyUsableHeight = modalBodyUsableHeight;
+        values.maxModalBodyHeightStyle = `${modalBodyUsableHeight}px`;
+        return values;
+    }
+    setModalBodyHeight(values, shouldUseFullHeight) {
+        const styles = { maxHeight: null, minHeight: null };
+        if (!shouldUseFullHeight) {
+            const { maxModalBodyHeightStyle, minModalBodyHeightStyle } = this.updateModalBodyHeightValues(values);
+            styles.maxHeight = maxModalBodyHeightStyle;
+            styles.minHeight = minModalBodyHeightStyle;
+        }
+        const divElem = this.contentElem;
+        Object.assign(divElem.style, styles);
+    }
+    updateValues(values) {
+        const { headerHeight, footerHeight, backdropHeight } = values;
+        const MODAL_BODY_MIN_HEIGHT = 80;
+        const PAD_TOP_DEFAULT = 48;
+        const PAD_BOTTOM_DEFAULT = 80;
+        const updatedValues = {
+            headerHeight: Math.floor(headerHeight),
+            footerHeight: Math.floor(footerHeight),
+            backdropHeight: Math.floor(backdropHeight),
+            paddingTop: PAD_TOP_DEFAULT,
+            paddingBottom: PAD_BOTTOM_DEFAULT,
+            modalBodyMinHeight: MODAL_BODY_MIN_HEIGHT,
+            minModalBodyHeightStyle: `${MODAL_BODY_MIN_HEIGHT}px`,
+            maxModalBodyHeightStyle: null,
+            modalBodyUsableHeight: null,
+            modalUsableHeight: null,
+        };
+        return updatedValues;
+    }
+    handleUpdateModalBodyHeight(values) {
+        if (!this.initialRender) {
+            const { sizeSetFull, isSmallScreenSize, size, headerHeight, footerHeight, } = values;
+            this.headerPresent = headerHeight !== 0;
+            this.footerPresent = footerHeight !== 0;
+            const shouldUseFullHeight = sizeSetFull && isSmallScreenSize;
+            const updatedValues = this.updateValues(values);
+            this.setModalBodyHeight(updatedValues, shouldUseFullHeight);
+            if (!this.headerPresent) {
+                this.setAttribute('data-variant-headless', '');
+            }
+            if (!this.footerPresent) {
+                this.setAttribute('data-variant-footless', '');
+            }
+            this.setAttribute('data-size', size);
+        }
+    }
+    registerWithParent() {
+        assertContext(this);
+        const evtRegister = new CustomEvent('privatemodalbodyregister', {
+            bubbles: true,
+            composed: true,
+            detail: {
+                bodyId: this.modalContentId,
+                bodyIsPopulated: this.isDefaultSlotPopulated,
+                defaultSlotHasRendered: !this.initialSlotRender,
+                updateBodyCallback: this.handleUpdateModalBodyHeight.bind(this),
+                unRegisterCallback: (unregisterCallback) => {
+                    this.unregisterCallback = unregisterCallback;
+                },
+                firstTabbableElemRef: this.firstTabbableElement,
+            },
+        });
+        this.dispatchEvent(evtRegister);
+    }
+    handleModalBodyFocusin = modalFocusinEventHandler.bind(this);
+    initState() {
+        this.initialRender = true;
+        this.initialSlotRender = true;
+        this.unregisterCallback = null;
+        this.headerPresent = false;
+        this.footerPresent = false;
+    }
+    constructor() {
+        super();
+        setContext(this);
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.initState();
+    }
+    disconnectedCallback() {
+        if (this.unregisterCallback) {
+            this.unregisterCallback();
+        }
+    }
+    renderedCallback() {
+        if (this.initialRender) {
+            this.registerWithParent();
+            this.initialRender = false;
+        }
+    }
+}

package/src/lightning/modalFooter/modalFooter.d.ts

@@ -0,0 +1,19 @@
+import LightningShadowBaseClass from 'lightning/shadowBaseClassPrivate';
+export default class LightningModalFooter extends LightningShadowBaseClass {
+    initialRender: boolean;
+    initialSlotRender: boolean;
+    hideFooter: boolean;
+    unregisterCallback: (() => void) | null;
+    handleDefaultSlotChange(): void;
+    get footerCssClasses(): string;
+    get footerHeight(): number;
+    get defaultSlotElement(): HTMLSlotElement | null;
+    get isDefaultSlotPopulated(): boolean;
+    registerWithParent(): void;
+    handleModalFooterFocusin: any;
+    initState(): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    renderedCallback(): void;
+}
+//# sourceMappingURL=modalFooter.d.ts.map

package/src/lightning/modalFooter/modalFooter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modalFooter.d.ts","sourceRoot":"","sources":["../../../../../modules/lightning/modalFooter/modalFooter.ts"],"names":[],"mappings":"AAAA,OAAO,wBAAwB,MAAM,kCAAkC,CAAC;AAexE,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,wBAAwB;IAEtE,aAAa,EAAE,OAAO,CAAQ;IAC9B,iBAAiB,EAAE,OAAO,CAAQ;IAClC,UAAU,EAAE,OAAO,CAAS;IAC5B,kBAAkB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAO/C,uBAAuB,IAAI,IAAI;IAgB/B,IAAI,gBAAgB,IAAI,MAAM,CAY7B;IAOD,IAAI,YAAY,IAAI,MAAM,CAKzB;IAOD,IAAI,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAE/C;IAOD,IAAI,sBAAsB,IAAI,OAAO,CAMpC;IASD,kBAAkB,IAAI,IAAI;IAiB1B,wBAAwB,MAAuC;IAS/D,SAAS,IAAI,IAAI;IAOjB,iBAAiB,IAAI,IAAI;IAOzB,oBAAoB,IAAI,IAAI;IAM5B,gBAAgB,IAAI,IAAI;CAO3B"}

package/src/lightning/modalFooter/modalFooter.js

@@ -0,0 +1,90 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import LightningShadowBaseClass from 'lightning/shadowBaseClassPrivate';
+import { classSet } from 'lightning/utils';
+import { modalFocusinEventHandler } from 'lightning/modalUtils';
+import orgHasWCAGResizeReflowSC from '@salesforce/accessCheck/ComponentAccessibility.orgHasWCAGResizeReflowSC';
+const footerClass = 'slds-modal__footer';
+const hideClass = 'slds-hide';
+const footerSelector = `.${footerClass}`;
+const footerSlotSelector = '[data-footer-slot]';
+export default class LightningModalFooter extends LightningShadowBaseClass {
+    initialRender = true;
+    initialSlotRender = true;
+    hideFooter = false;
+    unregisterCallback = null;
+    handleDefaultSlotChange() {
+        if (this.initialSlotRender) {
+            this.initialSlotRender = false;
+        }
+        this.registerWithParent();
+        this.hideFooter = !this.isDefaultSlotPopulated;
+    }
+    get footerCssClasses() {
+        const classes = classSet(footerClass);
+        classes.add({
+            [hideClass]: this.hideFooter,
+        });
+        classes.add({
+            'slds-modal__footer__reflow_resize': !!orgHasWCAGResizeReflowSC,
+        });
+        return classes.toString();
+    }
+    get footerHeight() {
+        const divElem = this.template.querySelector(footerSelector);
+        const footerRect = divElem ? divElem.getBoundingClientRect() : {};
+        const { height } = footerRect;
+        return height || 0;
+    }
+    get defaultSlotElement() {
+        return this.template.querySelector(footerSlotSelector);
+    }
+    get isDefaultSlotPopulated() {
+        const slotElement = this.defaultSlotElement;
+        if (slotElement && slotElement.assignedNodes) {
+            return slotElement.assignedNodes().length > 0;
+        }
+        return true;
+    }
+    registerWithParent() {
+        const evtRegister = new CustomEvent('privatemodalfooterregister', {
+            bubbles: true,
+            composed: true,
+            detail: {
+                footerHeight: this.footerHeight,
+                defaultSlotIsPopulated: this.isDefaultSlotPopulated,
+                defaultSlotHasRendered: !this.initialSlotRender,
+                unRegisterCallback: (unregisterCallback) => {
+                    this.unregisterCallback = unregisterCallback;
+                },
+            },
+        });
+        this.dispatchEvent(evtRegister);
+    }
+    handleModalFooterFocusin = modalFocusinEventHandler.bind(this);
+    initState() {
+        this.initialRender = true;
+        this.initialSlotRender = true;
+        this.hideFooter = false;
+        this.unregisterCallback = null;
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.initState();
+    }
+    disconnectedCallback() {
+        if (this.unregisterCallback) {
+            this.unregisterCallback();
+        }
+    }
+    renderedCallback() {
+        if (this.initialRender) {
+            this.registerWithParent();
+            this.initialRender = false;
+        }
+        this.hideFooter = !this.isDefaultSlotPopulated;
+    }
+}

package/src/lightning/modalHeader/modalHeader.d.ts

@@ -0,0 +1,24 @@
+import LightningShadowBaseClass from 'lightning/shadowBaseClassPrivate';
+export default class LightningModalHeader extends LightningShadowBaseClass {
+    initialRender: boolean;
+    initialSlotRender: boolean;
+    unregisterCallback: (() => void) | null;
+    defaultSlotPopulated: boolean;
+    label: string;
+    handleDefaultSlotChange(): void;
+    get headerHeight(): number;
+    get modalTitleElement(): HTMLElement | null;
+    get modalLabelId(): string | null;
+    get defaultSlotWrapperElement(): HTMLElement | null;
+    get defaultSlotWrapperId(): string | null;
+    get defaultSlotElement(): HTMLSlotElement | null;
+    get isDefaultSlotPopulated(): boolean;
+    get isLabelPopulated(): boolean;
+    registerWithParent(): void;
+    handleModalHeaderFocusin: any;
+    initState(): void;
+    connectedCallback(): void;
+    renderedCallback(): void;
+    disconnectedCallback(): void;
+}
+//# sourceMappingURL=modalHeader.d.ts.map

package/src/lightning/modalHeader/modalHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modalHeader.d.ts","sourceRoot":"","sources":["../../../../../modules/lightning/modalHeader/modalHeader.ts"],"names":[],"mappings":"AACA,OAAO,wBAAwB,MAAM,kCAAkC,CAAC;AAcxE,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,wBAAwB;IAEtE,aAAa,EAAE,OAAO,CAAQ;IAC9B,iBAAiB,EAAE,OAAO,CAAQ;IAClC,kBAAkB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAC/C,oBAAoB,EAAE,OAAO,CAAC;IAKzB,KAAK,EAAE,MAAM,CAAM;IAOxB,uBAAuB,IAAI,IAAI;IAa/B,IAAI,YAAY,IAAI,MAAM,CAMzB;IAQD,IAAI,iBAAiB,IAAI,WAAW,GAAG,IAAI,CAE1C;IAQD,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAGhC;IAQD,IAAI,yBAAyB,IAAI,WAAW,GAAG,IAAI,CAElD;IASD,IAAI,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAExC;IAOD,IAAI,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAE/C;IAOD,IAAI,sBAAsB,IAAI,OAAO,CASpC;IAQD,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IASD,kBAAkB,IAAI,IAAI;IA4B1B,wBAAwB,MAAuC;IAS/D,SAAS,IAAI,IAAI;IAMjB,iBAAiB,IAAI,IAAI;IAKzB,gBAAgB,IAAI,IAAI;IAOxB,oBAAoB,IAAI,IAAI;CAK/B"}

package/src/lightning/modalHeader/modalHeader.js

@@ -0,0 +1,109 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { api } from 'lwc';
+import LightningShadowBaseClass from 'lightning/shadowBaseClassPrivate';
+import { getRealDOMId } from 'lightning/utilsPrivate';
+import { modalFocusinEventHandler } from 'lightning/modalUtils';
+import orgHasWCAGResizeReflowSC from '@salesforce/accessCheck/ComponentAccessibility.orgHasWCAGResizeReflowSC';
+const modalHeaderSelector = '.slds-modal__header';
+const labelSelector = '[data-label]';
+const slotWrapperSelector = '[data-slot-wrapper]';
+const defaultSlotSelector = '[data-default-slot]';
+export default class LightningModalHeader extends LightningShadowBaseClass {
+    initialRender = true;
+    initialSlotRender = true;
+    unregisterCallback = null;
+    defaultSlotPopulated;
+    @api
+    label = '';
+    handleDefaultSlotChange() {
+        if (this.initialSlotRender) {
+            this.initialSlotRender = false;
+        }
+        this.registerWithParent();
+    }
+    get headerHeight() {
+        const divElem = this.template.querySelector(modalHeaderSelector);
+        const headerRect = divElem ? divElem.getBoundingClientRect() : {};
+        const { height } = headerRect;
+        const heightValue = height || 0;
+        return heightValue;
+    }
+    get modalTitleElement() {
+        return this.template.querySelector(labelSelector);
+    }
+    get modalLabelId() {
+        const labelElem = this.modalTitleElement;
+        return getRealDOMId(labelElem);
+    }
+    get defaultSlotWrapperElement() {
+        return this.template.querySelector(slotWrapperSelector);
+    }
+    get defaultSlotWrapperId() {
+        return getRealDOMId(this.defaultSlotWrapperElement);
+    }
+    get defaultSlotElement() {
+        return this.template.querySelector(defaultSlotSelector);
+    }
+    get isDefaultSlotPopulated() {
+        const slotElement = this.defaultSlotElement;
+        if (slotElement && slotElement.assignedNodes) {
+            const slotPopulated = slotElement.assignedNodes().length > 0;
+            this.defaultSlotPopulated = slotPopulated;
+            return slotPopulated;
+        }
+        this.defaultSlotPopulated = false;
+        return false;
+    }
+    get isLabelPopulated() {
+        return (this.label && this.label.trim().length > 0) || false;
+    }
+    registerWithParent() {
+        if (orgHasWCAGResizeReflowSC) {
+            this.template
+                .querySelector(modalHeaderSelector)
+                .classList.add('slds-modal__header__reflow_resize');
+        }
+        const evtRegister = new CustomEvent('privatemodalheaderregister', {
+            bubbles: true,
+            composed: true,
+            detail: {
+                labelId: this.modalLabelId,
+                labelIsPopulated: this.isLabelPopulated,
+                headerHeight: this.headerHeight,
+                defaultSlotWrapperId: this.defaultSlotWrapperId,
+                defaultSlotIsPopulated: this.isDefaultSlotPopulated,
+                defaultSlotHasRendered: !this.initialSlotRender,
+                unRegisterCallback: (unregisterCallback) => {
+                    this.unregisterCallback = unregisterCallback;
+                },
+                headerRef: this.modalTitleElement,
+            },
+        });
+        this.dispatchEvent(evtRegister);
+    }
+    handleModalHeaderFocusin = modalFocusinEventHandler.bind(this);
+    initState() {
+        this.initialRender = true;
+        this.initialSlotRender = true;
+        this.unregisterCallback = null;
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.initState();
+    }
+    renderedCallback() {
+        if (this.initialRender) {
+            this.registerWithParent();
+            this.initialRender = false;
+        }
+    }
+    disconnectedCallback() {
+        if (this.unregisterCallback) {
+            this.unregisterCallback();
+        }
+    }
+}

package/src/lightning/modalUtils/modalUtils.d.ts

@@ -0,0 +1,8 @@
+interface ModalUtils {
+    isModalClosing: boolean;
+    lastFocusedElement: HTMLElement | null;
+    dispatchEvent: (event: CustomEvent) => void;
+}
+export declare function modalFocusinEventHandler(this: ModalUtils, e: FocusEvent): void;
+export {};
+//# sourceMappingURL=modalUtils.d.ts.map

package/src/lightning/modalUtils/modalUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modalUtils.d.ts","sourceRoot":"","sources":["../../../../../modules/lightning/modalUtils/modalUtils.ts"],"names":[],"mappings":"AAeA,UAAU,UAAU;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,EAAE,WAAW,GAAG,IAAI,CAAC;IACvC,aAAa,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CAC/C;AAED,wBAAgB,wBAAwB,CACpC,IAAI,EAAE,UAAU,EAChB,CAAC,EAAE,UAAU,GACd,IAAI,CAyCN"}

package/src/lightning/modalUtils/modalUtils.js

@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { getElementWithFocus, returnFocusToElement, } from 'lightning/focusUtils';
+import { isLwcModalActive } from 'lightning/overlayManager';
+import { secure } from 'lightning/overlayUtils';
+const MODAL_SELECTORS = [
+    'lightning-modal-header',
+    'lightning-modal-body',
+    'lightning-modal-footer',
+    'lightning-focus-trap',
+    'lightning-overlay-container',
+];
+export function modalFocusinEventHandler(e) {
+    const { isModalClosing, lastFocusedElement } = this;
+    if (!isLwcModalActive() || isModalClosing) {
+        return;
+    }
+    let isTargetRelatedToModal = null;
+    if (e.target && typeof e.target.closest === 'function') {
+        isTargetRelatedToModal = e.target.closest(MODAL_SELECTORS.join(','));
+    }
+    else if (e.relatedTarget &&
+        typeof e.relatedTarget.closest === 'function') {
+        isTargetRelatedToModal = e.relatedTarget.closest(MODAL_SELECTORS.join(','));
+    }
+    if (isTargetRelatedToModal) {
+        this.lastFocusedElement = getElementWithFocus();
+        this.dispatchEvent(new CustomEvent('privatelightningmodallastfocus', {
+            composed: true,
+            bubbles: true,
+            detail: {
+                [secure]: true,
+                privatelightningmodallastfocus: this.lastFocusedElement,
+            },
+        }));
+    }
+    else if (lastFocusedElement) {
+        if (!lastFocusedElement.ariaHasPopup) {
+            returnFocusToElement(lastFocusedElement);
+        }
+    }
+}

package/src/lightning/multiColumnSortingModal/multiColumnSortingModal.d.ts

@@ -0,0 +1,69 @@
+/// <reference types="experimental-core-types" />
+export default class MultiColumnSortingModal extends LightningModal<any> {
+    constructor();
+    dynamicCmp: any;
+    dynamicCmpEvents: any;
+    dynamicCmpAttributes: any;
+    dtInstance: any;
+    size: string;
+    rules: {
+        selectedColumn: any;
+        sortOrder: string;
+    }[];
+    validInputs: boolean;
+    _modalBody: any;
+    _scrollToBottom: boolean;
+    assistiveText: string;
+    ruleIndexToSetLast: any;
+    get i18n(): {
+        modalTitle: string;
+        firstRuleHeading: string;
+        otherRuleHeading: string;
+        addRule: string;
+        ruleLimit: string;
+        ruleLimitReached: string;
+        clearButton: string;
+        cancelButton: string;
+        applyButton: string;
+        duplicateValueValidation: string;
+        multiColumnSortingToast: string;
+        ascending: string;
+        descending: string;
+        columnMovedUp: string;
+        columnMovedDown: string;
+    };
+    connectedCallback(): void;
+    renderedCallback(): void;
+    validationThroughApplyButton: boolean;
+    get columnSorters(): Element[];
+    get comboboxInputs(): any[];
+    get modalBody(): any;
+    get rulesWithData(): {
+        heading: string;
+        unselectedInitialRules: boolean;
+        disabledTrash: boolean;
+        selectedColumn: any;
+        sortOrder: string;
+        key: string;
+    }[];
+    get processedColumns(): any;
+    get ruleLimitText(): string;
+    get ruleLimitTextStyle(): "" | "color:#8C4B02;";
+    get isAddRuleButtonDisabled(): boolean;
+    get isApplyButtonDisabled(): boolean;
+    get isClearButtonDisabled(): boolean;
+    handleAddRule(): void;
+    handleDeleteRule(event: any): void;
+    handleSelectionChange(event: any): void;
+    handleRuleMovement(event: any): void;
+    applyRules(): void;
+    getToastMessage(fieldNames: any, sortDirections: any): string;
+    sendToast(toastMessage: any, variant: any): () => void;
+    clearRules(): void;
+    cancelRules(): void;
+    handleScrolling(): void;
+    setDuplicates(rules: any[]): Set<any>;
+    reportValidity(comboboxInputs: any[]): void;
+}
+import LightningModal from 'lightning/modal';
+//# sourceMappingURL=multiColumnSortingModal.d.ts.map

package/src/lightning/multiColumnSortingModal/multiColumnSortingModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiColumnSortingModal.d.ts","sourceRoot":"","sources":["../../../../../modules/lightning/multiColumnSortingModal/multiColumnSortingModal.js"],"names":[],"mappings":";AA+CA;IA3C8E,cACtE;IA2CJ,gBAAgB;IAChB,sBAAsB;IACtB,0BAA0B;IAG1B,gBAAgB;IAChB,aAAe;IACf;;;QAA4B;IAG5B,qBAAmB;IACnB,gBAAW;IACX,yBAAwB;IACxB,sBAAmB;IAEnB,wBAA+B;IAE/B;;;;;;;;;;;;;;;;MAEC;IAMD,0BAqBC;IAED,yBAiDC;IALO,sCAAyC;IAQjD,+BAIC;IAGD,4BAEC;IAGD,qBAOC;IAED;;;;;;;QAYC;IAMD,4BAWC;IAKD,4BAKC;IAKD,gDAIC;IAKD,uCAQC;IAKD,qCAwBC;IAKD,qCAEC;IAKD,sBAGC;IAKD,mCAiBC;IAKD,wCAiBC;IAKD,qCA6BC;IAMD,mBA8BC;IAED,8DAiBC;IAED,uDAWC;IAKD,mBAGC;IAKD,oBAEC;IAMD,wBAoBC;IAQD,sCAmBC;IAQD,4CAOC;CACJ;2BAxf0B,iBAAiB"}