@miaixz/ui 0.5.0

package/dist/internal/menu/menu.js

@@ -0,0 +1,150 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef, } from "react";
+import { classNames } from "../class-names.js";
+/**
+ * Selects enabled items owned by the package-internal menu pattern.
+ */
+const miaixzMenuItemSelector = [
+    '[role="menuitem"]',
+    '[role="menuitemcheckbox"]',
+    '[role="menuitemradio"]',
+].join(",");
+/**
+ * Selects document-order focus targets when Tab leaves a Portal menu.
+ */
+const miaixzDocumentTabStopSelector = [
+    "a[href]",
+    "button:not([disabled])",
+    "input:not([disabled]):not([type='hidden'])",
+    "select:not([disabled])",
+    "textarea:not([disabled])",
+    "[contenteditable='true']",
+    "[tabindex]:not([tabindex='-1'])",
+].join(",");
+/**
+ * Renders the single package-internal menu pattern used by Dropdown and future composites.
+ *
+ * @param props - Native menu attributes and package-owned lifecycle controls.
+ * @param props.active - Whether the menu owns keyboard focus.
+ * @param props.triggerRef - Reference to the owning menu button.
+ * @param props.onRequestClose - Closure request with focus-restoration intent.
+ * @param props.className - Optional project class merged with the internal menu class.
+ * @param props.children - Menu item, label, and divider content.
+ * @param props.onClick - Optional native click observer.
+ * @param props.onKeyDown - Optional native keyboard observer.
+ * @returns A WAI-ARIA menu with roving focus and Portal-safe Tab behavior.
+ */
+export function MiaixzMenu({ active, triggerRef, onRequestClose, className, children, onClick, onKeyDown, ...props }) {
+    const menuRef = useRef(null);
+    useEffect(() => {
+        if (!active)
+            return;
+        queueMicrotask(() => {
+            const items = getMiaixzMenuItems(menuRef.current);
+            for (const item of items)
+                item.tabIndex = -1;
+            items[0]?.focus({ preventScroll: true });
+        });
+    }, [active]);
+    return (_jsx("div", { ...props, ref: menuRef, role: "menu", className: classNames("miaixz-menu", className), onClick: (event) => {
+            onClick?.(event);
+            if (!event.defaultPrevented && getMiaixzMenuItemFromEvent(event) !== null) {
+                onRequestClose(true);
+            }
+        }, onKeyDown: (event) => {
+            onKeyDown?.(event);
+            if (!event.defaultPrevented) {
+                handleMiaixzMenuKeyDown(event, triggerRef.current, onRequestClose);
+            }
+        }, children: children }));
+}
+/**
+ * Applies the frozen menu keyboard table to one key event.
+ *
+ * @param event - Keyboard event dispatched by the menu.
+ * @param trigger - Owning menu button used for restoration and Tab order.
+ * @param onRequestClose - Closure request with focus-restoration intent.
+ */
+function handleMiaixzMenuKeyDown(event, trigger, onRequestClose) {
+    const items = getMiaixzMenuItems(event.currentTarget);
+    const currentIndex = items.indexOf(event.currentTarget.ownerDocument.activeElement);
+    let nextIndex;
+    if (items.length > 0) {
+        if (event.key === "ArrowDown")
+            nextIndex = (currentIndex + 1) % items.length;
+        if (event.key === "ArrowUp")
+            nextIndex = (currentIndex - 1 + items.length) % items.length;
+        if (event.key === "Home")
+            nextIndex = 0;
+        if (event.key === "End")
+            nextIndex = items.length - 1;
+    }
+    const nextItem = nextIndex === undefined ? undefined : items[nextIndex];
+    if (nextItem !== undefined) {
+        event.preventDefault();
+        nextItem.focus({ preventScroll: true });
+        return;
+    }
+    if (event.key === "Escape") {
+        event.preventDefault();
+        onRequestClose(true);
+        return;
+    }
+    if (event.key === "Tab") {
+        event.preventDefault();
+        const tabTarget = getAdjacentMiaixzTabStop(trigger, event.shiftKey);
+        onRequestClose(false);
+        queueMicrotask(() => tabTarget?.focus({ preventScroll: true }));
+    }
+}
+/**
+ * Reads connected and enabled menu items in current DOM order.
+ *
+ * @param menu - Menu root whose items should be queried.
+ * @returns Enabled menu items in roving-focus order.
+ */
+function getMiaixzMenuItems(menu) {
+    if (menu === null)
+        return [];
+    return Array.from(menu.querySelectorAll(miaixzMenuItemSelector)).filter((item) => item.isConnected &&
+        !item.hasAttribute("disabled") &&
+        item.getAttribute("aria-disabled") !== "true" &&
+        item.closest("[hidden], [inert], [aria-hidden='true']") === null);
+}
+/**
+ * Resolves an enabled menu item from a bubbling click event.
+ *
+ * @param event - Menu click event whose target should be inspected.
+ * @returns The selected enabled item, or null when the click is not a selection.
+ */
+function getMiaixzMenuItemFromEvent(event) {
+    const target = event.target;
+    if (!(target instanceof Element))
+        return null;
+    const item = target.closest(miaixzMenuItemSelector);
+    if (item === null ||
+        !event.currentTarget.contains(item) ||
+        item.hasAttribute("disabled") ||
+        item.getAttribute("aria-disabled") === "true") {
+        return null;
+    }
+    return item;
+}
+/**
+ * Finds the document-order Tab stop adjacent to a Portal menu trigger.
+ *
+ * @param trigger - Owning menu button.
+ * @param reverse - Whether Shift+Tab requests the previous stop.
+ * @returns Adjacent connected focus target, or null at a document boundary.
+ */
+function getAdjacentMiaixzTabStop(trigger, reverse) {
+    if (trigger === null)
+        return null;
+    const stops = Array.from(trigger.ownerDocument.querySelectorAll(miaixzDocumentTabStopSelector)).filter((element) => element.isConnected &&
+        element.closest("[hidden], [inert], [aria-hidden='true'], [role='menu']") === null);
+    const triggerIndex = stops.indexOf(trigger);
+    if (triggerIndex < 0)
+        return null;
+    return stops[triggerIndex + (reverse ? -1 : 1)] ?? null;
+}
+//# sourceMappingURL=menu.js.map

