npm - react-display-scale-engine - Versions diffs - 0.1.2 → 0.1.4 - Mend

react-display-scale-engine 0.1.2 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/README.md +48 -47
package/dist/{chunk-OQRISU2D.js → chunk-47O3TJUJ.js} +69 -26
package/dist/chunk-47O3TJUJ.js.map +1 -0
package/dist/index.d.ts +1 -1
package/dist/index.js +1 -1
package/dist/mui.d.ts +44 -8
package/dist/mui.js +1 -1
package/docs/display-scale-engine.md +193 -163
package/package.json +5 -3
package/dist/chunk-OQRISU2D.js.map +0 -1

package/README.md CHANGED Viewed

@@ -1,14 +1,8 @@
 # react-display-scale-engine
-React utilities for maintaining a consistent visual density on Windows displays with elevated OS display scaling, with first-class Material UI overlay support.
+Keep a React app visually consistent on Windows displays that use elevated OS display scaling, while preserving normal browser behavior at standard scale. It is especially useful for MUI overlays such as menus, popovers, poppers, and selects.
-The library is split into entry points, so an application only takes the layer it needs:
-```ts
-import { detectDisplayScale } from "react-display-scale-engine/core";
-import { DisplayScaleProvider } from "react-display-scale-engine/react";
-import { DisplayScaleMenu } from "react-display-scale-engine/mui";
-```
+The engine only applies compensation when it detects the supported display-scale condition. At normal scale, it leaves the app layout and native MUI positioning unchanged.
 ## Install
@@ -16,11 +10,20 @@ import { DisplayScaleMenu } from "react-display-scale-engine/mui";
 npm install react-display-scale-engine
 ```
-`react`, `react-dom`, `@mui/material`, `@emotion/react`, `@emotion/styled`, and `@popperjs/core` are peer dependencies. The MUI peers are necessary only for the `/mui` entry point.
+## Compatibility
-## Quick start
+| Dependency | Supported version | Notes |
+| --- | --- | --- |
+| Node.js | 18 or newer | Required by the package. |
+| React / React DOM | 18 or newer | React 19 is supported and tested. |
+| Material UI | 7.x | Required only when using `…/mui`. MUI 8 is not supported yet. |
+| Emotion | 11 or newer | Required only when using `…/mui`. |
+| `@popperjs/core` | 2 or newer | Required only when using `…/mui`. |
+| TypeScript | Optional | Type declarations are included; the package is verified with TypeScript 5.7. |
-Call the optional pre-mount warm-up, then wrap the application once.
+## Start here
+Call the optional warm-up before rendering, then add one provider around the app.
 ```tsx
 import { primeDisplayScaleCompensation } from "react-display-scale-engine/core";
