@miaixz/ui 0.5.0

package/dist/components/textarea/textarea.types.d.ts

@@ -0,0 +1,39 @@
+import type { TextareaHTMLAttributes } from "react";
+/**
+ * Defines the supported multiline control sizes.
+ *
+ * @public
+ */
+export type TextareaSize = "small" | "medium" | "large";
+/**
+ * Defines the browser resize directions enabled for a textarea.
+ *
+ * @public
+ */
+export type TextareaResize = "none" | "vertical" | "horizontal" | "both";
+/**
+ * Configures a multiline native text control.
+ *
+ * @public
+ */
+export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
+    /**
+     * Selects the control size.
+     *
+     * @defaultValue `"medium"`
+     */
+    size?: TextareaSize;
+    /**
+     * Applies the invalid state independently of `aria-invalid`.
+     *
+     * @defaultValue `false`
+     */
+    invalid?: boolean;
+    /**
+     * Selects the browser resize directions.
+     *
+     * @defaultValue `"vertical"`
+     */
+    resize?: TextareaResize;
+}
+//# sourceMappingURL=textarea.types.d.ts.map

package/dist/components/textarea/textarea.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea.types.d.ts","sourceRoot":"","sources":["../../../src/components/textarea/textarea.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAC;AAEpD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,sBAAsB,CAAC,mBAAmB,CAAC;IAChF;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB"}

package/dist/components/textarea/textarea.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=textarea.types.js.map

package/dist/components/textarea/textarea.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea.types.js","sourceRoot":"","sources":["../../../src/components/textarea/textarea.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TextareaHTMLAttributes } from \"react\";\n\n/**\n * Defines the supported multiline control sizes.\n *\n * @public\n */\nexport type TextareaSize = \"small\" | \"medium\" | \"large\";\n\n/**\n * Defines the browser resize directions enabled for a textarea.\n *\n * @public\n */\nexport type TextareaResize = \"none\" | \"vertical\" | \"horizontal\" | \"both\";\n\n/**\n * Configures a multiline native text control.\n *\n * @public\n */\nexport interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {\n  /**\n   * Selects the control size.\n   *\n   * @defaultValue `\"medium\"`\n   */\n  size?: TextareaSize;\n  /**\n   * Applies the invalid state independently of `aria-invalid`.\n   *\n   * @defaultValue `false`\n   */\n  invalid?: boolean;\n  /**\n   * Selects the browser resize directions.\n   *\n   * @defaultValue `\"vertical\"`\n   */\n  resize?: TextareaResize;\n}\n"]}

package/dist/components/toast/index.d.ts

@@ -0,0 +1,3 @@
+export { Toast, ToastProvider, useToast } from "./toast.js";
+export type { ToastContextValue, ToastOptions, ToastProps, ToastProviderProps, ToastRecord, ToastTone, } from "./toast.types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/toast/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/toast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,SAAS,GACV,MAAM,kBAAkB,CAAC"}

package/dist/components/toast/index.js

@@ -0,0 +1,2 @@
+export { Toast, ToastProvider, useToast } from "./toast.js";
+//# sourceMappingURL=index.js.map

package/dist/components/toast/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/toast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { Toast, ToastProvider, useToast } from \"./toast.js\";\nexport type {\n  ToastContextValue,\n  ToastOptions,\n  ToastProps,\n  ToastProviderProps,\n  ToastRecord,\n  ToastTone,\n} from \"./toast.types.js\";\n"]}

package/dist/components/toast/toast.d.ts

@@ -0,0 +1,24 @@
+import type { ToastContextValue, ToastProps, ToastProviderProps } from "./toast.types.js";
+/**
+ * Renders one localized live-region notification with optional action and dismissal.
+ *
+ * @public
+ */
+export declare const Toast: import("react").ForwardRefExoticComponent<ToastProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Owns the application toast queue and renders it into the document portal.
+ *
+ * @param props - Toast provider configuration.
+ * @returns The provider subtree and client-side toast portal.
+ * @public
+ */
+export declare function ToastProvider({ children, defaultDuration }: ToastProviderProps): import("react").JSX.Element;
+/**
+ * Returns the nearest toast controller.
+ *
+ * @returns The nearest toast queue controller.
+ * @throws A localized error when called outside {@link ToastProvider}.
+ * @public
+ */
+export declare function useToast(): ToastContextValue;
+//# sourceMappingURL=toast.d.ts.map

package/dist/components/toast/toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toast.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,iBAAiB,EAEjB,UAAU,EACV,kBAAkB,EAGnB,MAAM,kBAAkB,CAAC;AAuC1B;;;;GAIG;AACH,eAAO,MAAM,KAAK,uGAqChB,CAAC;AAmBH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,eAAsB,EAAE,EAAE,kBAAkB,+BAiDrF;AAGD;;;;;;GAMG;AACH,wBAAgB,QAAQ,IAAI,iBAAiB,CAU5C"}

package/dist/components/toast/toast.js

