@sia.soul/sia-react-ui 0.1.22 → 0.1.24

package/dist/chunk-NSSPGXNM.js

@@ -0,0 +1,284 @@
+// src/components/titleTooltip.tsx
+import { createRoot } from "react-dom/client";
+import { jsx } from "react/jsx-runtime";
+var documents = /* @__PURE__ */ new WeakSet();
+function withTitleTooltip(props) {
+  if (!props || typeof props !== "object" || !("title" in props)) return props;
+  const { title, ...rest } = props;
+  if (typeof document !== "undefined") installTitleTooltips(document);
+  return { ...rest, "data-sia-title": title == null ? void 0 : String(title) };
+}
+function installTitleTooltips(doc) {
+  if (documents.has(doc)) return;
+  documents.add(doc);
+  let hovered = null;
+  let focused = null;
+  let active = null;
+  let pending = null;
+  let timer;
+  let root;
+  let observer;
+  let tooltipId = "";
+  const candidate = (target) => {
+    if (!(target instanceof Element)) return null;
+    const element = target.closest("[data-sia-title]");
+    return element?.getAttribute("data-sia-title") && !element.closest(".sia-floating") ? element : null;
+  };
+  const hasExplicitTooltip = (target) => target instanceof Element && Boolean(target.closest(".sia-floating"));
+  const hide = () => {
+    clearTimeout(timer);
+    pending = null;
+    observer?.disconnect();
+    observer = void 0;
+    if (active) {
+      const ids = (active.getAttribute("aria-describedby") ?? "").split(/\s+/).filter((id) => id && id !== tooltipId);
+      if (ids.length) active.setAttribute("aria-describedby", ids.join(" "));
+      else active.removeAttribute("aria-describedby");
+    }
+    active = null;
+    root?.render(null);
+  };
+  const render = () => {
+    const text = active?.getAttribute("data-sia-title");
+    if (!active?.isConnected || !text) {
+      hide();
+      return;
+    }
+    if (!root) {
+      const host = doc.createElement("div");
+      host.setAttribute("data-sia-title-tooltip-host", "");
+      doc.body.append(host);
+      root = createRoot(host);
+      tooltipId = `sia-title-tooltip-${Math.random().toString(36).slice(2)}`;
+    }
+    const ids = new Set((active.getAttribute("aria-describedby") ?? "").split(/\s+/).filter(Boolean));
+    ids.add(tooltipId);
+    active.setAttribute("aria-describedby", [...ids].join(" "));
+    root.render(/* @__PURE__ */ jsx(
+      PopupPortal,
+      {
+        anchorRef: { current: active },
+        placement: "top-start",
+        id: tooltipId,
+        role: "tooltip",
+        className: "sia-title-tooltip",
+        children: text
+      }
+    ));
+  };
+  const show = (element) => {
+    if (!element && !active && !pending) return;
+    if (element && (element === active || element === pending)) return;
+    hide();
+    if (!element) return;
+    pending = element;
+    timer = setTimeout(() => {
+      pending = null;
+      if (!element.isConnected) return;
+      active = element;
+      render();
+      if (!active) return;
+      observer = new MutationObserver(() => {
+        if (!active?.isConnected) hide();
+        else if (active.getAttribute("data-sia-title") !== doc.getElementById(tooltipId)?.textContent) render();
+      });
+      observer.observe(doc.body, { childList: true, subtree: true, attributes: true, attributeFilter: ["data-sia-title"] });
+    }, 250);
+  };
+  doc.addEventListener("pointerover", (event) => {
+    if (event.pointerType === "touch") return;
+    hovered = candidate(event.target);
+    if (hasExplicitTooltip(event.target)) hide();
+    else show(hovered ?? focused);
+  }, true);
+  doc.addEventListener("pointermove", (event) => {
+    if (event.pointerType === "touch" || event.buttons) return;
+    hovered = candidate(event.target);
+    if (!hasExplicitTooltip(event.target)) show(hovered ?? focused);
+  }, true);
+  doc.addEventListener("pointerout", (event) => {
+    if (event.pointerType === "touch") return;
+    hovered = candidate(event.relatedTarget);
+    if (hasExplicitTooltip(event.relatedTarget)) hide();
+    else show(hovered ?? focused);
+  }, true);
+  doc.addEventListener("focusin", (event) => {
+    focused = candidate(event.target);
+    if (hasExplicitTooltip(event.target)) hide();
+    else show(focused ?? hovered);
+  }, true);
+  doc.addEventListener("focusout", (event) => {
+    focused = candidate(event.relatedTarget);
+    show(hovered ?? focused);
+  }, true);
+  doc.addEventListener("pointerdown", hide, true);
+  doc.addEventListener("keydown", (event) => {
+    if (event.key === "Escape") hide();
+  }, true);
+  doc.addEventListener("scroll", hide, true);
+  doc.defaultView?.addEventListener("blur", () => {
+    hovered = focused = null;
+    hide();
+  });
+}
+
+// src/components/PopupPortal.tsx
+import { forwardRef, useLayoutEffect, useRef, useState } from "react";
+import { createPortal } from "react-dom";
+import { jsx as jsx2 } from "react/jsx-runtime";
+function setForwardedRef(ref, value) {
+  if (typeof ref === "function") ref(value);
+  else if (ref) ref.current = value;
+}
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), Math.max(min, max));
+}
+var PopupPortal = forwardRef(function PopupPortal2({
+  anchorRef,
+  open = true,
+  placement = "bottom-start",
+  offset = 6,
+  viewportPadding = 8,
+  className = "",
+  style,
+  children,
+  ...props
+}, forwardedRef) {
+  const popupRef = useRef(null);
+  const [position, setPosition] = useState();
+  useLayoutEffect(() => {
+    if (!open || typeof document === "undefined") {
+      setPosition(void 0);
+      return;
+    }
+    const update = () => {
+      const anchor = anchorRef.current;
+      const popup = popupRef.current;
+      if (!anchor || !popup) return;
+      const anchorRect = anchor.getBoundingClientRect();
+      const popupRect = popup.getBoundingClientRect();
+      const viewportWidth = document.documentElement.clientWidth;
+      const viewportHeight = document.documentElement.clientHeight;
+      let resolvedPlacement = placement;
+      const availableBelow = Math.max(0, viewportHeight - viewportPadding - anchorRect.bottom - offset);
+      const availableAbove = Math.max(0, anchorRect.top - offset - viewportPadding);
+      const availableRight = Math.max(0, viewportWidth - viewportPadding - anchorRect.right - offset);
+      const availableLeft = Math.max(0, anchorRect.left - offset - viewportPadding);
+      const horizontalSide = placement.startsWith("right") || placement.startsWith("left");
+      if (horizontalSide) {
+        const prefersRight = placement.startsWith("right");
+        const fitsRight = popupRect.width <= availableRight;
+        const fitsLeft = popupRect.width <= availableLeft;
+        if (prefersRight && !fitsRight && (fitsLeft || availableLeft > availableRight)) {
+          resolvedPlacement = placement.replace("right", "left");
+        } else if (!prefersRight && !fitsLeft && (fitsRight || availableRight > availableLeft)) {
+          resolvedPlacement = placement.replace("left", "right");
+        }
+      } else {
+        const prefersBottom = placement.startsWith("bottom");
+        const fitsBelow = popupRect.height <= availableBelow;
+        const fitsAbove = popupRect.height <= availableAbove;
+        if (prefersBottom && !fitsBelow && (fitsAbove || availableAbove > availableBelow)) {
+          resolvedPlacement = placement.replace("bottom", "top");
+        } else if (!prefersBottom && !fitsAbove && (fitsBelow || availableBelow > availableAbove)) {
+          resolvedPlacement = placement.replace("top", "bottom");
+        }
+      }
+      const resolvedHorizontalSide = resolvedPlacement.startsWith("right") || resolvedPlacement.startsWith("left");
+      const top = resolvedHorizontalSide ? resolvedPlacement.endsWith("end") ? anchorRect.bottom - popupRect.height : anchorRect.top : resolvedPlacement.startsWith("bottom") ? anchorRect.bottom + offset : anchorRect.top - popupRect.height - offset;
+      const availableHeight = resolvedHorizontalSide ? Math.max(0, viewportHeight - viewportPadding * 2) : resolvedPlacement.startsWith("bottom") ? availableBelow : availableAbove;
+      const alignedLeft = resolvedHorizontalSide ? resolvedPlacement.startsWith("right") ? anchorRect.right + offset : anchorRect.left - popupRect.width - offset : resolvedPlacement.endsWith("end") ? anchorRect.right - popupRect.width : anchorRect.left;
+      const next = {
+        top: clamp(top, viewportPadding, viewportHeight - popupRect.height - viewportPadding),
+        left: clamp(alignedLeft, viewportPadding, viewportWidth - popupRect.width - viewportPadding),
+        anchorWidth: anchorRect.width,
+        availableHeight,
+        placement: resolvedPlacement
+      };
+      setPosition((current) => current && current.top === next.top && current.left === next.left && current.anchorWidth === next.anchorWidth && current.availableHeight === next.availableHeight && current.placement === next.placement ? current : next);
+    };
+    update();
+    window.addEventListener("resize", update);
+    window.addEventListener("scroll", update, true);
+    const observer = new ResizeObserver(update);
+    if (anchorRef.current) observer.observe(anchorRef.current);
+    if (popupRef.current) observer.observe(popupRef.current);
+    return () => {
+      window.removeEventListener("resize", update);
+      window.removeEventListener("scroll", update, true);
+      observer.disconnect();
+    };
+  }, [anchorRef, offset, open, placement, viewportPadding]);
+  if (!open || typeof document === "undefined") return null;
+  return createPortal(
+    /* @__PURE__ */ jsx2(
+      "div",
+      {
+        ref: (node) => {
+          popupRef.current = node;
+          setForwardedRef(forwardedRef, node);
+        },
+        className: `sia-popup-portal ${className}`.trim(),
+        "data-sia-popup-layer": "",
+        "data-placement": position?.placement ?? placement,
+        style: {
+          ...style,
+          "--sia-popup-anchor-width": `${position?.anchorWidth ?? anchorRef.current?.getBoundingClientRect().width ?? 0}px`,
+          "--sia-popup-available-height": position ? `${position.availableHeight}px` : void 0,
+          top: position?.top ?? 0,
+          left: position?.left ?? 0,
+          visibility: position ? "visible" : "hidden"
+        },
+        ...withTitleTooltip(props),
+        children
+      }
+    ),
+    document.body
+  );
+});
+
+// src/components/shared.ts
+import { createContext, useCallback, useContext, useState as useState2 } from "react";
+var ControlSizeContext = createContext("medium");
+function useControlSize(size) {
+  const inherited = useContext(ControlSizeContext);
+  return size ?? inherited;
+}
+var PlaceholderModeContext = createContext("default");
+function usePlaceholderMode(mode) {
+  const inherited = useContext(PlaceholderModeContext);
+  return mode ?? inherited;
+}
+function useControllableState({ value, defaultValue, onChange }) {
+  const [internalValue, setInternalValue] = useState2(defaultValue);
+  const controlled = value !== void 0;
+  const currentValue = controlled ? value : internalValue;
+  const setValue = useCallback((nextValue) => {
+    if (Object.is(currentValue, nextValue)) return;
+    if (!controlled) setInternalValue(nextValue);
+    onChange?.(nextValue);
+  }, [controlled, currentValue, onChange]);
+  return [currentValue, setValue];
+}
+
+// src/components/FloatingPlaceholder.tsx
+import { jsx as jsx3 } from "react/jsx-runtime";
+function useFloatingPlaceholder({ mode, placeholder, filled, active = false }) {
+  const enabled = usePlaceholderMode(mode) === "floating" && Boolean(placeholder);
+  return {
+    enabled,
+    className: enabled ? ` sia-placeholder-floating${filled ? " sia-placeholder-floating--filled" : ""}${active ? " sia-placeholder-floating--active" : ""}` : "",
+    label: enabled ? /* @__PURE__ */ jsx3("span", { className: "sia-floating-placeholder", "aria-hidden": "true", children: placeholder }) : null
+  };
+}
+
+export {
+  PopupPortal,
+  withTitleTooltip,
+  ControlSizeContext,
+  useControlSize,
+  PlaceholderModeContext,
+  usePlaceholderMode,
+  useControllableState,
+  useFloatingPlaceholder
+};

