@miaixz/ui 0.5.0

package/dist/internal/overlay/index.d.ts

@@ -0,0 +1,8 @@
+export { useMiaixzDismissibleLayer } from "./dismissible-layer.js";
+export type { MiaixzDismissReason } from "./dismissible-layer.js";
+export { useMiaixzFloatingPosition } from "./floating-position.js";
+export type { MiaixzFloatingPlacement } from "./floating-position.js";
+export { useMiaixzManualPopover } from "./top-layer.js";
+export { useMiaixzNativeModal } from "./native-modal.js";
+export { useMiaixzPortalTarget } from "./portal-target.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/overlay/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/overlay/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/internal/overlay/index.js

@@ -0,0 +1,6 @@
+export { useMiaixzDismissibleLayer } from "./dismissible-layer.js";
+export { useMiaixzFloatingPosition } from "./floating-position.js";
+export { useMiaixzManualPopover } from "./top-layer.js";
+export { useMiaixzNativeModal } from "./native-modal.js";
+export { useMiaixzPortalTarget } from "./portal-target.js";
+//# sourceMappingURL=index.js.map

package/dist/internal/overlay/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/overlay/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["export { useMiaixzDismissibleLayer } from \"./dismissible-layer.js\";\nexport type { MiaixzDismissReason } from \"./dismissible-layer.js\";\nexport { useMiaixzFloatingPosition } from \"./floating-position.js\";\nexport type { MiaixzFloatingPlacement } from \"./floating-position.js\";\nexport { useMiaixzManualPopover } from \"./top-layer.js\";\nexport { useMiaixzNativeModal } from \"./native-modal.js\";\nexport { useMiaixzPortalTarget } from \"./portal-target.js\";\n"]}

package/dist/internal/overlay/native-modal.d.ts

@@ -0,0 +1,11 @@
+import { type RefObject } from "react";
+/**
+ * Synchronizes a controlled state with one native modal, its stack, and document scroll lock.
+ *
+ * @param ref - Reference containing the native dialog element.
+ * @param open - Controlled modal open state.
+ * @param portalTarget - Current Portal target used to retrigger synchronization after mounting.
+ * @returns Stable reference to the element focused before the modal opened.
+ */
+export declare function useMiaixzNativeModal(ref: RefObject<HTMLDialogElement | null>, open: boolean, portalTarget: HTMLElement | null): RefObject<HTMLElement | null>;
+//# sourceMappingURL=native-modal.d.ts.map

package/dist/internal/overlay/native-modal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-modal.d.ts","sourceRoot":"","sources":["../../../src/internal/overlay/native-modal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AA0D3E;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,EACxC,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,WAAW,GAAG,IAAI,GAC/B,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CA6B/B"}

package/dist/internal/overlay/native-modal.js