@@ -0,0 +1,111 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, forwardRef, useContext, useEffect, useMemo, useRef, useState } from "react";
+import { createPortal } from "react-dom";
+import { createMiaixzUiError } from "../../errors/index.js";
+import { classNames } from "../../internal/class-names.js";
+import { useMiaixzManualPopover, useMiaixzPortalTarget } from "../../internal/overlay/index.js";
+import { useMiaixzLocale } from "../../i18n/index.js";
+import { Button } from "../button/index.js";
+import { Icon } from "../icon/index.js";
+const ToastContext = createContext(undefined);
+let toastSequence = 0;
+/**
+ * Freezes the maximum number of simultaneously visible notifications.
+ */
+const miaixzMaximumVisibleToasts = 5;
+/**
+ * Creates a collision-resistant identifier for an in-memory notification.
+ *
+ * @returns A process-local toast identifier.
+ */
+function createToastId() {
+    toastSequence += 1;
+    return `miaixz-toast-${Date.now()}-${toastSequence}`;
+}
+const toneIcons = {
+    neutral: "Info",
+    success: "CircleCheck",
+    warning: "TriangleAlert",
+    danger: "CircleAlert",
+    info: "Info",
+};
+/**
+ * Renders one localized live-region notification with optional action and dismissal.
+ *
+ * @public
+ */
+export const Toast = forwardRef(function Toast({ id, title, message, action, tone = "neutral", dismissLabel, onDismiss, className, ...props }, ref) {
+    const { t } = useMiaixzLocale();
+    const resolvedDismissLabel = dismissLabel ?? t("ui.notification.dismiss");
+    return (_jsxs("div", { ...props, ref: ref, role: tone === "danger" ? "alert" : "status", className: classNames("miaixz-toast", tone !== "neutral" && `miaixz-toast-${tone}`, className), children: [_jsx(Icon, { name: toneIcons[tone], size: "control", className: "miaixz-toast-icon" }), _jsxs("div", { className: "miaixz-toast-content", children: [_jsx("p", { className: "miaixz-toast-title", children: title }), message !== undefined && _jsx("p", { className: "miaixz-toast-message", children: message }), action !== undefined && _jsx("div", { className: "miaixz-toast-actions", children: action })] }), onDismiss && (_jsx(Button, { iconOnly: true, variant: "ghost", size: "small", "aria-label": resolvedDismissLabel, className: "miaixz-toast-dismiss", onClick: () => onDismiss(id), children: _jsx(Icon, { name: "X", size: "control" }) }))] }));
+});
+/* eslint-disable jsdoc/check-param-names, jsdoc/require-param -- TSDoc documents the typed properties instead of dotted parameter names. */
+/**
+ * Applies auto-dismiss lifecycle behavior to one toast record.
+ *
+ * @param props - Managed toast configuration.
+ * @returns The managed toast element.
+ */
+function ManagedToast({ toast, dismiss }) {
+    useEffect(() => {
+        if (!toast.duration || toast.duration <= 0)
+            return;
+        const timer = window.setTimeout(() => dismiss(toast.id), toast.duration);
+        return () => window.clearTimeout(timer);
+    }, [dismiss, toast.duration, toast.id]);
+    return _jsx(Toast, { ...toast, onDismiss: dismiss });
+}
+/**
+ * Owns the application toast queue and renders it into the document portal.
+ *
+ * @param props - Toast provider configuration.
+ * @returns The provider subtree and client-side toast portal.
+ * @public
+ */
+export function ToastProvider({ children, defaultDuration = 5000 }) {
+    const [toasts, setToasts] = useState([]);
+    const regionRef = useRef(null);
+    const portalTarget = useMiaixzPortalTarget(null, true);
+    const hasVisibleToasts = toasts.length > 0;
+    const visibleToasts = toasts.slice(0, miaixzMaximumVisibleToasts);
+    useMiaixzManualPopover(regionRef, hasVisibleToasts, portalTarget);
+    const context = useMemo(() => ({
+        notify(options) {
+            const id = options.id ?? createToastId();
+            setToasts((current) => [
+                ...current.filter((toast) => toast.id !== id),
+                { ...options, id, duration: options.duration ?? defaultDuration },
+            ]);
+            return id;
+        },
+        dismiss(id) {
+            setToasts((current) => current.filter((toast) => toast.id !== id));
+        },
+        dismissAll() {
+            setToasts([]);
+        },
+    }), [defaultDuration]);
+    return (_jsxs(ToastContext.Provider, { value: context, children: [children, hasVisibleToasts &&
+                portalTarget !== null &&
+                createPortal(_jsx("div", { ref: regionRef, popover: "manual", className: "miaixz-toast-region", "aria-live": "polite", "aria-relevant": "additions removals", children: visibleToasts.map((toast) => (_jsx(ManagedToast, { toast: toast, dismiss: context.dismiss }, toast.id))) }), portalTarget)] }));
+}
+/* eslint-enable jsdoc/check-param-names, jsdoc/require-param */
+/**
+ * Returns the nearest toast controller.
+ *
+ * @returns The nearest toast queue controller.
+ * @throws A localized error when called outside {@link ToastProvider}.
+ * @public
+ */
+export function useToast() {
+    const { t } = useMiaixzLocale();
+    const context = useContext(ToastContext);
+    if (!context) {
+        throw createMiaixzUiError(t, {
+            code: "UI_TOAST_PROVIDER_MISSING",
+            messageKey: "ui.error.toast.providerMissing",
+        });
+    }
+    return context;
+}
+//# sourceMappingURL=toast.js.map