package/dist/internal/menu/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../../../src/internal/menu/menu.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  useEffect,\n  useRef,\n  type HTMLAttributes,\n  type KeyboardEvent,\n  type MouseEvent,\n  type RefObject,\n} from \"react\";\n\nimport { classNames } from \"../class-names.js\";\n\n/**\n * Selects enabled items owned by the package-internal menu pattern.\n */\nconst miaixzMenuItemSelector = [\n  '[role=\"menuitem\"]',\n  '[role=\"menuitemcheckbox\"]',\n  '[role=\"menuitemradio\"]',\n].join(\",\");\n\n/**\n * Selects document-order focus targets when Tab leaves a Portal menu.\n */\nconst miaixzDocumentTabStopSelector = [\n  \"a[href]\",\n  \"button:not([disabled])\",\n  \"input:not([disabled]):not([type='hidden'])\",\n  \"select:not([disabled])\",\n  \"textarea:not([disabled])\",\n  \"[contenteditable='true']\",\n  \"[tabindex]:not([tabindex='-1'])\",\n].join(\",\");\n\n/**\n * Configures the package-internal WAI-ARIA menu behavior.\n */\nexport interface MiaixzMenuProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * Controls initial focus and active keyboard behavior.\n   */\n  readonly active: boolean;\n\n  /**\n   * References the menu button used for restoration and Tab ordering.\n   */\n  readonly triggerRef: RefObject<HTMLButtonElement | null>;\n\n  /**\n   * Requests closure and chooses whether trigger focus should be restored.\n   */\n  readonly onRequestClose: (restoreFocus: boolean) => void;\n}\n\n/**\n * Renders the single package-internal menu pattern used by Dropdown and future composites.\n *\n * @param props - Native menu attributes and package-owned lifecycle controls.\n * @param props.active - Whether the menu owns keyboard focus.\n * @param props.triggerRef - Reference to the owning menu button.\n * @param props.onRequestClose - Closure request with focus-restoration intent.\n * @param props.className - Optional project class merged with the internal menu class.\n * @param props.children - Menu item, label, and divider content.\n * @param props.onClick - Optional native click observer.\n * @param props.onKeyDown - Optional native keyboard observer.\n * @returns A WAI-ARIA menu with roving focus and Portal-safe Tab behavior.\n */\nexport function MiaixzMenu({\n  active,\n  triggerRef,\n  onRequestClose,\n  className,\n  children,\n  onClick,\n  onKeyDown,\n  ...props\n}: MiaixzMenuProps) {\n  const menuRef = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    if (!active) return;\n    queueMicrotask(() => {\n      const items = getMiaixzMenuItems(menuRef.current);\n      for (const item of items) item.tabIndex = -1;\n      items[0]?.focus({ preventScroll: true });\n    });\n  }, [active]);\n\n  return (\n    <div\n      {...props}\n      ref={menuRef}\n      role=\"menu\"\n      className={classNames(\"miaixz-menu\", className)}\n      onClick={(event) => {\n        onClick?.(event);\n        if (!event.defaultPrevented && getMiaixzMenuItemFromEvent(event) !== null) {\n          onRequestClose(true);\n        }\n      }}\n      onKeyDown={(event) => {\n        onKeyDown?.(event);\n        if (!event.defaultPrevented) {\n          handleMiaixzMenuKeyDown(event, triggerRef.current, onRequestClose);\n        }\n      }}\n    >\n      {children}\n    </div>\n  );\n}\n\n/**\n * Applies the frozen menu keyboard table to one key event.\n *\n * @param event - Keyboard event dispatched by the menu.\n * @param trigger - Owning menu button used for restoration and Tab order.\n * @param onRequestClose - Closure request with focus-restoration intent.\n */\nfunction handleMiaixzMenuKeyDown(\n  event: KeyboardEvent<HTMLDivElement>,\n  trigger: HTMLButtonElement | null,\n  onRequestClose: (restoreFocus: boolean) => void,\n): void {\n  const items = getMiaixzMenuItems(event.currentTarget);\n  const currentIndex = items.indexOf(\n    event.currentTarget.ownerDocument.activeElement as HTMLElement,\n  );\n  let nextIndex: number | undefined;\n\n  if (items.length > 0) {\n    if (event.key === \"ArrowDown\") nextIndex = (currentIndex + 1) % items.length;\n    if (event.key === \"ArrowUp\") nextIndex = (currentIndex - 1 + items.length) % items.length;\n    if (event.key === \"Home\") nextIndex = 0;\n    if (event.key === \"End\") nextIndex = items.length - 1;\n  }\n\n  const nextItem = nextIndex === undefined ? undefined : items[nextIndex];\n  if (nextItem !== undefined) {\n    event.preventDefault();\n    nextItem.focus({ preventScroll: true });\n    return;\n  }\n\n  if (event.key === \"Escape\") {\n    event.preventDefault();\n    onRequestClose(true);\n    return;\n  }\n\n  if (event.key === \"Tab\") {\n    event.preventDefault();\n    const tabTarget = getAdjacentMiaixzTabStop(trigger, event.shiftKey);\n    onRequestClose(false);\n    queueMicrotask(() => tabTarget?.focus({ preventScroll: true }));\n  }\n}\n\n/**\n * Reads connected and enabled menu items in current DOM order.\n *\n * @param menu - Menu root whose items should be queried.\n * @returns Enabled menu items in roving-focus order.\n */\nfunction getMiaixzMenuItems(menu: HTMLDivElement | null): HTMLElement[] {\n  if (menu === null) return [];\n  return Array.from(menu.querySelectorAll<HTMLElement>(miaixzMenuItemSelector)).filter(\n    (item) =>\n      item.isConnected &&\n      !item.hasAttribute(\"disabled\") &&\n      item.getAttribute(\"aria-disabled\") !== \"true\" &&\n      item.closest(\"[hidden], [inert], [aria-hidden='true']\") === null,\n  );\n}\n\n/**\n * Resolves an enabled menu item from a bubbling click event.\n *\n * @param event - Menu click event whose target should be inspected.\n * @returns The selected enabled item, or null when the click is not a selection.\n */\nfunction getMiaixzMenuItemFromEvent(event: MouseEvent<HTMLDivElement>): HTMLElement | null {\n  const target = event.target;\n  if (!(target instanceof Element)) return null;\n  const item = target.closest<HTMLElement>(miaixzMenuItemSelector);\n  if (\n    item === null ||\n    !event.currentTarget.contains(item) ||\n    item.hasAttribute(\"disabled\") ||\n    item.getAttribute(\"aria-disabled\") === \"true\"\n  ) {\n    return null;\n  }\n  return item;\n}\n\n/**\n * Finds the document-order Tab stop adjacent to a Portal menu trigger.\n *\n * @param trigger - Owning menu button.\n * @param reverse - Whether Shift+Tab requests the previous stop.\n * @returns Adjacent connected focus target, or null at a document boundary.\n */\nfunction getAdjacentMiaixzTabStop(\n  trigger: HTMLButtonElement | null,\n  reverse: boolean,\n): HTMLElement | null {\n  if (trigger === null) return null;\n  const stops = Array.from(\n    trigger.ownerDocument.querySelectorAll<HTMLElement>(miaixzDocumentTabStopSelector),\n  ).filter(\n    (element) =>\n      element.isConnected &&\n      element.closest(\"[hidden], [inert], [aria-hidden='true'], [role='menu']\") === null,\n  );\n  const triggerIndex = stops.indexOf(trigger);\n  if (triggerIndex < 0) return null;\n  return stops[triggerIndex + (reverse ? -1 : 1)] ?? null;\n}\n"]}