@@ -29,56 +32,54 @@ import { DisplayScaleProvider } from "react-display-scale-engine/react";
 primeDisplayScaleCompensation();
 export function AppRoot() {
-  return <DisplayScaleProvider><App /></DisplayScaleProvider>;
+  return (
+    <DisplayScaleProvider>
+      <App />
+    </DisplayScaleProvider>
+  );
 }
 ```
-Use supplied components for MUI overlays whose placement must account for the compensated coordinate space.
+## MUI overlays: recommended hook API
-```tsx
-import { DisplayScaleMenu } from "react-display-scale-engine/mui";
+Keep using MUI's native components. The hook supplies the compensated props; spread them onto the matching MUI component.
-<DisplayScaleMenu anchorEl={anchorEl} open={open} onClose={close}>
-  <MenuItem onClick={close}>Action</MenuItem>
-</DisplayScaleMenu>;
-```
-See [the engine guide](docs/display-scale-engine.md) for policy, limitations, and migration guidance.
+```tsx
+import { Menu, MenuItem } from "@mui/material";
+import { useMuiDisplayScaleMenu } from "react-display-scale-engine/mui";
-## Development
+function ActionsMenu({ anchorEl, open, close }) {
+  const { menuProps } = useMuiDisplayScaleMenu({ anchorEl, open });
-```bash
-npm install
-npm run check
-npm run build
-npm pack --dry-run
+  return (
+    <Menu {...menuProps} onClose={close}>
+      <MenuItem onClick={close}>Action</MenuItem>
+    </Menu>
+  );
+}
 ```
-Public entry points:
+Use the corresponding hook for each MUI component:
-| Import | Purpose |
+| MUI component | Engine hook |
 | --- | --- |
-| `react-display-scale-engine` | All public exports |
-| `…/core` | Framework-independent detection and compensation math |
-| `…/react` | Provider and React hooks |
-| `…/mui` | MUI Menu, Popover, Popper, Select, Drawer and token adapters |
-## Publishing
+| `Menu` | `useMuiDisplayScaleMenu` |
+| `Popover` | `useMuiDisplayScalePopover` |
+| `Popper` | `useMuiDisplayScalePopper` |
+| `Select` | `useMuiDisplayScaleSelect` |
-Before first publishing, make sure the `name` in `package.json` is an npm scope you own, then run `npm login`.
+`useMuiDisplayScaleSelect` also handles its internal MUI menu, including the first time the options list opens.
-```bash
-npm run release:check
-npm run release:dry-run
-npm run release:publish -- --otp 123456
-```
+Wrapper components (`DisplayScaleMenu`, `DisplayScalePopover`, `DisplayScalePopper`, and `DisplayScaleSelect`) remain available, but hooks are the preferred API for both new and existing MUI applications.
-The package includes a CLI:
+## Import paths
-```bash
-npx rds-engine check
-npx rds-engine publish --dry-run
-npx rds-engine publish --otp 123456
+```ts
+import { detectDisplayScale } from "react-display-scale-engine/core";
+import { DisplayScaleProvider } from "react-display-scale-engine/react";
+import { useMuiDisplayScalePopover } from "react-display-scale-engine/mui";
 ```
-`publish` always builds and runs `npm pack --dry-run` first. It never changes the version; use `npm version patch|minor|major` before publishing. When npm account policy requires 2FA for publishing, supply the current authenticator code with `--otp` or use an npm granular access token that has bypass-2FA permission.
+The package root (`react-display-scale-engine`) also exports all public APIs for compatibility. Prefer the explicit paths above for new code.
+For engine behavior, limitations, and migration examples, see [the guide](docs/display-scale-engine.md).

package/dist/{chunk-OQRISU2D.js → chunk-47O3TJUJ.js} RENAMED Viewed

@@ -1,7 +1,7 @@
 import { useDisplayScaleCompensation, useDisplayScaleAnchor } from './chunk-F5AFPMQC.js';
 import { Menu, Popover, Popper, Select } from '@mui/material';
 import { useTheme } from '@mui/material/styles';
-import { useCallback, useLayoutEffect, useRef, useMemo, useId, useState } from 'react';
+import { useCallback, useLayoutEffect, useRef, useMemo, useState, useId } from 'react';
 import { jsx } from 'react/jsx-runtime';
 // src/createMuiDisplayScaleComponents.ts
@@ -88,6 +88,7 @@ function resolveOrigins(anchorOrigin, transformOrigin, anchorWidth, anchorHeight
 function useDisplayScalePopoverPosition({
   open,
   overlayRootRef,
+  overlayRoot: mountedOverlayRoot,
   anchorElement,
   anchorReference,
   anchorPosition,
@@ -98,7 +99,7 @@ function useDisplayScalePopoverPosition({
   const { compensation, layoutExtents, rootRef } = useDisplayScaleCompensation();
   const correctPosition = useCallback(() => {
     if (!open || !compensation.active || !layoutExtents) return;
-    const overlayRoot = overlayRootRef.current;
+    const overlayRoot = mountedOverlayRoot ?? overlayRootRef.current;
     const paper = overlayRoot?.querySelector(".MuiPopover-paper");
     if (!paper) return;
     const zoom = compensation.zoom > 0 ? compensation.zoom : 1;
@@ -140,6 +141,7 @@ function useDisplayScalePopoverPosition({
     compensation.zoom,
     layoutExtents,
     marginThreshold,
+    mountedOverlayRoot,
     open,
     overlayRootRef,
     rootRef,
@@ -160,7 +162,10 @@ function useDisplayScalePopoverPosition({
     };
   }, [correctPosition, open]);
 }
-function DisplayScaleMenu({ anchorEl, ...props }) {
+function useMuiDisplayScaleMenu({
+  anchorEl,
+  ...props
+}) {
   const displayScaleAnchor = useDisplayScaleAnchor(anchorEl ?? null);
   const { compensation, rootRef } = useDisplayScaleCompensation();
   const theme = useTheme();
@@ -194,9 +199,8 @@ function DisplayScaleMenu({ anchorEl, ...props }) {
     transformOrigin,
     marginThreshold: props.marginThreshold
   });
-  return /* @__PURE__ */ jsx(
-    Menu,
-    {
+  return {
+    menuProps: {
       ...props,
       ref: overlayRootRef,
       anchorEl: displayScaleAnchor,
@@ -205,9 +209,13 @@ function DisplayScaleMenu({ anchorEl, ...props }) {
       container: rootRef.current ?? document.body,
       transformOrigin
     }
-  );
+  };
 }
-function DisplayScalePopover({
+function DisplayScaleMenu(props) {
+  const { menuProps } = useMuiDisplayScaleMenu(props);
+  return /* @__PURE__ */ jsx(Menu, { ...menuProps });
+}
+function useMuiDisplayScalePopover({
   anchorEl,
   ...props
 }) {
@@ -224,15 +232,18 @@ function DisplayScalePopover({
     transformOrigin: props.transformOrigin,
     marginThreshold: props.marginThreshold
   });
-  return /* @__PURE__ */ jsx(
-    Popover,
-    {
+  return {
+    popoverProps: {
       ...props,
       ref: overlayRootRef,
       anchorEl: displayScaleAnchor,
       container: rootRef.current ?? document.body
     }
-  );
+  };
+}
+function DisplayScalePopover(props) {
+  const { popoverProps } = useMuiDisplayScalePopover(props);
+  return /* @__PURE__ */ jsx(Popover, { ...popoverProps });
 }
 var defaultDisplayScalePopperModifiers = [
   {
@@ -255,25 +266,31 @@ function scalePopperOffsets(modifiers, zoom) {
     return { ...modifier, options: { ...options, offset } };
   });
 }
-function DisplayScalePopper({ anchorEl, ...props }) {
+function useMuiDisplayScalePopper({
+  anchorEl,
+  ...props
+}) {
   const displayScaleAnchor = useDisplayScaleAnchor(anchorEl ?? null);
   const { compensation, rootRef } = useDisplayScaleCompensation();
   const modifiers = useMemo(
     () => scalePopperOffsets(props.modifiers ?? defaultDisplayScalePopperModifiers, compensation.zoom),
     [compensation.zoom, props.modifiers]
   );
-  return /* @__PURE__ */ jsx(
-    Popper,
-    {
+  return {
+    popperProps: {
       ...props,
       anchorEl: displayScaleAnchor,
       container: rootRef.current ?? document.body,
       modifiers,
       style: { ...props.style, zoom: 1 }
     }
-  );
+  };
 }
-function DisplayScaleSelect(props) {
+function DisplayScalePopper(props) {
+  const { popperProps } = useMuiDisplayScalePopper(props);
+  return /* @__PURE__ */ jsx(Popper, { ...popperProps });
+}
+function useMuiDisplayScaleSelect(props) {
   const {
     MenuProps,
     SelectDisplayProps,
@@ -285,10 +302,15 @@ function DisplayScaleSelect(props) {
   } = props;
   const { rootRef } = useDisplayScaleCompensation();
   const menuRootRef = useRef(null);
+  const [menuRootElement, setMenuRootElement] = useState(null);
   const selectId = useId();
   const [anchorElement, setAnchorElement] = useState(null);
   const [uncontrolledOpen, setUncontrolledOpen] = useState(Boolean(defaultOpen));
   const open = openProp ?? uncontrolledOpen;
+  const handleMenuRootRef = useCallback((element) => {
+    menuRootRef.current = element;
+    setMenuRootElement(element);
+  }, []);
   useLayoutEffect(() => {
     if (!open) {
       setAnchorElement(null);
@@ -315,6 +337,7 @@ function DisplayScaleSelect(props) {
   useDisplayScalePopoverPosition({
     open,
     overlayRootRef: menuRootRef,
+    overlayRoot: menuRootElement,
     anchorElement,
     anchorOrigin: { vertical: "bottom", horizontal: "center" },
     transformOrigin: { vertical: "top", horizontal: "center" }
@@ -325,7 +348,10 @@ function DisplayScaleSelect(props) {
     return {
       ...MenuProps,
       container: rootRef.current ?? document.body,
-      ref: menuRootRef,
+      // Select mounts its internal Menu only after the first open event.
+      // Store the mounted root in state so the position hook runs again once
+      // MUI has measured and rendered its paper, rather than only on reopen.
+      ref: handleMenuRootRef,
       slotProps: {
         ...MenuProps?.slotProps,
         paper: {
@@ -334,10 +360,9 @@ function DisplayScaleSelect(props) {
         }
       }
     };
-  }, [MenuProps, rootRef]);
-  return /* @__PURE__ */ jsx(
-    Select,
-    {
+  }, [MenuProps, handleMenuRootRef, rootRef]);
+  return {
+    selectProps: {
       ...selectProps,
       open,
       onOpen: handleOpen,
@@ -348,6 +373,24 @@ function DisplayScaleSelect(props) {
         "data-ep-display-scale-select": selectId
       }
     }
+  };
+}
+function DisplayScaleSelect(props) {
+  const { selectProps } = useMuiDisplayScaleSelect(props);
+  return /* @__PURE__ */ jsx(Select, { ...selectProps });
+}
+function useMuiDisplayScaleComponents() {
+  const { compensation, overlayStrategy, rootRef } = useDisplayScaleCompensation();
+  const getPortalContainer = useCallback(() => {
+    if (overlayStrategy === "document-body") return document.body;
+    return rootRef.current ?? document.body;
+  }, [overlayStrategy, rootRef]);
+  return useMemo(
+    () => createMuiDisplayScaleComponents({
+      getPortalContainer,
+      overlayZoom: overlayStrategy === "document-body" ? compensation.zoom : 1
+    }),
+    [compensation.zoom, getPortalContainer, overlayStrategy]
   );
 }
 function useDisplayScaleTabsIndicator(tabsRef, value) {
@@ -408,6 +451,6 @@ var signinSplitColumnSx = {
   boxSizing: "border-box"
 };
-export { DisplayScaleMenu, DisplayScalePopover, DisplayScalePopper, DisplayScaleSelect, createMuiDisplayScaleComponents, displayScalePageFillSx, signinSplitColumnSx, signinViewportShellSx, useDisplayScalePopoverPosition, useDisplayScaleTabsIndicator };
-//# sourceMappingURL=chunk-OQRISU2D.js.map
-//# sourceMappingURL=chunk-OQRISU2D.js.map
+export { DisplayScaleMenu, DisplayScalePopover, DisplayScalePopper, DisplayScaleSelect, createMuiDisplayScaleComponents, displayScalePageFillSx, signinSplitColumnSx, signinViewportShellSx, useDisplayScalePopoverPosition, useDisplayScaleTabsIndicator, useMuiDisplayScaleComponents, useMuiDisplayScaleMenu, useMuiDisplayScalePopover, useMuiDisplayScalePopper, useMuiDisplayScaleSelect };
+//# sourceMappingURL=chunk-47O3TJUJ.js.map
+//# sourceMappingURL=chunk-47O3TJUJ.js.map

package/dist/chunk-47O3TJUJ.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/createMuiDisplayScaleComponents.ts","../src/useDisplayScalePopoverPosition.ts","../src/DisplayScaleMuiOverlays.tsx","../src/DisplayScaleSelect.tsx","../src/useMuiDisplayScaleComponents.ts","../src/useDisplayScaleTabsIndicator.ts","../src/displayScaleLayoutTokens.ts"],"names":["useRef","useCallback","useLayoutEffect","useMemo","jsx"],"mappings":"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","file":"chunk-47O3TJUJ.js","sourcesContent":["import type { Components, Theme } from \"@mui/material/styles\";\n\ntype PortalContainerGetter = () => HTMLElement;\n\ntype MuiDisplayScaleComponentsOptions = {\n getPortalContainer: PortalContainerGetter;\n /**\n * Overlay content is portalled outside the zoomed app root, so it needs the\n * same density correction independently.\n */\n overlayZoom?: number;\n};\n\n/**\n * MUI adapter for a compensated app root.\n *\n * Centralizing these defaults gives every MUI overlay the portal strategy and\n * density correction chosen by the display-scale engine.\n */\nexport function createMuiDisplayScaleComponents({\n getPortalContainer,\n overlayZoom = 1,\n}: MuiDisplayScaleComponentsOptions): Components<Theme> {\n const zoom = overlayZoom > 0 ? overlayZoom : 1;\n const resolveContainerZoom = (container: unknown): number => {\n if (typeof document === \"undefined\") return zoom;\n const resolvedContainer =\n typeof container === \"function\" ? (container as PortalContainerGetter)() : container;\n // MUI does not always expose the resolved portal node through ownerState.\n // Missing means the component will use its default (document.body).\n return resolvedContainer == null || resolvedContainer === document.body ? zoom : 1;\n };\n\n return {\n MuiModal: {\n defaultProps: {\n container: getPortalContainer,\n },\n },\n MuiDialog: {\n defaultProps: {\n container: getPortalContainer,\n },\n styleOverrides: {\n paper: ({ ownerState }) => ({ zoom: resolveContainerZoom(ownerState?.container) }),\n },\n },\n MuiPopover: {\n defaultProps: {\n container: getPortalContainer,\n },\n styleOverrides: {\n paper: ({ ownerState }) => ({ zoom: resolveContainerZoom(ownerState?.container) }),\n },\n },\n MuiPopper: {\n defaultProps: {\n container: getPortalContainer,\n },\n styleOverrides: {\n root: ({ ownerState }) => ({ zoom: resolveContainerZoom(ownerState?.container) }),\n },\n },\n MuiDrawer: {\n defaultProps: {\n // Drawer inherits Modal props. Supplying the portal host here (rather\n // than only through MuiModal) also covers Drawer internals directly.\n container: getPortalContainer,\n },\n styleOverrides: {\n paper: ({ ownerState }) => {\n // Permanent/persistent drawers live inside the compensated root and\n // must not be zoomed a second time. Temporary drawers are portalled\n // to document.body, so their paper needs the overlay density zoom.\n if (ownerState.variant !== \"temporary\") return {};\n\n const isVertical = ownerState.anchor === \"left\" || ownerState.anchor === \"right\";\n return isVertical\n ? {\n zoom,\n height: \"var(--ep-display-scale-overlay-viewport-height, 100dvh)\",\n maxHeight: \"var(--ep-display-scale-overlay-viewport-height, 100dvh)\",\n }\n : {\n zoom,\n width: \"var(--ep-display-scale-overlay-viewport-width, 100dvw)\",\n maxWidth: \"var(--ep-display-scale-overlay-viewport-width, 100dvw)\",\n };\n },\n },\n },\n };\n}\n","import type { PopoverOrigin, PopoverProps } from \"@mui/material\";\nimport { type RefObject, useCallback, useLayoutEffect } from \"react\";\nimport { useDisplayScaleCompensation } from \"./DisplayScaleCompensationProvider\";\n\ntype DisplayScalePopoverPositionOptions = {\n open: boolean;\n overlayRootRef: RefObject<HTMLDivElement | null>;\n /**\n * The mounted overlay root. A ref assignment alone does not trigger a\n * render, so callers with lazily-mounted overlays (notably MUI Select)\n * provide this state value to schedule the first correction after mount.\n */\n overlayRoot?: HTMLDivElement | null;\n anchorElement: HTMLElement | null;\n anchorReference?: PopoverProps[\"anchorReference\"];\n anchorPosition?: PopoverProps[\"anchorPosition\"];\n anchorOrigin?: PopoverProps[\"anchorOrigin\"];\n transformOrigin?: PopoverProps[\"transformOrigin\"];\n marginThreshold?: PopoverProps[\"marginThreshold\"];\n};\n\nfunction resolveOffset(\n origin: number | \"top\" | \"center\" | \"bottom\" | \"left\" | \"right\" | undefined,\n size: number,\n): number {\n if (typeof origin === \"number\") return origin;\n if (origin === \"center\") return size / 2;\n if (origin === \"bottom\" || origin === \"right\") return size;\n return 0;\n}\n\nfunction resolveOrigins(\n anchorOrigin: PopoverOrigin | undefined,\n transformOrigin: PopoverOrigin | undefined,\n anchorWidth: number,\n anchorHeight: number,\n paperWidth: number,\n paperHeight: number,\n): { anchorX: number; anchorY: number; transformX: number; transformY: number } {\n const resolvedAnchorOrigin = anchorOrigin ?? { vertical: \"top\", horizontal: \"left\" };\n const resolvedTransformOrigin = transformOrigin ?? { vertical: \"top\", horizontal: \"left\" };\n\n return {\n anchorX: resolveOffset(resolvedAnchorOrigin.horizontal, anchorWidth),\n anchorY: resolveOffset(resolvedAnchorOrigin.vertical, anchorHeight),\n transformX: resolveOffset(resolvedTransformOrigin.horizontal, paperWidth),\n transformY: resolveOffset(resolvedTransformOrigin.vertical, paperHeight),\n };\n}\n\n/**\n * Replaces only MUI Popover's physical-viewport collision pass. MUI still\n * owns focus, transition and anchor semantics; this writes the final logical\n * top/left inside the compensated portal root.\n */\nexport function useDisplayScalePopoverPosition({\n open,\n overlayRootRef,\n overlayRoot: mountedOverlayRoot,\n anchorElement,\n anchorReference,\n anchorPosition,\n anchorOrigin,\n transformOrigin,\n marginThreshold = 16,\n}: DisplayScalePopoverPositionOptions): void {\n const { compensation, layoutExtents, rootRef } = useDisplayScaleCompensation();\n\n const correctPosition = useCallback(() => {\n if (!open || !compensation.active || !layoutExtents) return;\n\n const overlayRoot = mountedOverlayRoot ?? overlayRootRef.current;\n const paper = overlayRoot?.querySelector<HTMLElement>(\".MuiPopover-paper\");\n if (!paper) return;\n\n const zoom = compensation.zoom > 0 ? compensation.zoom : 1;\n const rootRect = rootRef.current?.getBoundingClientRect();\n const rootLeft = rootRect?.left ?? 0;\n const rootTop = rootRect?.top ?? 0;\n const anchorRect = anchorElement?.getBoundingClientRect();\n const anchorX =\n anchorReference === \"anchorPosition\" && anchorPosition\n ? (anchorPosition.left - rootLeft) / zoom\n : anchorRect\n ? (anchorRect.left - rootLeft) / zoom\n : null;\n const anchorY =\n anchorReference === \"anchorPosition\" && anchorPosition\n ? (anchorPosition.top - rootTop) / zoom\n : anchorRect\n ? (anchorRect.top - rootTop) / zoom\n : null;\n if (anchorX == null || anchorY == null) return;\n\n const paperWidth = paper.offsetWidth;\n const paperHeight = paper.offsetHeight;\n const {\n anchorX: originX,\n anchorY: originY,\n transformX,\n transformY,\n } = resolveOrigins(\n anchorOrigin,\n transformOrigin,\n anchorRect ? anchorRect.width / zoom : 0,\n anchorRect ? anchorRect.height / zoom : 0,\n paperWidth,\n paperHeight,\n );\n const margin = typeof marginThreshold === \"number\" ? marginThreshold : 16;\n const maxLeft = Math.max(margin, layoutExtents.layoutWidthPx - margin - paperWidth);\n const maxTop = Math.max(margin, layoutExtents.layoutHeightPx - margin - paperHeight);\n const left = Math.min(maxLeft, Math.max(margin, anchorX + originX - transformX));\n const top = Math.min(maxTop, Math.max(margin, anchorY + originY - transformY));\n\n paper.style.left = `${Math.round(left)}px`;\n paper.style.top = `${Math.round(top)}px`;\n }, [\n anchorElement,\n anchorOrigin,\n anchorPosition,\n anchorReference,\n compensation.active,\n compensation.zoom,\n layoutExtents,\n marginThreshold,\n mountedOverlayRoot,\n open,\n overlayRootRef,\n rootRef,\n transformOrigin,\n ]);\n\n useLayoutEffect(() => {\n if (!open) return;\n\n const firstFrame = window.requestAnimationFrame(() => {\n correctPosition();\n window.requestAnimationFrame(correctPosition);\n });\n window.addEventListener(\"resize\", correctPosition);\n window.addEventListener(\"scroll\", correctPosition, true);\n\n return () => {\n window.cancelAnimationFrame(firstFrame);\n window.removeEventListener(\"resize\", correctPosition);\n window.removeEventListener(\"scroll\", correctPosition, true);\n };\n }, [correctPosition, open]);\n}\n","import type { MenuProps, PopoverProps, PopperProps } from \"@mui/material\";\nimport { Menu, Popover, Popper } from \"@mui/material\";\nimport { useTheme } from \"@mui/material/styles\";\nimport type {\n OffsetsFunction,\n Options as PopperOffsetOptions,\n} from \"@popperjs/core/lib/modifiers/offset\";\nimport { type ReactElement, useMemo, useRef } from \"react\";\nimport { useDisplayScaleCompensation } from \"./DisplayScaleCompensationProvider\";\nimport { useDisplayScaleAnchor } from \"./useDisplayScaleAnchor\";\nimport { useDisplayScalePopoverPosition } from \"./useDisplayScalePopoverPosition\";\n\ntype NativeAnchorProps = {\n anchorEl?: HTMLElement | null;\n};\n\nexport type DisplayScaleMenuProps = Omit<MenuProps, \"anchorEl\"> & NativeAnchorProps;\n\nexport type MuiDisplayScaleMenuAdapter = {\n /** Spread these props onto MUI's native `<Menu />`. */\n menuProps: MenuProps;\n};\n\n/** Non-wrapper display-scale adapter for MUI's native `<Menu />`. */\nexport function useMuiDisplayScaleMenu({\n anchorEl,\n ...props\n}: DisplayScaleMenuProps): MuiDisplayScaleMenuAdapter {\n const displayScaleAnchor = useDisplayScaleAnchor(anchorEl ?? null);\n const { compensation, rootRef } = useDisplayScaleCompensation();\n const theme = useTheme();\n const overlayRootRef = useRef<HTMLDivElement>(null);\n const horizontalOrigin = theme.direction === \"rtl\" ? \"right\" : \"left\";\n const anchorOrigin = props.anchorOrigin ?? {\n vertical: \"bottom\",\n horizontal: horizontalOrigin,\n };\n const transformOrigin = props.transformOrigin ?? {\n vertical: \"top\",\n horizontal: horizontalOrigin,\n };\n const anchorPosition = useMemo(() => {\n if (props.anchorReference !== \"anchorPosition\" || !props.anchorPosition) {\n return props.anchorPosition;\n }\n const zoom = compensation.zoom > 0 ? compensation.zoom : 1;\n return {\n top: props.anchorPosition.top / zoom,\n left: props.anchorPosition.left / zoom,\n };\n }, [compensation.zoom, props.anchorPosition, props.anchorReference]);\n useDisplayScalePopoverPosition({\n open: props.open,\n overlayRootRef,\n anchorElement: anchorEl ?? null,\n anchorReference: props.anchorReference,\n anchorPosition: props.anchorPosition,\n anchorOrigin,\n transformOrigin,\n marginThreshold: props.marginThreshold,\n });\n\n return {\n menuProps: {\n ...props,\n ref: overlayRootRef,\n anchorEl: displayScaleAnchor,\n anchorPosition,\n anchorOrigin,\n container: rootRef.current ?? document.body,\n transformOrigin,\n },\n };\n}\n\n/** MUI Menu wrapper — prefer `useMuiDisplayScaleMenu` when retaining `<Menu />`. */\nexport function DisplayScaleMenu(props: DisplayScaleMenuProps): ReactElement {\n const { menuProps } = useMuiDisplayScaleMenu(props);\n return <Menu {...menuProps} />;\n}\n\nexport type DisplayScalePopoverProps = Omit<PopoverProps, \"anchorEl\"> & NativeAnchorProps;\n\nexport type MuiDisplayScalePopoverAdapter = {\n /** Spread these props onto MUI's native `<Popover />`. */\n popoverProps: PopoverProps;\n};\n\n/** Non-wrapper display-scale adapter for MUI's native `<Popover />`. */\nexport function useMuiDisplayScalePopover({\n anchorEl,\n ...props\n}: DisplayScalePopoverProps): MuiDisplayScalePopoverAdapter {\n const displayScaleAnchor = useDisplayScaleAnchor(anchorEl ?? null);\n const { rootRef } = useDisplayScaleCompensation();\n const overlayRootRef = useRef<HTMLDivElement>(null);\n useDisplayScalePopoverPosition({\n open: props.open,\n overlayRootRef,\n anchorElement: anchorEl ?? null,\n anchorReference: props.anchorReference,\n anchorPosition: props.anchorPosition,\n anchorOrigin: props.anchorOrigin,\n transformOrigin: props.transformOrigin,\n marginThreshold: props.marginThreshold,\n });\n return {\n popoverProps: {\n ...props,\n ref: overlayRootRef,\n anchorEl: displayScaleAnchor,\n container: rootRef.current ?? document.body,\n },\n };\n}\n\n/** MUI Popover wrapper — prefer `useMuiDisplayScalePopover` when retaining `<Popover />`. */\nexport function DisplayScalePopover(props: DisplayScalePopoverProps): ReactElement {\n const { popoverProps } = useMuiDisplayScalePopover(props);\n return <Popover {...popoverProps} />;\n}\n\nexport type DisplayScalePopperProps = Omit<PopperProps, \"anchorEl\"> & NativeAnchorProps;\n\nexport type MuiDisplayScalePopperAdapter = {\n /** Spread these props onto MUI's native `<Popper />`. */\n popperProps: PopperProps;\n};\n\nconst defaultDisplayScalePopperModifiers: PopperProps[\"modifiers\"] = [\n {\n name: \"offset\",\n options: { offset: [0, 8] },\n },\n];\n\nfunction scalePopperOffsets(\n modifiers: PopperProps[\"modifiers\"],\n zoom: number,\n): PopperProps[\"modifiers\"] {\n if (!modifiers || zoom === 1) return modifiers;\n\n return modifiers.map((modifier) => {\n if (modifier.name !== \"offset\") return modifier;\n\n const options = modifier.options as Partial<PopperOffsetOptions> | undefined;\n const rawOffset = options?.offset;\n if (!rawOffset) return modifier;\n\n const scaleValue = (value: number | null | undefined) => (value == null ? value : value / zoom);\n const offset: PopperOffsetOptions[\"offset\"] =\n typeof rawOffset === \"function\"\n ? (args: Parameters<OffsetsFunction>[0]) => {\n const [skidding, distance] = rawOffset(args);\n return [scaleValue(skidding), scaleValue(distance)];\n }\n : [scaleValue(rawOffset[0]), scaleValue(rawOffset[1])];\n\n return { ...modifier, options: { ...options, offset } };\n });\n}\n\n/** Non-wrapper display-scale adapter for MUI's native `<Popper />`. */\nexport function useMuiDisplayScalePopper({\n anchorEl,\n ...props\n}: DisplayScalePopperProps): MuiDisplayScalePopperAdapter {\n const displayScaleAnchor = useDisplayScaleAnchor(anchorEl ?? null);\n const { compensation, rootRef } = useDisplayScaleCompensation();\n const modifiers = useMemo(\n () =>\n scalePopperOffsets(props.modifiers ?? defaultDisplayScalePopperModifiers, compensation.zoom),\n [compensation.zoom, props.modifiers],\n );\n return {\n popperProps: {\n ...props,\n anchorEl: displayScaleAnchor,\n container: rootRef.current ?? document.body,\n modifiers,\n style: { ...props.style, zoom: 1 },\n },\n };\n}\n\n/** MUI Popper wrapper — prefer `useMuiDisplayScalePopper` when retaining `<Popper />`. */\nexport function DisplayScalePopper(props: DisplayScalePopperProps): ReactElement {\n const { popperProps } = useMuiDisplayScalePopper(props);\n return <Popper {...popperProps} />;\n}\n","import type { MenuProps, SelectProps } from \"@mui/material\";\nimport { Select } from \"@mui/material\";\nimport type { ReactElement, SyntheticEvent } from \"react\";\nimport { useCallback, useId, useLayoutEffect, useMemo, useRef, useState } from \"react\";\nimport { useDisplayScaleCompensation } from \"./DisplayScaleCompensationProvider\";\nimport { useDisplayScalePopoverPosition } from \"./useDisplayScalePopoverPosition\";\n\nexport type MuiDisplayScaleSelectAdapter<Value = unknown> = {\n /** Spread these props onto MUI's native `<Select />`. */\n selectProps: SelectProps<Value>;\n};\n\n/**\n * MUI Select adapter for the display-scale engine. Select creates its Menu\n * internally, so it cannot use DisplayScaleMenu directly.\n */\nexport function useMuiDisplayScaleSelect<Value = unknown>(\n props: SelectProps<Value>,\n): MuiDisplayScaleSelectAdapter<Value> {\n const {\n MenuProps,\n SelectDisplayProps,\n defaultOpen,\n onClose,\n onOpen,\n open: openProp,\n ...selectProps\n } = props;\n const { rootRef } = useDisplayScaleCompensation();\n const menuRootRef = useRef<HTMLDivElement>(null);\n const [menuRootElement, setMenuRootElement] = useState<HTMLDivElement | null>(null);\n const selectId = useId();\n const [anchorElement, setAnchorElement] = useState<HTMLElement | null>(null);\n const [uncontrolledOpen, setUncontrolledOpen] = useState(Boolean(defaultOpen));\n const open = openProp ?? uncontrolledOpen;\n\n const handleMenuRootRef = useCallback((element: HTMLDivElement | null) => {\n menuRootRef.current = element;\n setMenuRootElement(element);\n }, []);\n\n useLayoutEffect(() => {\n if (!open) {\n setAnchorElement(null);\n return;\n }\n setAnchorElement(\n document.querySelector<HTMLElement>(`[data-ep-display-scale-select=\"${selectId}\"]`),\n );\n }, [open, selectId]);\n\n const handleOpen = useCallback(\n (event: SyntheticEvent) => {\n if (openProp === undefined) setUncontrolledOpen(true);\n onOpen?.(event);\n },\n [onOpen, openProp],\n );\n const handleClose = useCallback(\n (event: SyntheticEvent) => {\n if (openProp === undefined) setUncontrolledOpen(false);\n onClose?.(event);\n },\n [onClose, openProp],\n );\n\n useDisplayScalePopoverPosition({\n open,\n overlayRootRef: menuRootRef,\n overlayRoot: menuRootElement,\n anchorElement,\n anchorOrigin: { vertical: \"bottom\", horizontal: \"center\" },\n transformOrigin: { vertical: \"top\", horizontal: \"center\" },\n });\n\n const menuProps = useMemo((): Partial<MenuProps> => {\n const paperSlot = MenuProps?.slotProps?.paper;\n const resolvedPaperSlot = typeof paperSlot === \"function\" ? undefined : paperSlot;\n\n return {\n ...MenuProps,\n container: rootRef.current ?? document.body,\n // Select mounts its internal Menu only after the first open event.\n // Store the mounted root in state so the position hook runs again once\n // MUI has measured and rendered its paper, rather than only on reopen.\n ref: handleMenuRootRef,\n slotProps: {\n ...MenuProps?.slotProps,\n paper: {\n ...resolvedPaperSlot,\n style: { ...resolvedPaperSlot?.style, zoom: 1 },\n },\n },\n };\n }, [MenuProps, handleMenuRootRef, rootRef]);\n\n return {\n selectProps: {\n ...selectProps,\n open,\n onOpen: handleOpen,\n onClose: handleClose,\n MenuProps: menuProps,\n SelectDisplayProps: {\n ...SelectDisplayProps,\n \"data-ep-display-scale-select\": selectId,\n } as SelectProps<Value>[\"SelectDisplayProps\"],\n },\n };\n}\n\n/** MUI Select wrapper — prefer `useMuiDisplayScaleSelect` when retaining `<Select />`. */\nexport function DisplayScaleSelect<Value = unknown>(props: SelectProps<Value>): ReactElement {\n const { selectProps } = useMuiDisplayScaleSelect(props);\n return <Select<Value> {...selectProps} />;\n}\n","import type { Components, Theme } from \"@mui/material/styles\";\nimport { useCallback, useMemo } from \"react\";\nimport { useDisplayScaleCompensation } from \"./DisplayScaleCompensationProvider\";\nimport { createMuiDisplayScaleComponents } from \"./createMuiDisplayScaleComponents\";\n\n/**\n * React adapter for global MUI overlay defaults. Use inside an existing\n * `DisplayScaleProvider`, then pass the result to `createTheme`.\n */\nexport function useMuiDisplayScaleComponents(): Components<Theme> {\n const { compensation, overlayStrategy, rootRef } = useDisplayScaleCompensation();\n\n const getPortalContainer = useCallback((): HTMLElement => {\n if (overlayStrategy === \"document-body\") return document.body;\n return rootRef.current ?? document.body;\n }, [overlayStrategy, rootRef]);\n\n return useMemo(\n () =>\n createMuiDisplayScaleComponents({\n getPortalContainer,\n overlayZoom: overlayStrategy === \"document-body\" ? compensation.zoom : 1,\n }),\n [compensation.zoom, getPortalContainer, overlayStrategy],\n );\n}\n","import { type RefObject, useLayoutEffect } from \"react\";\nimport { useDisplayScaleCompensation } from \"./DisplayScaleCompensationProvider\";\n\n/**\n * Keeps MUI Tabs' indicator in the compensated root's logical coordinate\n * space. MUI normally uses getBoundingClientRect(), whose values are already\n * zoomed and therefore too small for a logical layout container.\n */\nexport function useDisplayScaleTabsIndicator(\n tabsRef: RefObject<HTMLDivElement | null>,\n value: unknown,\n): void {\n const { compensation } = useDisplayScaleCompensation();\n\n useLayoutEffect(() => {\n if (!compensation.active) return;\n // Re-run after the selected Tabs value changes.\n void value;\n\n const updateIndicator = (): void => {\n const tabs = tabsRef.current;\n const indicator = tabs?.querySelector<HTMLElement>(\".MuiTabs-indicator\");\n const selectedTab = tabs?.querySelector<HTMLElement>(\".MuiTab-root.Mui-selected\");\n if (!tabs || !indicator || !selectedTab) return;\n\n const isRtl = getComputedStyle(tabs).direction === \"rtl\";\n const left = selectedTab.offsetLeft;\n const width = selectedTab.offsetWidth;\n\n indicator.style.width = `${width}px`;\n if (isRtl) {\n indicator.style.left = \"auto\";\n indicator.style.right = `${tabs.offsetWidth - left - width}px`;\n } else {\n indicator.style.right = \"auto\";\n indicator.style.left = `${left}px`;\n }\n };\n\n const frame = window.requestAnimationFrame(updateIndicator);\n const observer = new ResizeObserver(updateIndicator);\n if (tabsRef.current) observer.observe(tabsRef.current);\n window.addEventListener(\"resize\", updateIndicator);\n\n return () => {\n window.cancelAnimationFrame(frame);\n observer.disconnect();\n window.removeEventListener(\"resize\", updateIndicator);\n };\n }, [compensation.active, tabsRef, value]);\n}\n","import type { SxProps, Theme } from \"@mui/material/styles\";\n\n/** Fill the compensated app tree — prefer over raw `100vh` inside `#root`. */\nexport const displayScalePageFillSx: SxProps<Theme> = {\n flex: 1,\n minHeight: 0,\n minWidth: 0,\n width: \"100%\",\n height: \"100%\",\n};\n\n/** Full-viewport auth split layout — fills the compensated app root (not `position: fixed`). */\nexport const signinViewportShellSx: SxProps<Theme> = {\n flex: 1,\n minHeight: 0,\n minWidth: 0,\n width: \"100%\",\n height: \"100%\",\n overflow: \"hidden\",\n boxSizing: \"border-box\",\n};\n\n/** 50/50 desktop columns — avoids flex min-content overflow at OS display scale. */\nexport const signinSplitColumnSx: SxProps<Theme> = {\n flex: { xs: \"0 0 auto\", md: \"1 1 0\" },\n width: { xs: \"100%\", md: \"50%\" },\n maxWidth: { xs: \"100%\", md: \"50%\" },\n minWidth: 0,\n boxSizing: \"border-box\",\n};\n"]}

