lightning-base-components 1.28.13-alpha → 1.28.15-alpha

package/src/lightning/overlay/__examples__/menu/menu.html

@@ -0,0 +1,20 @@
+<template>
+    <div class="example">
+        <button
+            class="slds-button slds-button_icon slds-button_icon-border"
+            type="button"
+            onclick={handleOpenMenu}
+            aria-label="Open menu"
+            aria-haspopup="menu"
+            aria-expanded={isMenuOpen}
+        >
+            <lightning-primitive-icon
+                icon-name="utility:down"
+                svg-class="slds-button__icon"
+                variant="bare"
+            ></lightning-primitive-icon>
+        </button>
+        <div>{selectedResult}</div>
+    </div>
+</template>
+

package/src/lightning/overlay/__examples__/menu/menu.js

@@ -0,0 +1,30 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { LightningElement } from 'lwc';
+import MenuPanel from './demo';
+export default class MenuExample extends LightningElement {
+    isMenuOpen = false;
+    selectedResult = null;
+    async handleOpenMenu() {
+        const button = this.template.querySelector('button');
+        this.isMenuOpen = true;
+        const result = await MenuPanel.open({
+            source: button,
+            position: 'bottom span-right',
+            popover: 'auto',
+            items: [
+                { label: 'Option 1', value: 'option1' },
+                { label: 'Option 2', value: 'option2' },
+                { label: 'Option 3', value: 'option3' },
+            ],
+            maxHeight: '8rem',
+        });
+        this.isMenuOpen = false;
+        if (result) {
+            this.selectedResult = result;
+        }
+    }
+}

package/src/lightning/overlay/overlay.d.ts