package/dist/internal/overlay/dismissible-layer.d.ts

@@ -0,0 +1,38 @@
+import { type RefObject } from "react";
+/**
+ * Identifies the user interaction that dismissed an overlay layer.
+ */
+export type MiaixzDismissReason = "escape" | "outside";
+/**
+ * Configures one active package-owned dismissible layer.
+ */
+interface MiaixzDismissibleLayerOptions {
+    /**
+     * Controls whether the layer participates in the document stack.
+     */
+    readonly active: boolean;
+    /**
+     * References the trigger or wrapper owned by the layer.
+     */
+    readonly triggerRef: RefObject<HTMLElement | null>;
+    /**
+     * References the Portal surface owned by the layer.
+     */
+    readonly contentRef: RefObject<HTMLElement | null>;
+    /**
+     * Receives a package-defined dismissal request.
+     */
+    readonly onDismiss: (reason: MiaixzDismissReason) => void;
+    /**
+     * Identifies the current Portal target and document realm.
+     */
+    readonly portalTarget: HTMLElement | null;
+}
+/**
+ * Registers Escape and external-pointer dismissal for one active overlay surface.
+ *
+ * @param options - Layer registration and dismissal configuration.
+ */
+export declare function useMiaixzDismissibleLayer(options: MiaixzDismissibleLayerOptions): void;
+export {};
+//# sourceMappingURL=dismissible-layer.d.ts.map

package/dist/internal/overlay/dismissible-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismissible-layer.d.ts","sourceRoot":"","sources":["../../../src/internal/overlay/dismissible-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEvD;;GAEG;AACH,UAAU,6BAA6B;IACrC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAEnD;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAEnD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAE1D;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;CAC3C;AA0CD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,6BAA6B,GAAG,IAAI,CA0BtF"}

package/dist/internal/overlay/dismissible-layer.js

@@ -0,0 +1,99 @@
+import { useEffect, useRef } from "react";
+/**
+ * Isolates dismissible overlay branches between document realms.
+ */
+const miaixzDismissibleLayerStores = new WeakMap();
+/**
+ * Registers Escape and external-pointer dismissal for one active overlay surface.
+ *
+ * @param options - Layer registration and dismissal configuration.
+ */
+export function useMiaixzDismissibleLayer(options) {
+    const dismissRef = useRef(options.onDismiss);
+    useEffect(() => {
+        dismissRef.current = options.onDismiss;
+    }, [options.onDismiss]);
+    useEffect(() => {
+        const ownerDocument = options.portalTarget?.ownerDocument;
+        if (!options.active || ownerDocument === undefined)
+            return undefined;
+        const entry = {
+            triggerRef: options.triggerRef,
+            contentRef: options.contentRef,
+            dismiss: (reason) => dismissRef.current(reason),
+        };
+        const store = getMiaixzDismissibleLayerStore(ownerDocument);
+        store.entries.push(entry);
+        return () => {
+            const index = store.entries.indexOf(entry);
+            if (index >= 0)
+                store.entries.splice(index, 1);
+            if (store.entries.length === 0) {
+                store.removeListeners();
+                miaixzDismissibleLayerStores.delete(ownerDocument);
+            }
+        };
+    }, [options.active, options.contentRef, options.portalTarget, options.triggerRef]);
+}
+/**
+ * Returns the existing document stack or installs its shared event listeners.
+ *
+ * @param ownerDocument - Document whose overlay stack is requested.
+ * @returns The active dismissible-layer store.
+ */
+function getMiaixzDismissibleLayerStore(ownerDocument) {
+    const existing = miaixzDismissibleLayerStores.get(ownerDocument);
+    if (existing !== undefined)
+        return existing;
+    const entries = [];
+    const handleKeyDown = (event) => {
+        if (event.key !== "Escape" || event.defaultPrevented)
+            return;
+        const topLayer = entries.at(-1);
+        if (topLayer === undefined)
+            return;
+        event.preventDefault();
+        topLayer.dismiss("escape");
+    };
+    const handlePointerDown = (event) => {
+        const path = event.composedPath();
+        let containingIndex = -1;
+        for (let index = entries.length - 1; index >= 0; index -= 1) {
+            const entry = entries[index];
+            if (entry !== undefined && doesMiaixzLayerContainPath(entry, path)) {
+                containingIndex = index;
+                break;
+            }
+        }
+        for (let index = entries.length - 1; index > containingIndex; index -= 1) {
+            entries[index]?.dismiss("outside");
+        }
+    };
+    ownerDocument.addEventListener("keydown", handleKeyDown, true);
+    ownerDocument.addEventListener("pointerdown", handlePointerDown, true);
+    const created = {
+        entries,
+        removeListeners: () => {
+            ownerDocument.removeEventListener("keydown", handleKeyDown, true);
+            ownerDocument.removeEventListener("pointerdown", handlePointerDown, true);
+        },
+    };
+    miaixzDismissibleLayerStores.set(ownerDocument, created);
+    return created;
+}
+/**
+ * Tests whether an event path belongs to a layer trigger or Portal surface.
+ *
+ * @param entry - Layer whose owned nodes should be inspected.
+ * @param path - Composed event path crossing shadow and Portal boundaries.
+ * @returns Whether the pointer event occurred inside the layer.
+ */
+function doesMiaixzLayerContainPath(entry, path) {
+    const trigger = entry.triggerRef.current;
+    const content = entry.contentRef.current;
+    return path.some((target) => target === trigger ||
+        target === content ||
+        (target instanceof Node &&
+            (trigger?.contains(target) === true || content?.contains(target) === true)));
+}
+//# sourceMappingURL=dismissible-layer.js.map

