@miaixz/ui 0.5.0

package/dist/accessibility/focus-scope.js

@@ -0,0 +1,272 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Fragment, useEffect } from "react";
+/**
+ * Selects elements that can participate in keyboard focus order.
+ */
+const focusableSelector = [
+    "a[href]",
+    "button:not([disabled])",
+    "input:not([disabled]):not([type='hidden'])",
+    "select:not([disabled])",
+    "textarea:not([disabled])",
+    "[contenteditable='true']",
+    "[tabindex]:not([tabindex='-1'])",
+].join(",");
+/**
+ * Stores the active focus scopes for each independent document realm.
+ */
+const focusScopeStacks = new WeakMap();
+/**
+ * Activates the single package-internal focus boundary around rendered children.
+ *
+ * Activation is deferred to a microtask so native dialog synchronization can finish before the
+ * first focus move. Cleanup cancels pending activation or deactivates the live scope exactly once.
+ *
+ * @param props - Internal focus boundary configuration.
+ * @param props.active - Whether the focus boundary is active.
+ * @param props.containerRef - Reference to the scope container.
+ * @param props.initialFocusRef - Optional reference to the preferred initial target.
+ * @param props.restoreFocusRef - Optional reference to a pre-captured restoration target.
+ * @param props.children - Content rendered without an additional wrapper.
+ * @returns Rendered children without an additional DOM element.
+ * @internal
+ */
+export function FocusScope({ active, containerRef, initialFocusRef, restoreFocusRef, children, }) {
+    useEffect(() => {
+        if (!active)
+            return undefined;
+        const container = containerRef.current;
+        if (container === null)
+            return undefined;
+        let cancelled = false;
+        let deactivate;
+        queueMicrotask(() => {
+            if (cancelled)
+                return;
+            deactivate = activateMiaixzFocusScope(container, initialFocusRef?.current ?? undefined, restoreFocusRef === undefined ? undefined : restoreFocusRef.current);
+        });
+        return () => {
+            cancelled = true;
+            deactivate?.();
+        };
+    }, [active, containerRef, initialFocusRef, restoreFocusRef]);
+    return _jsx(Fragment, { children: children });
+}
+/**
+ * Activates focus entry, Tab containment, nested-scope ownership, and restoration for one element.
+ *
+ * This package-internal function is exported only for direct reuse and deterministic unit tests;
+ * it is not re-exported from any public package entry.
+ *
+ * @param container - Element whose descendants form the focus boundary.
+ * @param initialFocus - Optional preferred initial focus element inside the container.
+ * @param restoreFocusTarget - Optional pre-captured restoration target; null disables restoration.
+ * @returns An idempotent function that removes the scope and restores a valid focus target.
+ * @internal
+ */
+export function activateMiaixzFocusScope(container, initialFocus, restoreFocusTarget) {
+    const ownerDocument = container.ownerDocument;
+    const stack = getFocusScopeStack(ownerDocument);
+    const activeElement = ownerDocument.activeElement;
+    const entry = {
+        id: Symbol("miaixz-focus-scope"),
+        container,
+        document: ownerDocument,
+        restoreTarget: restoreFocusTarget === undefined
+            ? isFocusableReference(activeElement)
+                ? activeElement
+                : undefined
+            : (restoreFocusTarget ?? undefined),
+        addedContainerTabIndex: false,
+    };
+    /**
+     * Keeps keyboard Tab movement inside the current topmost scope.
+     *
+     * @param event - Keyboard event dispatched from the scope container.
+     */
+    const handleKeyDown = (event) => {
+        if (event.key !== "Tab" ||
+            event.altKey ||
+            event.ctrlKey ||
+            event.metaKey ||
+            getTopFocusScope(ownerDocument)?.id !== entry.id) {
+            return;
+        }
+        const focusable = getFocusableElements(container);
+        if (focusable.length === 0) {
+            event.preventDefault();
+            focusScopeEntry(entry);
+            return;
+        }
+        const first = focusable[0];
+        const last = focusable.at(-1);
+        const current = ownerDocument.activeElement;
+        const currentIsInside = isFocusableReference(current) && container.contains(current);
+        if (event.shiftKey && (!currentIsInside || current === first)) {
+            event.preventDefault();
+            if (last !== undefined)
+                focusElement(last);
+        }
+        else if (!event.shiftKey && (!currentIsInside || current === last)) {
+            event.preventDefault();
+            if (first !== undefined)
+                focusElement(first);
+        }
+    };
+    /**
+     * Redirects programmatic focus back into the current topmost scope.
+     *
+     * @param event - Focus event observed by the owner document.
+     */
+    const handleFocusIn = (event) => {
+        if (getTopFocusScope(ownerDocument)?.id !== entry.id)
+            return;
+        const target = event.target;
+        if (!isFocusableReference(target) || !container.contains(target))
+            focusScopeEntry(entry);
+    };
+    stack.push(entry);
+    container.addEventListener("keydown", handleKeyDown);
+    ownerDocument.addEventListener("focusin", handleFocusIn);
+    focusScopeEntry(entry, initialFocus);
+    let active = true;
+    return () => {
+        if (!active)
+            return;
+        active = false;
+        const currentStack = getFocusScopeStack(ownerDocument);
+        const entryIndex = currentStack.findIndex((candidate) => candidate.id === entry.id);
+        if (entryIndex < 0)
+            return;
+        const wasTopScope = entryIndex === currentStack.length - 1;
+        currentStack.splice(entryIndex, 1);
+        container.removeEventListener("keydown", handleKeyDown);
+        ownerDocument.removeEventListener("focusin", handleFocusIn);
+        restoreContainerTabIndex(entry);
+        if (!wasTopScope) {
+            const nestedEntry = currentStack[entryIndex];
+            if (nestedEntry !== undefined &&
+                entry.restoreTarget !== undefined &&
+                nestedEntry.restoreTarget !== undefined &&
+                entry.container.contains(nestedEntry.restoreTarget)) {
+                nestedEntry.restoreTarget = entry.restoreTarget;
+            }
+            return;
+        }
+        restoreFocusAfterScope(entry, currentStack.at(-1));
+        if (currentStack.length === 0)
+            focusScopeStacks.delete(ownerDocument);
+    };
+}
+/**
+ * Returns the mutable activation stack for one document realm.
+ *
+ * @param ownerDocument - Document whose scopes are being coordinated.
+ * @returns Existing or newly created focus-scope stack.
+ */
+function getFocusScopeStack(ownerDocument) {
+    const existing = focusScopeStacks.get(ownerDocument);
+    if (existing !== undefined)
+        return existing;
+    const created = [];
+    focusScopeStacks.set(ownerDocument, created);
+    return created;
+}
+/**
+ * Returns the active topmost scope for one document.
+ *
+ * @param ownerDocument - Document whose scope stack should be inspected.
+ * @returns Topmost scope or undefined when none is active.
+ */
+function getTopFocusScope(ownerDocument) {
+    return focusScopeStacks.get(ownerDocument)?.at(-1);
+}
+/**
+ * Reads the current focusable descendants in document order.
+ *
+ * @param container - Scope container to inspect.
+ * @returns Connected, enabled, assistive-visible focus targets.
+ */
+function getFocusableElements(container) {
+    return Array.from(container.querySelectorAll(focusableSelector)).filter((element) => element.isConnected &&
+        !element.hasAttribute("disabled") &&
+        element.getAttribute("aria-hidden") !== "true" &&
+        element.closest("[hidden], [inert], [aria-hidden='true']") === null);
+}
+/**
+ * Moves focus to the preferred target, first focusable descendant, or the container itself.
+ *
+ * @param entry - Active scope receiving focus.
+ * @param preferred - Optional preferred target within the scope.
+ */
+function focusScopeEntry(entry, preferred) {
+    if (preferred !== undefined &&
+        preferred.isConnected &&
+        entry.container.contains(preferred) &&
+        focusElement(preferred)) {
+        return;
+    }
+    const first = getFocusableElements(entry.container)[0];
+    if (first !== undefined && focusElement(first))
+        return;
+    if (entry.container.getAttribute("tabindex") === null) {
+        entry.container.setAttribute("tabindex", "-1");
+        entry.addedContainerTabIndex = true;
+    }
+    focusElement(entry.container);
+}
+/**
+ * Restores focus to the captured target or to the still-active parent scope.
+ *
+ * @param entry - Scope being removed.
+ * @param parent - Remaining parent scope, when one exists.
+ */
+function restoreFocusAfterScope(entry, parent) {
+    const target = entry.restoreTarget;
+    if (target !== undefined &&
+        target.isConnected &&
+        (parent === undefined || parent.container.contains(target)) &&
+        focusElement(target)) {
+        return;
+    }
+    if (parent !== undefined)
+        focusScopeEntry(parent);
+}
+/**
+ * Removes a tabindex added only to support an otherwise empty focus scope.
+ *
+ * @param entry - Scope whose container attributes should be restored.
+ */
+function restoreContainerTabIndex(entry) {
+    if (entry.addedContainerTabIndex)
+        entry.container.removeAttribute("tabindex");
+}
+/**
+ * Determines whether an unknown active-element value can safely receive focus.
+ *
+ * @param value - Candidate active or restoration target.
+ * @returns Whether the candidate exposes the required HTMLElement focus contract.
+ */
+function isFocusableReference(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "focus" in value &&
+        typeof value.focus === "function" &&
+        "isConnected" in value);
+}
+/**
+ * Attempts a focus move without allowing detached or browser-specific failures to escape cleanup.
+ *
+ * @param element - Connected element that should receive focus.
+ * @returns Whether the owner document reports the element as active after the move.
+ */
+function focusElement(element) {
+    try {
+        element.focus({ preventScroll: true });
+        return element.ownerDocument.activeElement === element;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=focus-scope.js.map

package/dist/accessibility/focus-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-scope.js","sourceRoot":"","sources":["../../src/accessibility/focus-scope.tsx"],"names":[],"mappings":"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","sourcesContent":["import { Fragment, useEffect, type ReactElement, type ReactNode, type RefObject } from \"react\";\n\n/**\n * Selects elements that can participate in keyboard focus order.\n */\nconst focusableSelector = [\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 * Stores the active focus scopes for each independent document realm.\n */\nconst focusScopeStacks = new WeakMap<Document, FocusScopeEntry[]>();\n\n/**\n * Describes the internal state retained while one focus scope is active.\n */\ninterface FocusScopeEntry {\n  /**\n   * Uniquely identifies the activation instance.\n   */\n  readonly id: symbol;\n\n  /**\n   * Contains every focusable node owned by the scope.\n   */\n  readonly container: HTMLElement;\n\n  /**\n   * Identifies the document that owns the scope.\n   */\n  readonly document: Document;\n\n  /**\n   * Identifies the element that should receive focus after deactivation.\n   */\n  restoreTarget: HTMLElement | undefined;\n\n  /**\n   * Tracks whether the scope added a temporary container tabindex.\n   */\n  addedContainerTabIndex: boolean;\n}\n\n/**\n * Configures the package-internal focus scope component.\n */\ninterface FocusScopeProps {\n  /**\n   * Controls whether the focus boundary is active.\n   */\n  readonly active: boolean;\n\n  /**\n   * References the element that owns focusable descendants.\n   */\n  readonly containerRef: RefObject<HTMLElement | null>;\n\n  /**\n   * Optionally identifies the preferred initial focus element.\n   */\n  readonly initialFocusRef?: RefObject<HTMLElement | null>;\n\n  /**\n   * Optionally supplies a restoration target captured before a native modal changes focus.\n   */\n  readonly restoreFocusRef?: RefObject<HTMLElement | null>;\n\n  /**\n   * Supplies content without introducing another DOM wrapper.\n   */\n  readonly children: ReactNode;\n}\n\n/**\n * Activates the single package-internal focus boundary around rendered children.\n *\n * Activation is deferred to a microtask so native dialog synchronization can finish before the\n * first focus move. Cleanup cancels pending activation or deactivates the live scope exactly once.\n *\n * @param props - Internal focus boundary configuration.\n * @param props.active - Whether the focus boundary is active.\n * @param props.containerRef - Reference to the scope container.\n * @param props.initialFocusRef - Optional reference to the preferred initial target.\n * @param props.restoreFocusRef - Optional reference to a pre-captured restoration target.\n * @param props.children - Content rendered without an additional wrapper.\n * @returns Rendered children without an additional DOM element.\n * @internal\n */\nexport function FocusScope({\n  active,\n  containerRef,\n  initialFocusRef,\n  restoreFocusRef,\n  children,\n}: FocusScopeProps): ReactElement {\n  useEffect(() => {\n    if (!active) return undefined;\n    const container = containerRef.current;\n    if (container === null) return undefined;\n    let cancelled = false;\n    let deactivate: (() => void) | undefined;\n    queueMicrotask(() => {\n      if (cancelled) return;\n      deactivate = activateMiaixzFocusScope(\n        container,\n        initialFocusRef?.current ?? undefined,\n        restoreFocusRef === undefined ? undefined : restoreFocusRef.current,\n      );\n    });\n    return () => {\n      cancelled = true;\n      deactivate?.();\n    };\n  }, [active, containerRef, initialFocusRef, restoreFocusRef]);\n\n  return <Fragment>{children}</Fragment>;\n}\n\n/**\n * Activates focus entry, Tab containment, nested-scope ownership, and restoration for one element.\n *\n * This package-internal function is exported only for direct reuse and deterministic unit tests;\n * it is not re-exported from any public package entry.\n *\n * @param container - Element whose descendants form the focus boundary.\n * @param initialFocus - Optional preferred initial focus element inside the container.\n * @param restoreFocusTarget - Optional pre-captured restoration target; null disables restoration.\n * @returns An idempotent function that removes the scope and restores a valid focus target.\n * @internal\n */\nexport function activateMiaixzFocusScope(\n  container: HTMLElement,\n  initialFocus?: HTMLElement,\n  restoreFocusTarget?: HTMLElement | null,\n): () => void {\n  const ownerDocument = container.ownerDocument;\n  const stack = getFocusScopeStack(ownerDocument);\n  const activeElement = ownerDocument.activeElement;\n  const entry: FocusScopeEntry = {\n    id: Symbol(\"miaixz-focus-scope\"),\n    container,\n    document: ownerDocument,\n    restoreTarget:\n      restoreFocusTarget === undefined\n        ? isFocusableReference(activeElement)\n          ? activeElement\n          : undefined\n        : (restoreFocusTarget ?? undefined),\n    addedContainerTabIndex: false,\n  };\n\n  /**\n   * Keeps keyboard Tab movement inside the current topmost scope.\n   *\n   * @param event - Keyboard event dispatched from the scope container.\n   */\n  const handleKeyDown = (event: KeyboardEvent): void => {\n    if (\n      event.key !== \"Tab\" ||\n      event.altKey ||\n      event.ctrlKey ||\n      event.metaKey ||\n      getTopFocusScope(ownerDocument)?.id !== entry.id\n    ) {\n      return;\n    }\n\n    const focusable = getFocusableElements(container);\n    if (focusable.length === 0) {\n      event.preventDefault();\n      focusScopeEntry(entry);\n      return;\n    }\n\n    const first = focusable[0];\n    const last = focusable.at(-1);\n    const current = ownerDocument.activeElement;\n    const currentIsInside = isFocusableReference(current) && container.contains(current);\n    if (event.shiftKey && (!currentIsInside || current === first)) {\n      event.preventDefault();\n      if (last !== undefined) focusElement(last);\n    } else if (!event.shiftKey && (!currentIsInside || current === last)) {\n      event.preventDefault();\n      if (first !== undefined) focusElement(first);\n    }\n  };\n\n  /**\n   * Redirects programmatic focus back into the current topmost scope.\n   *\n   * @param event - Focus event observed by the owner document.\n   */\n  const handleFocusIn = (event: FocusEvent): void => {\n    if (getTopFocusScope(ownerDocument)?.id !== entry.id) return;\n    const target = event.target;\n    if (!isFocusableReference(target) || !container.contains(target)) focusScopeEntry(entry);\n  };\n\n  stack.push(entry);\n  container.addEventListener(\"keydown\", handleKeyDown);\n  ownerDocument.addEventListener(\"focusin\", handleFocusIn);\n  focusScopeEntry(entry, initialFocus);\n\n  let active = true;\n  return () => {\n    if (!active) return;\n    active = false;\n    const currentStack = getFocusScopeStack(ownerDocument);\n    const entryIndex = currentStack.findIndex((candidate) => candidate.id === entry.id);\n    if (entryIndex < 0) return;\n    const wasTopScope = entryIndex === currentStack.length - 1;\n    currentStack.splice(entryIndex, 1);\n    container.removeEventListener(\"keydown\", handleKeyDown);\n    ownerDocument.removeEventListener(\"focusin\", handleFocusIn);\n    restoreContainerTabIndex(entry);\n\n    if (!wasTopScope) {\n      const nestedEntry = currentStack[entryIndex];\n      if (\n        nestedEntry !== undefined &&\n        entry.restoreTarget !== undefined &&\n        nestedEntry.restoreTarget !== undefined &&\n        entry.container.contains(nestedEntry.restoreTarget)\n      ) {\n        nestedEntry.restoreTarget = entry.restoreTarget;\n      }\n      return;\n    }\n\n    restoreFocusAfterScope(entry, currentStack.at(-1));\n    if (currentStack.length === 0) focusScopeStacks.delete(ownerDocument);\n  };\n}\n\n/**\n * Returns the mutable activation stack for one document realm.\n *\n * @param ownerDocument - Document whose scopes are being coordinated.\n * @returns Existing or newly created focus-scope stack.\n */\nfunction getFocusScopeStack(ownerDocument: Document): FocusScopeEntry[] {\n  const existing = focusScopeStacks.get(ownerDocument);\n  if (existing !== undefined) return existing;\n  const created: FocusScopeEntry[] = [];\n  focusScopeStacks.set(ownerDocument, created);\n  return created;\n}\n\n/**\n * Returns the active topmost scope for one document.\n *\n * @param ownerDocument - Document whose scope stack should be inspected.\n * @returns Topmost scope or undefined when none is active.\n */\nfunction getTopFocusScope(ownerDocument: Document): FocusScopeEntry | undefined {\n  return focusScopeStacks.get(ownerDocument)?.at(-1);\n}\n\n/**\n * Reads the current focusable descendants in document order.\n *\n * @param container - Scope container to inspect.\n * @returns Connected, enabled, assistive-visible focus targets.\n */\nfunction getFocusableElements(container: HTMLElement): HTMLElement[] {\n  return Array.from(container.querySelectorAll<HTMLElement>(focusableSelector)).filter(\n    (element) =>\n      element.isConnected &&\n      !element.hasAttribute(\"disabled\") &&\n      element.getAttribute(\"aria-hidden\") !== \"true\" &&\n      element.closest(\"[hidden], [inert], [aria-hidden='true']\") === null,\n  );\n}\n\n/**\n * Moves focus to the preferred target, first focusable descendant, or the container itself.\n *\n * @param entry - Active scope receiving focus.\n * @param preferred - Optional preferred target within the scope.\n */\nfunction focusScopeEntry(entry: FocusScopeEntry, preferred?: HTMLElement): void {\n  if (\n    preferred !== undefined &&\n    preferred.isConnected &&\n    entry.container.contains(preferred) &&\n    focusElement(preferred)\n  ) {\n    return;\n  }\n\n  const first = getFocusableElements(entry.container)[0];\n  if (first !== undefined && focusElement(first)) return;\n  if (entry.container.getAttribute(\"tabindex\") === null) {\n    entry.container.setAttribute(\"tabindex\", \"-1\");\n    entry.addedContainerTabIndex = true;\n  }\n  focusElement(entry.container);\n}\n\n/**\n * Restores focus to the captured target or to the still-active parent scope.\n *\n * @param entry - Scope being removed.\n * @param parent - Remaining parent scope, when one exists.\n */\nfunction restoreFocusAfterScope(entry: FocusScopeEntry, parent: FocusScopeEntry | undefined): void {\n  const target = entry.restoreTarget;\n  if (\n    target !== undefined &&\n    target.isConnected &&\n    (parent === undefined || parent.container.contains(target)) &&\n    focusElement(target)\n  ) {\n    return;\n  }\n  if (parent !== undefined) focusScopeEntry(parent);\n}\n\n/**\n * Removes a tabindex added only to support an otherwise empty focus scope.\n *\n * @param entry - Scope whose container attributes should be restored.\n */\nfunction restoreContainerTabIndex(entry: FocusScopeEntry): void {\n  if (entry.addedContainerTabIndex) entry.container.removeAttribute(\"tabindex\");\n}\n\n/**\n * Determines whether an unknown active-element value can safely receive focus.\n *\n * @param value - Candidate active or restoration target.\n * @returns Whether the candidate exposes the required HTMLElement focus contract.\n */\nfunction isFocusableReference(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\n/**\n * Attempts a focus move without allowing detached or browser-specific failures to escape cleanup.\n *\n * @param element - Connected element that should receive focus.\n * @returns Whether the owner document reports the element as active after the move.\n */\nfunction focusElement(element: HTMLElement): boolean {\n  try {\n    element.focus({ preventScroll: true });\n    return element.ownerDocument.activeElement === element;\n  } catch {\n    return false;\n  }\n}\n"]}