@@ -0,0 +1,160 @@
+import { useEffect, useLayoutEffect, useRef } from "react";
+import { lockMiaixzDocumentScroll } from "./document-scroll-lock.js";
+import { registerMiaixzModal } from "./portal-target.js";
+/**
+ * Uses layout timing in browsers and passive timing during server rendering.
+ */
+const useMiaixzClientLayoutEffect = typeof document === "undefined" ? useEffect : useLayoutEffect;
+/**
+ * Selects interactive elements that can initiate a controlled modal transition.
+ */
+const miaixzModalTriggerSelector = [
+    "a[href]",
+    "button:not([disabled])",
+    "input:not([disabled])",
+    "select:not([disabled])",
+    "textarea:not([disabled])",
+    "[contenteditable='true']",
+    "[tabindex]:not([tabindex='-1'])",
+].join(",");
+/**
+ * Limits pointer-based restoration fallback to the interaction that immediately opened a modal.
+ */
+const miaixzModalInteractionWindow = 1000;
+/**
+ * Retains one shared pointer observer for each independent document realm.
+ */
+const miaixzModalInteractionRecords = new WeakMap();
+/**
+ * Synchronizes a controlled state with one native modal, its stack, and document scroll lock.
+ *
+ * @param ref - Reference containing the native dialog element.
+ * @param open - Controlled modal open state.
+ * @param portalTarget - Current Portal target used to retrigger synchronization after mounting.
+ * @returns Stable reference to the element focused before the modal opened.
+ */
+export function useMiaixzNativeModal(ref, open, portalTarget) {
+    const restoreFocusRef = useRef(null);
+    useEffect(() => {
+        const ownerDocument = ref.current?.ownerDocument ?? portalTarget?.ownerDocument;
+        if (ownerDocument === undefined)
+            return undefined;
+        return observeMiaixzModalInteractions(ownerDocument);
+    }, [portalTarget, ref]);
+    useMiaixzClientLayoutEffect(() => {
+        const dialog = ref.current;
+        if (dialog === null)
+            return undefined;
+        if (!open) {
+            if (dialog.open)
+                dialog.close();
+            return undefined;
+        }
+        if (!dialog.open) {
+            restoreFocusRef.current = resolveMiaixzModalRestoreTarget(dialog.ownerDocument);
+            dialog.showModal();
+        }
+        const unregisterModal = registerMiaixzModal(dialog);
+        const unlockDocument = lockMiaixzDocumentScroll(dialog.ownerDocument);
+        return () => {
+            unregisterModal();
+            unlockDocument();
+        };
+    }, [open, portalTarget, ref]);
+    return restoreFocusRef;
+}
+/**
+ * Installs or reuses the document observer that remembers pointer-triggered modal initiators.
+ *
+ * Safari does not focus buttons after pointer activation, so activeElement alone cannot identify
+ * the trigger. The short-lived captured target preserves cross-browser restoration without adding
+ * a public trigger property to controlled Dialog and Drawer APIs.
+ *
+ * @param ownerDocument - Document whose modal interactions should be observed.
+ * @returns Cleanup that releases the shared observer reference.
+ */
+function observeMiaixzModalInteractions(ownerDocument) {
+    let record = miaixzModalInteractionRecords.get(ownerDocument);
+    if (record === undefined) {
+        record = {
+            references: 0,
+            target: null,
+            recordedAt: 0,
+            handlePointerDown: (event) => {
+                const activeRecord = miaixzModalInteractionRecords.get(ownerDocument);
+                if (activeRecord === undefined)
+                    return;
+                activeRecord.target = findMiaixzModalInteractionTarget(event.target);
+                activeRecord.recordedAt = Date.now();
+            },
+        };
+        miaixzModalInteractionRecords.set(ownerDocument, record);
+        ownerDocument.addEventListener("pointerdown", record.handlePointerDown, true);
+    }
+    record.references += 1;
+    let active = true;
+    return () => {
+        if (!active)
+            return;
+        active = false;
+        const activeRecord = miaixzModalInteractionRecords.get(ownerDocument);
+        if (activeRecord === undefined)
+            return;
+        activeRecord.references -= 1;
+        if (activeRecord.references > 0)
+            return;
+        ownerDocument.removeEventListener("pointerdown", activeRecord.handlePointerDown, true);
+        miaixzModalInteractionRecords.delete(ownerDocument);
+    };
+}
+/**
+ * Resolves the focus destination to restore when a native modal closes.
+ *
+ * @param ownerDocument - Document whose active and recent interaction targets should be inspected.
+ * @returns Connected trigger target, current focus target, or null when neither is meaningful.
+ */
+function resolveMiaixzModalRestoreTarget(ownerDocument) {
+    const record = miaixzModalInteractionRecords.get(ownerDocument);
+    if (record?.target !== null &&
+        record?.target !== undefined &&
+        record.target.isConnected &&
+        Date.now() - record.recordedAt <= miaixzModalInteractionWindow) {
+        return record.target;
+    }
+    const activeElement = ownerDocument.activeElement;
+    return isMiaixzFocusableReference(activeElement) &&
+        activeElement !== ownerDocument.body &&
+        activeElement !== ownerDocument.documentElement
+        ? activeElement
+        : null;
+}
+/**
+ * Finds the nearest enabled interactive ancestor for one pointer event target.
+ *
+ * @param value - Pointer event target, which may be a nested icon or text node.
+ * @returns Nearest connected focusable ancestor or null when no trigger exists.
+ */
+function findMiaixzModalInteractionTarget(value) {
+    if (typeof value !== "object" ||
+        value === null ||
+        !("closest" in value) ||
+        typeof value.closest !== "function") {
+        return null;
+    }
+    const candidate = value.closest(miaixzModalTriggerSelector);
+    return isMiaixzFocusableReference(candidate) && candidate.isConnected ? candidate : null;
+}
+/**
+ * Determines whether an active-element value can be retained as a focus restoration target.
+ *
+ * @param value - Candidate active element from the modal's document realm.
+ * @returns Whether the candidate exposes a connected HTMLElement focus contract.
+ */
+function isMiaixzFocusableReference(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "focus" in value &&
+        typeof value.focus === "function" &&
+        "isConnected" in value);
+}
+//# sourceMappingURL=native-modal.js.map

