@fabric-msft/fabric-web 4.0.0 → 5.0.1

package/dist/dts/components/menu/menu.positioning.d.ts

@@ -1,6 +1,5 @@
-import { MenuPosition, MenuRepositionMode } from "./menu.options.js";
-import { type CollisionEdge } from "../../util/positioning.js";
-export { CollisionEdges, type CollisionEdge } from "../../util/positioning.js";
+import { type MenuPosition } from "./menu.options.js";
+import { type RepositionResult } from "../../util/positioning/index.js";
 /**
  * Options for the menu positioning manager
  * @internal
@@ -9,86 +8,46 @@ export interface MenuPositioningOptions {
     menuReference: HTMLElement;
     anchorReference: HTMLElement;
     overflowBoundaryReference?: HTMLElement | null;
-    repositionMode?: MenuRepositionMode;
 }
 /**
- * Positioning manager for menu component
- * Handles collision detection and repositioning logic
+ * Positioning manager for menu component.
+ * Delegates all coordinate-based positioning to {@link FlexiblePositionStrategy}.
  * @internal
  */
 export declare class MenuPositioning {
-    private menuReference;
-    private anchorReference;
+    private positionStrategy;
+    private readonly menuReference;
+    private readonly anchorReference;
     private overflowBoundaryReference;
-    private rootMargin;
-    private minMenuHeight;
     private _position;
-    private _repositionMode;
     set position(value: MenuPosition);
     get position(): MenuPosition;
-    set repositionMode(value: MenuRepositionMode);
-    get repositionMode(): MenuRepositionMode;
-    constructor(options: MenuPositioningOptions);
-    /**
-     * Gets the boundary bounds for overflow calculations.
-     * Uses custom overflow boundary if set, otherwise uses viewport.
-     * @returns BoundaryBounds object
-     */
-    private getBoundaryBounds;
-    /**
-     * Checks if a position is valid (menu fits within boundary)
-     * @param openPosition - The position to check
-     * @returns Whether the position is valid
-     */
-    checkPosition: (openPosition: MenuPosition) => boolean;
-    /**
-     * Gets the opposite position for flipping
-     * @param collisionEdge - The edge where collision occurred
-     * @returns The opposite position
-     */
-    private oppositePosition;
-    /**
-     * Gets open positions based on collision edge
-     * @param collisionEdge - The edge where collision occurred
-     * @returns Array of valid positions
-     */
-    private getOpenPositionsFromEdge;
     /**
-     * Gets all currently valid positions
-     * @returns Array of valid positions
+     * Updates the overflow boundary reference used for collision detection.
      */
-    getOpenPositions: () => Array<MenuPosition>;
-    /**
-     * Finds valid positions based on intersection collision
-     * @param entry - The intersection observer entry
-     * @returns Array of valid positions
-     */
-    findOpenPositionsFromCollision: (entry: IntersectionObserverEntry) => Array<MenuPosition>;
+    setOverflowBoundaryReference(boundary: HTMLElement | null | undefined): void;
+    constructor(options: MenuPositioningOptions);
     /**
-     * Calculates available space for the menu in a given position
-     * @param position - The position to calculate space for
-     * @returns Available height in pixels
+     * Build the ordered list of candidate positions.
+     * The original position is always the first entry, followed by fallbacks.
      */
-    getMenuAvailableSpace: (position: MenuPosition) => number;
+    private buildPositionCandidates;
     /**
-     * Determines if menu needs to be constrained with max-height
-     * @returns Object with needsConstraint flag and maxHeight value
+     * Create a new immutable FlexiblePositionStrategy from current state.
+     * Returns null if required element references are not available.
      */
-    calculateConstrainedHeight: () => {
-        needsConstraint: boolean;
-        maxHeight: number | null;
-    };
+    private createPositionStrategy;
     /**
-     * Checks if the menu overflows the boundary and returns the appropriate position.
-     * This uses direct rect calculations, which is needed for custom boundaries
-     * because popovers render in the top layer (outside the DOM hierarchy)
-     * and IntersectionObserver with a custom root won't work correctly.
-     * @returns Object with hasOverflow flag, collisionEdge, and suggested position
+     * Performs a combined resize + auto reposition.
+     *
+     * Delegates to the {@link FlexiblePositionStrategy}'s `reposition()` method,
+     * which selects the best-fitting position from the original + fallbacks.
+     * Converts the selected `ConnectedPosition` back to a menu shorthand.
+     *
+     * After repositioning, updates the internal position shorthand.
+     *
+     * @returns The reposition result, or `null` if not configured.
      */
-    checkOverflowWithBoundary: () => {
-        hasOverflow: boolean;
-        collisionEdge: CollisionEdge | undefined;
-        suggestedPosition: MenuPosition | undefined;
-    };
+    reposition(): RepositionResult | null;
 }
 //# sourceMappingURL=menu.positioning.d.ts.map