package/dist/accessibility/index.d.ts

@@ -0,0 +1,2 @@
+export { FocusScope, activateMiaixzFocusScope } from "./focus-scope.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/accessibility/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/accessibility/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/accessibility/index.js

@@ -0,0 +1,2 @@
+export { FocusScope, activateMiaixzFocusScope } from "./focus-scope.js";
+//# sourceMappingURL=index.js.map

package/dist/accessibility/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/accessibility/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC","sourcesContent":["export { FocusScope, activateMiaixzFocusScope } from \"./focus-scope.js\";\n"]}

package/dist/components/alert/alert.d.ts

@@ -0,0 +1,8 @@
+import type { AlertProps } from "./alert.types.js";
+/**
+ * Renders a prominent localized feedback message with optional actions and dismissal.
+ *
+ * @public
+ */
+export declare const Alert: import("react").ForwardRefExoticComponent<AlertProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=alert.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../../src/components/alert/alert.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAanD;;;;GAIG;AACH,eAAO,MAAM,KAAK,uGAmChB,CAAC"}

package/dist/components/alert/alert.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import { classNames } from "../../internal/class-names.js";
+import { useMiaixzLocale } from "../../i18n/index.js";
+import { Button } from "../button/index.js";
+import { Icon } from "../icon/index.js";
+const miaixzAlertIcons = {
+    neutral: "Info",
+    info: "Info",
+    success: "CircleCheck",
+    warning: "TriangleAlert",
+    danger: "CircleAlert",
+};
+/**
+ * Renders a prominent localized feedback message with optional actions and dismissal.
+ *
+ * @public
+ */
+export const Alert = forwardRef(function Alert({ tone = "neutral", title, children, actions, dismissLabel, onDismiss, className, ...props }, ref) {
+    const { t } = useMiaixzLocale();
+    const resolvedDismissLabel = dismissLabel ?? t("ui.action.dismiss");
+    return (_jsxs("div", { ...props, ref: ref, role: tone === "danger" ? "alert" : "status", "data-tone": tone, className: classNames("miaixz-alert", `miaixz-alert-${tone}`, className), children: [_jsx(Icon, { name: miaixzAlertIcons[tone], size: "control", className: "miaixz-alert-icon" }), _jsxs("div", { className: "miaixz-alert-content", children: [title !== undefined && _jsx("div", { className: "miaixz-alert-title", children: title }), _jsx("div", { className: "miaixz-alert-message", children: children }), actions !== undefined && _jsx("div", { className: "miaixz-alert-actions", children: actions })] }), onDismiss !== undefined && (_jsx(Button, { iconOnly: true, variant: "ghost", size: "small", "aria-label": resolvedDismissLabel, className: "miaixz-alert-dismiss", onClick: onDismiss, children: _jsx(Icon, { name: "X" }) }))] }));
+});
+//# sourceMappingURL=alert.js.map