package/dist/internal/overlay/native-modal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-modal.js","sourceRoot":"","sources":["../../../src/internal/overlay/native-modal.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useLayoutEffect, useRef, type RefObject } from \"react\";\n\nimport { lockMiaixzDocumentScroll } from \"./document-scroll-lock.js\";\nimport { registerMiaixzModal } from \"./portal-target.js\";\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 * Selects interactive elements that can initiate a controlled modal transition.\n */\nconst miaixzModalTriggerSelector = [\n  \"a[href]\",\n  \"button:not([disabled])\",\n  \"input:not([disabled])\",\n  \"select:not([disabled])\",\n  \"textarea:not([disabled])\",\n  \"[contenteditable='true']\",\n  \"[tabindex]:not([tabindex='-1'])\",\n].join(\",\");\n\n/**\n * Limits pointer-based restoration fallback to the interaction that immediately opened a modal.\n */\nconst miaixzModalInteractionWindow = 1000;\n\n/**\n * Retains one shared pointer observer for each independent document realm.\n */\nconst miaixzModalInteractionRecords = new WeakMap<Document, MiaixzModalInteractionRecord>();\n\n/**\n * Describes the shared recent-interaction state for one document realm.\n */\ninterface MiaixzModalInteractionRecord {\n  /**\n   * Counts mounted modal hooks using the document observer.\n   */\n  references: number;\n\n  /**\n   * Stores the most recent interactive pointer target.\n   */\n  target: HTMLElement | null;\n\n  /**\n   * Stores the wall-clock time at which the pointer interaction occurred.\n   */\n  recordedAt: number;\n\n  /**\n   * Handles pointer activity captured before application click handlers run.\n   */\n  readonly handlePointerDown: (event: PointerEvent) => void;\n}\n\n/**\n * Synchronizes a controlled state with one native modal, its stack, and document scroll lock.\n *\n * @param ref - Reference containing the native dialog element.\n * @param open - Controlled modal open state.\n * @param portalTarget - Current Portal target used to retrigger synchronization after mounting.\n * @returns Stable reference to the element focused before the modal opened.\n */\nexport function useMiaixzNativeModal(\n  ref: RefObject<HTMLDialogElement | null>,\n  open: boolean,\n  portalTarget: HTMLElement | null,\n): RefObject<HTMLElement | null> {\n  const restoreFocusRef = useRef<HTMLElement | null>(null);\n  useEffect(() => {\n    const ownerDocument = ref.current?.ownerDocument ?? portalTarget?.ownerDocument;\n    if (ownerDocument === undefined) return undefined;\n    return observeMiaixzModalInteractions(ownerDocument);\n  }, [portalTarget, ref]);\n\n  useMiaixzClientLayoutEffect(() => {\n    const dialog = ref.current;\n    if (dialog === null) return undefined;\n\n    if (!open) {\n      if (dialog.open) dialog.close();\n      return undefined;\n    }\n\n    if (!dialog.open) {\n      restoreFocusRef.current = resolveMiaixzModalRestoreTarget(dialog.ownerDocument);\n      dialog.showModal();\n    }\n    const unregisterModal = registerMiaixzModal(dialog);\n    const unlockDocument = lockMiaixzDocumentScroll(dialog.ownerDocument);\n    return () => {\n      unregisterModal();\n      unlockDocument();\n    };\n  }, [open, portalTarget, ref]);\n  return restoreFocusRef;\n}\n\n/**\n * Installs or reuses the document observer that remembers pointer-triggered modal initiators.\n *\n * Safari does not focus buttons after pointer activation, so activeElement alone cannot identify\n * the trigger. The short-lived captured target preserves cross-browser restoration without adding\n * a public trigger property to controlled Dialog and Drawer APIs.\n *\n * @param ownerDocument - Document whose modal interactions should be observed.\n * @returns Cleanup that releases the shared observer reference.\n */\nfunction observeMiaixzModalInteractions(ownerDocument: Document): () => void {\n  let record = miaixzModalInteractionRecords.get(ownerDocument);\n  if (record === undefined) {\n    record = {\n      references: 0,\n      target: null,\n      recordedAt: 0,\n      handlePointerDown: (event) => {\n        const activeRecord = miaixzModalInteractionRecords.get(ownerDocument);\n        if (activeRecord === undefined) return;\n        activeRecord.target = findMiaixzModalInteractionTarget(event.target);\n        activeRecord.recordedAt = Date.now();\n      },\n    };\n    miaixzModalInteractionRecords.set(ownerDocument, record);\n    ownerDocument.addEventListener(\"pointerdown\", record.handlePointerDown, true);\n  }\n  record.references += 1;\n\n  let active = true;\n  return () => {\n    if (!active) return;\n    active = false;\n    const activeRecord = miaixzModalInteractionRecords.get(ownerDocument);\n    if (activeRecord === undefined) return;\n    activeRecord.references -= 1;\n    if (activeRecord.references > 0) return;\n    ownerDocument.removeEventListener(\"pointerdown\", activeRecord.handlePointerDown, true);\n    miaixzModalInteractionRecords.delete(ownerDocument);\n  };\n}\n\n/**\n * Resolves the focus destination to restore when a native modal closes.\n *\n * @param ownerDocument - Document whose active and recent interaction targets should be inspected.\n * @returns Connected trigger target, current focus target, or null when neither is meaningful.\n */\nfunction resolveMiaixzModalRestoreTarget(ownerDocument: Document): HTMLElement | null {\n  const record = miaixzModalInteractionRecords.get(ownerDocument);\n  if (\n    record?.target !== null &&\n    record?.target !== undefined &&\n    record.target.isConnected &&\n    Date.now() - record.recordedAt <= miaixzModalInteractionWindow\n  ) {\n    return record.target;\n  }\n  const activeElement = ownerDocument.activeElement;\n  return isMiaixzFocusableReference(activeElement) &&\n    activeElement !== ownerDocument.body &&\n    activeElement !== ownerDocument.documentElement\n    ? activeElement\n    : null;\n}\n\n/**\n * Finds the nearest enabled interactive ancestor for one pointer event target.\n *\n * @param value - Pointer event target, which may be a nested icon or text node.\n * @returns Nearest connected focusable ancestor or null when no trigger exists.\n */\nfunction findMiaixzModalInteractionTarget(value: unknown): HTMLElement | null {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    !(\"closest\" in value) ||\n    typeof value.closest !== \"function\"\n  ) {\n    return null;\n  }\n  const candidate = value.closest(miaixzModalTriggerSelector) as unknown;\n  return isMiaixzFocusableReference(candidate) && candidate.isConnected ? candidate : null;\n}\n\n/**\n * Determines whether an active-element value can be retained as a focus restoration target.\n *\n * @param value - Candidate active element from the modal's document realm.\n * @returns Whether the candidate exposes a connected HTMLElement focus contract.\n */\nfunction isMiaixzFocusableReference(value: unknown): value is HTMLElement {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"focus\" in value &&\n    typeof value.focus === \"function\" &&\n    \"isConnected\" in value\n  );\n}\n"]}