package/dist/components/toast/toast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.js","sourceRoot":"","sources":["../../../src/components/toast/toast.tsx"],"names":[],"mappings":"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","sourcesContent":["import { createContext, forwardRef, useContext, useEffect, useMemo, useRef, useState } from \"react\";\nimport { createPortal } from \"react-dom\";\n\nimport { createMiaixzUiError } from \"../../errors/index.js\";\nimport { classNames } from \"../../internal/class-names.js\";\nimport { useMiaixzManualPopover, useMiaixzPortalTarget } from \"../../internal/overlay/index.js\";\nimport { useMiaixzLocale } from \"../../i18n/index.js\";\nimport { Button } from \"../button/index.js\";\nimport { Icon } from \"../icon/index.js\";\nimport type {\n  ToastContextValue,\n  ToastOptions,\n  ToastProps,\n  ToastProviderProps,\n  ToastRecord,\n  ToastTone,\n} from \"./toast.types.js\";\n\nconst ToastContext = createContext<ToastContextValue | undefined>(undefined);\nlet toastSequence = 0;\n\n/**\n * Freezes the maximum number of simultaneously visible notifications.\n */\nconst miaixzMaximumVisibleToasts = 5;\n\n/**\n * Creates a collision-resistant identifier for an in-memory notification.\n *\n * @returns A process-local toast identifier.\n */\nfunction createToastId(): string {\n  toastSequence += 1;\n  return `miaixz-toast-${Date.now()}-${toastSequence}`;\n}\n\nconst toneIcons: Record<ToastTone, \"Info\" | \"CircleCheck\" | \"TriangleAlert\" | \"CircleAlert\"> = {\n  neutral: \"Info\",\n  success: \"CircleCheck\",\n  warning: \"TriangleAlert\",\n  danger: \"CircleAlert\",\n  info: \"Info\",\n};\n\ninterface ManagedToastProps {\n  /**\n   * Supplies the toast record to render and schedule.\n   */\n  toast: ToastRecord;\n  /**\n   * Supplies the queue operation used to dismiss the toast.\n   */\n  dismiss: (id: string) => void;\n}\n\n/**\n * Renders one localized live-region notification with optional action and dismissal.\n *\n * @public\n */\nexport const Toast = forwardRef<HTMLDivElement, ToastProps>(function Toast(\n  { id, title, message, action, tone = \"neutral\", dismissLabel, onDismiss, className, ...props },\n  ref,\n) {\n  const { t } = useMiaixzLocale();\n  const resolvedDismissLabel = dismissLabel ?? t(\"ui.notification.dismiss\");\n  return (\n    <div\n      {...props}\n      ref={ref}\n      role={tone === \"danger\" ? \"alert\" : \"status\"}\n      className={classNames(\n        \"miaixz-toast\",\n        tone !== \"neutral\" && `miaixz-toast-${tone}`,\n        className,\n      )}\n    >\n      <Icon name={toneIcons[tone]} size=\"control\" className=\"miaixz-toast-icon\" />\n      <div className=\"miaixz-toast-content\">\n        <p className=\"miaixz-toast-title\">{title}</p>\n        {message !== undefined && <p className=\"miaixz-toast-message\">{message}</p>}\n        {action !== undefined && <div className=\"miaixz-toast-actions\">{action}</div>}\n      </div>\n      {onDismiss && (\n        <Button\n          iconOnly\n          variant=\"ghost\"\n          size=\"small\"\n          aria-label={resolvedDismissLabel}\n          className=\"miaixz-toast-dismiss\"\n          onClick={() => onDismiss(id)}\n        >\n          <Icon name=\"X\" size=\"control\" />\n        </Button>\n      )}\n    </div>\n  );\n});\n\n/* eslint-disable jsdoc/check-param-names, jsdoc/require-param -- TSDoc documents the typed properties instead of dotted parameter names. */\n/**\n * Applies auto-dismiss lifecycle behavior to one toast record.\n *\n * @param props - Managed toast configuration.\n * @returns The managed toast element.\n */\nfunction ManagedToast({ toast, dismiss }: ManagedToastProps) {\n  useEffect(() => {\n    if (!toast.duration || toast.duration <= 0) return;\n    const timer = window.setTimeout(() => dismiss(toast.id), toast.duration);\n    return () => window.clearTimeout(timer);\n  }, [dismiss, toast.duration, toast.id]);\n\n  return <Toast {...toast} onDismiss={dismiss} />;\n}\n\n/**\n * Owns the application toast queue and renders it into the document portal.\n *\n * @param props - Toast provider configuration.\n * @returns The provider subtree and client-side toast portal.\n * @public\n */\nexport function ToastProvider({ children, defaultDuration = 5000 }: ToastProviderProps) {\n  const [toasts, setToasts] = useState<ToastRecord[]>([]);\n  const regionRef = useRef<HTMLDivElement>(null);\n  const portalTarget = useMiaixzPortalTarget(null, true);\n  const hasVisibleToasts = toasts.length > 0;\n  const visibleToasts = toasts.slice(0, miaixzMaximumVisibleToasts);\n  useMiaixzManualPopover(regionRef, hasVisibleToasts, portalTarget);\n\n  const context = useMemo<ToastContextValue>(\n    () => ({\n      notify(options: ToastOptions) {\n        const id = options.id ?? createToastId();\n        setToasts((current) => [\n          ...current.filter((toast) => toast.id !== id),\n          { ...options, id, duration: options.duration ?? defaultDuration },\n        ]);\n        return id;\n      },\n      dismiss(id: string) {\n        setToasts((current) => current.filter((toast) => toast.id !== id));\n      },\n      dismissAll() {\n        setToasts([]);\n      },\n    }),\n    [defaultDuration],\n  );\n\n  return (\n    <ToastContext.Provider value={context}>\n      {children}\n      {hasVisibleToasts &&\n        portalTarget !== null &&\n        createPortal(\n          <div\n            ref={regionRef}\n            popover=\"manual\"\n            className=\"miaixz-toast-region\"\n            aria-live=\"polite\"\n            aria-relevant=\"additions removals\"\n          >\n            {visibleToasts.map((toast) => (\n              <ManagedToast key={toast.id} toast={toast} dismiss={context.dismiss} />\n            ))}\n          </div>,\n          portalTarget,\n        )}\n    </ToastContext.Provider>\n  );\n}\n/* eslint-enable jsdoc/check-param-names, jsdoc/require-param */\n\n/**\n * Returns the nearest toast controller.\n *\n * @returns The nearest toast queue controller.\n * @throws A localized error when called outside {@link ToastProvider}.\n * @public\n */\nexport function useToast(): ToastContextValue {\n  const { t } = useMiaixzLocale();\n  const context = useContext(ToastContext);\n  if (!context) {\n    throw createMiaixzUiError(t, {\n      code: \"UI_TOAST_PROVIDER_MISSING\",\n      messageKey: \"ui.error.toast.providerMissing\",\n    });\n  }\n  return context;\n}\n"]}