package/dist/index.d.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 export { DEFAULT_DISPLAY_SCALE_THRESHOLDS, clearDisplayScaleBaseline, detectDisplayScale, evaluateDisplayScale, readDisplayScaleBaseline, recalibrateDisplayScale, resetDisplayScaleEngine, shouldApplyOsScaleCompensation, snapToWindowsOsScale, subscribeDisplayScale, writeDisplayScaleBaseline } from './core.js';
 export { C as ComputeDisplayScaleCompensationOptions, D as DEFAULT_DISPLAY_SCALE_COMPENSATION_CONFIG, a as DetectDisplayScaleOptions, b as DisplayScaleBaseline, c as DisplayScaleCalibration, d as DisplayScaleCompensation, e as DisplayScaleCompensationConfig, f as DisplayScaleConfidence, g as DisplayScaleDetectionMethod, h as DisplayScaleEvaluation, i as DisplayScaleIssue, j as DisplayScaleLayoutExtents, k as DisplayScaleLogicalViewport, l as DisplayScaleOverlayBoundsOptions, m as DisplayScaleScreen, n as DisplayScaleSnapshot, o as DisplayScaleThresholds, p as DisplayScaleViewport, S as SubscribeDisplayScaleOptions, q as applyDisplayScaleCompensationStyles, r as applyDisplayScaleCompensationToDocument, s as clearDisplayScaleCompensationFromDocument, t as clearDisplayScaleCompensationStyles, u as computeDisplayScaleCompensation, v as getDisplayScaleLogicalViewport, w as getDisplayScaleOverlayMaxHeight, x as measureDisplayScaleLayoutExtents, y as primeDisplayScaleCompensation, z as readDisplayScaleViewportSize, A as supportsCssZoom, B as syncDisplayScaleCompensationMetadata, E as toDisplayScaleLogicalPixels } from './displayScaleLogicalViewport-Ikf-DtkQ.js';
 export { DisplayScaleCompensationProvider, DisplayScaleOverlay, DisplayScaleOverlayStrategy, DisplayScaleProvider, DisplayScaleProviderProps, DisplayScaleVirtualAnchor, useDisplayScale, useDisplayScaleAnchor, useDisplayScaleCompensation, useDisplayScaleOverlay, useDisplayScalePortalContainer, useLogicalMaxWidth, useLogicalMinWidth } from './react.js';