package/dist/components/alert/alert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert.js","sourceRoot":"","sources":["../../../src/components/alert/alert.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAIxC,MAAM,gBAAgB,GAGlB;IACF,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,aAAa;IACtB,OAAO,EAAE,eAAe;IACxB,MAAM,EAAE,aAAa;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,UAAU,CAA6B,SAAS,KAAK,CACxE,EAAE,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAC5F,GAAG;IAEH,MAAM,EAAE,CAAC,EAAE,GAAG,eAAe,EAAE,CAAC;IAChC,MAAM,oBAAoB,GAAG,YAAY,IAAI,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAEpE,OAAO,CACL,kBACM,KAAK,EACT,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,eACjC,IAAI,EACf,SAAS,EAAE,UAAU,CAAC,cAAc,EAAE,gBAAgB,IAAI,EAAE,EAAE,SAAS,CAAC,aAExE,KAAC,IAAI,IAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAC,SAAS,EAAC,SAAS,EAAC,mBAAmB,GAAG,EACnF,eAAK,SAAS,EAAC,sBAAsB,aAClC,KAAK,KAAK,SAAS,IAAI,cAAK,SAAS,EAAC,oBAAoB,YAAE,KAAK,GAAO,EACzE,cAAK,SAAS,EAAC,sBAAsB,YAAE,QAAQ,GAAO,EACrD,OAAO,KAAK,SAAS,IAAI,cAAK,SAAS,EAAC,sBAAsB,YAAE,OAAO,GAAO,IAC3E,EACL,SAAS,KAAK,SAAS,IAAI,CAC1B,KAAC,MAAM,IACL,QAAQ,QACR,OAAO,EAAC,OAAO,EACf,IAAI,EAAC,OAAO,gBACA,oBAAoB,EAChC,SAAS,EAAC,sBAAsB,EAChC,OAAO,EAAE,SAAS,YAElB,KAAC,IAAI,IAAC,IAAI,EAAC,GAAG,GAAG,GACV,CACV,IACG,CACP,CAAC;AACJ,CAAC,CAAC,CAAC","sourcesContent":["import { forwardRef } from \"react\";\n\nimport { classNames } from \"../../internal/class-names.js\";\nimport { useMiaixzLocale } from \"../../i18n/index.js\";\nimport { Button } from \"../button/index.js\";\nimport { Icon } from \"../icon/index.js\";\nimport type { MiaixzFeedbackTone } from \"../shared.types.js\";\nimport type { AlertProps } from \"./alert.types.js\";\n\nconst miaixzAlertIcons: Record<\n  MiaixzFeedbackTone,\n  \"Info\" | \"CircleCheck\" | \"TriangleAlert\" | \"CircleAlert\"\n> = {\n  neutral: \"Info\",\n  info: \"Info\",\n  success: \"CircleCheck\",\n  warning: \"TriangleAlert\",\n  danger: \"CircleAlert\",\n};\n\n/**\n * Renders a prominent localized feedback message with optional actions and dismissal.\n *\n * @public\n */\nexport const Alert = forwardRef<HTMLDivElement, AlertProps>(function Alert(\n  { tone = \"neutral\", title, children, actions, dismissLabel, onDismiss, className, ...props },\n  ref,\n) {\n  const { t } = useMiaixzLocale();\n  const resolvedDismissLabel = dismissLabel ?? t(\"ui.action.dismiss\");\n\n  return (\n    <div\n      {...props}\n      ref={ref}\n      role={tone === \"danger\" ? \"alert\" : \"status\"}\n      data-tone={tone}\n      className={classNames(\"miaixz-alert\", `miaixz-alert-${tone}`, className)}\n    >\n      <Icon name={miaixzAlertIcons[tone]} size=\"control\" className=\"miaixz-alert-icon\" />\n      <div className=\"miaixz-alert-content\">\n        {title !== undefined && <div className=\"miaixz-alert-title\">{title}</div>}\n        <div className=\"miaixz-alert-message\">{children}</div>\n        {actions !== undefined && <div className=\"miaixz-alert-actions\">{actions}</div>}\n      </div>\n      {onDismiss !== undefined && (\n        <Button\n          iconOnly\n          variant=\"ghost\"\n          size=\"small\"\n          aria-label={resolvedDismissLabel}\n          className=\"miaixz-alert-dismiss\"\n          onClick={onDismiss}\n        >\n          <Icon name=\"X\" />\n        </Button>\n      )}\n    </div>\n  );\n});\n"]}

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