package/dist/internal/overlay/dismissible-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismissible-layer.js","sourceRoot":"","sources":["../../../src/internal/overlay/dismissible-layer.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useRef, type RefObject } from \"react\";\n\n/**\n * Identifies the user interaction that dismissed an overlay layer.\n */\nexport type MiaixzDismissReason = \"escape\" | \"outside\";\n\n/**\n * Configures one active package-owned dismissible layer.\n */\ninterface MiaixzDismissibleLayerOptions {\n  /**\n   * Controls whether the layer participates in the document stack.\n   */\n  readonly active: boolean;\n\n  /**\n   * References the trigger or wrapper owned by the layer.\n   */\n  readonly triggerRef: RefObject<HTMLElement | null>;\n\n  /**\n   * References the Portal surface owned by the layer.\n   */\n  readonly contentRef: RefObject<HTMLElement | null>;\n\n  /**\n   * Receives a package-defined dismissal request.\n   */\n  readonly onDismiss: (reason: MiaixzDismissReason) => void;\n\n  /**\n   * Identifies the current Portal target and document realm.\n   */\n  readonly portalTarget: HTMLElement | null;\n}\n\n/**\n * Represents one registered layer in document activation order.\n */\ninterface MiaixzDismissibleLayerEntry {\n  /**\n   * References the trigger or wrapper owned by the layer.\n   */\n  readonly triggerRef: RefObject<HTMLElement | null>;\n\n  /**\n   * References the Portal surface owned by the layer.\n   */\n  readonly contentRef: RefObject<HTMLElement | null>;\n\n  /**\n   * Requests dismissal using the current React callback.\n   */\n  readonly dismiss: (reason: MiaixzDismissReason) => void;\n}\n\n/**\n * Stores active dismissible layers and shared listeners for one document realm.\n */\ninterface MiaixzDismissibleLayerStore {\n  /**\n   * Retains layers in activation order.\n   */\n  readonly entries: MiaixzDismissibleLayerEntry[];\n\n  /**\n   * Removes the shared document listeners.\n   */\n  readonly removeListeners: () => void;\n}\n\n/**\n * Isolates dismissible overlay branches between document realms.\n */\nconst miaixzDismissibleLayerStores = new WeakMap<Document, MiaixzDismissibleLayerStore>();\n\n/**\n * Registers Escape and external-pointer dismissal for one active overlay surface.\n *\n * @param options - Layer registration and dismissal configuration.\n */\nexport function useMiaixzDismissibleLayer(options: MiaixzDismissibleLayerOptions): void {\n  const dismissRef = useRef(options.onDismiss);\n\n  useEffect(() => {\n    dismissRef.current = options.onDismiss;\n  }, [options.onDismiss]);\n\n  useEffect(() => {\n    const ownerDocument = options.portalTarget?.ownerDocument;\n    if (!options.active || ownerDocument === undefined) return undefined;\n    const entry: MiaixzDismissibleLayerEntry = {\n      triggerRef: options.triggerRef,\n      contentRef: options.contentRef,\n      dismiss: (reason) => dismissRef.current(reason),\n    };\n    const store = getMiaixzDismissibleLayerStore(ownerDocument);\n    store.entries.push(entry);\n    return () => {\n      const index = store.entries.indexOf(entry);\n      if (index >= 0) store.entries.splice(index, 1);\n      if (store.entries.length === 0) {\n        store.removeListeners();\n        miaixzDismissibleLayerStores.delete(ownerDocument);\n      }\n    };\n  }, [options.active, options.contentRef, options.portalTarget, options.triggerRef]);\n}\n\n/**\n * Returns the existing document stack or installs its shared event listeners.\n *\n * @param ownerDocument - Document whose overlay stack is requested.\n * @returns The active dismissible-layer store.\n */\nfunction getMiaixzDismissibleLayerStore(ownerDocument: Document): MiaixzDismissibleLayerStore {\n  const existing = miaixzDismissibleLayerStores.get(ownerDocument);\n  if (existing !== undefined) return existing;\n\n  const entries: MiaixzDismissibleLayerEntry[] = [];\n  const handleKeyDown = (event: KeyboardEvent) => {\n    if (event.key !== \"Escape\" || event.defaultPrevented) return;\n    const topLayer = entries.at(-1);\n    if (topLayer === undefined) return;\n    event.preventDefault();\n    topLayer.dismiss(\"escape\");\n  };\n  const handlePointerDown = (event: PointerEvent) => {\n    const path = event.composedPath();\n    let containingIndex = -1;\n    for (let index = entries.length - 1; index >= 0; index -= 1) {\n      const entry = entries[index];\n      if (entry !== undefined && doesMiaixzLayerContainPath(entry, path)) {\n        containingIndex = index;\n        break;\n      }\n    }\n    for (let index = entries.length - 1; index > containingIndex; index -= 1) {\n      entries[index]?.dismiss(\"outside\");\n    }\n  };\n\n  ownerDocument.addEventListener(\"keydown\", handleKeyDown, true);\n  ownerDocument.addEventListener(\"pointerdown\", handlePointerDown, true);\n  const created: MiaixzDismissibleLayerStore = {\n    entries,\n    removeListeners: () => {\n      ownerDocument.removeEventListener(\"keydown\", handleKeyDown, true);\n      ownerDocument.removeEventListener(\"pointerdown\", handlePointerDown, true);\n    },\n  };\n  miaixzDismissibleLayerStores.set(ownerDocument, created);\n  return created;\n}\n\n/**\n * Tests whether an event path belongs to a layer trigger or Portal surface.\n *\n * @param entry - Layer whose owned nodes should be inspected.\n * @param path - Composed event path crossing shadow and Portal boundaries.\n * @returns Whether the pointer event occurred inside the layer.\n */\nfunction doesMiaixzLayerContainPath(\n  entry: MiaixzDismissibleLayerEntry,\n  path: EventTarget[],\n): boolean {\n  const trigger = entry.triggerRef.current;\n  const content = entry.contentRef.current;\n  return path.some(\n    (target) =>\n      target === trigger ||\n      target === content ||\n      (target instanceof Node &&\n        (trigger?.contains(target) === true || content?.contains(target) === true)),\n  );\n}\n"]}