package/dist/internal/overlay/portal-target.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Registers one open native modal and publishes its top-layer order.
+ *
+ * @param dialog - Open native dialog entering the modal stack.
+ * @returns An idempotent registration cleanup function.
+ */
+export declare function registerMiaixzModal(dialog: HTMLDialogElement): () => void;
+/**
+ * Resolves the package-owned Portal destination for an anchored or global overlay.
+ *
+ * Anchored overlays use the nearest open native dialog so modal focus containment remains valid.
+ * Global overlays use the topmost registered modal and otherwise fall back to the document body.
+ *
+ * @param anchor - Optional overlay trigger or wrapper element.
+ * @param useTopModal - Whether an unanchored overlay should follow the topmost modal.
+ * @returns A client Portal target, or null before client mounting.
+ */
+export declare function useMiaixzPortalTarget(anchor?: HTMLElement | null, useTopModal?: boolean): HTMLElement | null;
+//# sourceMappingURL=portal-target.d.ts.map

package/dist/internal/overlay/portal-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-target.d.ts","sourceRoot":"","sources":["../../../src/internal/overlay/portal-target.ts"],"names":[],"mappings":"AA+BA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAezE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,GAAE,WAAW,GAAG,IAAW,EACjC,WAAW,UAAQ,GAClB,WAAW,GAAG,IAAI,CAepB"}

package/dist/internal/overlay/portal-target.js

@@ -0,0 +1,113 @@
+import { useSyncExternalStore } from "react";
+/**
+ * Isolates active modal state between independent document realms.
+ */
+const miaixzModalStores = new WeakMap();
+/**
+ * Provides a stable no-op subscription for client document discovery.
+ *
+ * @returns A no-op cleanup function.
+ */
+function subscribeToMiaixzClientDocument() {
+    return () => undefined;
+}
+/**
+ * Registers one open native modal and publishes its top-layer order.
+ *
+ * @param dialog - Open native dialog entering the modal stack.
+ * @returns An idempotent registration cleanup function.
+ */
+export function registerMiaixzModal(dialog) {
+    const store = getMiaixzModalStore(dialog.ownerDocument);
+    const existingIndex = store.dialogs.indexOf(dialog);
+    if (existingIndex >= 0)
+        store.dialogs.splice(existingIndex, 1);
+    store.dialogs.push(dialog);
+    publishMiaixzModalStore(store);
+    let active = true;
+    return () => {
+        if (!active)
+            return;
+        active = false;
+        const index = store.dialogs.indexOf(dialog);
+        if (index >= 0)
+            store.dialogs.splice(index, 1);
+        publishMiaixzModalStore(store);
+    };
+}
+/**
+ * Resolves the package-owned Portal destination for an anchored or global overlay.
+ *
+ * Anchored overlays use the nearest open native dialog so modal focus containment remains valid.
+ * Global overlays use the topmost registered modal and otherwise fall back to the document body.
+ *
+ * @param anchor - Optional overlay trigger or wrapper element.
+ * @param useTopModal - Whether an unanchored overlay should follow the topmost modal.
+ * @returns A client Portal target, or null before client mounting.
+ */
+export function useMiaixzPortalTarget(anchor = null, useTopModal = false) {
+    const ownerDocument = useSyncExternalStore(subscribeToMiaixzClientDocument, () => anchor?.ownerDocument ?? document, () => null);
+    const topModal = useSyncExternalStore((listener) => subscribeToMiaixzModalStore(ownerDocument, listener), () => getTopMiaixzModal(ownerDocument), () => null);
+    if (ownerDocument === null)
+        return null;
+    if (useTopModal)
+        return topModal ?? ownerDocument.body;
+    return anchor?.closest("dialog[open]") ?? ownerDocument.body;
+}
+/**
+ * Returns the mutable modal store for one document, creating it when necessary.
+ *
+ * @param ownerDocument - Document whose modal stack is requested.
+ * @returns The document-scoped modal store.
+ */
+function getMiaixzModalStore(ownerDocument) {
+    const existing = miaixzModalStores.get(ownerDocument);
+    if (existing !== undefined)
+        return existing;
+    const created = { dialogs: [], listeners: new Set() };
+    miaixzModalStores.set(ownerDocument, created);
+    return created;
+}
+/**
+ * Returns the connected topmost native modal for a document.
+ *
+ * @param ownerDocument - Document whose active modal should be read.
+ * @returns The topmost connected open dialog, or null when none exists.
+ */
+function getTopMiaixzModal(ownerDocument) {
+    if (ownerDocument === null)
+        return null;
+    const store = miaixzModalStores.get(ownerDocument);
+    if (store === undefined)
+        return null;
+    for (let index = store.dialogs.length - 1; index >= 0; index -= 1) {
+        const dialog = store.dialogs[index];
+        if (dialog?.isConnected && dialog.open)
+            return dialog;
+    }
+    return null;
+}
+/**
+ * Subscribes to modal target changes without creating a store during server rendering.
+ *
+ * @param ownerDocument - Document whose modal changes should be observed.
+ * @param listener - Snapshot listener supplied by React.
+ * @returns Subscription cleanup.
+ */
+function subscribeToMiaixzModalStore(ownerDocument, listener) {
+    if (ownerDocument === null)
+        return () => undefined;
+    const store = getMiaixzModalStore(ownerDocument);
+    store.listeners.add(listener);
+    return () => store.listeners.delete(listener);
+}
+/**
+ * Notifies every current modal-store subscriber.
+ *
+ * @param store - Modal store whose ordering changed.
+ */
+function publishMiaixzModalStore(store) {
+    for (const listener of store.listeners)
+        listener();
+}
+//# sourceMappingURL=portal-target.js.map