@@ -0,0 +1,43 @@
+import type { HTMLAttributes, ReactNode } from "react";
+import type { MiaixzFeedbackTone } from "../shared.types.js";
+/**
+ * Defines properties owned by the Miaixz Alert contract.
+ *
+ * @public
+ */
+export interface MiaixzAlertOwnProps {
+    /**
+     * Selects the semantic feedback tone.
+     *
+     * @defaultValue `"neutral"`
+     */
+    readonly tone?: MiaixzFeedbackTone;
+    /**
+     * Displays an optional alert heading.
+     */
+    readonly title?: ReactNode;
+    /**
+     * Supplies the required alert message content.
+     */
+    readonly children: ReactNode;
+    /**
+     * Displays optional actions below the message.
+     */
+    readonly actions?: ReactNode;
+    /**
+     * Overrides the localized accessible dismissal label.
+     */
+    readonly dismissLabel?: string;
+    /**
+     * Enables dismissal and receives the dismissal request.
+     */
+    readonly onDismiss?: () => void;
+}
+/**
+ * Configures a prominent semantic feedback message.
+ *
+ * @public
+ */
+export interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, keyof MiaixzAlertOwnProps>, MiaixzAlertOwnProps {
+}
+//# sourceMappingURL=alert.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alert.types.d.ts","sourceRoot":"","sources":["../../../src/components/alert/alert.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,MAAM,mBAAmB,CAAC,EAAE,mBAAmB;CAAG"}