package/dist/internal/overlay/document-scroll-lock.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Locks one document scrolling root while preserving its exact caller-owned inline values.
+ *
+ * @param ownerDocument - Document whose background scrolling should be suspended.
+ * @returns An idempotent unlock function.
+ */
+export declare function lockMiaixzDocumentScroll(ownerDocument: Document): () => void;
+//# sourceMappingURL=document-scroll-lock.d.ts.map

package/dist/internal/overlay/document-scroll-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-scroll-lock.d.ts","sourceRoot":"","sources":["../../../src/internal/overlay/document-scroll-lock.ts"],"names":[],"mappings":"AA8BA;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,QAAQ,GAAG,MAAM,IAAI,CA2B5E"}

package/dist/internal/overlay/document-scroll-lock.js

@@ -0,0 +1,58 @@
+/**
+ * Coordinates nested native modal scroll locks per document realm.
+ */
+const miaixzDocumentScrollLocks = new WeakMap();
+/**
+ * Locks one document scrolling root while preserving its exact caller-owned inline values.
+ *
+ * @param ownerDocument - Document whose background scrolling should be suspended.
+ * @returns An idempotent unlock function.
+ */
+export function lockMiaixzDocumentScroll(ownerDocument) {
+    const existing = miaixzDocumentScrollLocks.get(ownerDocument);
+    if (existing !== undefined) {
+        existing.count += 1;
+        return createMiaixzScrollUnlock(ownerDocument, existing);
+    }
+    const root = ownerDocument.scrollingElement ?? ownerDocument.documentElement;
+    const state = {
+        count: 1,
+        overflow: root.style.overflow,
+        paddingInlineEnd: root.style.paddingInlineEnd,
+        root,
+    };
+    const viewport = ownerDocument.defaultView;
+    const scrollbarWidth = Math.max(0, (viewport?.innerWidth ?? root.clientWidth) - root.clientWidth);
+    root.style.overflow = "hidden";
+    if (scrollbarWidth > 0 && viewport !== null) {
+        const computedPadding = viewport.getComputedStyle(root).paddingInlineEnd;
+        root.style.paddingInlineEnd =
+            computedPadding === "0px"
+                ? `${scrollbarWidth}px`
+                : `calc(${computedPadding} + ${scrollbarWidth}px)`;
+    }
+    miaixzDocumentScrollLocks.set(ownerDocument, state);
+    return createMiaixzScrollUnlock(ownerDocument, state);
+}
+/**
+ * Creates an idempotent release operation for one reference-counted document lock.
+ *
+ * @param ownerDocument - Document owning the lock.
+ * @param state - Shared lock state for that document.
+ * @returns An idempotent unlock function.
+ */
+function createMiaixzScrollUnlock(ownerDocument, state) {
+    let active = true;
+    return () => {
+        if (!active)
+            return;
+        active = false;
+        state.count -= 1;
+        if (state.count > 0)
+            return;
+        state.root.style.overflow = state.overflow;
+        state.root.style.paddingInlineEnd = state.paddingInlineEnd;
+        miaixzDocumentScrollLocks.delete(ownerDocument);
+    };
+}
+//# sourceMappingURL=document-scroll-lock.js.map

package/dist/internal/overlay/document-scroll-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-scroll-lock.js","sourceRoot":"","sources":["../../../src/internal/overlay/document-scroll-lock.ts"],"names":[],"mappings":"AAyBA;;GAEG;AACH,MAAM,yBAAyB,GAAG,IAAI,OAAO,EAAsC,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,aAAuB;IAC9D,MAAM,QAAQ,GAAG,yBAAyB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC9D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;QACpB,OAAO,wBAAwB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,IAAI,GACP,aAAa,CAAC,gBAAuC,IAAI,aAAa,CAAC,eAAe,CAAC;IAC1F,MAAM,KAAK,GAA6B;QACtC,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ;QAC7B,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB;QAC7C,IAAI;KACL,CAAC;IACF,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,CAAC;IAC3C,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAClG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC/B,IAAI,cAAc,GAAG,CAAC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,eAAe,GAAG,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,gBAAgB,CAAC;QACzE,IAAI,CAAC,KAAK,CAAC,gBAAgB;YACzB,eAAe,KAAK,KAAK;gBACvB,CAAC,CAAC,GAAG,cAAc,IAAI;gBACvB,CAAC,CAAC,QAAQ,eAAe,MAAM,cAAc,KAAK,CAAC;IACzD,CAAC;IACD,yBAAyB,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,wBAAwB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,wBAAwB,CAC/B,aAAuB,EACvB,KAA+B;IAE/B,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,GAAG,KAAK,CAAC;QACf,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QACjB,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC;YAAE,OAAO;QAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;QAC3D,yBAAyB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAClD,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Retains the exact inline styles and nesting depth for one scrolling root.\n */\ninterface MiaixzDocumentScrollLock {\n  /**\n   * Counts active native modal owners.\n   */\n  count: number;\n\n  /**\n   * Preserves the caller-owned inline overflow value.\n   */\n  readonly overflow: string;\n\n  /**\n   * Preserves the caller-owned inline logical scrollbar compensation.\n   */\n  readonly paddingInlineEnd: string;\n\n  /**\n   * Identifies the root scrolling element being locked.\n   */\n  readonly root: HTMLElement;\n}\n\n/**\n * Coordinates nested native modal scroll locks per document realm.\n */\nconst miaixzDocumentScrollLocks = new WeakMap<Document, MiaixzDocumentScrollLock>();\n\n/**\n * Locks one document scrolling root while preserving its exact caller-owned inline values.\n *\n * @param ownerDocument - Document whose background scrolling should be suspended.\n * @returns An idempotent unlock function.\n */\nexport function lockMiaixzDocumentScroll(ownerDocument: Document): () => void {\n  const existing = miaixzDocumentScrollLocks.get(ownerDocument);\n  if (existing !== undefined) {\n    existing.count += 1;\n    return createMiaixzScrollUnlock(ownerDocument, existing);\n  }\n\n  const root =\n    (ownerDocument.scrollingElement as HTMLElement | null) ?? ownerDocument.documentElement;\n  const state: MiaixzDocumentScrollLock = {\n    count: 1,\n    overflow: root.style.overflow,\n    paddingInlineEnd: root.style.paddingInlineEnd,\n    root,\n  };\n  const viewport = ownerDocument.defaultView;\n  const scrollbarWidth = Math.max(0, (viewport?.innerWidth ?? root.clientWidth) - root.clientWidth);\n  root.style.overflow = \"hidden\";\n  if (scrollbarWidth > 0 && viewport !== null) {\n    const computedPadding = viewport.getComputedStyle(root).paddingInlineEnd;\n    root.style.paddingInlineEnd =\n      computedPadding === \"0px\"\n        ? `${scrollbarWidth}px`\n        : `calc(${computedPadding} + ${scrollbarWidth}px)`;\n  }\n  miaixzDocumentScrollLocks.set(ownerDocument, state);\n  return createMiaixzScrollUnlock(ownerDocument, state);\n}\n\n/**\n * Creates an idempotent release operation for one reference-counted document lock.\n *\n * @param ownerDocument - Document owning the lock.\n * @param state - Shared lock state for that document.\n * @returns An idempotent unlock function.\n */\nfunction createMiaixzScrollUnlock(\n  ownerDocument: Document,\n  state: MiaixzDocumentScrollLock,\n): () => void {\n  let active = true;\n  return () => {\n    if (!active) return;\n    active = false;\n    state.count -= 1;\n    if (state.count > 0) return;\n    state.root.style.overflow = state.overflow;\n    state.root.style.paddingInlineEnd = state.paddingInlineEnd;\n    miaixzDocumentScrollLocks.delete(ownerDocument);\n  };\n}\n"]}