package/dist/internal/overlay/portal-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-target.js","sourceRoot":"","sources":["../../../src/internal/overlay/portal-target.ts"],"names":[],"mappings":"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","sourcesContent":["import { useSyncExternalStore } from \"react\";\n\n/**\n * Stores modal ordering and subscriptions for one document realm.\n */\ninterface MiaixzModalStore {\n  /**\n   * Retains open native dialogs in top-layer activation order.\n   */\n  readonly dialogs: HTMLDialogElement[];\n\n  /**\n   * Receives changes to the active modal stack.\n   */\n  readonly listeners: Set<() => void>;\n}\n\n/**\n * Isolates active modal state between independent document realms.\n */\nconst miaixzModalStores = new WeakMap<Document, MiaixzModalStore>();\n\n/**\n * Provides a stable no-op subscription for client document discovery.\n *\n * @returns A no-op cleanup function.\n */\nfunction subscribeToMiaixzClientDocument(): () => void {\n  return () => undefined;\n}\n\n/**\n * Registers one open native modal and publishes its top-layer order.\n *\n * @param dialog - Open native dialog entering the modal stack.\n * @returns An idempotent registration cleanup function.\n */\nexport function registerMiaixzModal(dialog: HTMLDialogElement): () => void {\n  const store = getMiaixzModalStore(dialog.ownerDocument);\n  const existingIndex = store.dialogs.indexOf(dialog);\n  if (existingIndex >= 0) store.dialogs.splice(existingIndex, 1);\n  store.dialogs.push(dialog);\n  publishMiaixzModalStore(store);\n\n  let active = true;\n  return () => {\n    if (!active) return;\n    active = false;\n    const index = store.dialogs.indexOf(dialog);\n    if (index >= 0) store.dialogs.splice(index, 1);\n    publishMiaixzModalStore(store);\n  };\n}\n\n/**\n * Resolves the package-owned Portal destination for an anchored or global overlay.\n *\n * Anchored overlays use the nearest open native dialog so modal focus containment remains valid.\n * Global overlays use the topmost registered modal and otherwise fall back to the document body.\n *\n * @param anchor - Optional overlay trigger or wrapper element.\n * @param useTopModal - Whether an unanchored overlay should follow the topmost modal.\n * @returns A client Portal target, or null before client mounting.\n */\nexport function useMiaixzPortalTarget(\n  anchor: HTMLElement | null = null,\n  useTopModal = false,\n): HTMLElement | null {\n  const ownerDocument = useSyncExternalStore(\n    subscribeToMiaixzClientDocument,\n    () => anchor?.ownerDocument ?? document,\n    () => null,\n  );\n  const topModal = useSyncExternalStore(\n    (listener) => subscribeToMiaixzModalStore(ownerDocument, listener),\n    () => getTopMiaixzModal(ownerDocument),\n    () => null,\n  );\n\n  if (ownerDocument === null) return null;\n  if (useTopModal) return topModal ?? ownerDocument.body;\n  return anchor?.closest<HTMLDialogElement>(\"dialog[open]\") ?? ownerDocument.body;\n}\n\n/**\n * Returns the mutable modal store for one document, creating it when necessary.\n *\n * @param ownerDocument - Document whose modal stack is requested.\n * @returns The document-scoped modal store.\n */\nfunction getMiaixzModalStore(ownerDocument: Document): MiaixzModalStore {\n  const existing = miaixzModalStores.get(ownerDocument);\n  if (existing !== undefined) return existing;\n  const created: MiaixzModalStore = { dialogs: [], listeners: new Set() };\n  miaixzModalStores.set(ownerDocument, created);\n  return created;\n}\n\n/**\n * Returns the connected topmost native modal for a document.\n *\n * @param ownerDocument - Document whose active modal should be read.\n * @returns The topmost connected open dialog, or null when none exists.\n */\nfunction getTopMiaixzModal(ownerDocument: Document | null): HTMLDialogElement | null {\n  if (ownerDocument === null) return null;\n  const store = miaixzModalStores.get(ownerDocument);\n  if (store === undefined) return null;\n  for (let index = store.dialogs.length - 1; index >= 0; index -= 1) {\n    const dialog = store.dialogs[index];\n    if (dialog?.isConnected && dialog.open) return dialog;\n  }\n  return null;\n}\n\n/**\n * Subscribes to modal target changes without creating a store during server rendering.\n *\n * @param ownerDocument - Document whose modal changes should be observed.\n * @param listener - Snapshot listener supplied by React.\n * @returns Subscription cleanup.\n */\nfunction subscribeToMiaixzModalStore(\n  ownerDocument: Document | null,\n  listener: () => void,\n): () => void {\n  if (ownerDocument === null) return () => undefined;\n  const store = getMiaixzModalStore(ownerDocument);\n  store.listeners.add(listener);\n  return () => store.listeners.delete(listener);\n}\n\n/**\n * Notifies every current modal-store subscriber.\n *\n * @param store - Modal store whose ordering changed.\n */\nfunction publishMiaixzModalStore(store: MiaixzModalStore): void {\n  for (const listener of store.listeners) listener();\n}\n"]}

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