package/dist/components/toast/toast.types.d.ts

@@ -0,0 +1,103 @@
+import type { HTMLAttributes, ReactNode } from "react";
+/**
+ * Defines the semantic treatment and live-region priority of a toast.
+ *
+ * @public
+ */
+export type ToastTone = "neutral" | "success" | "warning" | "danger" | "info";
+/**
+ * Configures a notification submitted to the toast provider.
+ *
+ * @public
+ */
+export interface ToastOptions {
+    /**
+     * Supplies a stable identifier for replacing or dismissing the toast.
+     */
+    id?: string;
+    /**
+     * Supplies the required notification title.
+     */
+    title: ReactNode;
+    /**
+     * Supplies optional notification detail content.
+     */
+    message?: ReactNode;
+    /**
+     * Displays an optional notification action.
+     */
+    action?: ReactNode;
+    /**
+     * Selects the semantic notification treatment.
+     *
+     * @defaultValue `"neutral"`
+     */
+    tone?: ToastTone;
+    /**
+     * Sets the auto-dismiss delay in milliseconds, or disables it with zero.
+     */
+    duration?: number;
+    /**
+     * Overrides the localized dismissal label.
+     */
+    dismissLabel?: string;
+}
+/**
+ * Represents a toast with its required provider-assigned identifier.
+ *
+ * @public
+ */
+export interface ToastRecord extends ToastOptions {
+    /**
+     * Identifies the toast within the provider queue.
+     */
+    id: string;
+}
+/**
+ * Configures a rendered toast notification.
+ *
+ * @public
+ */
+export interface ToastProps extends Omit<HTMLAttributes<HTMLDivElement>, "id" | "title">, ToastRecord {
+    /**
+     * Receives a request to dismiss the identified toast.
+     */
+    onDismiss?: (id: string) => void;
+}
+/**
+ * Configures the application toast queue provider.
+ *
+ * @public
+ */
+export interface ToastProviderProps {
+    /**
+     * Supplies the application subtree that can submit notifications.
+     */
+    children: ReactNode;
+    /**
+     * Sets the fallback auto-dismiss delay in milliseconds.
+     *
+     * @defaultValue `5000`
+     */
+    defaultDuration?: number;
+}
+/**
+ * Exposes imperative operations for the nearest toast queue.
+ *
+ * @public
+ */
+export interface ToastContextValue {
+    /**
+     * Adds or replaces a toast and returns its identifier.
+     */
+    notify: (options: ToastOptions) => string;
+    /**
+     * Dismisses one toast by identifier.
+     */
+    dismiss: (id: string) => void;
+    /**
+     * Dismisses every toast in the queue.
+     */
+    dismissAll: () => void;
+}
+//# sourceMappingURL=toast.types.d.ts.map

package/dist/components/toast/toast.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.types.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toast.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9E;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,EAAE,WAAW;IACzE;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,MAAM,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,MAAM,CAAC;IAC1C;;OAEG;IACH,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB"}

package/dist/components/toast/toast.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=toast.types.js.map