-export { DisplayScaleMenu, DisplayScaleMenuProps, DisplayScalePopover, DisplayScalePopoverProps, DisplayScalePopper, DisplayScalePopperProps, DisplayScaleSelect, createMuiDisplayScaleComponents, displayScalePageFillSx, signinSplitColumnSx, signinViewportShellSx, useDisplayScalePopoverPosition, useDisplayScaleTabsIndicator } from './mui.js';
+export { DisplayScaleMenu, DisplayScaleMenuProps, DisplayScalePopover, DisplayScalePopoverProps, DisplayScalePopper, DisplayScalePopperProps, DisplayScaleSelect, MuiDisplayScaleMenuAdapter, MuiDisplayScalePopoverAdapter, MuiDisplayScalePopperAdapter, MuiDisplayScaleSelectAdapter, createMuiDisplayScaleComponents, displayScalePageFillSx, signinSplitColumnSx, signinViewportShellSx, useDisplayScalePopoverPosition, useDisplayScaleTabsIndicator, useMuiDisplayScaleComponents, useMuiDisplayScaleMenu, useMuiDisplayScalePopover, useMuiDisplayScalePopper, useMuiDisplayScaleSelect } from './mui.js';
 import 'react';
 import '@mui/material/styles';
 import '@mui/material';

package/dist/index.js CHANGED Viewed

@@ -1,7 +1,7 @@
 import './chunk-SLNYXBHU.js';
 export { useDisplayScaleOverlay, useLogicalMaxWidth, useLogicalMinWidth } from './chunk-64EBQUAW.js';
 export { getDisplayScaleLogicalViewport, getDisplayScaleOverlayMaxHeight, toDisplayScaleLogicalPixels } from './chunk-U3ZWHUJG.js';
-export { DisplayScaleMenu, DisplayScalePopover, DisplayScalePopper, DisplayScaleSelect, createMuiDisplayScaleComponents, displayScalePageFillSx, signinSplitColumnSx, signinViewportShellSx, useDisplayScalePopoverPosition, useDisplayScaleTabsIndicator } from './chunk-OQRISU2D.js';
+export { DisplayScaleMenu, DisplayScalePopover, DisplayScalePopper, DisplayScaleSelect, createMuiDisplayScaleComponents, displayScalePageFillSx, signinSplitColumnSx, signinViewportShellSx, useDisplayScalePopoverPosition, useDisplayScaleTabsIndicator, useMuiDisplayScaleComponents, useMuiDisplayScaleMenu, useMuiDisplayScalePopover, useMuiDisplayScalePopper, useMuiDisplayScaleSelect } from './chunk-47O3TJUJ.js';
 export { DisplayScaleCompensationProvider, DisplayScaleProvider, useDisplayScale, useDisplayScaleAnchor, useDisplayScaleCompensation, useDisplayScalePortalContainer } from './chunk-F5AFPMQC.js';
 export { DEFAULT_DISPLAY_SCALE_COMPENSATION_CONFIG, DEFAULT_DISPLAY_SCALE_THRESHOLDS, applyDisplayScaleCompensationStyles, applyDisplayScaleCompensationToDocument, clearDisplayScaleBaseline, clearDisplayScaleCompensationFromDocument, clearDisplayScaleCompensationStyles, computeDisplayScaleCompensation, detectDisplayScale, evaluateDisplayScale, measureDisplayScaleLayoutExtents, primeDisplayScaleCompensation, readDisplayScaleBaseline, readDisplayScaleViewportSize, recalibrateDisplayScale, resetDisplayScaleEngine, shouldApplyOsScaleCompensation, snapToWindowsOsScale, subscribeDisplayScale, supportsCssZoom, syncDisplayScaleCompensationMetadata, writeDisplayScaleBaseline } from './chunk-VWJNHWMD.js';
 //# sourceMappingURL=index.js.map