@@ -0,0 +1,21 @@
+import { type RefObject } from "react";
+/**
+ * Synchronizes a non-modal surface with the browser manual Popover top layer.
+ *
+ * Unsupported browsers retain a fixed non-modal fallback by removing the unsupported attribute.
+ * Cross-modal fallback is intentionally not promised by the frozen browser support contract.
+ *
+ * @param ref - Reference containing the Portal surface.
+ * @param open - Whether the surface should be visible.
+ * @param portalTarget - Current Portal destination used to synchronize remounts.
+ */
+export declare function useMiaixzManualPopover(ref: RefObject<HTMLElement | null>, open: boolean, portalTarget: HTMLElement | null): void;
+/**
+ * Applies one top-layer state transition and returns exact teardown behavior.
+ *
+ * @param element - Connected or test-owned surface receiving top-layer state.
+ * @param open - Whether the surface should be visible.
+ * @returns Cleanup that hides the synchronized surface.
+ */
+export declare function synchronizeMiaixzManualPopover(element: HTMLElement, open: boolean): () => void;
+//# sourceMappingURL=top-layer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"top-layer.d.ts","sourceRoot":"","sources":["../../../src/internal/overlay/top-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAOnE;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAClC,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,WAAW,GAAG,IAAI,GAC/B,IAAI,CAMN;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,IAAI,CAiB9F"}

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

@@ -0,0 +1,51 @@
+import { useEffect, useLayoutEffect } from "react";
+/**
+ * Uses layout timing in browsers and passive timing during server rendering.
+ */
+const useMiaixzClientLayoutEffect = typeof document === "undefined" ? useEffect : useLayoutEffect;
+/**
+ * Synchronizes a non-modal surface with the browser manual Popover top layer.
+ *
+ * Unsupported browsers retain a fixed non-modal fallback by removing the unsupported attribute.
+ * Cross-modal fallback is intentionally not promised by the frozen browser support contract.
+ *
+ * @param ref - Reference containing the Portal surface.
+ * @param open - Whether the surface should be visible.
+ * @param portalTarget - Current Portal destination used to synchronize remounts.
+ */
+export function useMiaixzManualPopover(ref, open, portalTarget) {
+    useMiaixzClientLayoutEffect(() => {
+        const element = ref.current;
+        if (element === null)
+            return undefined;
+        return synchronizeMiaixzManualPopover(element, open);
+    }, [open, portalTarget, ref]);
+}
+/**
+ * Applies one top-layer state transition and returns exact teardown behavior.
+ *
+ * @param element - Connected or test-owned surface receiving top-layer state.
+ * @param open - Whether the surface should be visible.
+ * @returns Cleanup that hides the synchronized surface.
+ */
+export function synchronizeMiaixzManualPopover(element, open) {
+    if (typeof element.showPopover !== "function" || typeof element.hidePopover !== "function") {
+        element.removeAttribute("popover");
+        element.hidden = !open;
+        element.toggleAttribute("data-miaixz-top-layer-fallback", open);
+        return () => {
+            element.hidden = true;
+            element.removeAttribute("data-miaixz-top-layer-fallback");
+        };
+    }
+    element.hidden = false;
+    if (open && !element.matches(":popover-open"))
+        element.showPopover();
+    if (!open && element.matches(":popover-open"))
+        element.hidePopover();
+    return () => {
+        if (element.matches(":popover-open"))
+            element.hidePopover();
+    };
+}
+//# sourceMappingURL=top-layer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"top-layer.js","sourceRoot":"","sources":["../../../src/internal/overlay/top-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAkB,MAAM,OAAO,CAAC;AAEnE;;GAEG;AACH,MAAM,2BAA2B,GAAG,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC;AAElG;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAkC,EAClC,IAAa,EACb,YAAgC;IAEhC,2BAA2B,CAAC,GAAG,EAAE;QAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACvC,OAAO,8BAA8B,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAAoB,EAAE,IAAa;IAChF,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QAC3F,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QACnC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC;QACvB,OAAO,CAAC,eAAe,CAAC,gCAAgC,EAAE,IAAI,CAAC,CAAC;QAChE,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YACtB,OAAO,CAAC,eAAe,CAAC,gCAAgC,CAAC,CAAC;QAC5D,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC;IACvB,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC;QAAE,OAAO,CAAC,WAAW,EAAE,CAAC;IACrE,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC;QAAE,OAAO,CAAC,WAAW,EAAE,CAAC;IACrE,OAAO,GAAG,EAAE;QACV,IAAI,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC;YAAE,OAAO,CAAC,WAAW,EAAE,CAAC;IAC9D,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { useEffect, useLayoutEffect, type RefObject } from \"react\";\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 * Synchronizes a non-modal surface with the browser manual Popover top layer.\n *\n * Unsupported browsers retain a fixed non-modal fallback by removing the unsupported attribute.\n * Cross-modal fallback is intentionally not promised by the frozen browser support contract.\n *\n * @param ref - Reference containing the Portal surface.\n * @param open - Whether the surface should be visible.\n * @param portalTarget - Current Portal destination used to synchronize remounts.\n */\nexport function useMiaixzManualPopover(\n  ref: RefObject<HTMLElement | null>,\n  open: boolean,\n  portalTarget: HTMLElement | null,\n): void {\n  useMiaixzClientLayoutEffect(() => {\n    const element = ref.current;\n    if (element === null) return undefined;\n    return synchronizeMiaixzManualPopover(element, open);\n  }, [open, portalTarget, ref]);\n}\n\n/**\n * Applies one top-layer state transition and returns exact teardown behavior.\n *\n * @param element - Connected or test-owned surface receiving top-layer state.\n * @param open - Whether the surface should be visible.\n * @returns Cleanup that hides the synchronized surface.\n */\nexport function synchronizeMiaixzManualPopover(element: HTMLElement, open: boolean): () => void {\n  if (typeof element.showPopover !== \"function\" || typeof element.hidePopover !== \"function\") {\n    element.removeAttribute(\"popover\");\n    element.hidden = !open;\n    element.toggleAttribute(\"data-miaixz-top-layer-fallback\", open);\n    return () => {\n      element.hidden = true;\n      element.removeAttribute(\"data-miaixz-top-layer-fallback\");\n    };\n  }\n\n  element.hidden = false;\n  if (open && !element.matches(\":popover-open\")) element.showPopover();\n  if (!open && element.matches(\":popover-open\")) element.hidePopover();\n  return () => {\n    if (element.matches(\":popover-open\")) element.hidePopover();\n  };\n}\n"]}