package/dist/components/toast/toast.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.types.js","sourceRoot":"","sources":["../../../src/components/toast/toast.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { HTMLAttributes, ReactNode } from \"react\";\n\n/**\n * Defines the semantic treatment and live-region priority of a toast.\n *\n * @public\n */\nexport type ToastTone = \"neutral\" | \"success\" | \"warning\" | \"danger\" | \"info\";\n\n/**\n * Configures a notification submitted to the toast provider.\n *\n * @public\n */\nexport interface ToastOptions {\n  /**\n   * Supplies a stable identifier for replacing or dismissing the toast.\n   */\n  id?: string;\n  /**\n   * Supplies the required notification title.\n   */\n  title: ReactNode;\n  /**\n   * Supplies optional notification detail content.\n   */\n  message?: ReactNode;\n  /**\n   * Displays an optional notification action.\n   */\n  action?: ReactNode;\n  /**\n   * Selects the semantic notification treatment.\n   *\n   * @defaultValue `\"neutral\"`\n   */\n  tone?: ToastTone;\n  /**\n   * Sets the auto-dismiss delay in milliseconds, or disables it with zero.\n   */\n  duration?: number;\n  /**\n   * Overrides the localized dismissal label.\n   */\n  dismissLabel?: string;\n}\n\n/**\n * Represents a toast with its required provider-assigned identifier.\n *\n * @public\n */\nexport interface ToastRecord extends ToastOptions {\n  /**\n   * Identifies the toast within the provider queue.\n   */\n  id: string;\n}\n\n/**\n * Configures a rendered toast notification.\n *\n * @public\n */\nexport interface ToastProps\n  extends Omit<HTMLAttributes<HTMLDivElement>, \"id\" | \"title\">, ToastRecord {\n  /**\n   * Receives a request to dismiss the identified toast.\n   */\n  onDismiss?: (id: string) => void;\n}\n\n/**\n * Configures the application toast queue provider.\n *\n * @public\n */\nexport interface ToastProviderProps {\n  /**\n   * Supplies the application subtree that can submit notifications.\n   */\n  children: ReactNode;\n  /**\n   * Sets the fallback auto-dismiss delay in milliseconds.\n   *\n   * @defaultValue `5000`\n   */\n  defaultDuration?: number;\n}\n\n/**\n * Exposes imperative operations for the nearest toast queue.\n *\n * @public\n */\nexport interface ToastContextValue {\n  /**\n   * Adds or replaces a toast and returns its identifier.\n   */\n  notify: (options: ToastOptions) => string;\n  /**\n   * Dismisses one toast by identifier.\n   */\n  dismiss: (id: string) => void;\n  /**\n   * Dismisses every toast in the queue.\n   */\n  dismissAll: () => void;\n}\n"]}

package/dist/components/toolbar/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./toolbar.js";
+export type * from "./toolbar.types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/toolbar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/toolbar/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,mBAAmB,oBAAoB,CAAC"}

package/dist/components/toolbar/index.js

@@ -0,0 +1,2 @@
+export * from "./toolbar.js";
+//# sourceMappingURL=index.js.map

package/dist/components/toolbar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/toolbar/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC","sourcesContent":["export * from \"./toolbar.js\";\nexport type * from \"./toolbar.types.js\";\n"]}

package/dist/components/toolbar/toolbar.d.ts

@@ -0,0 +1,20 @@
+import type { ToolbarGroupProps, ToolbarProps, ToolbarSpacerProps } from "./toolbar.types.js";
+/**
+ * Renders a labeled toolbar for a related set of controls.
+ *
+ * @public
+ */
+export declare const Toolbar: import("react").ForwardRefExoticComponent<ToolbarProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Groups related toolbar controls with consistent spacing.
+ *
+ * @public
+ */
+export declare const ToolbarGroup: import("react").ForwardRefExoticComponent<ToolbarGroupProps & import("react").RefAttributes<HTMLDivElement>>;
+/**
+ * Consumes available toolbar space to separate control groups.
+ *
+ * @public
+ */
+export declare const ToolbarSpacer: import("react").ForwardRefExoticComponent<ToolbarSpacerProps & import("react").RefAttributes<HTMLSpanElement>>;
+//# sourceMappingURL=toolbar.d.ts.map

package/dist/components/toolbar/toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.d.ts","sourceRoot":"","sources":["../../../src/components/toolbar/toolbar.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE9F;;;;GAIG;AACH,eAAO,MAAM,OAAO,yGAelB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,8GAavB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa,gHAYxB,CAAC"}

package/dist/components/toolbar/toolbar.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import { classNames } from "../../internal/class-names.js";
+/**
+ * Renders a labeled toolbar for a related set of controls.
+ *
+ * @public
+ */
+export const Toolbar = forwardRef(function Toolbar({ label, orientation = "horizontal", className, ...props }, ref) {
+    return (_jsx("div", { ...props, ref: ref, role: "toolbar", "aria-label": label, "aria-orientation": orientation, "data-orientation": orientation, className: classNames("miaixz-toolbar", className) }));
+});
+/**
+ * Groups related toolbar controls with consistent spacing.
+ *
+ * @public
+ */
+export const ToolbarGroup = forwardRef(function ToolbarGroup({ label, className, ...props }, ref) {
+    return (_jsx("div", { ...props, ref: ref, role: "group", "aria-label": label, className: classNames("miaixz-toolbar-group", className) }));
+});
+/**
+ * Consumes available toolbar space to separate control groups.
+ *
+ * @public
+ */
+export const ToolbarSpacer = forwardRef(function ToolbarSpacer({ className, "aria-hidden": ariaHidden = true, ...props }, ref) {
+    return (_jsx("span", { ...props, ref: ref, "aria-hidden": ariaHidden, className: classNames("miaixz-toolbar-spacer", className) }));
+});
+//# sourceMappingURL=toolbar.js.map