package/dist/{chunk-YT6E3X2K.js → chunk-OH6YILJW.js}

@@ -1,7 +1,8 @@
 import {
   useControlSize,
-  useFloatingPlaceholder
-} from "./chunk-3VJ4CZDQ.js";
+  useFloatingPlaceholder,
+  withTitleTooltip
+} from "./chunk-NSSPGXNM.js";
 
 // src/components/TextArea.tsx
 import { forwardRef, useId, useState } from "react";
@@ -39,7 +40,7 @@ var TextArea = forwardRef(function TextArea2({
     /* @__PURE__ */ jsx(
       "textarea",
       {
-        ...props,
+        ...withTitleTooltip(props),
         ref,
         id: textAreaId,
         className: "sia-textarea",

package/dist/{chunk-RWGSZW32.js → chunk-RGXVPS37.js}

@@ -2,13 +2,14 @@ import {
   Dropdown,
   Icon,
   Input
-} from "./chunk-KLI65JVD.js";
+} from "./chunk-LRPQ5FGE.js";
 import {
   Button
-} from "./chunk-TZGUBGA4.js";
+} from "./chunk-6WBABNAX.js";
 import {
-  useFloatingPlaceholder
-} from "./chunk-3VJ4CZDQ.js";
+  useFloatingPlaceholder,
+  withTitleTooltip
+} from "./chunk-NSSPGXNM.js";
 
 // src/components/RichTextEditor.tsx
 import { useEffect, useMemo, useRef, useState } from "react";
@@ -42,7 +43,7 @@ function sanitizeContent(value) {
 function RichTextContent({ content, emptyText = "\u6682\u65E0\u5185\u5BB9", className = "", ...props }) {
   const html = useMemo(() => sanitizeContent(content), [content]);
   if (!html.trim()) return /* @__PURE__ */ jsx("div", { className: `sia-rich-text-content sia-rich-text-content--empty ${className}`.trim(), children: emptyText });
-  return /* @__PURE__ */ jsx("article", { className: `sia-rich-text-content ${className}`.trim(), dangerouslySetInnerHTML: { __html: html }, ...props });
+  return /* @__PURE__ */ jsx("article", { className: `sia-rich-text-content ${className}`.trim(), dangerouslySetInnerHTML: { __html: html }, ...withTitleTooltip(props) });
 }
 function RichTextEditor({
   value,
@@ -222,7 +223,7 @@ function RichTextEditor({
     }
   };
   const floating = useFloatingPlaceholder({ mode: placeholderMode, placeholder, filled: editor ? !editor.isEmpty : Boolean(value ?? defaultValue) });
-  return /* @__PURE__ */ jsxs("div", { ...props, id, style: mergedStyle, className: `sia-rich-text-editor${floating.className}${disabled ? " is-disabled" : ""} sia-rich-text-editor--${toolbar} ${className}`.trim(), children: [
+  return /* @__PURE__ */ jsxs("div", { ...withTitleTooltip(props), id, style: mergedStyle, className: `sia-rich-text-editor${floating.className}${disabled ? " is-disabled" : ""} sia-rich-text-editor--${toolbar} ${className}`.trim(), children: [
     floating.label,
     /* @__PURE__ */ jsxs("div", { className: "sia-rich-text-editor__toolbar", "aria-label": "\u6587\u672C\u683C\u5F0F\u5DE5\u5177\u680F", children: [
       /* @__PURE__ */ jsxs("div", { className: "sia-rich-text-editor__toolbar-main", children: [

package/dist/{chunk-VN6PIPP7.js → chunk-T2QIW4OO.js}

@@ -1,15 +1,16 @@
 import {
   Select
-} from "./chunk-3TRRBMXY.js";
+} from "./chunk-6R7JY7IY.js";
 import {
-  Icon,
-  PopupPortal
-} from "./chunk-KLI65JVD.js";
+  Icon
+} from "./chunk-LRPQ5FGE.js";
 import {
+  PopupPortal,
   useControlSize,
   useControllableState,
-  useFloatingPlaceholder
-} from "./chunk-3VJ4CZDQ.js";
+  useFloatingPlaceholder,
+  withTitleTooltip
+} from "./chunk-NSSPGXNM.js";
 
 // src/components/DatePicker.tsx
 import { useEffect, useId, useMemo, useRef as useRef2, useState } from "react";
@@ -840,7 +841,7 @@ function SelectDateRange({
   const size = useControlSize(sizeProp);
   const initialValue = defaultValue ?? { select: options[0]?.value ?? "", range: ["", ""] };
   const [currentValue, setCurrentValue] = useControllableState({ value: value === void 0 ? void 0 : value && typeof value === "object" ? value : { select: "", range: ["", ""] }, defaultValue: initialValue, onChange });
-  return /* @__PURE__ */ jsxs3("div", { className: `sia-select-date-range sia-select-date-range--${size} ${className}`.trim(), role: "group", "aria-label": `${selectAriaLabel}\u4E0E${rangeAriaLabel}`, ...props, style: { ...style, "--sia-select-date-range-select-width": typeof selectWidth === "number" ? `${selectWidth}px` : selectWidth }, children: [
+  return /* @__PURE__ */ jsxs3("div", { className: `sia-select-date-range sia-select-date-range--${size} ${className}`.trim(), role: "group", "aria-label": `${selectAriaLabel}\u4E0E${rangeAriaLabel}`, ...withTitleTooltip(props), style: { ...style, "--sia-select-date-range-select-width": typeof selectWidth === "number" ? `${selectWidth}px` : selectWidth }, children: [
     /* @__PURE__ */ jsx3(
       Select,
       {

package/dist/{core-DeZknKwc.d.ts → core-BOzLwiXG.d.ts}

@@ -1,46 +1,46 @@
 import * as react from 'react';
-import { ButtonHTMLAttributes, ReactNode, HTMLAttributes, CSSProperties, MouseEvent, ReactElement, ImgHTMLAttributes, InputHTMLAttributes, MouseEventHandler, AnchorHTMLAttributes } from 'react';
+import { ReactNode, HTMLAttributes, CSSProperties, MouseEvent, ReactElement, ImgHTMLAttributes, InputHTMLAttributes, MouseEventHandler, AnchorHTMLAttributes, ButtonHTMLAttributes } from 'react';
+import { B as ButtonProps, f as Button } from './Select-O_yY51vc.js';
 import { C as ControlSize, a as ControlStatus, I as InputPlaceholderMode } from './shared-Bx4B28Wh.js';
-import './Select-BNSE67xn.js';
 
-/** 按钮视觉样式，可选择主按钮、默认按钮、文本按钮或链接等形式。 */
-type ButtonVariant = "primary" | "default" | "dashed" | "filled" | "text" | "link";
-/** 按钮尺寸等级。 */
-type ButtonSize = ControlSize;
-/** 按钮的属性配置。 */
-interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
-    /**
-     组件的视觉样式。
-     * @defaultValue "default"
-     */
-    variant?: ButtonVariant;
-    /** small / medium / large 高度为 22 / 30 / 38px；默认继承 Form，组件自身 size 优先 */
-    size?: ButtonSize;
-    /**
-     * 显示加载状态并禁止重复点击
-     * @defaultValue false
-     */
+/** 单个工具栏操作及其下拉菜单。 */
+interface ToolbarItem {
+    /** 操作唯一标识，点击后由 onAction 返回。 */
+    key: string;
+    /** 按钮与溢出菜单共用的文案。 */
+    label: ReactNode;
+    /** 按钮与菜单图标。 */
+    icon?: ReactNode;
+    /** 禁用该操作及其下级操作。 */
+    disabled?: boolean;
+    /** 主按钮的等待状态，等待期间不可再次触发。 */
     loading?: boolean;
-    /**
-     * 宽度撑满父容器
-     * @defaultValue false
-     */
-    block?: boolean;
-    /**
-     * 危险操作样式
-     * @defaultValue false
-     */
+    /** 危险操作样式。 */
     danger?: boolean;
-    /** 按钮图标 */
-    icon?: ReactNode;
-    /**
-     * 图标位置
-     * @defaultValue "start"
-     */
-    iconPosition?: "start" | "end";
+    /** 完全隐藏该操作，不占宽度，也不进入溢出菜单。 */
+    hidden?: boolean;
+    /** 下拉操作；split 为 true 时主按钮和下拉箭头可分别操作。 */
+    children?: readonly ToolbarItem[];
+    /** 使用独立的主操作按钮和下拉箭头。 */
+    split?: boolean;
+}
+/** 单行自适应工具栏的配置。 */
+interface ToolbarProps {
+    /** 按展示顺序排列的操作配置。 */
+    items: readonly ToolbarItem[];
+    /** 业务处理回调；异步状态由调用方通过 loading/disabled 控制。 */
+    onAction?: (key: string) => void | Promise<void>;
+    /** 禁用全部操作。 */
+    disabled?: boolean;
+    /** 按钮尺寸，默认 small。 */
+    size?: ButtonProps["size"];
+    /** 按钮样式，默认 link。 */
+    variant?: ButtonProps["variant"];
+    /** 溢出入口的无障碍名称与提示，默认“更多操作”。 */
+    overflowLabel?: string;
 }
-/** 按钮组件。 */
-declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
+/** 单行操作栏；宽度不足时按原顺序将尾部操作收纳到 hover 菜单。 */
+declare function Toolbar({ items, onAction, disabled, size, variant, overflowLabel }: ToolbarProps): react.JSX.Element;
 
 /** 卡片强调装饰的显示方式。 */
 type CardAccent = "primary" | "success" | "warning" | "error";
@@ -298,7 +298,7 @@ declare const iconPaths: {
 /** 可用的线框图标名称。 */
 type IconName = keyof typeof iconPaths;
 /** 可用线框图标名称集合。 */
-declare const ICON_NAMES: readonly ("warning" | "link" | "copy" | "move" | "zoom-in" | "zoom-out" | "table" | "italic" | "bold" | "underline" | "menu" | "search" | "send" | "notepad-file" | "notepad-folder" | "notepad-virtual-folder" | "step-backward" | "step-forward" | "fast-backward" | "fast-forward" | "corner-up-left" | "corner-up-right" | "swap-horizontal" | "swap-vertical" | "expand" | "shrink" | "fullscreen" | "fullscreen-exit" | "menu-fold" | "menu-unfold" | "login" | "logout" | "vertical-align-top" | "vertical-align-middle" | "vertical-align-bottom" | "square-plus" | "square-minus" | "square-check" | "square-close" | "tab-plus" | "folder-plus" | "pin" | "pin-off" | "stop" | "help-circle" | "save" | "clipboard" | "clipboard-check" | "file-plus" | "file-check" | "file-warning" | "file-spreadsheet" | "align-left" | "align-center" | "align-right" | "align-justify" | "strikethrough" | "list-ordered" | "list-unordered" | "eraser" | "highlighter" | "columns" | "rows" | "bar-chart" | "line-chart" | "pie-chart" | "area-chart" | "activity" | "trending-up" | "trending-down" | "database" | "cloud" | "cloud-download" | "cloud-upload" | "server" | "desktop" | "laptop" | "mobile" | "tablet" | "printer" | "camera" | "video" | "microphone" | "volume-up" | "volume-off" | "speaker-wave" | "speaker-muted" | "wifi" | "power" | "key" | "shield" | "shield-check" | "bug" | "bulb" | "rocket" | "target" | "trophy" | "shopping-cart" | "shopping-bag" | "shop" | "wallet" | "bank" | "calculator" | "tag" | "tags" | "message" | "comments" | "share" | "paperclip" | "location" | "compass" | "car" | "truck" | "gift" | "coffee" | "experiment" | "tool" | "appstore" | "puzzle" | "partition" | "branches" | "scan" | "qr-code" | "barcode" | "user-plus" | "user-minus" | "smile" | "meh" | "frown" | "game-cultivator" | "game-swordsman" | "game-spirit-wolf" | "game-gem" | "game-ingot" | "game-sword" | "game-robe" | "game-pants" | "game-pendant" | "game-necklace" | "game-pill" | "game-potion" | "game-elixir-jar" | "game-flame" | "game-soul-elixir" | "game-herb" | "game-meditate" | "game-backpack" | "game-qi" | "plus" | "minus" | "close" | "check" | "info" | "question" | "circle-check" | "circle-close" | "circle-plus" | "circle-minus" | "chevron-left" | "chevron-right" | "chevron-up" | "chevron-down" | "double-left" | "double-right" | "arrow-left" | "arrow-right" | "arrow-up" | "arrow-down" | "more-horizontal" | "more-vertical" | "home" | "user" | "users" | "settings" | "edit" | "trash" | "scissors" | "undo" | "redo" | "download" | "upload" | "refresh" | "loader" | "calendar" | "clock" | "mail" | "phone" | "external-link" | "eye" | "eye-off" | "lock" | "unlock" | "bell" | "star" | "heart" | "file" | "folder" | "image" | "filter" | "sort-ascending" | "sort-descending" | "play" | "pause" | "book" | "component" | "token" | "sun" | "moon" | "code" | "github")[];
+declare const ICON_NAMES: readonly ("search" | "bold" | "link" | "copy" | "move" | "zoom-in" | "zoom-out" | "table" | "italic" | "underline" | "menu" | "send" | "close" | "pause" | "play" | "message" | "code" | "video" | "filter" | "image" | "stop" | "warning" | "notepad-file" | "notepad-folder" | "notepad-virtual-folder" | "step-backward" | "step-forward" | "fast-backward" | "fast-forward" | "corner-up-left" | "corner-up-right" | "swap-horizontal" | "swap-vertical" | "expand" | "shrink" | "fullscreen" | "fullscreen-exit" | "menu-fold" | "menu-unfold" | "login" | "logout" | "vertical-align-top" | "vertical-align-middle" | "vertical-align-bottom" | "square-plus" | "square-minus" | "square-check" | "square-close" | "tab-plus" | "folder-plus" | "pin" | "pin-off" | "help-circle" | "save" | "clipboard" | "clipboard-check" | "file-plus" | "file-check" | "file-warning" | "file-spreadsheet" | "align-left" | "align-center" | "align-right" | "align-justify" | "strikethrough" | "list-ordered" | "list-unordered" | "eraser" | "highlighter" | "columns" | "rows" | "bar-chart" | "line-chart" | "pie-chart" | "area-chart" | "activity" | "trending-up" | "trending-down" | "database" | "cloud" | "cloud-download" | "cloud-upload" | "server" | "desktop" | "laptop" | "mobile" | "tablet" | "printer" | "camera" | "microphone" | "volume-up" | "volume-off" | "speaker-wave" | "speaker-muted" | "wifi" | "power" | "key" | "shield" | "shield-check" | "bug" | "bulb" | "rocket" | "target" | "trophy" | "shopping-cart" | "shopping-bag" | "shop" | "wallet" | "bank" | "calculator" | "tag" | "tags" | "comments" | "share" | "paperclip" | "location" | "compass" | "car" | "truck" | "gift" | "coffee" | "experiment" | "tool" | "appstore" | "puzzle" | "partition" | "branches" | "scan" | "qr-code" | "barcode" | "user-plus" | "user-minus" | "smile" | "meh" | "frown" | "game-cultivator" | "game-swordsman" | "game-spirit-wolf" | "game-gem" | "game-ingot" | "game-sword" | "game-robe" | "game-pants" | "game-pendant" | "game-necklace" | "game-pill" | "game-potion" | "game-elixir-jar" | "game-flame" | "game-soul-elixir" | "game-herb" | "game-meditate" | "game-backpack" | "game-qi" | "plus" | "minus" | "check" | "info" | "question" | "circle-check" | "circle-close" | "circle-plus" | "circle-minus" | "chevron-left" | "chevron-right" | "chevron-up" | "chevron-down" | "double-left" | "double-right" | "arrow-left" | "arrow-right" | "arrow-up" | "arrow-down" | "more-horizontal" | "more-vertical" | "home" | "user" | "users" | "settings" | "edit" | "trash" | "scissors" | "undo" | "redo" | "download" | "upload" | "refresh" | "loader" | "calendar" | "clock" | "mail" | "phone" | "external-link" | "eye" | "eye-off" | "lock" | "unlock" | "bell" | "star" | "heart" | "file" | "folder" | "sort-ascending" | "sort-descending" | "book" | "component" | "token" | "sun" | "moon" | "github")[];
 declare const filledIconPaths: {
     info: react.JSX.Element;
     question: react.JSX.Element;
@@ -334,7 +334,7 @@ type FilledIconName = keyof typeof filledIconPaths;
 /** 图标采用线框还是填充样式。 */
 type IconVariant = "outline" | "filled";
 /** 可用填充图标名称集合。 */
-declare const FILLED_ICON_NAMES: readonly ("warning" | "info" | "question" | "circle-check" | "circle-close" | "circle-plus" | "circle-minus" | "home" | "user" | "users" | "trash" | "calendar" | "clock" | "mail" | "lock" | "unlock" | "bell" | "star" | "heart" | "file" | "folder" | "image" | "filter" | "play" | "pause" | "book" | "component" | "token")[];
+declare const FILLED_ICON_NAMES: readonly ("pause" | "play" | "filter" | "image" | "warning" | "info" | "question" | "circle-check" | "circle-close" | "circle-plus" | "circle-minus" | "home" | "user" | "users" | "trash" | "calendar" | "clock" | "mail" | "lock" | "unlock" | "bell" | "star" | "heart" | "file" | "folder" | "book" | "component" | "token")[];
 /** 图标的属性配置。 */
 interface IconProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children"> {
     /** 名称或字段标识。 */
@@ -1918,124 +1918,6 @@ declare const Upload: typeof UploadRoot & {
     LIST_IGNORE: symbol;
 };
 
-/** 弹层挂载节点或返回挂载节点的函数。 */
-type OverlayContainer = HTMLElement | (() => HTMLElement);
-
-/** 模态框的类型标识。 */
-type ModalType = "default" | "info" | "success" | "warning" | "error" | "confirm";
-/** 确认操作的返回值；false 阻止关闭，Promise 可用于等待异步操作。 */
-type ModalActionResult = void | boolean | Promise<void | boolean>;
-/** 模态框的属性配置。 */
-interface ModalProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "onSubmit"> {
-    /** 是否显示对话框 */
-    open: boolean;
-    /** 标题 */
-    title?: ReactNode;
-    /** 子内容；组件嵌套内容或当前节点的子项。 */
-    children?: ReactNode;
-    /** 自定义底部操作区，传 null 隐藏 */
-    footer?: ReactNode | null;
-    /** 默认底部操作区左侧的扩展内容。 */
-    footerExtra?: ReactNode;
-    /**
-     * 类型标识，用于选择对应的表现形式。
-     * @defaultValue "default"
-     */
-    type?: ModalType;
-    /**
-     * 确定按钮文案。
-     * @defaultValue "确定"
-     */
-    okText?: ReactNode;
-    /**
-     * 取消按钮文案。
-     * @defaultValue "取消"
-     */
-    cancelText?: ReactNode;
-    /**
-     * 是否显示取消按钮。
-     * @defaultValue type === "default" || type === "confirm"
-     */
-    showCancel?: boolean;
-    /**
-     * 确定操作是否正在执行；为 true 时阻止重复提交和关闭。
-     * @defaultValue false
-     */
-    confirmLoading?: boolean;
-    /** 确定按钮的 Button 属性。 */
-    okButtonProps?: ButtonProps;
-    /** 取消按钮的 Button 属性。 */
-    cancelButtonProps?: ButtonProps;
-    /**
-     * 是否显示关闭入口。
-     * @defaultValue true
-     */
-    closable?: boolean;
-    /**
-     * 点击遮罩时是否允许关闭。
-     * @defaultValue true
-     */
-    maskClosable?: boolean;
-    /**
-     * 是否允许通过 Esc 等键盘操作关闭。
-     * @defaultValue true
-     */
-    keyboard?: boolean;
-    /**
-     * 弹框是否垂直居中。
-     * @defaultValue false
-     */
-    centered?: boolean;
-    /**
-     * 宽度；数值按像素处理，字符串可使用 CSS 尺寸。
-     * @defaultValue 520
-     */
-    width?: number | string;
-    /**
-     组件或浮层的堆叠层级。
-     * @defaultValue 1000
-     */
-    zIndex?: number;
-    /** 弹层挂载目标；可提供元素或返回元素的函数，默认挂载到页面容器。 */
-    getContainer?: OverlayContainer;
-    /** 确认回调，支持 Promise 与返回 false 阻止关闭 */
-    onOk?: () => ModalActionResult;
-    /** 用户取消或通过关闭入口退出时调用。 */
-    onCancel?: () => void;
-    /** 打开状态变化回调 */
-    onOpenChange?: (open: boolean) => void;
-    /** 动画完成后触发，适用于聚焦内容和释放外部挂载点。 */
-    afterOpenChange?: (open: boolean) => void;
-}
-/** ModalOpen的配置。 */
-interface ModalOpenConfig extends Omit<ModalProps, "open"> {
-}
-/** OverlayApi的操作句柄。 */
-interface OverlayApiHandle<T> {
-    /** 关闭弹层并在退出动画后释放挂载点。程序化关闭不会模拟用户取消按钮点击。 */
-    destroy: () => void;
-    /** 合并更新已打开弹层的配置，未提供的属性保留原值。 */
-    update: (next: Partial<T>) => void;
-}
-declare function openModal(config: ModalOpenConfig): OverlayApiHandle<ModalOpenConfig>;
-/** 模态框组件。 */
-declare const Modal: react.ForwardRefExoticComponent<ModalProps & react.RefAttributes<HTMLDivElement>> & {
-    /** 直接打开实例，返回可用于更新或关闭的操作句柄。 */
-    open: typeof openModal;
-    /** 显示普通信息提示。 */
-    info: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
-    /** 显示成功提示。 */
-    success: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
-    /** 显示警告提示。 */
-    warning: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
-    /** 显示错误提示。 */
-    error: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
-    /** 打开确认弹框，支持异步确认；返回 false 可阻止关闭。 */
-    confirm: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
-    /** 关闭由此 API 打开的所有弹层。 */
-    destroyAll(): void;
-};
-
 /** 全局消息的类型标识。 */
 type MessageType = "info" | "success" | "warning" | "error" | "loading";
 /** 全局消息的唯一标识，用于更新或关闭已有消息。 */
@@ -2285,4 +2167,4 @@ declare const FloatButton: react.ForwardRefExoticComponent<FloatButtonProps & re
     BackTop: typeof FloatButtonBackTop;
 };
 
-export { type ImageProps as $, type DropdownPlacement as A, type ButtonProps as B, Calendar as C, Dropdown as D, type DropdownProps as E, type DropdownTrigger as F, FILLED_ICON_NAMES as G, type FilledIconName as H, FloatButton as I, type FloatButtonBackTopProps as J, type FloatButtonGroupProps as K, type FloatButtonProps as L, type ModalOpenConfig as M, type FloatButtonShape as N, type OverlayContainer as O, type FloatingPlacement as P, type FloatingTrigger as Q, ICON_NAMES as R, Icon as S, type TagStatus as T, type IconName as U, type IconProps as V, type IconVariant as W, Image as X, ImagePreview as Y, type ImagePreviewConfig as Z, type ImagePreviewProps as _, type OverlayApiHandle as a, type TypographyTitleProps as a$, Input as a0, type InputProps as a1, Menu as a2, type MenuClickInfo as a3, type MenuItem as a4, type MenuMode as a5, type MenuProps as a6, type MenuTheme as a7, type MessageConfig as a8, type MessageHandle as a9, type StepsProps as aA, type TabItem as aB, Tabs as aC, type TabsContextMenuClickInfo as aD, type TabsOrientation as aE, type TabsPosition as aF, type TabsProps as aG, type TabsType as aH, Tag as aI, type TagProps as aJ, type TagVariant as aK, Timeline as aL, type TimelineItem as aM, type TimelineProps as aN, Tooltip as aO, type TooltipProps as aP, Tour as aQ, type TourProps as aR, type TourStep as aS, Tree as aT, type TreeDropPosition as aU, type TreeKey as aV, type TreeNode as aW, type TreeProps as aX, Typography as aY, type TypographyLinkProps as aZ, type TypographyProps as a_, type MessageKey as aa, type MessageType as ab, Modal as ac, type ModalProps as ad, type ModalType as ae, type NotificationConfig as af, type NotificationPlacement as ag, type NotificationType as ah, Popconfirm as ai, type PopconfirmProps as aj, Popover as ak, type PopoverProps as al, Progress as am, type ProgressProps as an, type ProgressStatus as ao, Rate as ap, type RateProps as aq, Segmented as ar, type SegmentedOption as as, type SegmentedProps as at, type SegmentedValue as au, Spin as av, type SpinProps as aw, type StepItem as ax, type StepStatus as ay, Steps as az, type ModalActionResult as b, type TypographyType as b0, Upload as b1, type UploadChangeInfo as b2, type UploadDraggerProps as b3, type UploadFile as b4, type UploadFileStatus as b5, type UploadProps as b6, type UploadRequestOptions as b7, Watermark as b8, type WatermarkFont as b9, type WatermarkProps as ba, message as bb, notification as bc, type ButtonSize as c, type BadgeProps as d, Badge as e, type BadgeRibbonProps as f, type BadgeStatus as g, Breadcrumb as h, type BreadcrumbItem as i, type BreadcrumbProps as j, Button as k, type ButtonVariant as l, type CalendarProps as m, Card as n, type CardAccent as o, type CardProps as p, Carousel as q, type CarouselProps as r, type CarouselRef as s, Collapse as t, type CollapseItem as u, type CollapseKey as v, type CollapseProps as w, type DropdownButtonProps as x, type DropdownMenuProps as y, type DropdownOpenSource as z };
+export { type MenuTheme as $, type FloatButtonGroupProps as A, type BadgeProps as B, Calendar as C, Dropdown as D, type FloatButtonProps as E, FILLED_ICON_NAMES as F, type FloatButtonShape as G, type FloatingPlacement as H, type FloatingTrigger as I, ICON_NAMES as J, Icon as K, type IconName as L, type IconProps as M, type IconVariant as N, Image as O, ImagePreview as P, type ImagePreviewConfig as Q, type ImagePreviewProps as R, type ImageProps as S, type TagStatus as T, Input as U, type InputProps as V, Menu as W, type MenuClickInfo as X, type MenuItem as Y, type MenuMode as Z, type MenuProps as _, Badge as a, type UploadRequestOptions as a$, type MessageConfig as a0, type MessageHandle as a1, type MessageKey as a2, type MessageType as a3, type NotificationConfig as a4, type NotificationPlacement as a5, type NotificationType as a6, Popconfirm as a7, type PopconfirmProps as a8, Popover as a9, Timeline as aA, type TimelineItem as aB, type TimelineProps as aC, Toolbar as aD, type ToolbarItem as aE, type ToolbarProps as aF, Tooltip as aG, type TooltipProps as aH, Tour as aI, type TourProps as aJ, type TourStep as aK, Tree as aL, type TreeDropPosition as aM, type TreeKey as aN, type TreeNode as aO, type TreeProps as aP, Typography as aQ, type TypographyLinkProps as aR, type TypographyProps as aS, type TypographyTitleProps as aT, type TypographyType as aU, Upload as aV, type UploadChangeInfo as aW, type UploadDraggerProps as aX, type UploadFile as aY, type UploadFileStatus as aZ, type UploadProps as a_, type PopoverProps as aa, Progress as ab, type ProgressProps as ac, type ProgressStatus as ad, Rate as ae, type RateProps as af, Segmented as ag, type SegmentedOption as ah, type SegmentedProps as ai, type SegmentedValue as aj, Spin as ak, type SpinProps as al, type StepItem as am, type StepStatus as an, Steps as ao, type StepsProps as ap, type TabItem as aq, Tabs as ar, type TabsContextMenuClickInfo as as, type TabsOrientation as at, type TabsPosition as au, type TabsProps as av, type TabsType as aw, Tag as ax, type TagProps as ay, type TagVariant as az, type BadgeRibbonProps as b, Watermark as b0, type WatermarkFont as b1, type WatermarkProps as b2, message as b3, notification as b4, type BadgeStatus as c, Breadcrumb as d, type BreadcrumbItem as e, type BreadcrumbProps as f, type CalendarProps as g, Card as h, type CardAccent as i, type CardProps as j, Carousel as k, type CarouselProps as l, type CarouselRef as m, Collapse as n, type CollapseItem as o, type CollapseKey as p, type CollapseProps as q, type DropdownButtonProps as r, type DropdownMenuProps as s, type DropdownOpenSource as t, type DropdownPlacement as u, type DropdownProps as v, type DropdownTrigger as w, type FilledIconName as x, FloatButton as y, type FloatButtonBackTopProps as z };