package/dist/internal/overlay/floating-position.d.ts

@@ -0,0 +1,46 @@
+import { type RefObject } from "react";
+/**
+ * Defines every fixed placement used by package-owned Popover and Tooltip surfaces.
+ */
+export type MiaixzFloatingPlacement = "bottom-start" | "bottom-end" | "top-start" | "top-end" | "top" | "right" | "bottom" | "left";
+/**
+ * Describes one resolved viewport-relative floating position.
+ */
+interface MiaixzFloatingPosition {
+    /**
+     * Identifies the resolved placement after main-axis flipping.
+     */
+    readonly placement: MiaixzFloatingPlacement;
+    /**
+     * Supplies the clamped viewport x coordinate.
+     */
+    readonly x: number;
+    /**
+     * Supplies the clamped viewport y coordinate.
+     */
+    readonly y: number;
+}
+/**
+ * Positions one open Portal surface and maintains it across geometry changes.
+ *
+ * @param triggerRef - Reference containing the anchor element.
+ * @param contentRef - Reference containing the fixed surface.
+ * @param open - Whether geometry observers should be active.
+ * @param placement - Requested logical placement.
+ * @param portalTarget - Current Portal target used to retrigger observers after remounting.
+ */
+export declare function useMiaixzFloatingPosition(triggerRef: RefObject<HTMLElement | null>, contentRef: RefObject<HTMLElement | null>, open: boolean, placement: MiaixzFloatingPlacement, portalTarget: HTMLElement | null): void;
+/**
+ * Resolves flipping, logical alignment, and viewport clamping for one floating surface.
+ *
+ * @param trigger - Viewport geometry of the anchor element.
+ * @param content - Viewport geometry of the floating surface.
+ * @param requestedPlacement - Caller-requested logical placement.
+ * @param viewportWidth - Current layout viewport width.
+ * @param viewportHeight - Current layout viewport height.
+ * @param rightToLeft - Whether logical inline start resolves to the right edge.
+ * @returns Resolved placement and clamped viewport coordinates.
+ */
+export declare function calculateMiaixzFloatingPosition(trigger: DOMRect, content: DOMRect, requestedPlacement: MiaixzFloatingPlacement, viewportWidth: number, viewportHeight: number, rightToLeft: boolean): MiaixzFloatingPosition;
+export {};
+//# sourceMappingURL=floating-position.d.ts.map

package/dist/internal/overlay/floating-position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floating-position.d.ts","sourceRoot":"","sources":["../../../src/internal/overlay/floating-position.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,uBAAuB,GACjC,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhG;;GAEG;AACH,UAAU,sBAAsB;IAC9B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACzC,UAAU,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACzC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,uBAAuB,EAClC,YAAY,EAAE,WAAW,GAAG,IAAI,GAC/B,IAAI,CAuCN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,uBAAuB,EAC3C,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,OAAO,GACnB,sBAAsB,CA6CxB"}

package/dist/internal/overlay/floating-position.js