package/dist/mui.d.ts CHANGED Viewed

@@ -23,24 +23,60 @@ type NativeAnchorProps = {
     anchorEl?: HTMLElement | null;
 };
 type DisplayScaleMenuProps = Omit<MenuProps, "anchorEl"> & NativeAnchorProps;
-/** MUI Menu with an anchor adapted to the active portal strategy. */
-declare function DisplayScaleMenu({ anchorEl, ...props }: DisplayScaleMenuProps): ReactElement;
+type MuiDisplayScaleMenuAdapter = {
+    /** Spread these props onto MUI's native `<Menu />`. */
+    menuProps: MenuProps;
+};
+/** Non-wrapper display-scale adapter for MUI's native `<Menu />`. */
+declare function useMuiDisplayScaleMenu({ anchorEl, ...props }: DisplayScaleMenuProps): MuiDisplayScaleMenuAdapter;
+/** MUI Menu wrapper — prefer `useMuiDisplayScaleMenu` when retaining `<Menu />`. */
+declare function DisplayScaleMenu(props: DisplayScaleMenuProps): ReactElement;
 type DisplayScalePopoverProps = Omit<PopoverProps, "anchorEl"> & NativeAnchorProps;
-/** MUI Popover with an anchor adapted to the active portal strategy. */
-declare function DisplayScalePopover({ anchorEl, ...props }: DisplayScalePopoverProps): ReactElement;
+type MuiDisplayScalePopoverAdapter = {
+    /** Spread these props onto MUI's native `<Popover />`. */
+    popoverProps: PopoverProps;
+};
+/** Non-wrapper display-scale adapter for MUI's native `<Popover />`. */
+declare function useMuiDisplayScalePopover({ anchorEl, ...props }: DisplayScalePopoverProps): MuiDisplayScalePopoverAdapter;
+/** MUI Popover wrapper — prefer `useMuiDisplayScalePopover` when retaining `<Popover />`. */
+declare function DisplayScalePopover(props: DisplayScalePopoverProps): ReactElement;
 type DisplayScalePopperProps = Omit<PopperProps, "anchorEl"> & NativeAnchorProps;
-/** MUI Popper with an anchor adapted to the active portal strategy. */
-declare function DisplayScalePopper({ anchorEl, ...props }: DisplayScalePopperProps): ReactElement;
+type MuiDisplayScalePopperAdapter = {
+    /** Spread these props onto MUI's native `<Popper />`. */
+    popperProps: PopperProps;
+};
+/** Non-wrapper display-scale adapter for MUI's native `<Popper />`. */
+declare function useMuiDisplayScalePopper({ anchorEl, ...props }: DisplayScalePopperProps): MuiDisplayScalePopperAdapter;
+/** MUI Popper wrapper — prefer `useMuiDisplayScalePopper` when retaining `<Popper />`. */
+declare function DisplayScalePopper(props: DisplayScalePopperProps): ReactElement;
+type MuiDisplayScaleSelectAdapter<Value = unknown> = {
+    /** Spread these props onto MUI's native `<Select />`. */
+    selectProps: SelectProps<Value>;
+};
 /**
  * MUI Select adapter for the display-scale engine. Select creates its Menu
  * internally, so it cannot use DisplayScaleMenu directly.
  */
+declare function useMuiDisplayScaleSelect<Value = unknown>(props: SelectProps<Value>): MuiDisplayScaleSelectAdapter<Value>;
+/** MUI Select wrapper — prefer `useMuiDisplayScaleSelect` when retaining `<Select />`. */
 declare function DisplayScaleSelect<Value = unknown>(props: SelectProps<Value>): ReactElement;