package/dist/internal/use-merged-ref.d.ts

@@ -0,0 +1,11 @@
+import type { ForwardedRef, RefCallback } from "react";
+/**
+ * Merges two callback or object refs into one stable React ref callback.
+ *
+ * @typeParam T - Value stored by the React refs.
+ * @param firstRef - First React ref that receives the value.
+ * @param secondRef - Second React ref that receives the value.
+ * @returns A ref callback that updates both source refs.
+ */
+export declare function useMergedRef<T>(firstRef: ForwardedRef<T>, secondRef: ForwardedRef<T>): RefCallback<T>;
+//# sourceMappingURL=use-merged-ref.d.ts.map

package/dist/internal/use-merged-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-merged-ref.d.ts","sourceRoot":"","sources":["../../src/internal/use-merged-ref.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAoB,WAAW,EAAE,MAAM,OAAO,CAAC;AAiBzE;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,GACzB,WAAW,CAAC,CAAC,CAAC,CAQhB"}

package/dist/internal/use-merged-ref.js

@@ -0,0 +1,31 @@
+import { useCallback } from "react";
+/**
+ * Assigns a value to either a callback ref or a mutable object ref.
+ *
+ * @typeParam T - Value stored by the React ref.
+ * @param ref - React ref that receives the value.
+ * @param value - Value assigned to the ref.
+ */
+function assignRef(ref, value) {
+    if (typeof ref === "function") {
+        ref(value);
+    }
+    else if (ref) {
+        ref.current = value;
+    }
+}
+/**
+ * Merges two callback or object refs into one stable React ref callback.
+ *
+ * @typeParam T - Value stored by the React refs.
+ * @param firstRef - First React ref that receives the value.
+ * @param secondRef - Second React ref that receives the value.
+ * @returns A ref callback that updates both source refs.
+ */
+export function useMergedRef(firstRef, secondRef) {
+    return useCallback((value) => {
+        assignRef(firstRef, value);
+        assignRef(secondRef, value);
+    }, [firstRef, secondRef]);
+}
+//# sourceMappingURL=use-merged-ref.js.map

package/dist/internal/use-merged-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-merged-ref.js","sourceRoot":"","sources":["../../src/internal/use-merged-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGpC;;;;;;GAMG;AACH,SAAS,SAAS,CAAI,GAAoB,EAAE,KAAQ;IAClD,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC9B,GAAG,CAAC,KAAK,CAAC,CAAC;IACb,CAAC;SAAM,IAAI,GAAG,EAAE,CAAC;QACd,GAA2B,CAAC,OAAO,GAAG,KAAK,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAyB,EACzB,SAA0B;IAE1B,OAAO,WAAW,CAChB,CAAC,KAAQ,EAAE,EAAE;QACX,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC,EACD,CAAC,QAAQ,EAAE,SAAS,CAAC,CACtB,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback } from \"react\";\nimport type { ForwardedRef, MutableRefObject, RefCallback } from \"react\";\n\n/**\n * Assigns a value to either a callback ref or a mutable object ref.\n *\n * @typeParam T - Value stored by the React ref.\n * @param ref - React ref that receives the value.\n * @param value - Value assigned to the ref.\n */\nfunction assignRef<T>(ref: ForwardedRef<T>, value: T): void {\n  if (typeof ref === \"function\") {\n    ref(value);\n  } else if (ref) {\n    (ref as MutableRefObject<T>).current = value;\n  }\n}\n\n/**\n * Merges two callback or object refs into one stable React ref callback.\n *\n * @typeParam T - Value stored by the React refs.\n * @param firstRef - First React ref that receives the value.\n * @param secondRef - Second React ref that receives the value.\n * @returns A ref callback that updates both source refs.\n */\nexport function useMergedRef<T>(\n  firstRef: ForwardedRef<T>,\n  secondRef: ForwardedRef<T>,\n): RefCallback<T> {\n  return useCallback(\n    (value: T) => {\n      assignRef(firstRef, value);\n      assignRef(secondRef, value);\n    },\n    [firstRef, secondRef],\n  );\n}\n"]}