@@ -0,0 +1,137 @@
+import { useEffect, useLayoutEffect } from "react";
+/**
+ * Keeps floating surfaces and viewport edges separated by the frozen eight-pixel gap.
+ */
+const miaixzFloatingGap = 8;
+/**
+ * Uses layout timing in browsers and passive timing during server rendering.
+ */
+const useMiaixzClientLayoutEffect = typeof document === "undefined" ? useEffect : useLayoutEffect;
+/**
+ * Positions one open Portal surface and maintains it across geometry changes.
+ *
+ * @param triggerRef - Reference containing the anchor element.
+ * @param contentRef - Reference containing the fixed surface.
+ * @param open - Whether geometry observers should be active.
+ * @param placement - Requested logical placement.
+ * @param portalTarget - Current Portal target used to retrigger observers after remounting.
+ */
+export function useMiaixzFloatingPosition(triggerRef, contentRef, open, placement, portalTarget) {
+    useMiaixzClientLayoutEffect(() => {
+        const trigger = triggerRef.current;
+        const content = contentRef.current;
+        if (!open || trigger === null || content === null)
+            return undefined;
+        const ownerDocument = trigger.ownerDocument;
+        const viewport = ownerDocument.defaultView;
+        if (viewport === null)
+            return undefined;
+        const update = () => {
+            const position = calculateMiaixzFloatingPosition(trigger.getBoundingClientRect(), content.getBoundingClientRect(), placement, viewport.innerWidth, viewport.innerHeight, viewport.getComputedStyle(trigger).direction === "rtl");
+            content.style.left = `${position.x}px`;
+            content.style.top = `${position.y}px`;
+            content.dataset.placement = position.placement;
+            content.dataset.miaixzPositioned = "true";
+        };
+        update();
+        ownerDocument.addEventListener("scroll", update, true);
+        viewport.addEventListener("resize", update);
+        const resizeObserver = typeof ResizeObserver === "function" ? new ResizeObserver(update) : undefined;
+        resizeObserver?.observe(trigger);
+        resizeObserver?.observe(content);
+        return () => {
+            ownerDocument.removeEventListener("scroll", update, true);
+            viewport.removeEventListener("resize", update);
+            resizeObserver?.disconnect();
+            delete content.dataset.miaixzPositioned;
+        };
+    }, [contentRef, open, placement, portalTarget, triggerRef]);
+}
+/**
+ * Resolves flipping, logical alignment, and viewport clamping for one floating surface.
+ *
+ * @param trigger - Viewport geometry of the anchor element.
+ * @param content - Viewport geometry of the floating surface.
+ * @param requestedPlacement - Caller-requested logical placement.
+ * @param viewportWidth - Current layout viewport width.
+ * @param viewportHeight - Current layout viewport height.
+ * @param rightToLeft - Whether logical inline start resolves to the right edge.
+ * @returns Resolved placement and clamped viewport coordinates.
+ */
+export function calculateMiaixzFloatingPosition(trigger, content, requestedPlacement, viewportWidth, viewportHeight, rightToLeft) {
+    const placement = resolveMiaixzFloatingPlacement(trigger, content, requestedPlacement, viewportWidth, viewportHeight);
+    let x;
+    let y;
+    if (placement === "top" || placement === "bottom") {
+        x = trigger.left + (trigger.width - content.width) / 2;
+        y =
+            placement === "top"
+                ? trigger.top - content.height - miaixzFloatingGap
+                : trigger.bottom + miaixzFloatingGap;
+    }
+    else if (placement === "left" || placement === "right") {
+        x =
+            placement === "left"
+                ? trigger.left - content.width - miaixzFloatingGap
+                : trigger.right + miaixzFloatingGap;
+        y = trigger.top + (trigger.height - content.height) / 2;
+    }
+    else {
+        const alignStart = placement.endsWith("-start");
+        const alignLeft = rightToLeft ? !alignStart : alignStart;
+        x = alignLeft ? trigger.left : trigger.right - content.width;
+        y = placement.startsWith("top-")
+            ? trigger.top - content.height - miaixzFloatingGap
+            : trigger.bottom + miaixzFloatingGap;
+    }
+    return {
+        placement,
+        x: clampMiaixzFloatingCoordinate(x, miaixzFloatingGap, viewportWidth - content.width - miaixzFloatingGap),
+        y: clampMiaixzFloatingCoordinate(y, miaixzFloatingGap, viewportHeight - content.height - miaixzFloatingGap),
+    };
+}
+/**
+ * Flips one requested placement when its main-axis surface does not fit.
+ *
+ * @param trigger - Viewport geometry of the anchor element.
+ * @param content - Viewport geometry of the floating surface.
+ * @param placement - Requested placement.
+ * @param viewportWidth - Current layout viewport width.
+ * @param viewportHeight - Current layout viewport height.
+ * @returns Original or opposite placement.
+ */
+function resolveMiaixzFloatingPlacement(trigger, content, placement, viewportWidth, viewportHeight) {
+    if ((placement === "bottom" || placement.startsWith("bottom-")) &&
+        trigger.bottom + miaixzFloatingGap + content.height > viewportHeight - miaixzFloatingGap) {
+        return placement === "bottom"
+            ? "top"
+            : placement.replace("bottom-", "top-");
+    }
+    if ((placement === "top" || placement.startsWith("top-")) &&
+        trigger.top - miaixzFloatingGap - content.height < miaixzFloatingGap) {
+        return placement === "top"
+            ? "bottom"
+            : placement.replace("top-", "bottom-");
+    }
+    if (placement === "right" &&
+        trigger.right + miaixzFloatingGap + content.width > viewportWidth - miaixzFloatingGap) {
+        return "left";
+    }
+    if (placement === "left" &&
+        trigger.left - miaixzFloatingGap - content.width < miaixzFloatingGap) {
+        return "right";
+    }
+    return placement;
+}
+/**
+ * Clamps one coordinate while handling surfaces larger than the available viewport.
+ *
+ * @param value - Requested coordinate.
+ * @param minimum - Minimum safe viewport coordinate.
+ * @param maximum - Maximum safe viewport coordinate.
+ * @returns Coordinate constrained to the valid interval.
+ */
+function clampMiaixzFloatingCoordinate(value, minimum, maximum) {
+    return Math.min(Math.max(value, minimum), Math.max(minimum, maximum));
+}
+//# sourceMappingURL=floating-position.js.map