+/**
+ * React adapter for global MUI overlay defaults. Use inside an existing
+ * `DisplayScaleProvider`, then pass the result to `createTheme`.
+ */
+declare function useMuiDisplayScaleComponents(): Components<Theme>;
 type DisplayScalePopoverPositionOptions = {
     open: boolean;
     overlayRootRef: RefObject<HTMLDivElement | null>;
+    /**
+     * The mounted overlay root. A ref assignment alone does not trigger a
+     * render, so callers with lazily-mounted overlays (notably MUI Select)
+     * provide this state value to schedule the first correction after mount.
+     */
+    overlayRoot?: HTMLDivElement | null;
     anchorElement: HTMLElement | null;
     anchorReference?: PopoverProps["anchorReference"];
     anchorPosition?: PopoverProps["anchorPosition"];
@@ -53,7 +89,7 @@ type DisplayScalePopoverPositionOptions = {
  * owns focus, transition and anchor semantics; this writes the final logical
  * top/left inside the compensated portal root.
  */
-declare function useDisplayScalePopoverPosition({ open, overlayRootRef, anchorElement, anchorReference, anchorPosition, anchorOrigin, transformOrigin, marginThreshold, }: DisplayScalePopoverPositionOptions): void;
+declare function useDisplayScalePopoverPosition({ open, overlayRootRef, overlayRoot: mountedOverlayRoot, anchorElement, anchorReference, anchorPosition, anchorOrigin, transformOrigin, marginThreshold, }: DisplayScalePopoverPositionOptions): void;
 /**
  * Keeps MUI Tabs' indicator in the compensated root's logical coordinate
@@ -69,4 +105,4 @@ declare const signinViewportShellSx: SxProps<Theme>;
 /** 50/50 desktop columns — avoids flex min-content overflow at OS display scale. */
 declare const signinSplitColumnSx: SxProps<Theme>;
-export { DisplayScaleMenu, type DisplayScaleMenuProps, DisplayScalePopover, type DisplayScalePopoverProps, DisplayScalePopper, type DisplayScalePopperProps, DisplayScaleSelect, createMuiDisplayScaleComponents, displayScalePageFillSx, signinSplitColumnSx, signinViewportShellSx, useDisplayScalePopoverPosition, useDisplayScaleTabsIndicator };
+export { DisplayScaleMenu, type DisplayScaleMenuProps, DisplayScalePopover, type DisplayScalePopoverProps, DisplayScalePopper, type DisplayScalePopperProps, DisplayScaleSelect, type MuiDisplayScaleMenuAdapter, type MuiDisplayScalePopoverAdapter, type MuiDisplayScalePopperAdapter, type MuiDisplayScaleSelectAdapter, createMuiDisplayScaleComponents, displayScalePageFillSx, signinSplitColumnSx, signinViewportShellSx, useDisplayScalePopoverPosition, useDisplayScaleTabsIndicator, useMuiDisplayScaleComponents, useMuiDisplayScaleMenu, useMuiDisplayScalePopover, useMuiDisplayScalePopper, useMuiDisplayScaleSelect };

package/dist/mui.js CHANGED Viewed

@@ -1,4 +1,4 @@
-export { DisplayScaleMenu, DisplayScalePopover, DisplayScalePopper, DisplayScaleSelect, createMuiDisplayScaleComponents, displayScalePageFillSx, signinSplitColumnSx, signinViewportShellSx, useDisplayScalePopoverPosition, useDisplayScaleTabsIndicator } from './chunk-OQRISU2D.js';
+export { DisplayScaleMenu, DisplayScalePopover, DisplayScalePopper, DisplayScaleSelect, createMuiDisplayScaleComponents, displayScalePageFillSx, signinSplitColumnSx, signinViewportShellSx, useDisplayScalePopoverPosition, useDisplayScaleTabsIndicator, useMuiDisplayScaleComponents, useMuiDisplayScaleMenu, useMuiDisplayScalePopover, useMuiDisplayScalePopper, useMuiDisplayScaleSelect } from './chunk-47O3TJUJ.js';
 import './chunk-F5AFPMQC.js';
 import './chunk-VWJNHWMD.js';
 //# sourceMappingURL=mui.js.map

package/docs/display-scale-engine.md CHANGED Viewed

@@ -1,208 +1,238 @@
-# Display-scale engine
+# Display Scale Engine guide
-## Purpose
+`react-display-scale-engine` is an optional visual-density policy for React applications.
+It targets Windows desktop users whose operating-system display scale is above 100%—for example
+125% or 150%—when a product requires roughly the same dashboard density as Windows 100%.
-The display-scale engine provides an optional **visual-density lock** for Windows desktop browsers.
-When Windows display scale is 125%, 150%, or another supported tier, the app can render toward a
-100% visual-density target while retaining an expanded logical layout area.
+It is not a generic replacement for responsive design and it does not force browser zoom.
-This is a product policy, not a browser requirement. A conventional responsive website should not
-enable this behavior unless matching 100% visual density is an explicit requirement.
+## What it solves
-## Scope and limitations
+At Windows 150%, a browser usually reports a higher `devicePixelRatio`. A conventional web app
+then renders typography, spacing, and MUI components visibly larger. That is normally correct and
+accessible browser behavior, but dense desktop dashboards sometimes require a consistent visual
+density across managed workstations.
-- The engine targets Windows desktop and is disabled for coarse-pointer and compact viewports.
-- Browser page zoom and OS display scale are not perfectly distinguishable in a normal browser.
-  `window.devicePixelRatio` is an effective value influenced by both.
-- The session baseline assumes browser page zoom is 100% when first stored. If this is not true,
-  call `recalibrateDisplayScale()` after the user resets page zoom to 100%.
-- Native shells such as Electron can provide a more authoritative OS scale factor. A pure web app
-  cannot.
+Applying CSS `zoom` to an app root corrects that density, but creates a second coordinate system.
+Anchored overlays such as MUI `Menu`, `Popover`, `Popper`, `Select`, `Dialog`, and temporary
+`Drawer` can drift, clip, or calculate a wrong viewport height. This engine manages the root
+compensation and the overlay geometry together.
-## Architecture
+## When it has an effect
+| Environment | Engine result |
+| --- | --- |
+| Windows desktop at 100% display scale | Inactive: no compensation wrapper and no visual change. |
+| Windows desktop at 125%, 150%, and supported higher tiers | Active: the app root is compensated toward the configured target density. |
+| macOS / Linux | Inactive by default. |
+| Touch/coarse-pointer or compact viewport | Inactive by default. |
+| Browser zoom differs from the recorded baseline | Best-effort detection; use calibration for a strict policy. |
+When inactive, `DisplayScaleProvider` supplies context to hooks only. It does not insert a layout
+container or apply visual scaling, so a normal display scale preserves the host app's layout.
+## Engine model
 ```text
-display-scale core
-  detection + calibration + compensation policy
-              |
-              v
-React provider
-  compensated root (visible portal host) + logical viewport context
-              |
-              +-- clipped app-content layer
-              +-- document-body MUI portal host
-              +-- overlay adapter
+Browser metrics + session baseline
+              │
+              ▼
+        /core detection
+      policy + compensation
+              │
+              ▼
+  /react DisplayScaleProvider
+ active: compensated root + logical viewport
+ inactive: context only
+              │
+              ▼
+       /mui integration
+ corrected anchor + portal + final overlay placement
 ```
-The code is intentionally divided so that the core calculation modules do not depend on React or
-MUI. The React-facing API is exported from `@/shared/display-scale` today and can be moved into
-an internal package without changing feature call sites.
+A web browser cannot perfectly separate OS display scale from browser page zoom. The engine uses
+`devicePixelRatio`, `visualViewport`, and a session baseline to form a best-effort estimate. For a
+strict product policy, provide an explicit action after users reset browser zoom to 100%.
-## Public API
+## Best-practice quick start
-```tsx
-import {
-  DisplayScaleProvider,
-  useDisplayScale,
-  useDisplayScaleOverlay,
-} from "@/shared/display-scale";
-<DisplayScaleProvider
-  config={{
-    windowsOnly: true,
-    targetOsScale: 1,
-    minOsScaleToCompensate: 1.05,
-    requireExplicitCalibration: true,
-  }}
->
-  <App />
-</DisplayScaleProvider>;
+Use the subpath imports below. The root package export exists only for compatibility.
+### 1. Install
+```bash
+npm install react-display-scale-engine
 ```
-### Core utilities
-- `detectDisplayScale()`: returns current DPR, estimated OS scale, estimated browser zoom and
-  confidence.
-- `recalibrateDisplayScale()`: replaces the current session baseline when browser zoom is known
-  to be 100% and marks it as explicit calibration.
-- `computeDisplayScaleCompensation()`: resolves whether compensation is active and the target
-  root zoom.
-- `getDisplayScaleLogicalViewport()`: returns browser viewport and compensated-root viewport.
-- `toDisplayScaleLogicalPixels()`: converts visible CSS-pixel geometry to root coordinates.
-### React utilities
-- `DisplayScaleProvider`: package-friendly name for the existing root provider.
-- `useDisplayScale()`: subscribes to a scale snapshot.
-- `useDisplayScaleCompensation()`: exposes the root and resolved compensation.
-- `useDisplayScaleOverlay()`: obtains the portal container, logical viewport and overlay bounds
-  helpers, including `toOverlayContentPixels()` for a custom density-zoomed dimension.
-- `useDisplayScaleAnchor()`: converts a native anchor to a MUI-compatible virtual anchor in the
-  compensated portal coordinate space.
-- `useLogicalMinWidth()` / `useLogicalMaxWidth()`: evaluate app-shell breakpoints against the
-  compensated root width.
-- `createMuiDisplayScaleComponents()`: optional MUI adapter that centralizes portal defaults for
-  Dialog, Menu/Popover and Popper.
-## Overlay integration
-MUI overlays must share the same coordinate system as their anchor. The theme adapter keeps legacy
-MUI portals on `document.body` with density correction. For anchored `Menu`, `Popover` and
-`Popper`, use the provided wrappers: they move only that overlay into the compensated root and
-adapt the anchor rectangle relative to the engine root centrally. This avoids the `top`/`left`
-drift caused by applying CSS zoom to an absolutely positioned body portal. The adapter also handles temporary MUI Drawers: the
-portal host, density zoom, and inverse viewport dimension are set globally. Permanent and
-persistent Drawers remain inside the compensated root and are deliberately untouched.
-The compensated root is intentionally a visible portal host. The app content sits in a clipped
-child layer, so a portalled overlay is bounded by the real viewport rather than an invisible
-`overflow: hidden` root rectangle.
-Use `overlayStrategy="compensated-root"` only for an app that has verified every portal and
-anchor in logical root coordinates. `document-body` is preferred for CSS zoom roots.
-Do not divide a Popper or Menu height by `compensation.zoom` in feature code. Use the overlay
-adapter instead; it uses visible pixels for placement and converts only an overlay content
-dimension when its density zoom requires it:
+### 2. Prime once before React renders
+In the application entry file, before `createRoot`:
 ```tsx
-const { getMaxHeightBelowAnchor } = useDisplayScaleOverlay();
+import { primeDisplayScaleCompensation } from "react-display-scale-engine/core";
-const maxHeight = getMaxHeightBelowAnchor(anchorElement, {
-  offset: 8,
-  viewportInset: 16,
-});
+primeDisplayScaleCompensation();
+```
+### 3. Add exactly one provider at the application root
+```tsx
+import { DisplayScaleProvider } from "react-display-scale-engine/react";
+export function App() {
+  return (
+    <DisplayScaleProvider>
+      <AppContent />
+    </DisplayScaleProvider>
+  );
+}
 ```
-For MUI `Menu`, `Popover` and `Popper`, adapt the anchor before passing it to the component:
+Do not add a provider around individual features, dialogs, or pages.
+### 4. Add the MUI theme adapter once
+Call this hook inside `DisplayScaleProvider`, then merge its result into the existing MUI theme.
 ```tsx
-const [anchorEl, setAnchorEl] = useState<HTMLElement | null>(null);
-const displayScaleAnchor = useDisplayScaleAnchor(anchorEl);
+import { CssBaseline, ThemeProvider, createTheme } from "@mui/material";
+import { useMemo } from "react";
+import { useMuiDisplayScaleComponents } from "react-display-scale-engine/mui";
+function AppThemeProvider({ children }: { children: React.ReactNode }) {
+  const components = useMuiDisplayScaleComponents();
+  const theme = useMemo(() => createTheme({ components }), [components]);
+  return (
+    <ThemeProvider theme={theme}>
+      <CssBaseline />
+      {children}
+    </ThemeProvider>
+  );
+}
+```
+For an existing theme, use `createTheme(baseTheme, { components })`; do not create a second theme
+provider only for this engine.
-<Menu anchorEl={displayScaleAnchor} open={Boolean(anchorEl)} />;
+### 5. Use hook adapters for anchored MUI components
+This is the recommended API for new code. Your app retains native MUI components and supplies
+engine-managed props through the matching hook.
+```tsx
+import { Menu, MenuItem } from "@mui/material";
+import { useState } from "react";
+import { useMuiDisplayScaleMenu } from "react-display-scale-engine/mui";
+function ActionsMenu() {
+  const [anchorEl, setAnchorEl] = useState<HTMLElement | null>(null);
+  const open = Boolean(anchorEl);
+  const { menuProps } = useMuiDisplayScaleMenu({ anchorEl, open });
+  return (
+    <Menu {...menuProps} onClose={() => setAnchorEl(null)}>
+      <MenuItem onClick={() => setAnchorEl(null)}>Action</MenuItem>
+    </Menu>
+  );
+}
 ```
-For new code, prefer the MUI wrappers so the conversion cannot be skipped:
+| Native MUI component | Engine hook |
+| --- | --- |
+| `Menu` | `useMuiDisplayScaleMenu` |
+| `Popover` | `useMuiDisplayScalePopover` |
+| `Popper` | `useMuiDisplayScalePopper` |
+| `Select` | `useMuiDisplayScaleSelect` |
+The hook owns display-scale-specific props only: corrected anchor geometry, portal container,
+placement correction, zoom-aware modifiers, and internal overlay refs. Keep business state,
+children, item rendering, `onClose`, and `onChange` in the application.
+## Wrapper API
+For a fast migration, wrappers remain available:
 ```tsx
-import { DisplayScaleMenu, DisplayScalePopover, DisplayScalePopper } from "@/shared/display-scale";
+import { DisplayScaleMenu } from "react-display-scale-engine/mui";
-<DisplayScaleMenu anchorEl={anchorEl} open={Boolean(anchorEl)} />;
+<DisplayScaleMenu anchorEl={anchorEl} open={open} onClose={handleClose}>
+  <MenuItem>Action</MenuItem>
+</DisplayScaleMenu>;
 ```
-The wrappers accept a native `HTMLElement` anchor, and also support a Menu using
-`anchorReference="anchorPosition"`. Use the lower-level hook only for components that require a
-custom virtual anchor.
+`DisplayScaleMenu`, `DisplayScalePopover`, `DisplayScalePopper`, and `DisplayScaleSelect` use the
+same hook adapters internally. Hook adapters and wrappers therefore have equivalent placement and
+scaling behavior. Prefer hooks for new code; use wrappers when migrating a feature quickly.
+## Custom overlay content
+For a custom panel or scrollable list, use the logical overlay helper instead of dividing values
+by `zoom` manually:
-For engine wrappers, MUI still performs its initial placement. The engine then replaces only the
-final collision clamp with a logical-viewport calculation, preserving MUI focus handling,
-transitions and origin semantics. `Popper` is intentionally separate because it uses Popper.js
-modifiers rather than MUI Popover's collision implementation.
+```tsx
+import { useDisplayScaleOverlay } from "react-display-scale-engine/react";
+const { getMaxHeightBelowAnchor } = useDisplayScaleOverlay();
+const maxHeight = getMaxHeightBelowAnchor(anchorElement, {
+  offset: 8,
+  viewportInset: 16,
+});
+```
-For custom positioning:
+Apply `maxHeight` to the scrollable surface, usually with `overflowY: "auto"` and `minHeight: 0`.
-1. Read the anchor rectangle with `getBoundingClientRect()`.
-2. Let `useDisplayScaleOverlay()` convert geometry only when the active portal strategy needs it.
-3. Keep the anchor, portal host and overlay in the same strategy.
-4. Give scrollable content `minHeight: 0` and put `overflowY: "auto"` on the list surface.
-5. Prefer Popper modifiers (`offset`, `flip`, `preventOverflow`) over hard-coded
-   `position: fixed`, `top` or `right`.
+## Responsive behavior
-## Responsive guidance
+Density and responsive layout are different concerns. Browser media queries still use the raw CSS
+viewport. When an application-shell breakpoint must stay stable between Windows 100% and 150%, use
+the logical breakpoint hooks:
-Visual density and responsive behavior are separate:
+```tsx
+import { useLogicalMinWidth } from "react-display-scale-engine/react";
-- **Density** controls perceived font, component and spacing size.
-- **Responsive behavior** controls breakpoints, columns and navigation variants.
-- **Overlay geometry** controls portals and viewport bounds.
+const isDesktop = useLogicalMinWidth(900);
+```
-Browser-level media queries still observe the browser CSS viewport. Features that must preserve the
-same breakpoint behavior at 100% and 150% should use container queries within the compensated root
-or `useLogicalMinWidth()` / `useLogicalMaxWidth()` for JavaScript app-shell decisions. Do not
-assume root `zoom` changes `window.matchMedia()`.
+Do not use the engine to make a mobile layout behave as desktop.
-## Migration plan for another React app
+## Calibration and diagnostics
-1. Copy or package only `displayScaleCompensation`, `detectDisplayScale`, baseline storage,
-   types and logical viewport utilities as the core layer.
-2. Add `DisplayScaleProvider` around the new app shell.
-3. Configure the app's portal system with `createMuiDisplayScaleComponents()`.
-4. Migrate overlays first, then fixed-position pages, then breakpoint-sensitive layouts.
-5. For strict density lock, set `requireExplicitCalibration: true` and call
-   `recalibrateDisplayScale()` after the app confirms that browser zoom is 100%.
+The default automatic baseline is suitable for most applications. For strict calibration, call this
+only when browser zoom is known to be 100%:
-Suggested future package structure:
+```tsx
+import { recalibrateDisplayScale } from "react-display-scale-engine/core";
-```text
-@envidi/display-scale-core
-@envidi/display-scale-react
-@envidi/display-scale-mui
+recalibrateDisplayScale();
 ```
-The MUI package should remain optional; core must not import MUI.
+`useDisplayScale()` exposes the current estimate, confidence, browser zoom, and OS scale for a
+diagnostics or support screen. Avoid changing feature layout directly from raw scale values.
-## Verification matrix
+## Rules that prevent overlay bugs
-Run the following with browser page zoom at 100%, then repeat at 80%, 125% and 150%:
+1. Use one provider for one application root.
+2. Import by responsibility: `/core`, `/react`, and `/mui`.
+3. Use an engine hook or wrapper for every anchored MUI overlay; do not manually divide coordinates.
+4. Keep anchor, portal, and overlay under the same engine strategy.
+5. Avoid hard-coded `position: fixed`, `top`, or `left` as an overlay repair.
+6. Test Windows 100%, 125%, and 150% with browser zoom at 100%.
-| Windows display scale | Required result |
-| --- | --- |
-| 100% | No compensation; baseline visual layout |
-| 125% | Target visual density; no overlay clipping |
-| 150% | Target visual density; no overlay drift or viewport overflow |
-| Multiple monitors | Re-read scale after the window moves; recalibrate if confidence is insufficient |
-Check at minimum: app shell, sidebar animation, dialogs, menus, Popper lists, fixed controls,
-virtualized or scrollable lists, responsive grids and sign-in.
-## Current known work
-- Factory selector uses `useDisplayScaleOverlay()` for viewport-bounded list height.
-- MUI portals are globally routed to `document.body` by default; the theme adapter applies the
-  matching overlay density there, avoiding coordinate drift from the compensated root.
-- The app shell and sidebar profile already use logical breakpoints. Dashboard grids and other
-  feature-level breakpoint consumers remain a staged migration.
-- The engine currently uses best-effort browser-zoom detection; explicit calibration UX remains a
-  follow-up before enabling strict density lock across other apps.
+## Compatibility and release checks
+- `/core` is framework-independent.
+- `/react` requires React 18 or later.
+- `/mui` is tested with MUI 7 (`>=7 <8`) and Emotion peers.
+- The root export is a compatibility entry; prefer subpaths for new application code.
+Before publishing, run:
+```bash
+npm run check
+npm run release:dry-run
+```
+`npm run check` type-checks, builds distributable artifacts, and runs a DOM consumer test. It
+renders root and subpath APIs, wrappers, and native MUI components receiving hook adapter props.
+This catches React Context duplication and normal-scale wrapper regressions before publishing.

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "react-display-scale-engine",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "React and Material UI utilities for consistent Windows display-scale rendering.",
   "license": "MIT",
   "type": "module",
@@ -40,7 +40,8 @@
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
-    "check": "npm run typecheck && npm run build",
+    "check": "npm run typecheck && npm run build && npm run test:consumer",
+    "test:consumer": "node ./scripts/verify-consumer-runtime.mjs",
     "pack:check": "npm pack --dry-run",
     "release:check": "node ./bin/rds-engine.mjs check",
     "release:dry-run": "node ./bin/rds-engine.mjs publish --dry-run",
@@ -58,7 +59,7 @@
   "peerDependencies": {
     "@emotion/react": ">=11.0.0",
     "@emotion/styled": ">=11.0.0",
-    "@mui/material": ">=5.0.0",
+    "@mui/material": ">=7.0.0 <8.0.0",
     "@popperjs/core": ">=2.0.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0"
@@ -71,6 +72,7 @@
     "@types/node": "^22.10.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "jsdom": "^26.1.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "tsup": "^8.5.1",

package/dist/chunk-OQRISU2D.js.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"sources":["../src/createMuiDisplayScaleComponents.ts","../src/useDisplayScalePopoverPosition.ts","../src/DisplayScaleMuiOverlays.tsx","../src/DisplayScaleSelect.tsx","../src/useDisplayScaleTabsIndicator.ts","../src/displayScaleLayoutTokens.ts"],"names":["useRef","useLayoutEffect","useCallback","useMemo","jsx"],"mappings":"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","file":"chunk-OQRISU2D.js","sourcesContent":["import type { Components, Theme } from \"@mui/material/styles\";\n\ntype PortalContainerGetter = () => HTMLElement;\n\ntype MuiDisplayScaleComponentsOptions = {\n getPortalContainer: PortalContainerGetter;\n /**\n * Overlay content is portalled outside the zoomed app root, so it needs the\n * same density correction independently.\n */\n overlayZoom?: number;\n};\n\n/**\n * MUI adapter for a compensated app root.\n *\n * Centralizing these defaults gives every MUI overlay the portal strategy and\n * density correction chosen by the display-scale engine.\n */\nexport function createMuiDisplayScaleComponents({\n getPortalContainer,\n overlayZoom = 1,\n}: MuiDisplayScaleComponentsOptions): Components<Theme> {\n const zoom = overlayZoom > 0 ? overlayZoom : 1;\n const resolveContainerZoom = (container: unknown): number => {\n if (typeof document === \"undefined\") return zoom;\n const resolvedContainer =\n typeof container === \"function\" ? (container as PortalContainerGetter)() : container;\n // MUI does not always expose the resolved portal node through ownerState.\n // Missing means the component will use its default (document.body).\n return resolvedContainer == null || resolvedContainer === document.body ? zoom : 1;\n };\n\n return {\n MuiModal: {\n defaultProps: {\n container: getPortalContainer,\n },\n },\n MuiDialog: {\n defaultProps: {\n container: getPortalContainer,\n },\n styleOverrides: {\n paper: ({ ownerState }) => ({ zoom: resolveContainerZoom(ownerState?.container) }),\n },\n },\n MuiPopover: {\n defaultProps: {\n container: getPortalContainer,\n },\n styleOverrides: {\n paper: ({ ownerState }) => ({ zoom: resolveContainerZoom(ownerState?.container) }),\n },\n },\n MuiPopper: {\n defaultProps: {\n container: getPortalContainer,\n },\n styleOverrides: {\n root: ({ ownerState }) => ({ zoom: resolveContainerZoom(ownerState?.container) }),\n },\n },\n MuiDrawer: {\n defaultProps: {\n // Drawer inherits Modal props. Supplying the portal host here (rather\n // than only through MuiModal) also covers Drawer internals directly.\n container: getPortalContainer,\n },\n styleOverrides: {\n paper: ({ ownerState }) => {\n // Permanent/persistent drawers live inside the compensated root and\n // must not be zoomed a second time. Temporary drawers are portalled\n // to document.body, so their paper needs the overlay density zoom.\n if (ownerState.variant !== \"temporary\") return {};\n\n const isVertical = ownerState.anchor === \"left\" || ownerState.anchor === \"right\";\n return isVertical\n ? {\n zoom,\n height: \"var(--ep-display-scale-overlay-viewport-height, 100dvh)\",\n maxHeight: \"var(--ep-display-scale-overlay-viewport-height, 100dvh)\",\n }\n : {\n zoom,\n width: \"var(--ep-display-scale-overlay-viewport-width, 100dvw)\",\n maxWidth: \"var(--ep-display-scale-overlay-viewport-width, 100dvw)\",\n };\n },\n },\n },\n };\n}\n","import type { PopoverOrigin, PopoverProps } from \"@mui/material\";\nimport { type RefObject, useCallback, useLayoutEffect } from \"react\";\nimport { useDisplayScaleCompensation } from \"./DisplayScaleCompensationProvider\";\n\ntype DisplayScalePopoverPositionOptions = {\n open: boolean;\n overlayRootRef: RefObject<HTMLDivElement | null>;\n anchorElement: HTMLElement | null;\n anchorReference?: PopoverProps[\"anchorReference\"];\n anchorPosition?: PopoverProps[\"anchorPosition\"];\n anchorOrigin?: PopoverProps[\"anchorOrigin\"];\n transformOrigin?: PopoverProps[\"transformOrigin\"];\n marginThreshold?: PopoverProps[\"marginThreshold\"];\n};\n\nfunction resolveOffset(\n origin: number | \"top\" | \"center\" | \"bottom\" | \"left\" | \"right\" | undefined,\n size: number,\n): number {\n if (typeof origin === \"number\") return origin;\n if (origin === \"center\") return size / 2;\n if (origin === \"bottom\" || origin === \"right\") return size;\n return 0;\n}\n\nfunction resolveOrigins(\n anchorOrigin: PopoverOrigin | undefined,\n transformOrigin: PopoverOrigin | undefined,\n anchorWidth: number,\n anchorHeight: number,\n paperWidth: number,\n paperHeight: number,\n): { anchorX: number; anchorY: number; transformX: number; transformY: number } {\n const resolvedAnchorOrigin = anchorOrigin ?? { vertical: \"top\", horizontal: \"left\" };\n const resolvedTransformOrigin = transformOrigin ?? { vertical: \"top\", horizontal: \"left\" };\n\n return {\n anchorX: resolveOffset(resolvedAnchorOrigin.horizontal, anchorWidth),\n anchorY: resolveOffset(resolvedAnchorOrigin.vertical, anchorHeight),\n transformX: resolveOffset(resolvedTransformOrigin.horizontal, paperWidth),\n transformY: resolveOffset(resolvedTransformOrigin.vertical, paperHeight),\n };\n}\n\n/**\n * Replaces only MUI Popover's physical-viewport collision pass. MUI still\n * owns focus, transition and anchor semantics; this writes the final logical\n * top/left inside the compensated portal root.\n */\nexport function useDisplayScalePopoverPosition({\n open,\n overlayRootRef,\n anchorElement,\n anchorReference,\n anchorPosition,\n anchorOrigin,\n transformOrigin,\n marginThreshold = 16,\n}: DisplayScalePopoverPositionOptions): void {\n const { compensation, layoutExtents, rootRef } = useDisplayScaleCompensation();\n\n const correctPosition = useCallback(() => {\n if (!open || !compensation.active || !layoutExtents) return;\n\n const overlayRoot = overlayRootRef.current;\n const paper = overlayRoot?.querySelector<HTMLElement>(\".MuiPopover-paper\");\n if (!paper) return;\n\n const zoom = compensation.zoom > 0 ? compensation.zoom : 1;\n const rootRect = rootRef.current?.getBoundingClientRect();\n const rootLeft = rootRect?.left ?? 0;\n const rootTop = rootRect?.top ?? 0;\n const anchorRect = anchorElement?.getBoundingClientRect();\n const anchorX =\n anchorReference === \"anchorPosition\" && anchorPosition\n ? (anchorPosition.left - rootLeft) / zoom\n : anchorRect\n ? (anchorRect.left - rootLeft) / zoom\n : null;\n const anchorY =\n anchorReference === \"anchorPosition\" && anchorPosition\n ? (anchorPosition.top - rootTop) / zoom\n : anchorRect\n ? (anchorRect.top - rootTop) / zoom\n : null;\n if (anchorX == null || anchorY == null) return;\n\n const paperWidth = paper.offsetWidth;\n const paperHeight = paper.offsetHeight;\n const {\n anchorX: originX,\n anchorY: originY,\n transformX,\n transformY,\n } = resolveOrigins(\n anchorOrigin,\n transformOrigin,\n anchorRect ? anchorRect.width / zoom : 0,\n anchorRect ? anchorRect.height / zoom : 0,\n paperWidth,\n paperHeight,\n );\n const margin = typeof marginThreshold === \"number\" ? marginThreshold : 16;\n const maxLeft = Math.max(margin, layoutExtents.layoutWidthPx - margin - paperWidth);\n const maxTop = Math.max(margin, layoutExtents.layoutHeightPx - margin - paperHeight);\n const left = Math.min(maxLeft, Math.max(margin, anchorX + originX - transformX));\n const top = Math.min(maxTop, Math.max(margin, anchorY + originY - transformY));\n\n paper.style.left = `${Math.round(left)}px`;\n paper.style.top = `${Math.round(top)}px`;\n }, [\n anchorElement,\n anchorOrigin,\n anchorPosition,\n anchorReference,\n compensation.active,\n compensation.zoom,\n layoutExtents,\n marginThreshold,\n open,\n overlayRootRef,\n rootRef,\n transformOrigin,\n ]);\n\n useLayoutEffect(() => {\n if (!open) return;\n\n const firstFrame = window.requestAnimationFrame(() => {\n correctPosition();\n window.requestAnimationFrame(correctPosition);\n });\n window.addEventListener(\"resize\", correctPosition);\n window.addEventListener(\"scroll\", correctPosition, true);\n\n return () => {\n window.cancelAnimationFrame(firstFrame);\n window.removeEventListener(\"resize\", correctPosition);\n window.removeEventListener(\"scroll\", correctPosition, true);\n };\n }, [correctPosition, open]);\n}\n","import type { MenuProps, PopoverProps, PopperProps } from \"@mui/material\";\nimport { Menu, Popover, Popper } from \"@mui/material\";\nimport { useTheme } from \"@mui/material/styles\";\nimport type {\n OffsetsFunction,\n Options as PopperOffsetOptions,\n} from \"@popperjs/core/lib/modifiers/offset\";\nimport { type ReactElement, useMemo, useRef } from \"react\";\nimport { useDisplayScaleCompensation } from \"./DisplayScaleCompensationProvider\";\nimport { useDisplayScaleAnchor } from \"./useDisplayScaleAnchor\";\nimport { useDisplayScalePopoverPosition } from \"./useDisplayScalePopoverPosition\";\n\ntype NativeAnchorProps = {\n anchorEl?: HTMLElement | null;\n};\n\nexport type DisplayScaleMenuProps = Omit<MenuProps, \"anchorEl\"> & NativeAnchorProps;\n\n/** MUI Menu with an anchor adapted to the active portal strategy. */\nexport function DisplayScaleMenu({ anchorEl, ...props }: DisplayScaleMenuProps): ReactElement {\n const displayScaleAnchor = useDisplayScaleAnchor(anchorEl ?? null);\n const { compensation, rootRef } = useDisplayScaleCompensation();\n const theme = useTheme();\n const overlayRootRef = useRef<HTMLDivElement>(null);\n const horizontalOrigin = theme.direction === \"rtl\" ? \"right\" : \"left\";\n const anchorOrigin = props.anchorOrigin ?? {\n vertical: \"bottom\",\n horizontal: horizontalOrigin,\n };\n const transformOrigin = props.transformOrigin ?? {\n vertical: \"top\",\n horizontal: horizontalOrigin,\n };\n const anchorPosition = useMemo(() => {\n if (props.anchorReference !== \"anchorPosition\" || !props.anchorPosition) {\n return props.anchorPosition;\n }\n const zoom = compensation.zoom > 0 ? compensation.zoom : 1;\n return {\n top: props.anchorPosition.top / zoom,\n left: props.anchorPosition.left / zoom,\n };\n }, [compensation.zoom, props.anchorPosition, props.anchorReference]);\n useDisplayScalePopoverPosition({\n open: props.open,\n overlayRootRef,\n anchorElement: anchorEl ?? null,\n anchorReference: props.anchorReference,\n anchorPosition: props.anchorPosition,\n anchorOrigin,\n transformOrigin,\n marginThreshold: props.marginThreshold,\n });\n\n return (\n <Menu\n {...props}\n ref={overlayRootRef}\n anchorEl={displayScaleAnchor}\n anchorPosition={anchorPosition}\n anchorOrigin={anchorOrigin}\n container={rootRef.current ?? document.body}\n transformOrigin={transformOrigin}\n />\n );\n}\n\nexport type DisplayScalePopoverProps = Omit<PopoverProps, \"anchorEl\"> & NativeAnchorProps;\n\n/** MUI Popover with an anchor adapted to the active portal strategy. */\nexport function DisplayScalePopover({\n anchorEl,\n ...props\n}: DisplayScalePopoverProps): ReactElement {\n const displayScaleAnchor = useDisplayScaleAnchor(anchorEl ?? null);\n const { rootRef } = useDisplayScaleCompensation();\n const overlayRootRef = useRef<HTMLDivElement>(null);\n useDisplayScalePopoverPosition({\n open: props.open,\n overlayRootRef,\n anchorElement: anchorEl ?? null,\n anchorReference: props.anchorReference,\n anchorPosition: props.anchorPosition,\n anchorOrigin: props.anchorOrigin,\n transformOrigin: props.transformOrigin,\n marginThreshold: props.marginThreshold,\n });\n return (\n <Popover\n {...props}\n ref={overlayRootRef}\n anchorEl={displayScaleAnchor}\n container={rootRef.current ?? document.body}\n />\n );\n}\n\nexport type DisplayScalePopperProps = Omit<PopperProps, \"anchorEl\"> & NativeAnchorProps;\n\nconst defaultDisplayScalePopperModifiers: PopperProps[\"modifiers\"] = [\n {\n name: \"offset\",\n options: { offset: [0, 8] },\n },\n];\n\nfunction scalePopperOffsets(\n modifiers: PopperProps[\"modifiers\"],\n zoom: number,\n): PopperProps[\"modifiers\"] {\n if (!modifiers || zoom === 1) return modifiers;\n\n return modifiers.map((modifier) => {\n if (modifier.name !== \"offset\") return modifier;\n\n const options = modifier.options as Partial<PopperOffsetOptions> | undefined;\n const rawOffset = options?.offset;\n if (!rawOffset) return modifier;\n\n const scaleValue = (value: number | null | undefined) => (value == null ? value : value / zoom);\n const offset: PopperOffsetOptions[\"offset\"] =\n typeof rawOffset === \"function\"\n ? (args: Parameters<OffsetsFunction>[0]) => {\n const [skidding, distance] = rawOffset(args);\n return [scaleValue(skidding), scaleValue(distance)];\n }\n : [scaleValue(rawOffset[0]), scaleValue(rawOffset[1])];\n\n return { ...modifier, options: { ...options, offset } };\n });\n}\n\n/** MUI Popper with an anchor adapted to the active portal strategy. */\nexport function DisplayScalePopper({ anchorEl, ...props }: DisplayScalePopperProps): ReactElement {\n const displayScaleAnchor = useDisplayScaleAnchor(anchorEl ?? null);\n const { compensation, rootRef } = useDisplayScaleCompensation();\n const modifiers = useMemo(\n () =>\n scalePopperOffsets(props.modifiers ?? defaultDisplayScalePopperModifiers, compensation.zoom),\n [compensation.zoom, props.modifiers],\n );\n return (\n <Popper\n {...props}\n anchorEl={displayScaleAnchor}\n container={rootRef.current ?? document.body}\n modifiers={modifiers}\n style={{ ...props.style, zoom: 1 }}\n />\n );\n}\n","import type { MenuProps, SelectProps } from \"@mui/material\";\nimport { Select } from \"@mui/material\";\nimport type { ReactElement, SyntheticEvent } from \"react\";\nimport { useCallback, useId, useLayoutEffect, useMemo, useRef, useState } from \"react\";\nimport { useDisplayScaleCompensation } from \"./DisplayScaleCompensationProvider\";\nimport { useDisplayScalePopoverPosition } from \"./useDisplayScalePopoverPosition\";\n\n/**\n * MUI Select adapter for the display-scale engine. Select creates its Menu\n * internally, so it cannot use DisplayScaleMenu directly.\n */\nexport function DisplayScaleSelect<Value = unknown>(props: SelectProps<Value>): ReactElement {\n const {\n MenuProps,\n SelectDisplayProps,\n defaultOpen,\n onClose,\n onOpen,\n open: openProp,\n ...selectProps\n } = props;\n const { rootRef } = useDisplayScaleCompensation();\n const menuRootRef = useRef<HTMLDivElement>(null);\n const selectId = useId();\n const [anchorElement, setAnchorElement] = useState<HTMLElement | null>(null);\n const [uncontrolledOpen, setUncontrolledOpen] = useState(Boolean(defaultOpen));\n const open = openProp ?? uncontrolledOpen;\n\n useLayoutEffect(() => {\n if (!open) {\n setAnchorElement(null);\n return;\n }\n setAnchorElement(\n document.querySelector<HTMLElement>(`[data-ep-display-scale-select=\"${selectId}\"]`),\n );\n }, [open, selectId]);\n\n const handleOpen = useCallback(\n (event: SyntheticEvent) => {\n if (openProp === undefined) setUncontrolledOpen(true);\n onOpen?.(event);\n },\n [onOpen, openProp],\n );\n const handleClose = useCallback(\n (event: SyntheticEvent) => {\n if (openProp === undefined) setUncontrolledOpen(false);\n onClose?.(event);\n },\n [onClose, openProp],\n );\n\n useDisplayScalePopoverPosition({\n open,\n overlayRootRef: menuRootRef,\n anchorElement,\n anchorOrigin: { vertical: \"bottom\", horizontal: \"center\" },\n transformOrigin: { vertical: \"top\", horizontal: \"center\" },\n });\n\n const menuProps = useMemo((): Partial<MenuProps> => {\n const paperSlot = MenuProps?.slotProps?.paper;\n const resolvedPaperSlot = typeof paperSlot === \"function\" ? undefined : paperSlot;\n\n return {\n ...MenuProps,\n container: rootRef.current ?? document.body,\n ref: menuRootRef,\n slotProps: {\n ...MenuProps?.slotProps,\n paper: {\n ...resolvedPaperSlot,\n style: { ...resolvedPaperSlot?.style, zoom: 1 },\n },\n },\n };\n }, [MenuProps, rootRef]);\n\n return (\n <Select<Value>\n {...selectProps}\n open={open}\n onOpen={handleOpen}\n onClose={handleClose}\n MenuProps={menuProps}\n SelectDisplayProps={\n {\n ...SelectDisplayProps,\n \"data-ep-display-scale-select\": selectId,\n } as SelectProps<Value>[\"SelectDisplayProps\"]\n }\n />\n );\n}\n","import { type RefObject, useLayoutEffect } from \"react\";\nimport { useDisplayScaleCompensation } from \"./DisplayScaleCompensationProvider\";\n\n/**\n * Keeps MUI Tabs' indicator in the compensated root's logical coordinate\n * space. MUI normally uses getBoundingClientRect(), whose values are already\n * zoomed and therefore too small for a logical layout container.\n */\nexport function useDisplayScaleTabsIndicator(\n tabsRef: RefObject<HTMLDivElement | null>,\n value: unknown,\n): void {\n const { compensation } = useDisplayScaleCompensation();\n\n useLayoutEffect(() => {\n if (!compensation.active) return;\n // Re-run after the selected Tabs value changes.\n void value;\n\n const updateIndicator = (): void => {\n const tabs = tabsRef.current;\n const indicator = tabs?.querySelector<HTMLElement>(\".MuiTabs-indicator\");\n const selectedTab = tabs?.querySelector<HTMLElement>(\".MuiTab-root.Mui-selected\");\n if (!tabs || !indicator || !selectedTab) return;\n\n const isRtl = getComputedStyle(tabs).direction === \"rtl\";\n const left = selectedTab.offsetLeft;\n const width = selectedTab.offsetWidth;\n\n indicator.style.width = `${width}px`;\n if (isRtl) {\n indicator.style.left = \"auto\";\n indicator.style.right = `${tabs.offsetWidth - left - width}px`;\n } else {\n indicator.style.right = \"auto\";\n indicator.style.left = `${left}px`;\n }\n };\n\n const frame = window.requestAnimationFrame(updateIndicator);\n const observer = new ResizeObserver(updateIndicator);\n if (tabsRef.current) observer.observe(tabsRef.current);\n window.addEventListener(\"resize\", updateIndicator);\n\n return () => {\n window.cancelAnimationFrame(frame);\n observer.disconnect();\n window.removeEventListener(\"resize\", updateIndicator);\n };\n }, [compensation.active, tabsRef, value]);\n}\n","import type { SxProps, Theme } from \"@mui/material/styles\";\n\n/** Fill the compensated app tree — prefer over raw `100vh` inside `#root`. */\nexport const displayScalePageFillSx: SxProps<Theme> = {\n flex: 1,\n minHeight: 0,\n minWidth: 0,\n width: \"100%\",\n height: \"100%\",\n};\n\n/** Full-viewport auth split layout — fills the compensated app root (not `position: fixed`). */\nexport const signinViewportShellSx: SxProps<Theme> = {\n flex: 1,\n minHeight: 0,\n minWidth: 0,\n width: \"100%\",\n height: \"100%\",\n overflow: \"hidden\",\n boxSizing: \"border-box\",\n};\n\n/** 50/50 desktop columns — avoids flex min-content overflow at OS display scale. */\nexport const signinSplitColumnSx: SxProps<Theme> = {\n flex: { xs: \"0 0 auto\", md: \"1 1 0\" },\n width: { xs: \"100%\", md: \"50%\" },\n maxWidth: { xs: \"100%\", md: \"50%\" },\n minWidth: 0,\n boxSizing: \"border-box\",\n};\n"]}