package/dist/internal/use-native-dialog.d.ts

@@ -0,0 +1,9 @@
+import type { RefObject } from "react";
+/**
+ * Synchronizes a controlled React boolean with a native modal dialog.
+ *
+ * @param ref - Ref containing the native dialog element.
+ * @param open - Controlled modal open state.
+ */
+export declare function useNativeDialog(ref: RefObject<HTMLDialogElement | null>, open: boolean): void;
+//# sourceMappingURL=use-native-dialog.d.ts.map

package/dist/internal/use-native-dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-native-dialog.d.ts","sourceRoot":"","sources":["../../src/internal/use-native-dialog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAQ7F"}

package/dist/internal/use-native-dialog.js

@@ -0,0 +1,19 @@
+import { useEffect } from "react";
+/**
+ * Synchronizes a controlled React boolean with a native modal dialog.
+ *
+ * @param ref - Ref containing the native dialog element.
+ * @param open - Controlled modal open state.
+ */
+export function useNativeDialog(ref, open) {
+    useEffect(() => {
+        const dialog = ref.current;
+        if (!dialog)
+            return;
+        if (open && !dialog.open)
+            dialog.showModal();
+        if (!open && dialog.open)
+            dialog.close();
+    }, [open, ref]);
+}
+//# sourceMappingURL=use-native-dialog.js.map

package/dist/internal/use-native-dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-native-dialog.js","sourceRoot":"","sources":["../../src/internal/use-native-dialog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAwC,EAAE,IAAa;IACrF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC;QAC3B,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;YAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC3C,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;AAClB,CAAC","sourcesContent":["import { useEffect } from \"react\";\nimport type { RefObject } from \"react\";\n\n/**\n * Synchronizes a controlled React boolean with a native modal dialog.\n *\n * @param ref - Ref containing the native dialog element.\n * @param open - Controlled modal open state.\n */\nexport function useNativeDialog(ref: RefObject<HTMLDialogElement | null>, open: boolean): void {\n  useEffect(() => {\n    const dialog = ref.current;\n    if (!dialog) return;\n\n    if (open && !dialog.open) dialog.showModal();\n    if (!open && dialog.open) dialog.close();\n  }, [open, ref]);\n}\n"]}

package/dist/runtime/appearance.d.ts

@@ -0,0 +1,32 @@
+import { type MiaixzAppearanceSettings, type MiaixzColorMode, type MiaixzResolvedColorMode } from "@miaixz/sdk/appearance";
+export { isMiaixzAppearanceSettings, isMiaixzColorMode, isMiaixzDensity, miaixzColorModes, miaixzDarkThemeColors, miaixzDefaultAppearance, miaixzDensities, miaixzLightThemeColors, miaixzThemeColorTokens, parseMiaixzAppearanceSettings, validateMiaixzThemeContrast, } from "@miaixz/sdk/appearance";
+export type { MiaixzAppearancePayload, MiaixzAppearanceSettings, MiaixzColorMode, MiaixzDensity, MiaixzResolvedColorMode, MiaixzThemeColors, MiaixzThemeColorToken, } from "@miaixz/sdk/appearance";
+/**
+ * Resolves a color preference to a concrete light or dark mode.
+ *
+ * @param colorMode - Configured light, dark, or system preference.
+ * @param prefersDark - Optional explicit system dark-mode result.
+ * @returns Concrete light or dark mode.
+ * @public
+ */
+export declare function resolveMiaixzColorMode(colorMode: MiaixzColorMode, prefersDark?: boolean): MiaixzResolvedColorMode;
+/**
+ * Validates and atomically applies appearance attributes and custom colors to a DOM target.
+ *
+ * @param appearance - Appearance settings to validate and apply.
+ * @param target - Optional target element, null for resolution without DOM writes.
+ * @param prefersDark - Optional explicit system dark-mode result.
+ * @returns Concrete light or dark mode applied or resolved.
+ * @throws MiaixzSdkError When the appearance syntax, colors, or contrast are invalid.
+ * @public
+ */
+export declare function applyMiaixzAppearance(appearance: Readonly<MiaixzAppearanceSettings>, target?: HTMLElement | null, prefersDark?: boolean): MiaixzResolvedColorMode;
+/**
+ * Watches operating-system color preference changes in supported browsers.
+ *
+ * @param listener - Callback invoked with each changed concrete color mode.
+ * @returns An idempotent function that removes the system listener.
+ * @public
+ */
+export declare function watchMiaixzSystemColorMode(listener: (mode: MiaixzResolvedColorMode) => void): () => void;
+//# sourceMappingURL=appearance.d.ts.map

package/dist/runtime/appearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appearance.d.ts","sourceRoot":"","sources":["../../src/runtime/appearance.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,0BAA0B,EAC1B,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,eAAe,EAC1B,WAAW,UAA6B,GACvC,uBAAuB,CAEzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,QAAQ,CAAC,wBAAwB,CAAC,EAC9C,MAAM,GAAE,WAAW,GAAG,IAAwE,EAC9F,WAAW,CAAC,EAAE,OAAO,GACpB,uBAAuB,CAqCzB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,IAAI,GAChD,MAAM,IAAI,CAmBZ"}