package/dist/components/alert/alert.types.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"alert.types.js","sourceRoot":"","sources":["../../../src/components/alert/alert.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { HTMLAttributes, ReactNode } from \"react\";\n\nimport type { MiaixzFeedbackTone } from \"../shared.types.js\";\n\n/**\n * Defines properties owned by the Miaixz Alert contract.\n *\n * @public\n */\nexport interface MiaixzAlertOwnProps {\n  /**\n   * Selects the semantic feedback tone.\n   *\n   * @defaultValue `\"neutral\"`\n   */\n  readonly tone?: MiaixzFeedbackTone;\n\n  /**\n   * Displays an optional alert heading.\n   */\n  readonly title?: ReactNode;\n\n  /**\n   * Supplies the required alert message content.\n   */\n  readonly children: ReactNode;\n\n  /**\n   * Displays optional actions below the message.\n   */\n  readonly actions?: ReactNode;\n\n  /**\n   * Overrides the localized accessible dismissal label.\n   */\n  readonly dismissLabel?: string;\n\n  /**\n   * Enables dismissal and receives the dismissal request.\n   */\n  readonly onDismiss?: () => void;\n}\n\n/**\n * Configures a prominent semantic feedback message.\n *\n * @public\n */\nexport interface AlertProps\n  extends Omit<HTMLAttributes<HTMLDivElement>, keyof MiaixzAlertOwnProps>, MiaixzAlertOwnProps {}\n"]}

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