package/dist/dts/components/menu/menu.positioning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu.positioning.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/menu/menu.positioning.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,kBAAkB,EAEnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,aAAa,EAOnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,WAAW,CAAC;IAC3B,eAAe,EAAE,WAAW,CAAC;IAC7B,yBAAyB,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC/C,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,yBAAyB,CAAqB;IACtD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,aAAa,CAAO;IAE5B,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,eAAe,CAAgD;IAEvE,IAAW,QAAQ,CAAC,KAAK,EAAE,YAAY,EAEtC;IAED,IAAW,QAAQ,IAAI,YAAY,CAElC;IAED,IAAW,cAAc,CAAC,KAAK,EAAE,kBAAkB,EAElD;IAED,IAAW,cAAc,IAAI,kBAAkB,CAE9C;gBAEW,OAAO,EAAE,sBAAsB;IAO3C;;;;OAIG;IACH,OAAO,CAAC,iBAAiB,CAEvB;IAEF;;;;OAIG;IACI,aAAa,GAAI,cAAc,YAAY,KAAG,OAAO,CAgB1D;IAEF;;;;OAIG;IACH,OAAO,CAAC,gBAAgB,CAStB;IAEF;;;;OAIG;IACH,OAAO,CAAC,wBAAwB,CAU9B;IAEF;;;OAGG;IACI,gBAAgB,QAAO,KAAK,CAAC,YAAY,CAAC,CAS/C;IAEF;;;;OAIG;IACI,8BAA8B,GACnC,OAAO,yBAAyB,KAC/B,KAAK,CAAC,YAAY,CAAC,CAGpB;IAEF;;;;OAIG;IACI,qBAAqB,GAAI,UAAU,YAAY,KAAG,MAAM,CAkB7D;IAEF;;;OAGG;IACI,0BAA0B,QAAO;QACtC,eAAe,EAAE,OAAO,CAAC;QACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAmCC;IAEF;;;;;;OAMG;IACI,yBAAyB,QAAO;QACrC,WAAW,EAAE,OAAO,CAAC;QACrB,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;QACzC,iBAAiB,EAAE,YAAY,GAAG,SAAS,CAAC;KAC7C,CAsCC;CACH"}
+{"version":3,"file":"menu.positioning.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/menu/menu.positioning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAC;AAgCzC;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,WAAW,CAAC;IAC3B,eAAe,EAAE,WAAW,CAAC;IAC7B,yBAAyB,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAChD;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,gBAAgB,CAAyC;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAc;IAC9C,OAAO,CAAC,yBAAyB,CAAqB;IAEtD,OAAO,CAAC,SAAS,CAAqC;IAEtD,IAAW,QAAQ,CAAC,KAAK,EAAE,YAAY,EAEtC;IAED,IAAW,QAAQ,IAAI,YAAY,CAElC;IAED;;OAEG;IACI,4BAA4B,CACjC,QAAQ,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GACvC,IAAI;gBAIK,OAAO,EAAE,sBAAsB;IAM3C;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAY/B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAkB9B;;;;;;;;;;OAUG;IACI,UAAU,IAAI,gBAAgB,GAAG,IAAI;CAsB7C"}

package/dist/dts/components/menu/menu.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu.styles.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/menu/menu.styles.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,eAAO,MAAM,MAAM,iDA2DlB,CAAC"}
+{"version":3,"file":"menu.styles.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/menu/menu.styles.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,eAAO,MAAM,MAAM,iDAgDlB,CAAC"}

package/dist/dts/components/menu/menu.template.d.ts

@@ -1,4 +1,4 @@
-import { ElementViewTemplate } from "@microsoft/fast-element";
+import type { ElementViewTemplate } from "@microsoft/fast-element";
 import type { Menu } from "./menu.js";
 export declare function menuTemplate<T extends Menu>(): ElementViewTemplate<T>;
 export declare const template: ElementViewTemplate<Menu>;

package/dist/dts/components/menu/menu.template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu.template.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/menu/menu.template.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,EAGpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,wBAAgB,YAAY,CAAC,CAAC,SAAS,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,CAqBrE;AAED,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,IAAI,CAAkB,CAAC"}
+{"version":3,"file":"menu.template.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/menu/menu.template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,wBAAgB,YAAY,CAAC,CAAC,SAAS,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,CAqBrE;AAED,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,IAAI,CAAkB,CAAC"}

package/dist/dts/components/menu-item/menu-item.d.ts