package/dist/components/toolbar/toolbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.js","sourceRoot":"","sources":["../../../src/components/toolbar/toolbar.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAG3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,CAA+B,SAAS,OAAO,CAC9E,EAAE,KAAK,EAAE,WAAW,GAAG,YAAY,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAC1D,GAAG;IAEH,OAAO,CACL,iBACM,KAAK,EACT,GAAG,EAAE,GAAG,EACR,IAAI,EAAC,SAAS,gBACF,KAAK,sBACC,WAAW,sBACX,WAAW,EAC7B,SAAS,EAAE,UAAU,CAAC,gBAAgB,EAAE,SAAS,CAAC,GAClD,CACH,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAoC,SAAS,YAAY,CAC7F,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAC9B,GAAG;IAEH,OAAO,CACL,iBACM,KAAK,EACT,GAAG,EAAE,GAAG,EACR,IAAI,EAAC,OAAO,gBACA,KAAK,EACjB,SAAS,EAAE,UAAU,CAAC,sBAAsB,EAAE,SAAS,CAAC,GACxD,CACH,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAsC,SAAS,aAAa,CACjG,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,EACzD,GAAG;IAEH,OAAO,CACL,kBACM,KAAK,EACT,GAAG,EAAE,GAAG,iBACK,UAAU,EACvB,SAAS,EAAE,UAAU,CAAC,uBAAuB,EAAE,SAAS,CAAC,GACzD,CACH,CAAC;AACJ,CAAC,CAAC,CAAC","sourcesContent":["import { forwardRef } from \"react\";\n\nimport { classNames } from \"../../internal/class-names.js\";\nimport type { ToolbarGroupProps, ToolbarProps, ToolbarSpacerProps } from \"./toolbar.types.js\";\n\n/**\n * Renders a labeled toolbar for a related set of controls.\n *\n * @public\n */\nexport const Toolbar = forwardRef<HTMLDivElement, ToolbarProps>(function Toolbar(\n  { label, orientation = \"horizontal\", className, ...props },\n  ref,\n) {\n  return (\n    <div\n      {...props}\n      ref={ref}\n      role=\"toolbar\"\n      aria-label={label}\n      aria-orientation={orientation}\n      data-orientation={orientation}\n      className={classNames(\"miaixz-toolbar\", className)}\n    />\n  );\n});\n\n/**\n * Groups related toolbar controls with consistent spacing.\n *\n * @public\n */\nexport const ToolbarGroup = forwardRef<HTMLDivElement, ToolbarGroupProps>(function ToolbarGroup(\n  { label, className, ...props },\n  ref,\n) {\n  return (\n    <div\n      {...props}\n      ref={ref}\n      role=\"group\"\n      aria-label={label}\n      className={classNames(\"miaixz-toolbar-group\", className)}\n    />\n  );\n});\n\n/**\n * Consumes available toolbar space to separate control groups.\n *\n * @public\n */\nexport const ToolbarSpacer = forwardRef<HTMLSpanElement, ToolbarSpacerProps>(function ToolbarSpacer(\n  { className, \"aria-hidden\": ariaHidden = true, ...props },\n  ref,\n) {\n  return (\n    <span\n      {...props}\n      ref={ref}\n      aria-hidden={ariaHidden}\n      className={classNames(\"miaixz-toolbar-spacer\", className)}\n    />\n  );\n});\n"]}

package/dist/components/toolbar/toolbar.types.d.ts

@@ -0,0 +1,37 @@
+import type { HTMLAttributes } from "react";
+/**
+ * Configures an accessible group of related controls.
+ *
+ * @public
+ */
+export interface ToolbarProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Provides the required accessible toolbar label.
+     */
+    label: string;
+    /**
+     * Selects the control flow direction and keyboard metadata.
+     *
+     * @defaultValue `"horizontal"`
+     */
+    orientation?: "horizontal" | "vertical";
+}
+/**
+ * Configures a labeled subgroup within a toolbar.
+ *
+ * @public
+ */
+export interface ToolbarGroupProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Provides an accessible group label when needed.
+     */
+    label?: string;
+}
+/**
+ * Configures a flexible spacer between toolbar groups.
+ *
+ * @public
+ */
+export interface ToolbarSpacerProps extends HTMLAttributes<HTMLSpanElement> {
+}
+//# sourceMappingURL=toolbar.types.d.ts.map

package/dist/components/toolbar/toolbar.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.types.d.ts","sourceRoot":"","sources":["../../../src/components/toolbar/toolbar.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,cAAc,CAAC,cAAc,CAAC;IAClE;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;CACzC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACvE;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc,CAAC,eAAe,CAAC;CAAG"}

package/dist/components/toolbar/toolbar.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=toolbar.types.js.map