@@ -0,0 +1,4 @@
+export { Alert } from "./alert.js";
+export type { AlertProps, MiaixzAlertOwnProps } from "./alert.types.js";
+export type { MiaixzFeedbackTone } from "../shared.types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/alert/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACxE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/components/alert/index.js

@@ -0,0 +1,2 @@
+export { Alert } from "./alert.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/alert/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { Alert } from \"./alert.js\";\nexport type { AlertProps, MiaixzAlertOwnProps } from \"./alert.types.js\";\nexport type { MiaixzFeedbackTone } from \"../shared.types.js\";\n"]}

package/dist/components/avatar/avatar.d.ts

@@ -0,0 +1,8 @@
+import type { AvatarProps } from "./avatar.types.js";
+/**
+ * Renders an accessible avatar image with a Unicode-safe name fallback.
+ *
+ * @public
+ */
+export declare const Avatar: import("react").ForwardRefExoticComponent<AvatarProps & import("react").RefAttributes<HTMLSpanElement>>;
+//# sourceMappingURL=avatar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/avatar.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAmBrD;;;;GAIG;AACH,eAAO,MAAM,MAAM,yGA6BjB,CAAC"}

package/dist/components/avatar/avatar.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useState } from "react";
+import { classNames } from "../../internal/class-names.js";
+/**
+ * Derives the first two visible Unicode graphemes from a display name.
+ *
+ * @param name - Display name used to generate the fallback.
+ * @returns Uppercase graphemes or a question mark when the name is empty.
+ */
+function createAvatarFallback(name) {
+    const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+    const fallback = Array.from(segmenter.segment(name.trim()), ({ segment }) => segment)
+        .filter((segment) => segment.trim().length > 0)
+        .slice(0, 2)
+        .join("")
+        .toLocaleUpperCase();
+    return fallback || "?";
+}
+/**
+ * Renders an accessible avatar image with a Unicode-safe name fallback.
+ *
+ * @public
+ */
+export const Avatar = forwardRef(function Avatar({ src, alt, name, size = "medium", className, ...props }, ref) {
+    const [failedSource, setFailedSource] = useState();
+    const displaysImage = src !== undefined && src.length > 0 && failedSource !== src;
+    return (_jsx("span", { ...props, ref: ref, "data-size": size, "data-state": displaysImage ? "image" : "fallback", className: classNames("miaixz-avatar", `miaixz-avatar-${size}`, className), children: displaysImage ? (_jsx("img", { className: "miaixz-avatar-image", src: src, alt: alt, onError: () => setFailedSource(src) })) : (_jsx("span", { className: "miaixz-avatar-fallback", role: "img", "aria-label": alt, children: createAvatarFallback(name) })) }));
+});
+//# sourceMappingURL=avatar.js.map