@@ -78,7 +78,7 @@ export declare class MenuItem extends FASTElement {
      * @param prev - the previous state
      * @param next - the next state
      */
-    disabledChanged(prev: boolean | undefined, next: boolean | undefined): void;
+    disabledChanged(_prev: boolean | undefined, next: boolean | undefined): void;
     /**
      * The role of the element.
      *
@@ -92,7 +92,7 @@ export declare class MenuItem extends FASTElement {
      * @param prev - the previous state
      * @param next - the next state
      */
-    roleChanged(prev: MenuItemRole | undefined, next: MenuItemRole | undefined): void;
+    roleChanged(_prev: MenuItemRole | undefined, next: MenuItemRole | undefined): void;
     /**
      * The checked value of the element.
      *
@@ -106,7 +106,7 @@ export declare class MenuItem extends FASTElement {
      * @param prev - the previous state
      * @param next - the next state
      */
-    protected checkedChanged(prev: boolean, next: boolean): void;
+    protected checkedChanged(_prev: boolean, next: boolean): void;
     /**
      * The hidden attribute.
      *
@@ -126,7 +126,7 @@ export declare class MenuItem extends FASTElement {
      *
      * @internal
      */
-    protected slottedSubmenuChanged(prev: HTMLElement[] | undefined, next: HTMLElement[]): void;
+    protected slottedSubmenuChanged(_prev: HTMLElement[] | undefined, next: HTMLElement[]): void;
     /**
      * @public
      */

package/dist/dts/components/menu-item/menu-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu-item.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/menu-item/menu-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,WAAW,EAAc,MAAM,yBAAyB,CAAC;AASxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,qBAAa,QAAS,SAAQ,WAAW;;IACvC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB,CAA4C;IAEpE;;;;;;OAMG;IAEI,QAAQ,EAAG,OAAO,CAAC;IAE1B;;;;OAIG;IACI,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS;IAK3E;;;;;;OAMG;IAEI,IAAI,EAAE,YAAY,CAA0B;IAEnD;;;;OAIG;IACI,WAAW,CAChB,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,IAAI,EAAE,YAAY,GAAG,SAAS;IAkBhC;;;;;;OAMG;IAEI,OAAO,EAAE,OAAO,CAAS;IAEhC;;;;OAIG;IACH,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAc5D;;;;;;OAMG;IAEI,MAAM,EAAG,OAAO,CAAC;IAExB;;;;OAIG;IAEI,cAAc,EAAG,WAAW,EAAE,CAAC;IAEtC;;;;OAIG;IACH,SAAS,CAAC,qBAAqB,CAC7B,IAAI,EAAE,WAAW,EAAE,GAAG,SAAS,EAC/B,IAAI,EAAE,WAAW,EAAE;IAgBrB;;OAEG;IAEI,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IAExC;;;OAGG;IACI,iBAAiB,IAAI,IAAI;IAQhC;;OAEG;IACI,oBAAoB,IAAI,IAAI;IA6BnC;;;;;;OAMG;IACH,SAAS,CAAC,qBAAqB,GAAI,GAAG,aAAa,KAAG,OAAO,CA+B3D;IAEF;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,GAAI,GAAG,UAAU,KAAG,OAAO,CAOtD;IAEF;;;;;;;OAOG;IACH,SAAS,CAAC,eAAe,QAAO,OAAO,CAMrC;IAEF;;;;;;;;OAQG;IACH,SAAS,CAAC,cAAc,QAAO,OAAO,CAOpC;IAEF;;;;;;OAMG;IACH,SAAS,CAAC,aAAa,GAAI,GAAG,KAAK,KAAG,IAAI,CAUxC;IAEF;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CA0BZ;IAEF;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB,CAuBxB;CACH;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC"}
+{"version":3,"file":"menu-item.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/menu-item/menu-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,WAAW,EAAc,MAAM,yBAAyB,CAAC;AASxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,qBAAa,QAAS,SAAQ,WAAW;;IACvC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB,CAA4C;IAEpE;;;;;;OAMG;IAEI,QAAQ,EAAG,OAAO,CAAC;IAE1B;;;;OAIG;IACI,eAAe,CACpB,KAAK,EAAE,OAAO,GAAG,SAAS,EAC1B,IAAI,EAAE,OAAO,GAAG,SAAS;IAM3B;;;;;;OAMG;IAEI,IAAI,EAAE,YAAY,CAA0B;IAEnD;;;;OAIG;IACI,WAAW,CAChB,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,IAAI,EAAE,YAAY,GAAG,SAAS;IAkBhC;;;;;;OAMG;IAEI,OAAO,EAAE,OAAO,CAAS;IAEhC;;;;OAIG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAc7D;;;;;;OAMG;IAEI,MAAM,EAAG,OAAO,CAAC;IAExB;;;;OAIG;IAEI,cAAc,EAAG,WAAW,EAAE,CAAC;IAEtC;;;;OAIG;IACH,SAAS,CAAC,qBAAqB,CAC7B,KAAK,EAAE,WAAW,EAAE,GAAG,SAAS,EAChC,IAAI,EAAE,WAAW,EAAE;IAgBrB;;OAEG;IAEI,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IAExC;;;OAGG;IACI,iBAAiB,IAAI,IAAI;IAQhC;;OAEG;IACI,oBAAoB,IAAI,IAAI;IA6BnC;;;;;;OAMG;IACH,SAAS,CAAC,qBAAqB,GAAI,GAAG,aAAa,KAAG,OAAO,CA+B3D;IAEF;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,GAAI,GAAG,UAAU,KAAG,OAAO,CAOtD;IAEF;;;;;;;OAOG;IACH,SAAS,CAAC,eAAe,QAAO,OAAO,CAMrC;IAEF;;;;;;;;OAQG;IACH,SAAS,CAAC,cAAc,QAAO,OAAO,CAOpC;IAEF;;;;;;OAMG;IACH,SAAS,CAAC,aAAa,GAAI,GAAG,KAAK,KAAG,IAAI,CAUxC;IAEF;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CA0BZ;IAEF;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB,CAuBxB;CACH;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC"}

package/dist/dts/components/menu-list/menu-list.d.ts

@@ -90,7 +90,7 @@ export declare class MenuList extends FASTElement {
     /**
      * Method for Observable changes to the hidden attribute of child elements
      */
-    handleChange(source: unknown, propertyName: string): void;
+    handleChange(_source: unknown, propertyName: string): void;
     /**
      * Handle change from child MenuItem element and set radio group behavior
      */

package/dist/dts/components/menu-list/menu-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu-list.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/menu-list/menu-list.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAIZ,MAAM,yBAAyB,CAAC;AAYjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;OAIG;IACI,gBAAgB,EAAE,gBAAgB,CAA0B;IAEnE;;OAEG;IAEI,KAAK,EAAG,WAAW,EAAE,CAAC;IACtB,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IASpE,SAAS,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IAExC;;;OAGG;IACI,UAAU,EAAE,MAAM,CAAM;IAE/B,gBAAuB,qBAAqB;;;;MAAiB;;IAQ7D;;OAEG;IACI,iBAAiB,IAAI,IAAI;IAWhC;;OAEG;IACI,oBAAoB,IAAI,IAAI;IAOnC;;OAEG;IACH,SAAgB,YAAY,QAAO,OAAO,CAMxC;IAEF;;;;OAIG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,iBAAiB,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO;IA2B1D;;;OAGG;IACI,cAAc,GAAI,GAAG,UAAU,UAgBpC;IAEF,OAAO,CAAC,eAAe,CAWrB;IAEF,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,MAAM,CAAC,aAAa;IAW5B,SAAS,CAAC,QAAQ,IAAI,IAAI;IAiD1B;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM;IAMzD;;OAEG;IACH,OAAO,CAAC,sBAAsB,CAqC5B;IAEF;;OAEG;IACH,SAAS,CAAC,iBAAiB,GAAI,IAAI,OAAO,KAAG,EAAE,IAAI,WAAW,CAM5D;IAEF;;OAEG;IACH,OAAO,CAAC,kBAAkB,CAExB;IAEF,OAAO,CAAC,QAAQ;CAgCjB"}
+{"version":3,"file":"menu-list.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/menu-list/menu-list.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAIZ,MAAM,yBAAyB,CAAC;AAYjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;OAIG;IACI,gBAAgB,EAAE,gBAAgB,CAA0B;IAEnE;;OAEG;IAEI,KAAK,EAAG,WAAW,EAAE,CAAC;IACtB,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IASpE,SAAS,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IAExC;;;OAGG;IACI,UAAU,EAAE,MAAM,CAAM;IAE/B,gBAAuB,qBAAqB;;;;MAAiB;;IAQ7D;;OAEG;IACI,iBAAiB,IAAI,IAAI;IAWhC;;OAEG;IACI,oBAAoB,IAAI,IAAI;IAOnC;;OAEG;IACH,SAAgB,YAAY,QAAO,OAAO,CAMxC;IAEF;;;;OAIG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,iBAAiB,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO;IA2B1D;;;OAGG;IACI,cAAc,GAAI,GAAG,UAAU,UAgBpC;IAEF,OAAO,CAAC,eAAe,CAWrB;IAEF,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,MAAM,CAAC,aAAa;IAW5B,SAAS,CAAC,QAAQ,IAAI,IAAI;IAiD1B;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM;IAM1D;;OAEG;IACH,OAAO,CAAC,sBAAsB,CAqC5B;IAEF;;OAEG;IACH,SAAS,CAAC,iBAAiB,GAAI,IAAI,OAAO,KAAG,EAAE,IAAI,WAAW,CAM5D;IAEF;;OAEG;IACH,OAAO,CAAC,kBAAkB,CAExB;IAEF,OAAO,CAAC,QAAQ;CAgCjB"}

package/dist/dts/components/multi-view/multi-view.template.d.ts

@@ -1,4 +1,4 @@
-import { ElementViewTemplate } from "@microsoft/fast-element";
+import type { ElementViewTemplate } from "@microsoft/fast-element";
 import { MultiView } from "./multi-view.js";
 /**
  * The template for the {@link @fabric-msft/fabric-web#MultiView} component.

package/dist/dts/components/multi-view/multi-view.template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multi-view.template.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/multi-view/multi-view.template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAQ,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA+B5C;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,SAAS,CAAuB,CAAC"}
+{"version":3,"file":"multi-view.template.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/multi-view/multi-view.template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA+B5C;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,SAAS,CAAuB,CAAC"}

package/dist/dts/components/multi-view-controller/multi-view-controller.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multi-view-controller.styles.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/multi-view-controller/multi-view-controller.styles.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,MAAM,iDAyDlB,CAAC"}
+{"version":3,"file":"multi-view-controller.styles.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/multi-view-controller/multi-view-controller.styles.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,MAAM,iDAyDlB,CAAC"}

package/dist/dts/components/multi-view-controller/multi-view-controller.template.d.ts

@@ -1,4 +1,4 @@
-import { ElementViewTemplate } from "@microsoft/fast-element";
+import type { ElementViewTemplate } from "@microsoft/fast-element";
 import type { MultiViewController } from "./multi-view-controller.js";
 /**
  * The template for the {@link @fabric-msft/fabric-web#MultiViewController} component.

package/dist/dts/components/multi-view-controller/multi-view-controller.template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multi-view-controller.template.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/multi-view-controller/multi-view-controller.template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAQ,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAwBtE;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,mBAAmB,CAC/B,CAAC"}
+{"version":3,"file":"multi-view-controller.template.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/multi-view-controller/multi-view-controller.template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAwBtE;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,mBAAmB,CAC/B,CAAC"}

package/dist/dts/components/multi-view-group/multi-view-group.template.d.ts

@@ -1,4 +1,4 @@
-import { ElementViewTemplate } from "@microsoft/fast-element";
+import type { ElementViewTemplate } from "@microsoft/fast-element";
 import type { MultiViewGroup } from "./multi-view-group.js";
 /**
  * The template for the {@link @fabric-msft/fabric-web#MultiViewGroup} component.

package/dist/dts/components/multi-view-group/multi-view-group.template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multi-view-group.template.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/multi-view-group/multi-view-group.template.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EAIpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA2C5D;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,cAAc,CAC/B,CAAC"}
+{"version":3,"file":"multi-view-group.template.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/multi-view-group/multi-view-group.template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA2C5D;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,cAAc,CAC/B,CAAC"}

package/dist/dts/components/option-group/option-group.d.ts

@@ -76,7 +76,7 @@ export declare class OptionGroup extends FASTElement {
      * @param next - The new disabled state.
      * @internal
      */
-    disabledChanged(prev: boolean | undefined, next: boolean | undefined): void;
+    disabledChanged(_prev: boolean | undefined, next: boolean | undefined): void;
     connectedCallback(): void;
     /**
      * Handles changes to the label attribute.

package/dist/dts/components/option-group/option-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"option-group.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/option-group/option-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,WAAW,EAAc,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;OAIG;IACI,gBAAgB,EAAE,gBAAgB,CAA0B;IAEnE;;;;;;OAMG;IAEI,KAAK,EAAG,MAAM,CAAC;IAEtB;;;;;;;OAOG;IAEI,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;OAIG;IAEI,cAAc,EAAE,OAAO,EAAE,CAAM;IAEtC;;;;OAIG;IACH,IAAW,OAAO,IAAI,cAAc,EAAE,CAIrC;IAED;;;;;;;OAOG;IACI,eAAe,CACpB,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,IAAI,EAAE,OAAO,GAAG,SAAS,GACxB,IAAI;IAIP,iBAAiB,IAAI,IAAI;IAMzB;;;;;;;OAOG;IACI,YAAY,CACjB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,IAAI;CAGR"}
+{"version":3,"file":"option-group.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/option-group/option-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,WAAW,EAAc,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;OAIG;IACI,gBAAgB,EAAE,gBAAgB,CAA0B;IAEnE;;;;;;OAMG;IAEI,KAAK,EAAG,MAAM,CAAC;IAEtB;;;;;;;OAOG;IAEI,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;OAIG;IAEI,cAAc,EAAE,OAAO,EAAE,CAAM;IAEtC;;;;OAIG;IACH,IAAW,OAAO,IAAI,cAAc,EAAE,CAIrC;IAED;;;;;;;OAOG;IACI,eAAe,CACpB,KAAK,EAAE,OAAO,GAAG,SAAS,EAC1B,IAAI,EAAE,OAAO,GAAG,SAAS,GACxB,IAAI;IAIP,iBAAiB,IAAI,IAAI;IAMzB;;;;;;;OAOG;IACI,YAAY,CACjB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,IAAI;CAGR"}

package/dist/dts/components/option-group/option-group.template.d.ts

@@ -1,4 +1,4 @@
-import { ElementViewTemplate } from "@microsoft/fast-element";
+import type { ElementViewTemplate } from "@microsoft/fast-element";
 import type { OptionGroup } from "./option-group.js";
 /**
  * The template for the {@link @fabric-msft/fabric-web#(OptionGroup:class)} component.

package/dist/dts/components/option-group/option-group.template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"option-group.template.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/option-group/option-group.template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAiB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,SAAS,WAAW,KAClB,mBAAmB,CAAC,CAAC,CAAC,CAS1B;AAED,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,WAAW,CAAyB,CAAC"}
+{"version":3,"file":"option-group.template.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/option-group/option-group.template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,SAAS,WAAW,KAClB,mBAAmB,CAAC,CAAC,CAAC,CAS1B;AAED,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,WAAW,CAAyB,CAAC"}

package/dist/dts/components/popover/index.d.ts

@@ -1,5 +1,5 @@
 export { Popover } from "./popover.js";
-export { CollisionEdge, CollisionEdges, PositioningShorthand, PopoverRepositionModes, PopoverPositions, PopoverSize, PopoverMode, PopoverRepositionMode, PositioningShorthandKeys, PositioningShorthandValues, HTMLPopoverElement, PopoverEventData, PopoverEventNames } from "./popover.options.js";
+export { type CollisionEdge, CollisionEdges, PositioningShorthand, PositioningShorthands, PopoverRepositionModes, PopoverPositions, type PopoverSize, type PopoverMode, type PopoverRepositionMode, type PositioningShorthandKeys, type PositioningShorthandValues, type HTMLPopoverElement, type PopoverEventData, PopoverEventNames } from "./popover.options.js";
 export { ElementStyles } from "@microsoft/fast-element";
 export { definition as PopoverDefinition } from "./popover.definition.js";
 export { template as PopoverTemplate } from "./popover.template.js";

package/dist/dts/components/popover/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/popover/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/popover/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,KAAK,aAAa,EAClB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/dts/components/popover/popover.d.ts

@@ -1,5 +1,5 @@
 import { FASTElement } from "@microsoft/fast-element";
-import { HTMLPopoverElement, PopoverMode, PopoverRepositionMode, PopoverSize, PositioningShorthandValues } from "./popover.options";
+import type { HTMLPopoverElement, PopoverMode, PopoverRepositionMode, PopoverSize, PositioningShorthandValues } from "./popover.options.js";
 /**
  * Popover
  * @summary A Popover component that displays content in a floating container, with configurable size, position, and behavior.
@@ -18,7 +18,7 @@ import { HTMLPopoverElement, PopoverMode, PopoverRepositionMode, PopoverSize, Po
  * @attr {PopoverMode} mode - The mode of the popover. In auto mode, the popover closes when the user clicks outside of it. In manual mode, the popover stays open.
  * @attr {PositioningShorthandValues} position - The position of the popover.
  * @attr {string} target-id - The ID of the target element.
- * @attr {PopoverRepositionMode} reposition-mode - The mode for repositioning the popover.
+ * @attr {PopoverRepositionMode} reposition-mode - Controls how the `FlexiblePositionStrategy` selects a fallback when the preferred `position` overflows the boundary. `"flip"` tries only the geometrically opposite position (default). `"auto"` evaluates all 12 positions and picks the one with the most available space. `"none"` disables automatic repositioning.
  * @attr {boolean} open - Whether the popover is open.
  * @attr {number} transition-duration - The duration of the transition of the popover. The default value is 100.
  * @attr {number} transition-delay - The delay of the transition of the popover. The default value is 0.
@@ -28,10 +28,9 @@ import { HTMLPopoverElement, PopoverMode, PopoverRepositionMode, PopoverSize, Po
  * @prop {ElementStyles | undefined} styles - Stores the CSS variables required for animations.
  * @prop {boolean} transitionComplete - Indicates if the transition is complete.
  * @prop {PopoverRepositionMode} repositionMode - The mode for repositioning the popover.
- * @prop {Array<PositioningShorthandValues>} openPositions - The array of open positions based on the collision edge.
  * @prop {HTMLPopoverElement | undefined} popoverReference - The reference to the popover element.
  * @prop {string | undefined} popoverRole - An optional user-defined role for the popover floating content element.
- * @prop {HTMLElement | undefined} overflowBoundary - The boundary container element of the popover for repositioning.
+ * @prop {HTMLElement | undefined} overflowBoundary - Optional scrolling container used as the collision boundary by `FlexiblePositionStrategy`. When set, overflow is measured against this element instead of the document viewport, and its `scroll` events trigger repositioning. Only relevant when `reposition-mode` is not `"none"`.
  *
  * @slot popover-trigger - Slot for the popover trigger element.
  * @slot popover-content - Slot for the popover content.
@@ -52,11 +51,11 @@ import { HTMLPopoverElement, PopoverMode, PopoverRepositionMode, PopoverSize, Po
  * @method createPositioningManager - Creates the positioning manager for the popover.
  * @method removeEventListeners - Removes event listeners from the popover.
  *
- * @fires hide - Emits when the popover is hidden.
- * @fires show - Emits when the popover is shown.
- * @fires toggle - Emits when the popover is toggled.
- * @fires mouseEnter - Emits when the mouse enters the popover.
- * @fires mouseLeave - Emits when the mouse leaves the popover.
+ * @fires hide-popover - Emits when the popover is hidden.
+ * @fires show-popover - Emits when the popover is shown.
+ * @fires toggle-popover - Emits when the popover is toggled.
+ * @fires mouse-enter-popover - Emits when the mouse enters the popover.
+ * @fires mouse-leave-popover - Emits when the mouse leaves the popover.
  *
  * @extends FASTElement
  * @tagname fabric-popover
@@ -108,6 +107,13 @@ export declare class Popover extends FASTElement {
      * @attr
      */
     position: PositioningShorthandValues;
+    /**
+     * Handles changes to the public `position` attribute.
+     * Updates the positioning strategy and triggers a reposition if the
+     * popover is currently open, without closing/reopening.
+     * @public
+     */
+    positionChanged(): void;
     /**
      * ## targetId
      *
@@ -129,9 +135,9 @@ export declare class Popover extends FASTElement {
     /**
      * Handles changes to the anchor references.
      * Adds anchor attributes and event listeners when the anchor is added to the DOM.
-     * @public
+     * @internal
      */
-    anchorReferencesChanged(): void;
+    private anchorReferencesChanged;
     /**
      * ## styles
      * @summary used in the class for storing the css variables required for animations
@@ -189,7 +195,14 @@ export declare class Popover extends FASTElement {
      */
     removeTransitionStyles(): void;
     /**
-     * The mode for repositioning the popover.
+     * The mode for repositioning the popover via `FlexiblePositionStrategy`.
+     *
+     * - `"flip"` (default) — tries only the geometrically opposite position
+     *   (e.g. `above-center` ↔ `below-center`) as a fallback.
+     * - `"auto"` — evaluates all 12 `PositioningShorthand` positions and picks
+     *   the one with the most available space.
+     * - `"none"` — disables automatic repositioning; the popover stays at the
+     *   declared `position`.
      * @public
      * @type {PopoverRepositionMode}
      * @attr reposition-mode
@@ -203,22 +216,6 @@ export declare class Popover extends FASTElement {
      * @public
      */
     repositionModeChanged(): void;
-    /**
-     * ## openPositions
-     *
-     * @summary The array of open positions based on the collision edge.
-     *
-     * @public
-     * @type {Array<PositioningShorthandValues>}
-     * @observable
-     */
-    openPositions: Array<PositioningShorthandValues>;
-    /**
-     * The original position of the popover before repositioning.
-     * @private
-     * @type {PositioningShorthandValues | undefined}
-     */
-    private originalPopoverPosition;
     /**
      * ## open
      *
@@ -250,7 +247,11 @@ export declare class Popover extends FASTElement {
      * @observable
      */
     popoverReference: HTMLPopoverElement | undefined;
-    popoverReferenceChanged(): void;
+    /**
+     * Handles changes to the popover reference element.
+     * @internal
+     */
+    private popoverReferenceChanged;
     /**
      * ## popoverRole
      *
@@ -266,7 +267,12 @@ export declare class Popover extends FASTElement {
      */
     private initializeTargetId;
     /**
-     * The boundary container element of the popover for repositioning.
+     * Optional scrolling container used as the collision boundary by
+     * `FlexiblePositionStrategy`.
+     *
+     * When set, the strategy measures overflow against this element instead of
+     * the document viewport and listens for its `scroll` events to trigger
+     * repositioning. Only relevant when `reposition-mode` is not `"none"`.
      * @public
      * @type {HTMLElement | undefined}
      * @observable
@@ -329,11 +335,6 @@ export declare class Popover extends FASTElement {
      * @private
      */
     private removeMouseOverEventListeners;
-    /**
-     * Updates the popover position.
-     * @private
-     */
-    private updatePopoverPosition;
     /**
      * ## handleWindowChanges
      *
@@ -383,28 +384,14 @@ export declare class Popover extends FASTElement {
      */
     private removeOverlayEventListeners;
     /**
-     * ## intersectionObserver
-     *
-     * @summary used for tracking the overflow / collision of the popover to adjacent edges on ui changes. The intersection observer for tracking overflow.
-     * @private
-     * @type {IntersectionObserver | undefined}
-     */
-    private intersectionObserver;
-    /**
-     * ## createOverflowHandler
-     *
-     * @summary handles the overflow of the popover based on the overflowBoundary. Calls handleOverflow when the popover collides with its container or user defined overflowed boundary. Creates the overflow handler based on the overflow boundary.
+     * Checks for overflow and repositions the popover if needed.
+     * Writes the resolved position to a `data-position` attribute on
+     * the internal `.popover` element so shadow-DOM CSS can follow
+     * the repositioned placement without mutating the public `position`
+     * attribute.
      * @private
      */
-    private createOverflowHandler;
-    /**
-     * ## handleOverflow
-     *
-     * @summary Repositions the popover when it collides with its container or user defined overflowed boundary. Handles overflow collisions with the popover. Repositions the popover when it collides with its container or defined boundary. Called by the intersectionObserver in createOverflowHandler.
-     * @private
-     * @param {Array<IntersectionObserverEntry>} entries - The entries to observe.
-     */
-    private handleOverflow;
+    private checkOverflow;
     /**
      * ## addRepositioningHandlers
      *
@@ -413,9 +400,13 @@ export declare class Popover extends FASTElement {
      */
     addRepositioningHandlers(): void;
     /**
-     * ## addPositioningManager
+     * Creates a new {@link Positioning} instance that wraps `FlexiblePositionStrategy`
+     * for this popover.
      *
-     * @summary Creates a new positioning manager for the popover. The positioning manager is used to calculate the position of the popover based on the anchor and the popover's collision with the window or overflowBoundary. Creates the positioning manager for the popover.
+     * Called every time the popover opens (`openChanged`). Passes the current
+     * `repositionMode`, anchor reference, popover element, optional
+     * `overflowBoundary`, and the `beak` flag so beak-gap offsets are applied
+     * to every candidate position.
      * @public
      */
     createPositioningManager(): void;
@@ -425,24 +416,12 @@ export declare class Popover extends FASTElement {
      */
     removeEventListeners(): void;
     /**
-     * ## releasePositions
-     *
-     * @summary cleans the positions that are not allowed. Releases the open positions for the popover. Cleans the positions that are not allowed.
-     * @private
-     */
-    private releasePositions;
-    /**
-     * ## repositionPopover
-     *
-     * @summary Updates the position of the popover based on popover collisions. Repositions the popover based on collisions.
-     * @private
-     * @param {Array<PositioningShorthandValues>} openPositions - The array of open positions.
-     */
-    private repositionPopover;
-    /**
-     * ## observePopoverOverflow
+     * Schedules an overflow check via `FlexiblePositionStrategy` on the next
+     * animation frame using `Updates.enqueue()`.
      *
-     * @summary Disconnects and re-observes the popoverReference for overflow. This is used to reposition the popover in the event that it collides with its container or user defined overflowed boundary. Disconnecting is required to reset the baseline for the intersection observer. This method will be called repeatedly on ui changes like resizing the window or scrolling the overflowBoundary. Observes the popover for overflow.  Disconnects and re-observes the popoverReference for overflow.
+     * Coordinates are applied before the popover becomes visible, preventing a
+     * layout flash on open. Also called on every resize and scroll event while
+     * the popover is open.
      * @private
      */
     private observePopoverOverflow;

package/dist/dts/components/popover/popover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/popover/popover.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/popover/popover.ts"],"names":[],"mappings":"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"}

package/dist/dts/components/popover/popover.definition.d.ts

@@ -1,3 +1,3 @@
-import { Popover } from "./popover";
+import { Popover } from "./popover.js";
 export declare const definition: import("@microsoft/fast-element").FASTElementDefinition<typeof Popover>;
 //# sourceMappingURL=popover.definition.d.ts.map

package/dist/dts/components/popover/popover.definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"popover.definition.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/popover/popover.definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,UAAU,yEAOrB,CAAC"}
+{"version":3,"file":"popover.definition.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/popover/popover.definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAIvC,eAAO,MAAM,UAAU,yEAOrB,CAAC"}

package/dist/dts/components/popover/popover.options.d.ts

@@ -1,5 +1,19 @@
-import { type RepositionMode } from "../../util/positioning.js";
-export { CollisionEdges, type CollisionEdge } from "../../util/positioning.js";
+import { type ValuesOf } from "../../util/typings.js";
+export { CollisionEdges, type CollisionEdge } from "../../util/positioning/index.js";
+export declare const PositioningShorthands: {
+    readonly aboveEnd: "above-end";
+    readonly aboveCenter: "above-center";
+    readonly aboveStart: "above-start";
+    readonly endBottom: "end-bottom";
+    readonly endMiddle: "end-middle";
+    readonly endTop: "end-top";
+    readonly belowEnd: "below-end";
+    readonly belowCenter: "below-center";
+    readonly belowStart: "below-start";
+    readonly startBottom: "start-bottom";
+    readonly startTop: "start-top";
+    readonly startMiddle: "start-middle";
+};
 export declare const PositioningShorthand: {
     readonly aboveEnd: "above-end";
     readonly aboveCenter: "above-center";
@@ -14,17 +28,18 @@ export declare const PositioningShorthand: {
     readonly startTop: "start-top";
     readonly startMiddle: "start-middle";
 };
+export type PositioningShorthand = ValuesOf<typeof PositioningShorthands>;
 export declare const PopoverPositions: ("above-end" | "above-center" | "above-start" | "end-bottom" | "end-middle" | "end-top" | "below-end" | "below-center" | "below-start" | "start-bottom" | "start-top" | "start-middle")[];
 export type PopoverSize = "small" | "medium" | "large";
 export type PopoverMode = "manual" | "auto";
-export type PopoverRepositionMode = RepositionMode;
+export type PopoverRepositionMode = ValuesOf<typeof PopoverRepositionModes>;
 export declare const PopoverRepositionModes: {
     readonly auto: "auto";
     readonly flip: "flip";
     readonly none: "none";
 };
-export type PositioningShorthandKeys = keyof typeof PositioningShorthand;
-export type PositioningShorthandValues = (typeof PositioningShorthand)[keyof typeof PositioningShorthand];
+export type PositioningShorthandKeys = keyof typeof PositioningShorthands;
+export type PositioningShorthandValues = (typeof PositioningShorthands)[keyof typeof PositioningShorthands];
 export interface HTMLPopoverElement extends HTMLElement {
     showPopover: () => void;
     hidePopover: () => void;
@@ -36,10 +51,10 @@ export interface PopoverEventData {
     target: HTMLElement;
 }
 export declare const PopoverEventNames: {
-    readonly hide: "hidePopover";
-    readonly show: "showPopover";
-    readonly toggle: "togglePopover";
-    readonly mouseEnter: "mouseEnterPopover";
-    readonly mouseLeave: "mouseLeavePopover";
+    readonly hide: "hide-popover";
+    readonly show: "show-popover";
+    readonly toggle: "toggle-popover";
+    readonly mouseEnter: "mouse-enter-popover";
+    readonly mouseLeave: "mouse-leave-popover";
 };
 //# sourceMappingURL=popover.options.d.ts.map