@@ -1,8 +1,27 @@
-import LightningShadowBaseClass from 'lightning/shadowBaseClassPrivate';
-import { instanceName } from 'lightning/overlayUtils';
-export default class LightningOverlay extends LightningShadowBaseClass {
+import LightningPrimitiveOverlay from 'lightning/primitiveOverlay';
+import { parent, instanceName } from 'lightning/overlayUtils';
+import LightningOverlayBase from 'lightning/overlayBase';
+import { type PopoverValue, type PositionValue } from 'lightning/overlayPositionUtils';
+export default class LightningOverlay extends LightningPrimitiveOverlay {
+    static [parent]: typeof LightningOverlayBase;
     static [instanceName]: string;
-    static open(apis: object): Promise<void>;
-    close(result?: any, promise?: Promise<void>): void;
+    source: Element | null;
+    minWidth: string | number;
+    maxWidth: string | number;
+    minHeight: string;
+    maxHeight: string;
+    offsetInline: number;
+    offsetBlock: number;
+    _popover: PopoverValue;
+    _position: PositionValue;
+    _enableFocusTrap: boolean;
+    get popover(): PopoverValue;
+    set popover(value: unknown);
+    get position(): PositionValue;
+    set position(value: unknown);
+    get enableFocusTrap(): boolean;
+    set enableFocusTrap(value: unknown);
+    close(result?: any, maybeSecure?: unknown): void;
+    connectedCallback(): void;
 }
 //# sourceMappingURL=overlay.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../../../../modules/lightning/overlay/overlay.ts"],"names":[],"mappings":"AACA,OAAO,wBAAwB,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAwBtD,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,wBAAwB;IAIlE,MAAM,CAAC,CAAC,YAAY,CAAC,SAAuB;IAO5C,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAKrD"}
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../../../../modules/lightning/overlay/overlay.ts"],"names":[],"mappings":"AACA,OAAO,yBAAyB,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAU,MAAM,wBAAwB,CAAC;AACtE,OAAO,oBAAoB,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAKH,KAAK,YAAY,EACjB,KAAK,aAAa,EACrB,MAAM,gCAAgC,CAAC;AAKxC,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,yBAAyB;IACnE,MAAM,CAAC,CAAC,MAAM,CAAC,8BAAwB;IACvC,MAAM,CAAC,CAAC,YAAY,CAAC,SAAuB;IAOvC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAQ;IAU9B,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAU;IAUnC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAU;IAUnC,SAAS,EAAE,MAAM,CAAU;IAU3B,SAAS,EAAE,MAAM,CAAU;IAO3B,YAAY,EAAE,MAAM,CAAK;IAOzB,WAAW,EAAE,MAAM,CAAK;IAG7B,QAAQ,EAAE,YAAY,CAAmB;IACzC,SAAS,EAAE,aAAa,CAAoB;IAC5C,gBAAgB,EAAE,OAAO,CAAS;IAQlC,IACI,OAAO,IAAI,YAAY,CAE1B;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAKzB;IAQD,IACI,QAAQ,IAAI,aAAa,CAE5B;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,EAK1B;IAOD,IACI,eAAe,IAAI,OAAO,CAE7B;IACD,IAAI,eAAe,CAAC,KAAK,EAAE,OAAO,EAEjC;IASD,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI;IAUhD,iBAAiB,IAAI,IAAI;CAS5B"}

package/src/lightning/overlay/overlay.html

@@ -1,3 +1,4 @@
 <template>
-    <!-- This template is overridden when the class is extended. -->
-</template>
+    <!-- LightningOverlayBase -->
+</template>
+

package/src/lightning/overlay/overlay.js

@@ -3,35 +3,73 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
-import { createElement, api } from 'lwc';
-import LightningShadowBaseClass from 'lightning/shadowBaseClassPrivate';
-import { instanceName } from 'lightning/overlayUtils';
-import OverlayContainer from 'lightning/overlayContainer';
-const ROOT = 'body';
-const OVERLAY_CONTAINER = 'lightning-overlay-container';
-function container() {
-    let element = document.querySelector(`${ROOT} > ${OVERLAY_CONTAINER}`);
-    if (!element) {
-        element = createElement(OVERLAY_CONTAINER, {
-            is: OverlayContainer,
+import { api } from 'lwc';
+import LightningPrimitiveOverlay from 'lightning/primitiveOverlay';
+import { parent, instanceName, secure } from 'lightning/overlayUtils';
+import LightningOverlayBase from 'lightning/overlayBase';
+import { normalizeString, normalizeBoolean } from 'lightning/utilsPrivate';
+import { DEFAULT_POPOVER, VALID_POPOVER_VALUES, DEFAULT_POSITION, VALID_POSITION_VALUES, } from 'lightning/overlayPositionUtils';
+export default class LightningOverlay extends LightningPrimitiveOverlay {
+    static [parent] = LightningOverlayBase;
+    static [instanceName] = 'lightning-overlay';
+    @api
+    source = null;
+    @api
+    minWidth = '1rem';
+    @api
+    maxWidth = 'auto';
+    @api
+    minHeight = '1rem';
+    @api
+    maxHeight = 'auto';
+    @api
+    offsetInline = 0;
+    @api
+    offsetBlock = 0;
+    _popover = DEFAULT_POPOVER;
+    _position = DEFAULT_POSITION;
+    _enableFocusTrap = false;
+    @api
+    get popover() {
+        return this._popover;
+    }
+    set popover(value) {
+        this._popover = normalizeString(value, {
+            fallbackValue: DEFAULT_POPOVER,
+            validValues: VALID_POPOVER_VALUES,
         });
-        element.classList.add('slds-scope');
-        document.body.appendChild(element);
     }
-    return element;
-}
-export default class LightningOverlay extends LightningShadowBaseClass {
-    static [instanceName] = 'lightning-overlay';
-    static open(apis) {
-        if (!import.meta.env.SSR) {
-            return container().push(this, apis);
-        }
-        return new Promise(() => { });
+    @api
+    get position() {
+        return this._position;
+    }
+    set position(value) {
+        this._position = normalizeString(value, {
+            fallbackValue: DEFAULT_POSITION,
+            validValues: VALID_POSITION_VALUES,
+        });
     }
     @api
-    close(result, promise) {
-        if (!import.meta.env.SSR) {
-            container().pop(this.template.host, result, promise);
+    get enableFocusTrap() {
+        return this._enableFocusTrap;
+    }
+    set enableFocusTrap(value) {
+        this._enableFocusTrap = normalizeBoolean(value);
+    }
+    @api
+    close(result, maybeSecure) {
+        if (maybeSecure === secure) {
+            super.close(result);
+        }
+        else {
+            const rootNode = this.template.host.getRootNode();
+            const base = rootNode.host;
+            base.hideSurfacePopover(result);
+        }
+    }
+    connectedCallback() {
+        if (this.constructor.name === 'LightningOverlay') {
+            throw new Error('Use of <lightning-overlay> as an element is not supported. See developer documentation for extending the LightningOverlay class.');
         }
     }
 }

package/src/lightning/overlay/overlay.js-meta.xml

@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<LightningComponentBundle xmlns="xmlns=http://soap.sforce.com/2006/04/metadata">
+<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata">
+    <isExposed>true</isExposed>
     <capabilities>
         <capability>lightning__ServerRenderable</capability>
     </capabilities>

package/src/lightning/overlayBase/overlayBase.css

@@ -0,0 +1,21 @@
+.overlay-surface:popover-open {
+    border: none;
+    background: transparent;
+    padding: 0;
+    margin: 0;
+    inset: auto;
+    position-try-fallbacks:
+        flip-inline,
+        flip-block,
+        flip-inline flip-block;
+}
+
+.popover__container {
+    display: flex;
+    flex-direction: column;
+}
+
+.overlay__close {
+    margin-left: auto;
+}
+

package/src/lightning/overlayBase/overlayBase.d.ts

@@ -0,0 +1,28 @@
+import LightningShadowBaseClass from 'lightning/shadowBaseClassPrivate';
+import { instanceName } from 'lightning/overlayUtils';
+import { AnchorPositioningAdapter, type PopoverValue } from 'lightning/overlayPositionUtils';
+import type LightningOverlay from 'lightning/overlay';
+export default class LightningOverlayBase extends LightningShadowBaseClass {
+    static [instanceName]: string;
+    _focusTrapEnabled: boolean;
+    _popover: PopoverValue;
+    _initialized: boolean;
+    _anchorAdapter: AnchorPositioningAdapter | null;
+    _focusTrapChanged: boolean;
+    isPanelOpen: boolean;
+    _closeResult: any;
+    disconnectedCallback(): void;
+    get focusTrapEnabled(): boolean;
+    set focusTrapEnabled(value: unknown);
+    get popover(): PopoverValue;
+    renderedCallback(): void;
+    openPanel(): void;
+    applyDynamicUpdates(): void;
+    initialize(): void;
+    setupAnchorPositioning(): void;
+    handleToggle(event: ToggleEvent): void;
+    get overlay(): LightningOverlay;
+    get defaultSlot(): HTMLElement | null;
+    hideSurfacePopover(result?: unknown): void;
+}
+//# sourceMappingURL=overlayBase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overlayBase.d.ts","sourceRoot":"","sources":["../../../../../modules/lightning/overlayBase/overlayBase.ts"],"names":[],"mappings":"AACA,OAAO,wBAAwB,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAU,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EACH,wBAAwB,EAExB,KAAK,YAAY,EACpB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,gBAAgB,MAAM,mBAAmB,CAAC;AAOtD,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,wBAAwB;IACtE,MAAM,CAAC,CAAC,YAAY,CAAC,SAA4B;IAOjD,iBAAiB,EAAE,OAAO,CAAS;IAOnC,QAAQ,EAAE,YAAY,CAAmB;IAOzC,YAAY,EAAE,OAAO,CAAS;IAO9B,cAAc,EAAE,wBAAwB,GAAG,IAAI,CAAQ;IAOvD,iBAAiB,EAAE,OAAO,CAAS;IAOnC,WAAW,EAAE,OAAO,CAAS;IAE7B,YAAY,EAAE,GAAG,CAAC;IAElB,oBAAoB,IAAI,IAAI;IAa5B,IACI,gBAAgB,IAAI,OAAO,CAE9B;IACD,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAElC;IAOD,IAAI,OAAO,IAAI,YAAY,CAE1B;IAED,gBAAgB,IAAI,IAAI;IAaxB,SAAS,IAAI,IAAI;IAWjB,mBAAmB,IAAI,IAAI;IAkC3B,UAAU,IAAI,IAAI;IAgBlB,sBAAsB,IAAI,IAAI;IAwC9B,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAWtC,IAAI,OAAO,IAAI,gBAAgB,CAO9B;IAMD,IACI,WAAW,IAAI,WAAW,GAAG,IAAI,CAEpC;IAOD,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;CAO7C"}

package/src/lightning/overlayBase/overlayBase.html

@@ -0,0 +1,24 @@
+<template>
+    <div
+        id="overlay-base-div"
+        class="overlay-surface"
+        lwc:ref="surface"
+        popover={popover}
+        data-open={isPanelOpen}
+        ontoggle={handleToggle}
+    >
+        <template lwc:if={focusTrapEnabled}>
+            <lightning-focus-trap>
+                <div class="popover__container">
+                    <div data-slot lwc:dom="manual"></div>
+                </div>
+            </lightning-focus-trap>
+        </template>
+        <template lwc:else>
+            <div class="popover__container">
+                <div data-slot lwc:dom="manual"></div>
+            </div>
+        </template>
+    </div>
+</template>
+

package/src/lightning/overlayBase/overlayBase.js

@@ -0,0 +1,125 @@
+/*
+ * 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 { instanceName, secure } from 'lightning/overlayUtils';
+import { AnchorPositioningAdapter, DEFAULT_POPOVER, } from 'lightning/overlayPositionUtils';
+import { normalizeBoolean } from 'lightning/utilsPrivate';
+export default class LightningOverlayBase extends LightningShadowBaseClass {
+    static [instanceName] = 'lightning-overlay-base';
+    _focusTrapEnabled = false;
+    _popover = DEFAULT_POPOVER;
+    _initialized = false;
+    _anchorAdapter = null;
+    _focusTrapChanged = false;
+    isPanelOpen = false;
+    _closeResult;
+    disconnectedCallback() {
+        if (this._anchorAdapter) {
+            this._anchorAdapter.destroy();
+            this._anchorAdapter = null;
+        }
+    }
+    @api
+    get focusTrapEnabled() {
+        return this._focusTrapEnabled;
+    }
+    set focusTrapEnabled(value) {
+        this._focusTrapEnabled = normalizeBoolean(value);
+    }
+    get popover() {
+        return this._popover;
+    }
+    renderedCallback() {
+        this._focusTrapChanged = false;
+        if (!this.isPanelOpen) {
+            this.openPanel();
+        }
+        else {
+            this.applyDynamicUpdates();
+        }
+    }
+    openPanel() {
+        if (!this.isPanelOpen) {
+            this.isPanelOpen = true;
+        }
+    }
+    applyDynamicUpdates() {
+        if (!this._initialized) {
+            this.initialize();
+            this._initialized = true;
+        }
+        if (!this._focusTrapChanged) {
+            const overlay = this.overlay;
+            const surface = this.refs && this.refs.surface;
+            if (!overlay || !surface) {
+                return;
+            }
+            if (surface.popover === this._popover) {
+                const source = overlay.source;
+                if (source) {
+                    surface.showPopover({ source });
+                }
+                else {
+                    surface.showPopover();
+                }
+            }
+        }
+    }
+    initialize() {
+        if (this._popover !== this.overlay.popover) {
+            this._popover = this.overlay.popover;
+        }
+        if (this._focusTrapEnabled !== this.overlay.enableFocusTrap) {
+            this._focusTrapEnabled = this.overlay.enableFocusTrap;
+            this._focusTrapChanged = true;
+        }
+        this.setupAnchorPositioning();
+    }
+    setupAnchorPositioning() {
+        if (!this.overlay ||
+            !this.overlay.source ||
+            !this.refs.surface ||
+            this._anchorAdapter) {
+            return;
+        }
+        const { source, position, minWidth, maxWidth, minHeight, maxHeight, offsetInline, offsetBlock, } = this.overlay;
+        this._anchorAdapter = new AnchorPositioningAdapter(this.refs?.surface, {
+            source,
+            position,
+            minWidth,
+            maxWidth,
+            minHeight,
+            maxHeight,
+            offsetInline,
+            offsetBlock,
+        });
+        this._anchorAdapter.apply();
+    }
+    handleToggle(event) {
+        if (event.newState === 'closed') {
+            this.overlay.close(this._closeResult, secure);
+        }
+    }
+    get overlay() {
+        return ((!import.meta.env.SSR &&
+            this.defaultSlot &&
+            this.defaultSlot.childNodes[0]) ||
+            null);
+    }
+    @api
+    get defaultSlot() {
+        return this.template.querySelector('[data-slot]');
+    }
+    @api
+    hideSurfacePopover(result) {
+        this._closeResult = result;
+        const surface = this.refs?.surface;
+        if (surface) {
+            surface?.hidePopover();
+        }
+    }
+}

package/src/lightning/overlayBase/overlayBase.js-meta.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<LightningComponentBundle xmlns="xmlns=http://soap.sforce.com/2006/04/metadata">
+    <capabilities>
+        <capability>lightning__ServerRenderable</capability>
+        <capability>lightning__dynamicComponent</capability>
+    </capabilities>
+</LightningComponentBundle>
+

package/src/lightning/overlayContainer/overlayContainer.js

@@ -46,7 +46,7 @@ export default class LightningOverlayContainer extends LightningShadowBaseClass
             const parentElement = createElement(overlayParent[instanceName], {
                 is: overlayParent,
             });
-            if (overlayInstanceName === 'lightning-panel') {
+            if (overlayInstanceName === 'lightning-overlay') {
                 parentElement.focusTrapEnabled = apis.enableFocusTrap;
             }
             this.root.appendChild(parentElement);

package/src/lightning/overlayManager/overlayManager.d.ts

@@ -11,13 +11,13 @@ export const LWC_TOAST_CONTAINER_STARTING_ZINDEX: 10000;
 export const LWC_ZINDEX_INCREMENT: 2;
 export const LWC_ZINDEX_OFFSET: 1;
 export const LWC_OVERLAY_TYPES: Readonly<{
-    "lightning-overlay": {
+    "lightning-primitive-overlay": {
         pos: string;
     };
     "lightning-modal": {
         pos: string;
     };
-    "lightning-panel": {
+    "lightning-overlay": {
         pos: string;
     };
     "lightning-alert": {

package/src/lightning/overlayManager/overlayManager.js

@@ -4,11 +4,11 @@
  * For full license text, see the LICENSE.txt file
  */
 const TYPE_MODAL = 'lightning-modal';
-const TYPE_PANEL = 'lightning-panel';
+const TYPE_OVERLAY = 'lightning-overlay';
 const TYPE_ALERT = 'lightning-alert';
 const TYPE_CONFIRM = 'lightning-confirm';
 const TYPE_PROMPT = 'lightning-prompt';
-const TYPE_OVERLAY = 'lightning-overlay';
+const TYPE_PRIMITIVE_OVERLAY = 'lightning-primitive-overlay';
 export const TYPE_TOAST_CONTAINER = 'lightning-toast-container';
 export const LWC_OVERLAY_ENGINE = 'lwc';
 export const LWC_OVERLAY_STARTING_ZINDEX = 9000;
@@ -16,9 +16,9 @@ export const LWC_TOAST_CONTAINER_STARTING_ZINDEX = 10000;
 export const LWC_ZINDEX_INCREMENT = 2;
 export const LWC_ZINDEX_OFFSET = 1;
 export const LWC_OVERLAY_TYPES = Object.freeze({
-    [TYPE_OVERLAY]: { pos: 'absolute' },
+    [TYPE_PRIMITIVE_OVERLAY]: { pos: 'absolute' },
     [TYPE_MODAL]: { pos: 'absolute' },
-    [TYPE_PANEL]: { pos: 'absolute' },
+    [TYPE_OVERLAY]: { pos: 'absolute' },
     [TYPE_ALERT]: { pos: 'absolute' },
     [TYPE_CONFIRM]: { pos: 'absolute' },
     [TYPE_PROMPT]: { pos: 'absolute' },

package/src/lightning/overlayPositionUtils/anchorPositioningAdapter.d.ts

@@ -0,0 +1,24 @@
+import { CSSAnchorPositioning } from './cssAnchorPositioning';
+import { PositionLibraryFallback } from './positionLibraryFallback';
+import type { PositionValue } from 'lightning/overlayPositionUtils';
+export interface AnchorPositioningConfig {
+    source?: Element | null;
+    position?: PositionValue;
+    minWidth?: string | number;
+    maxWidth?: string | number;
+    minHeight?: string | number;
+    maxHeight?: string | number;
+    offsetInline?: number;
+    offsetBlock?: number;
+}
+export declare class AnchorPositioningAdapter {
+    element: HTMLElement;
+    config: AnchorPositioningConfig;
+    usesNativeAnchor: boolean;
+    cssAnchorPositioning: CSSAnchorPositioning | null;
+    positionLibraryFallback: PositionLibraryFallback | null;
+    constructor(element: HTMLElement, config?: AnchorPositioningConfig);
+    apply(): void;
+    destroy(): void;
+}
+//# sourceMappingURL=anchorPositioningAdapter.d.ts.map

package/src/lightning/overlayPositionUtils/anchorPositioningAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchorPositioningAdapter.d.ts","sourceRoot":"","sources":["../../../../../modules/lightning/overlayPositionUtils/anchorPositioningAdapter.ts"],"names":[],"mappings":"AAKA,OAAO,EAEH,oBAAoB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACpC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,wBAAwB;IACjC,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,uBAAuB,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oBAAoB,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAClD,uBAAuB,EAAE,uBAAuB,GAAG,IAAI,CAAC;gBAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,GAAE,uBAA4B;IAgBtE,KAAK,IAAI,IAAI;IAuBb,OAAO,IAAI,IAAI;CAWlB"}

package/src/lightning/overlayPositionUtils/anchorPositioningAdapter.js

@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { supportsCSSAnchorPositioning, CSSAnchorPositioning, } from './cssAnchorPositioning';
+import { PositionLibraryFallback } from './positionLibraryFallback';
+export class AnchorPositioningAdapter {
+    element;
+    config;
+    usesNativeAnchor;
+    cssAnchorPositioning;
+    positionLibraryFallback;
+    constructor(element, config = {}) {
+        if (!element) {
+            console.error('AnchorPositioningAdapter requires an element');
+            return;
+        }
+        this.element = element;
+        this.config = config;
+        this.usesNativeAnchor = supportsCSSAnchorPositioning();
+        this.cssAnchorPositioning = null;
+        this.positionLibraryFallback = null;
+    }
+    apply() {
+        if (this.usesNativeAnchor) {
+            if (!this.cssAnchorPositioning) {
+                this.cssAnchorPositioning = new CSSAnchorPositioning(this.element, this.config);
+            }
+            this.cssAnchorPositioning.apply();
+        }
+        else {
+            if (!this.positionLibraryFallback) {
+                this.positionLibraryFallback = new PositionLibraryFallback(this.element, this.config);
+            }
+            this.positionLibraryFallback.apply();
+        }
+    }
+    destroy() {
+        if (this.cssAnchorPositioning) {
+            this.cssAnchorPositioning.cleanup();
+            this.cssAnchorPositioning = null;
+        }
+        if (this.positionLibraryFallback) {
+            this.positionLibraryFallback.cleanup();
+            this.positionLibraryFallback = null;
+        }
+    }
+}

package/src/lightning/overlayPositionUtils/cssAnchorPositioning.d.ts

@@ -0,0 +1,14 @@
+import type { AnchorPositioningConfig } from './anchorPositioningAdapter';
+import type { PositionValue } from 'lightning/overlayPositionUtils';
+export declare function supportsCSSAnchorPositioning(): boolean;
+export declare class CSSAnchorPositioning {
+    element: HTMLElement;
+    config: AnchorPositioningConfig;
+    constructor(element: HTMLElement, config?: AnchorPositioningConfig);
+    apply(): void;
+    setPositionArea(): void;
+    applyPanelStyles(): void;
+    applyLogicalInsets(position: PositionValue, offsetInline: number, offsetBlock: number): void;
+    cleanup(): void;
+}
+//# sourceMappingURL=cssAnchorPositioning.d.ts.map

package/src/lightning/overlayPositionUtils/cssAnchorPositioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssAnchorPositioning.d.ts","sourceRoot":"","sources":["../../../../../modules/lightning/overlayPositionUtils/cssAnchorPositioning.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAKpE,wBAAgB,4BAA4B,IAAI,OAAO,CAkBtD;AAKD,qBAAa,oBAAoB;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,uBAAuB,CAAC;gBAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,GAAE,uBAA4B;IAQtE,KAAK,IAAI,IAAI;IAQb,eAAe,IAAI,IAAI;IAOvB,gBAAgB,IAAI,IAAI;IA6CxB,kBAAkB,CACd,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GACpB,IAAI;IA8BP,OAAO,IAAI,IAAI;CA4BlB"}