package/dist/components/avatar/avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.js","sourceRoot":"","sources":["../../../src/components/avatar/avatar.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAG3D;;;;;GAKG;AACH,SAAS,oBAAoB,CAAC,IAAY;IACxC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC;SAClF,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SAC9C,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,IAAI,CAAC,EAAE,CAAC;SACR,iBAAiB,EAAE,CAAC;IAEvB,OAAO,QAAQ,IAAI,GAAG,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAA+B,SAAS,MAAM,CAC5E,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EACxD,GAAG;IAEH,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,EAAU,CAAC;IAC3D,MAAM,aAAa,GAAG,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,KAAK,GAAG,CAAC;IAElF,OAAO,CACL,kBACM,KAAK,EACT,GAAG,EAAE,GAAG,eACG,IAAI,gBACH,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAChD,SAAS,EAAE,UAAU,CAAC,eAAe,EAAE,iBAAiB,IAAI,EAAE,EAAE,SAAS,CAAC,YAEzE,aAAa,CAAC,CAAC,CAAC,CACf,cACE,SAAS,EAAC,qBAAqB,EAC/B,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,GACnC,CACH,CAAC,CAAC,CAAC,CACF,eAAM,SAAS,EAAC,wBAAwB,EAAC,IAAI,EAAC,KAAK,gBAAa,GAAG,YAChE,oBAAoB,CAAC,IAAI,CAAC,GACtB,CACR,GACI,CACR,CAAC;AACJ,CAAC,CAAC,CAAC","sourcesContent":["import { forwardRef, useState } from \"react\";\n\nimport { classNames } from \"../../internal/class-names.js\";\nimport type { AvatarProps } from \"./avatar.types.js\";\n\n/**\n * Derives the first two visible Unicode graphemes from a display name.\n *\n * @param name - Display name used to generate the fallback.\n * @returns Uppercase graphemes or a question mark when the name is empty.\n */\nfunction createAvatarFallback(name: string): string {\n  const segmenter = new Intl.Segmenter(undefined, { granularity: \"grapheme\" });\n  const fallback = Array.from(segmenter.segment(name.trim()), ({ segment }) => segment)\n    .filter((segment) => segment.trim().length > 0)\n    .slice(0, 2)\n    .join(\"\")\n    .toLocaleUpperCase();\n\n  return fallback || \"?\";\n}\n\n/**\n * Renders an accessible avatar image with a Unicode-safe name fallback.\n *\n * @public\n */\nexport const Avatar = forwardRef<HTMLSpanElement, AvatarProps>(function Avatar(\n  { src, alt, name, size = \"medium\", className, ...props },\n  ref,\n) {\n  const [failedSource, setFailedSource] = useState<string>();\n  const displaysImage = src !== undefined && src.length > 0 && failedSource !== src;\n\n  return (\n    <span\n      {...props}\n      ref={ref}\n      data-size={size}\n      data-state={displaysImage ? \"image\" : \"fallback\"}\n      className={classNames(\"miaixz-avatar\", `miaixz-avatar-${size}`, className)}\n    >\n      {displaysImage ? (\n        <img\n          className=\"miaixz-avatar-image\"\n          src={src}\n          alt={alt}\n          onError={() => setFailedSource(src)}\n        />\n      ) : (\n        <span className=\"miaixz-avatar-fallback\" role=\"img\" aria-label={alt}>\n          {createAvatarFallback(name)}\n        </span>\n      )}\n    </span>\n  );\n});\n"]}

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

@@ -0,0 +1,35 @@
+import type { HTMLAttributes } from "react";
+import type { MiaixzComponentSize } from "../shared.types.js";
+/**
+ * Defines properties owned by the Miaixz Avatar contract.
+ *
+ * @public
+ */
+export interface MiaixzAvatarOwnProps {
+    /**
+     * Supplies the optional profile image source.
+     */
+    readonly src?: string;
+    /**
+     * Supplies the required accessible name for either image or fallback content.
+     */
+    readonly alt: string;
+    /**
+     * Supplies the name used to derive fallback graphemes.
+     */
+    readonly name: string;
+    /**
+     * Selects the semantic avatar size.
+     *
+     * @defaultValue `"medium"`
+     */
+    readonly size?: MiaixzComponentSize;
+}
+/**
+ * Configures an accessible profile image with a deterministic name fallback.
+ *
+ * @public
+ */
+export interface AvatarProps extends Omit<HTMLAttributes<HTMLSpanElement>, keyof MiaixzAvatarOwnProps>, MiaixzAvatarOwnProps {
+}
+//# sourceMappingURL=avatar.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.types.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/avatar.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,WACf,SAAQ,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,MAAM,oBAAoB,CAAC,EAAE,oBAAoB;CAAG"}