package/dist/internal/overlay/floating-position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"floating-position.js","sourceRoot":"","sources":["../../../src/internal/overlay/floating-position.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useLayoutEffect, type RefObject } from \"react\";\n\n/**\n * Defines every fixed placement used by package-owned Popover and Tooltip surfaces.\n */\nexport type MiaixzFloatingPlacement =\n  \"bottom-start\" | \"bottom-end\" | \"top-start\" | \"top-end\" | \"top\" | \"right\" | \"bottom\" | \"left\";\n\n/**\n * Describes one resolved viewport-relative floating position.\n */\ninterface MiaixzFloatingPosition {\n  /**\n   * Identifies the resolved placement after main-axis flipping.\n   */\n  readonly placement: MiaixzFloatingPlacement;\n\n  /**\n   * Supplies the clamped viewport x coordinate.\n   */\n  readonly x: number;\n\n  /**\n   * Supplies the clamped viewport y coordinate.\n   */\n  readonly y: number;\n}\n\n/**\n * Keeps floating surfaces and viewport edges separated by the frozen eight-pixel gap.\n */\nconst miaixzFloatingGap = 8;\n\n/**\n * Uses layout timing in browsers and passive timing during server rendering.\n */\nconst useMiaixzClientLayoutEffect = typeof document === \"undefined\" ? useEffect : useLayoutEffect;\n\n/**\n * Positions one open Portal surface and maintains it across geometry changes.\n *\n * @param triggerRef - Reference containing the anchor element.\n * @param contentRef - Reference containing the fixed surface.\n * @param open - Whether geometry observers should be active.\n * @param placement - Requested logical placement.\n * @param portalTarget - Current Portal target used to retrigger observers after remounting.\n */\nexport function useMiaixzFloatingPosition(\n  triggerRef: RefObject<HTMLElement | null>,\n  contentRef: RefObject<HTMLElement | null>,\n  open: boolean,\n  placement: MiaixzFloatingPlacement,\n  portalTarget: HTMLElement | null,\n): void {\n  useMiaixzClientLayoutEffect(() => {\n    const trigger = triggerRef.current;\n    const content = contentRef.current;\n    if (!open || trigger === null || content === null) return undefined;\n    const ownerDocument = trigger.ownerDocument;\n    const viewport = ownerDocument.defaultView;\n    if (viewport === null) return undefined;\n\n    const update = () => {\n      const position = calculateMiaixzFloatingPosition(\n        trigger.getBoundingClientRect(),\n        content.getBoundingClientRect(),\n        placement,\n        viewport.innerWidth,\n        viewport.innerHeight,\n        viewport.getComputedStyle(trigger).direction === \"rtl\",\n      );\n      content.style.left = `${position.x}px`;\n      content.style.top = `${position.y}px`;\n      content.dataset.placement = position.placement;\n      content.dataset.miaixzPositioned = \"true\";\n    };\n\n    update();\n    ownerDocument.addEventListener(\"scroll\", update, true);\n    viewport.addEventListener(\"resize\", update);\n    const resizeObserver =\n      typeof ResizeObserver === \"function\" ? new ResizeObserver(update) : undefined;\n    resizeObserver?.observe(trigger);\n    resizeObserver?.observe(content);\n\n    return () => {\n      ownerDocument.removeEventListener(\"scroll\", update, true);\n      viewport.removeEventListener(\"resize\", update);\n      resizeObserver?.disconnect();\n      delete content.dataset.miaixzPositioned;\n    };\n  }, [contentRef, open, placement, portalTarget, triggerRef]);\n}\n\n/**\n * Resolves flipping, logical alignment, and viewport clamping for one floating surface.\n *\n * @param trigger - Viewport geometry of the anchor element.\n * @param content - Viewport geometry of the floating surface.\n * @param requestedPlacement - Caller-requested logical placement.\n * @param viewportWidth - Current layout viewport width.\n * @param viewportHeight - Current layout viewport height.\n * @param rightToLeft - Whether logical inline start resolves to the right edge.\n * @returns Resolved placement and clamped viewport coordinates.\n */\nexport function calculateMiaixzFloatingPosition(\n  trigger: DOMRect,\n  content: DOMRect,\n  requestedPlacement: MiaixzFloatingPlacement,\n  viewportWidth: number,\n  viewportHeight: number,\n  rightToLeft: boolean,\n): MiaixzFloatingPosition {\n  const placement = resolveMiaixzFloatingPlacement(\n    trigger,\n    content,\n    requestedPlacement,\n    viewportWidth,\n    viewportHeight,\n  );\n  let x: number;\n  let y: number;\n\n  if (placement === \"top\" || placement === \"bottom\") {\n    x = trigger.left + (trigger.width - content.width) / 2;\n    y =\n      placement === \"top\"\n        ? trigger.top - content.height - miaixzFloatingGap\n        : trigger.bottom + miaixzFloatingGap;\n  } else if (placement === \"left\" || placement === \"right\") {\n    x =\n      placement === \"left\"\n        ? trigger.left - content.width - miaixzFloatingGap\n        : trigger.right + miaixzFloatingGap;\n    y = trigger.top + (trigger.height - content.height) / 2;\n  } else {\n    const alignStart = placement.endsWith(\"-start\");\n    const alignLeft = rightToLeft ? !alignStart : alignStart;\n    x = alignLeft ? trigger.left : trigger.right - content.width;\n    y = placement.startsWith(\"top-\")\n      ? trigger.top - content.height - miaixzFloatingGap\n      : trigger.bottom + miaixzFloatingGap;\n  }\n\n  return {\n    placement,\n    x: clampMiaixzFloatingCoordinate(\n      x,\n      miaixzFloatingGap,\n      viewportWidth - content.width - miaixzFloatingGap,\n    ),\n    y: clampMiaixzFloatingCoordinate(\n      y,\n      miaixzFloatingGap,\n      viewportHeight - content.height - miaixzFloatingGap,\n    ),\n  };\n}\n\n/**\n * Flips one requested placement when its main-axis surface does not fit.\n *\n * @param trigger - Viewport geometry of the anchor element.\n * @param content - Viewport geometry of the floating surface.\n * @param placement - Requested placement.\n * @param viewportWidth - Current layout viewport width.\n * @param viewportHeight - Current layout viewport height.\n * @returns Original or opposite placement.\n */\nfunction resolveMiaixzFloatingPlacement(\n  trigger: DOMRect,\n  content: DOMRect,\n  placement: MiaixzFloatingPlacement,\n  viewportWidth: number,\n  viewportHeight: number,\n): MiaixzFloatingPlacement {\n  if (\n    (placement === \"bottom\" || placement.startsWith(\"bottom-\")) &&\n    trigger.bottom + miaixzFloatingGap + content.height > viewportHeight - miaixzFloatingGap\n  ) {\n    return placement === \"bottom\"\n      ? \"top\"\n      : (placement.replace(\"bottom-\", \"top-\") as MiaixzFloatingPlacement);\n  }\n  if (\n    (placement === \"top\" || placement.startsWith(\"top-\")) &&\n    trigger.top - miaixzFloatingGap - content.height < miaixzFloatingGap\n  ) {\n    return placement === \"top\"\n      ? \"bottom\"\n      : (placement.replace(\"top-\", \"bottom-\") as MiaixzFloatingPlacement);\n  }\n  if (\n    placement === \"right\" &&\n    trigger.right + miaixzFloatingGap + content.width > viewportWidth - miaixzFloatingGap\n  ) {\n    return \"left\";\n  }\n  if (\n    placement === \"left\" &&\n    trigger.left - miaixzFloatingGap - content.width < miaixzFloatingGap\n  ) {\n    return \"right\";\n  }\n  return placement;\n}\n\n/**\n * Clamps one coordinate while handling surfaces larger than the available viewport.\n *\n * @param value - Requested coordinate.\n * @param minimum - Minimum safe viewport coordinate.\n * @param maximum - Maximum safe viewport coordinate.\n * @returns Coordinate constrained to the valid interval.\n */\nfunction clampMiaixzFloatingCoordinate(value: number, minimum: number, maximum: number): number {\n  return Math.min(Math.max(value, minimum), Math.max(minimum, maximum));\n}\n"]}