package/dist/components/toolbar/toolbar.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.types.js","sourceRoot":"","sources":["../../../src/components/toolbar/toolbar.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { HTMLAttributes } from \"react\";\n\n/**\n * Configures an accessible group of related controls.\n *\n * @public\n */\nexport interface ToolbarProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * Provides the required accessible toolbar label.\n   */\n  label: string;\n  /**\n   * Selects the control flow direction and keyboard metadata.\n   *\n   * @defaultValue `\"horizontal\"`\n   */\n  orientation?: \"horizontal\" | \"vertical\";\n}\n\n/**\n * Configures a labeled subgroup within a toolbar.\n *\n * @public\n */\nexport interface ToolbarGroupProps extends HTMLAttributes<HTMLDivElement> {\n  /**\n   * Provides an accessible group label when needed.\n   */\n  label?: string;\n}\n\n/**\n * Configures a flexible spacer between toolbar groups.\n *\n * @public\n */\nexport interface ToolbarSpacerProps extends HTMLAttributes<HTMLSpanElement> {}\n"]}

package/dist/components/tooltip/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./tooltip.js";
+export type * from "./tooltip.types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/tooltip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,mBAAmB,oBAAoB,CAAC"}

package/dist/components/tooltip/index.js

@@ -0,0 +1,2 @@
+export * from "./tooltip.js";
+//# sourceMappingURL=index.js.map

package/dist/components/tooltip/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/tooltip/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC","sourcesContent":["export * from \"./tooltip.js\";\nexport type * from \"./tooltip.types.js\";\n"]}

package/dist/components/tooltip/tooltip.d.ts

@@ -0,0 +1,8 @@
+import type { TooltipProps } from "./tooltip.types.js";
+/**
+ * Associates concise contextual help with an interactive or informational child.
+ *
+ * @public
+ */
+export declare const Tooltip: import("react").ForwardRefExoticComponent<TooltipProps & import("react").RefAttributes<HTMLSpanElement>>;
+//# sourceMappingURL=tooltip.d.ts.map

package/dist/components/tooltip/tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/tooltip.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvD;;;;GAIG;AACH,eAAO,MAAM,OAAO,0GA0GlB,CAAC"}

package/dist/components/tooltip/tooltip.js

@@ -0,0 +1,84 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cloneElement, forwardRef, useCallback, useEffect, useId, useRef, useState } from "react";
+import { createPortal } from "react-dom";
+import { classNames } from "../../internal/class-names.js";
+import { useMiaixzDismissibleLayer, useMiaixzFloatingPosition, useMiaixzManualPopover, useMiaixzPortalTarget, } from "../../internal/overlay/index.js";
+import { useMergedRef } from "../../internal/use-merged-ref.js";
+/**
+ * Freezes the WAI-ARIA Tooltip show delay in milliseconds.
+ */
+const miaixzTooltipShowDelay = 300;
+/**
+ * Associates concise contextual help with an interactive or informational child.
+ *
+ * @public
+ */
+export const Tooltip = forwardRef(function Tooltip({ content, children, placement = "top", className, onPointerEnter, onPointerLeave, onFocus, onBlur, ...props }, forwardedRef) {
+    const tooltipId = useId();
+    const describedBy = [children.props["aria-describedby"], tooltipId].filter(Boolean).join(" ");
+    const wrapperRef = useRef(null);
+    const [wrapperElement, setWrapperElement] = useState(null);
+    const contentRef = useRef(null);
+    const captureWrapper = useCallback((element) => {
+        wrapperRef.current = element;
+        setWrapperElement(element);
+    }, []);
+    const ref = useMergedRef(forwardedRef, captureWrapper);
+    const timerRef = useRef(undefined);
+    const hoveredRef = useRef(false);
+    const focusedRef = useRef(false);
+    const [visible, setVisible] = useState(false);
+    const portalTarget = useMiaixzPortalTarget(wrapperElement);
+    const clearTimer = () => {
+        if (timerRef.current === undefined)
+            return;
+        window.clearTimeout(timerRef.current);
+        timerRef.current = undefined;
+    };
+    const scheduleShow = () => {
+        clearTimer();
+        timerRef.current = window.setTimeout(() => {
+            timerRef.current = undefined;
+            if (hoveredRef.current || focusedRef.current)
+                setVisible(true);
+        }, miaixzTooltipShowDelay);
+    };
+    const hideImmediately = () => {
+        clearTimer();
+        if (!hoveredRef.current && !focusedRef.current)
+            setVisible(false);
+    };
+    useMiaixzManualPopover(contentRef, visible, portalTarget);
+    useMiaixzFloatingPosition(wrapperRef, contentRef, visible, placement, portalTarget);
+    useMiaixzDismissibleLayer({
+        active: visible,
+        triggerRef: wrapperRef,
+        contentRef,
+        portalTarget,
+        onDismiss: () => {
+            clearTimer();
+            setVisible(false);
+        },
+    });
+    useEffect(() => clearTimer, []);
+    return (_jsxs("span", { ...props, ref: ref, "data-placement": placement, className: classNames("miaixz-tooltip", className), onPointerEnter: (event) => {
+            onPointerEnter?.(event);
+            hoveredRef.current = true;
+            scheduleShow();
+        }, onPointerLeave: (event) => {
+            onPointerLeave?.(event);
+            hoveredRef.current = false;
+            hideImmediately();
+        }, onFocus: (event) => {
+            onFocus?.(event);
+            focusedRef.current = true;
+            scheduleShow();
+        }, onBlur: (event) => {
+            onBlur?.(event);
+            if (!event.currentTarget.contains(event.relatedTarget))
+                focusedRef.current = false;
+            hideImmediately();
+        }, children: [cloneElement(children, { "aria-describedby": describedBy }), portalTarget !== null &&
+                createPortal(_jsx("span", { ref: contentRef, id: tooltipId, role: "tooltip", popover: "manual", hidden: !visible, className: "miaixz-tooltip-content", children: content }), portalTarget)] }));
+});
+//# sourceMappingURL=tooltip.js.map