package/dist/components/avatar/avatar.types.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"avatar.types.js","sourceRoot":"","sources":["../../../src/components/avatar/avatar.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { HTMLAttributes } from \"react\";\n\nimport type { MiaixzComponentSize } from \"../shared.types.js\";\n\n/**\n * Defines properties owned by the Miaixz Avatar contract.\n *\n * @public\n */\nexport interface MiaixzAvatarOwnProps {\n  /**\n   * Supplies the optional profile image source.\n   */\n  readonly src?: string;\n\n  /**\n   * Supplies the required accessible name for either image or fallback content.\n   */\n  readonly alt: string;\n\n  /**\n   * Supplies the name used to derive fallback graphemes.\n   */\n  readonly name: string;\n\n  /**\n   * Selects the semantic avatar size.\n   *\n   * @defaultValue `\"medium\"`\n   */\n  readonly size?: MiaixzComponentSize;\n}\n\n/**\n * Configures an accessible profile image with a deterministic name fallback.\n *\n * @public\n */\nexport interface AvatarProps\n  extends Omit<HTMLAttributes<HTMLSpanElement>, keyof MiaixzAvatarOwnProps>, MiaixzAvatarOwnProps {}\n"]}

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

@@ -0,0 +1,4 @@
+export { Avatar } from "./avatar.js";
+export type { AvatarProps, MiaixzAvatarOwnProps } from "./avatar.types.js";
+export type { MiaixzComponentSize } from "../shared.types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/components/avatar/index.js

@@ -0,0 +1,2 @@
+export { Avatar } from "./avatar.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/avatar/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC","sourcesContent":["export { Avatar } from \"./avatar.js\";\nexport type { AvatarProps, MiaixzAvatarOwnProps } from \"./avatar.types.js\";\nexport type { MiaixzComponentSize } from \"../shared.types.js\";\n"]}

package/dist/components/badge/badge.d.ts

@@ -0,0 +1,8 @@
+import type { BadgeProps } from "./badge.types.js";
+/**
+ * Renders a compact semantic status or category label.
+ *
+ * @public
+ */
+export declare const Badge: import("react").ForwardRefExoticComponent<BadgeProps & import("react").RefAttributes<HTMLSpanElement>>;
+//# sourceMappingURL=badge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../../src/components/badge/badge.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,KAAK,wGAqBhB,CAAC"}

package/dist/components/badge/badge.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import { classNames } from "../../internal/class-names.js";
+/**
+ * Renders a compact semantic status or category label.
+ *
+ * @public
+ */
+export const Badge = forwardRef(function Badge({ tone = "neutral", outline = false, dot = false, icon, className, children, ...props }, ref) {
+    return (_jsxs("span", { ...props, ref: ref, "data-tone": tone, className: classNames("miaixz-badge", tone !== "neutral" && `miaixz-badge-${tone}`, outline && "miaixz-badge-outline", className), children: [dot && _jsx("span", { className: "miaixz-badge-dot", "aria-hidden": "true" }), icon && _jsx("span", { className: "miaixz-badge-icon", children: icon }), _jsx("span", { className: "miaixz-badge-label", children: children })] }));
+});
+//# sourceMappingURL=badge.js.map

package/dist/components/badge/badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.js","sourceRoot":"","sources":["../../../src/components/badge/badge.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,KAAK,GAAG,UAAU,CAA8B,SAAS,KAAK,CACzE,EAAE,IAAI,GAAG,SAAS,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,GAAG,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EACvF,GAAG;IAEH,OAAO,CACL,mBACM,KAAK,EACT,GAAG,EAAE,GAAG,eACG,IAAI,EACf,SAAS,EAAE,UAAU,CACnB,cAAc,EACd,IAAI,KAAK,SAAS,IAAI,gBAAgB,IAAI,EAAE,EAC5C,OAAO,IAAI,sBAAsB,EACjC,SAAS,CACV,aAEA,GAAG,IAAI,eAAM,SAAS,EAAC,kBAAkB,iBAAa,MAAM,GAAG,EAC/D,IAAI,IAAI,eAAM,SAAS,EAAC,mBAAmB,YAAE,IAAI,GAAQ,EAC1D,eAAM,SAAS,EAAC,oBAAoB,YAAE,QAAQ,GAAQ,IACjD,CACR,CAAC;AACJ,CAAC,CAAC,CAAC","sourcesContent":["import { forwardRef } from \"react\";\n\nimport { classNames } from \"../../internal/class-names.js\";\nimport type { BadgeProps } from \"./badge.types.js\";\n\n/**\n * Renders a compact semantic status or category label.\n *\n * @public\n */\nexport const Badge = forwardRef<HTMLSpanElement, BadgeProps>(function Badge(\n  { tone = \"neutral\", outline = false, dot = false, icon, className, children, ...props },\n  ref,\n) {\n  return (\n    <span\n      {...props}\n      ref={ref}\n      data-tone={tone}\n      className={classNames(\n        \"miaixz-badge\",\n        tone !== \"neutral\" && `miaixz-badge-${tone}`,\n        outline && \"miaixz-badge-outline\",\n        className,\n      )}\n    >\n      {dot && <span className=\"miaixz-badge-dot\" aria-hidden=\"true\" />}\n      {icon && <span className=\"miaixz-badge-icon\">{icon}</span>}\n      <span className=\"miaixz-badge-label\">{children}</span>\n    </span>\n  );\n});\n"]}