package/dist/components/tooltip/tooltip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.js","sourceRoot":"","sources":["../../../src/components/tooltip/tooltip.tsx"],"names":[],"mappings":"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","sourcesContent":["import { cloneElement, forwardRef, useCallback, useEffect, useId, useRef, useState } from \"react\";\nimport { createPortal } from \"react-dom\";\n\nimport { classNames } from \"../../internal/class-names.js\";\nimport {\n  useMiaixzDismissibleLayer,\n  useMiaixzFloatingPosition,\n  useMiaixzManualPopover,\n  useMiaixzPortalTarget,\n} from \"../../internal/overlay/index.js\";\nimport { useMergedRef } from \"../../internal/use-merged-ref.js\";\nimport type { TooltipProps } from \"./tooltip.types.js\";\n\n/**\n * Freezes the WAI-ARIA Tooltip show delay in milliseconds.\n */\nconst miaixzTooltipShowDelay = 300;\n\n/**\n * Associates concise contextual help with an interactive or informational child.\n *\n * @public\n */\nexport const Tooltip = forwardRef<HTMLSpanElement, TooltipProps>(function Tooltip(\n  {\n    content,\n    children,\n    placement = \"top\",\n    className,\n    onPointerEnter,\n    onPointerLeave,\n    onFocus,\n    onBlur,\n    ...props\n  },\n  forwardedRef,\n) {\n  const tooltipId = useId();\n  const describedBy = [children.props[\"aria-describedby\"], tooltipId].filter(Boolean).join(\" \");\n  const wrapperRef = useRef<HTMLSpanElement>(null);\n  const [wrapperElement, setWrapperElement] = useState<HTMLSpanElement | null>(null);\n  const contentRef = useRef<HTMLSpanElement>(null);\n  const captureWrapper = useCallback((element: HTMLSpanElement | null) => {\n    wrapperRef.current = element;\n    setWrapperElement(element);\n  }, []);\n  const ref = useMergedRef(forwardedRef, captureWrapper);\n  const timerRef = useRef<number | undefined>(undefined);\n  const hoveredRef = useRef(false);\n  const focusedRef = useRef(false);\n  const [visible, setVisible] = useState(false);\n  const portalTarget = useMiaixzPortalTarget(wrapperElement);\n\n  const clearTimer = () => {\n    if (timerRef.current === undefined) return;\n    window.clearTimeout(timerRef.current);\n    timerRef.current = undefined;\n  };\n  const scheduleShow = () => {\n    clearTimer();\n    timerRef.current = window.setTimeout(() => {\n      timerRef.current = undefined;\n      if (hoveredRef.current || focusedRef.current) setVisible(true);\n    }, miaixzTooltipShowDelay);\n  };\n  const hideImmediately = () => {\n    clearTimer();\n    if (!hoveredRef.current && !focusedRef.current) setVisible(false);\n  };\n\n  useMiaixzManualPopover(contentRef, visible, portalTarget);\n  useMiaixzFloatingPosition(wrapperRef, contentRef, visible, placement, portalTarget);\n  useMiaixzDismissibleLayer({\n    active: visible,\n    triggerRef: wrapperRef,\n    contentRef,\n    portalTarget,\n    onDismiss: () => {\n      clearTimer();\n      setVisible(false);\n    },\n  });\n\n  useEffect(() => clearTimer, []);\n\n  return (\n    <span\n      {...props}\n      ref={ref}\n      data-placement={placement}\n      className={classNames(\"miaixz-tooltip\", className)}\n      onPointerEnter={(event) => {\n        onPointerEnter?.(event);\n        hoveredRef.current = true;\n        scheduleShow();\n      }}\n      onPointerLeave={(event) => {\n        onPointerLeave?.(event);\n        hoveredRef.current = false;\n        hideImmediately();\n      }}\n      onFocus={(event) => {\n        onFocus?.(event);\n        focusedRef.current = true;\n        scheduleShow();\n      }}\n      onBlur={(event) => {\n        onBlur?.(event);\n        if (!event.currentTarget.contains(event.relatedTarget)) focusedRef.current = false;\n        hideImmediately();\n      }}\n    >\n      {cloneElement(children, { \"aria-describedby\": describedBy })}\n      {portalTarget !== null &&\n        createPortal(\n          <span\n            ref={contentRef}\n            id={tooltipId}\n            role=\"tooltip\"\n            popover=\"manual\"\n            hidden={!visible}\n            className=\"miaixz-tooltip-content\"\n          >\n            {content}\n          </span>,\n          portalTarget,\n        )}\n    </span>\n  );\n});\n"]}