niuma-ui 2.0.2 → 2.0.3

package/dist/components/button/src/RsButton.css

@@ -1,5 +1,5 @@
 
-.rs-btn[data-v-cd44e899] {
+.rs-btn[data-v-423f0a90] {
   position: relative;
   display: inline-flex;
   align-items: center;
@@ -23,124 +23,127 @@
     padding var(--rs-transition-normal),
     gap var(--rs-transition-normal);
 }
-.rs-btn--ssm[data-v-cd44e899] {
+.rs-btn--ssm[data-v-423f0a90] {
   min-height: var(--rs-control-height-ssm);
   padding: 0 var(--rs-space-xs);
   font-size: var(--rs-font-size-xs);
   gap: var(--rs-space-xs);
 }
-.rs-btn--sm[data-v-cd44e899] {
+.rs-btn--sm[data-v-423f0a90] {
   min-height: var(--rs-control-height-sm);
   padding: 0 var(--rs-space-sm);
   font-size: var(--rs-font-size-xs);
   gap: var(--rs-space-xs);
 }
-.rs-btn--lg[data-v-cd44e899] {
+.rs-btn--lg[data-v-423f0a90] {
   min-height: var(--rs-control-height-lg);
   padding: 0 var(--rs-space-xl);
   font-size: var(--rs-font-size-base);
 }
-.rs-btn[data-v-cd44e899]:disabled {
+.rs-btn[data-v-423f0a90]:disabled {
   opacity: 0.38;
   cursor: not-allowed;
 }
-.rs-btn--loading[data-v-cd44e899] {
+.rs-btn--loading[data-v-423f0a90] {
   pointer-events: none;
   cursor: wait;
   transition: none;
 }
 /* loading 时不使用 disabled，避免部分浏览器暂停子元素 CSS 动画 */
-.rs-btn--loading[data-v-cd44e899]:disabled {
+.rs-btn--loading[data-v-423f0a90]:disabled {
   opacity: 1;
   cursor: wait;
 }
-.rs-btn--loading.rs-btn--default[data-v-cd44e899] {
+.rs-btn--loading.rs-btn--default[data-v-423f0a90] {
   color: var(--rs-text);
   border-color: var(--rs-border);
   background: var(--rs-surface);
 }
-.rs-btn--loading.rs-btn--default[data-v-cd44e899]:not(.rs-btn--tone-neutral) {
+.rs-btn--loading.rs-btn--default[data-v-423f0a90]:not(.rs-btn--tone-neutral) {
   color: var(--rs-btn-tone-on-container);
   border-color: color-mix(in srgb, var(--rs-btn-tone) 42%, var(--rs-border));
   background: var(--rs-btn-tone-container);
 }
-.rs-btn--loading.rs-btn--ghost[data-v-cd44e899],
-.rs-btn--loading.rs-btn--text[data-v-cd44e899] {
+.rs-btn--loading.rs-btn--ghost[data-v-423f0a90],
+.rs-btn--loading.rs-btn--text[data-v-423f0a90] {
   color: var(--rs-btn-tone, var(--rs-text));
   background: var(--rs-surface-hover);
 }
-.rs-btn[data-v-cd44e899]:focus-visible {
+.rs-btn[data-v-423f0a90]:focus-visible {
   outline: none;
   box-shadow: 0 0 0 var(--rs-focus-ring-width, 2px) var(--rs-focus-ring);
 }
-.rs-btn--icon-only[data-v-cd44e899] {
+.rs-btn--icon-only[data-v-423f0a90] {
   padding: 0;
   min-width: var(--rs-control-height-md);
 }
-.rs-btn--icon-only.rs-btn--ssm[data-v-cd44e899] {
+.rs-btn--icon-only.rs-btn--ssm[data-v-423f0a90] {
   min-width: var(--rs-control-height-ssm);
 }
-.rs-btn--icon-only.rs-btn--sm[data-v-cd44e899] {
+.rs-btn--icon-only.rs-btn--sm[data-v-423f0a90] {
   min-width: var(--rs-control-height-sm);
 }
-.rs-btn--icon-only.rs-btn--lg[data-v-cd44e899] {
+.rs-btn--icon-only.rs-btn--lg[data-v-423f0a90] {
   min-width: var(--rs-control-height-lg);
 }
-.rs-btn--primary[data-v-cd44e899] {
+.rs-btn--primary[data-v-423f0a90] {
   background: var(--rs-primary);
   color: var(--rs-primary-foreground);
   box-shadow: var(--rs-shadow-sm);
 }
-.rs-btn--primary[data-v-cd44e899]:hover:not(:disabled) {
+.rs-btn--primary[data-v-423f0a90]:hover:not(:disabled) {
   background: var(--rs-primary-hover);
   box-shadow: var(--rs-shadow);
 }
-.rs-btn--primary[data-v-cd44e899]:active:not(:disabled) {
+.rs-btn--primary[data-v-423f0a90]:active:not(:disabled) {
   box-shadow: none;
 }
-.rs-btn--default[data-v-cd44e899] {
+.rs-btn--default[data-v-423f0a90] {
   border: 1px solid var(--rs-btn-outline-border, var(--rs-border));
   background: var(--rs-btn-secondary-bg, var(--rs-surface-hover));
   color: var(--rs-text);
   box-shadow: none;
 }
-.rs-btn--default[data-v-cd44e899]:hover:not(:disabled) {
+.rs-btn--default[data-v-423f0a90]:hover:not(:disabled) {
   color: var(--rs-primary);
   border-color: var(--rs-primary);
   background: var(--rs-btn-secondary-bg-hover, var(--rs-primary-container));
 }
-.rs-btn--default[data-v-cd44e899]:active:not(:disabled) {
+.rs-btn--default[data-v-423f0a90]:active:not(:disabled) {
   color: var(--rs-primary-hover);
   border-color: var(--rs-primary-hover);
   background: var(--rs-btn-secondary-bg-active, var(--rs-primary-container));
 }
-.rs-btn--ghost[data-v-cd44e899] {
+.rs-btn--ghost[data-v-423f0a90] {
   background: transparent;
   border: 1px solid var(--rs-btn-outline-border, var(--rs-border));
   color: var(--rs-btn-tone, var(--rs-text));
 }
-.rs-btn--ghost[data-v-cd44e899]:hover:not(:disabled) {
-  background: color-mix(in srgb, var(--rs-btn-tone, var(--rs-text)) 8%, transparent);
+.rs-btn--ghost[data-v-423f0a90]:hover:not(:disabled) {
+  background: var(--rs-surface-hover);
   border-color: var(--rs-btn-outline-border, var(--rs-border));
   color: var(--rs-btn-tone-hover, var(--rs-btn-tone, var(--rs-text)));
 }
-.rs-btn--borderless[data-v-cd44e899],
-.rs-btn--borderless[data-v-cd44e899]:hover:not(:disabled),
-.rs-btn--borderless[data-v-cd44e899]:active:not(:disabled) {
+.rs-btn--ghost[data-v-423f0a90]:active:not(:disabled) {
+  background: color-mix(in srgb, var(--rs-btn-tone, var(--rs-text)) 12%, var(--rs-surface-hover));
+}
+.rs-btn--borderless[data-v-423f0a90],
+.rs-btn--borderless[data-v-423f0a90]:hover:not(:disabled),
+.rs-btn--borderless[data-v-423f0a90]:active:not(:disabled) {
   border-color: transparent;
 }
-.rs-btn--danger[data-v-cd44e899] {
+.rs-btn--danger[data-v-423f0a90] {
   background: var(--rs-danger-container);
   border-color: color-mix(in srgb, var(--rs-danger) 30%, transparent);
   color: var(--rs-on-danger-container);
 }
-.rs-btn--danger[data-v-cd44e899]:hover:not(:disabled) {
+.rs-btn--danger[data-v-423f0a90]:hover:not(:disabled) {
   border-color: var(--rs-danger);
   background: color-mix(in srgb, var(--rs-danger) 20%, var(--rs-danger-container));
 }
 
 /* 行内链接：可下划线；色调由 tone 控制（默认 primary） */
-.rs-btn--link[data-v-cd44e899] {
+.rs-btn--link[data-v-423f0a90] {
   min-height: auto;
   padding: 0;
   border-color: transparent;
@@ -150,7 +153,7 @@
   box-shadow: none;
   font-weight: var(--rs-font-weight-medium);
 }
-.rs-btn--link[data-v-cd44e899]:hover:not(:disabled) {
+.rs-btn--link[data-v-423f0a90]:hover:not(:disabled) {
   color: var(--rs-btn-tone-hover, var(--rs-primary-hover));
   text-decoration: underline;
 }
@@ -159,7 +162,7 @@
  * text：工具栏 / 表格操作 quaternary
  * 无底无边，靠 tone 着色；hover 使用同色浅底
  */
-.rs-btn--text[data-v-cd44e899] {
+.rs-btn--text[data-v-423f0a90] {
   min-height: var(--rs-control-height-sm);
   padding: 0 var(--rs-space-sm);
   border-color: transparent;
@@ -168,103 +171,105 @@
   font-weight: var(--rs-font-weight-regular);
   color: var(--rs-btn-tone, var(--rs-text));
 }
-.rs-btn--text.rs-btn--ssm[data-v-cd44e899] {
+.rs-btn--text.rs-btn--ssm[data-v-423f0a90] {
   min-height: var(--rs-control-height-ssm);
 }
-.rs-btn--text.rs-btn--md[data-v-cd44e899] {
+.rs-btn--text.rs-btn--md[data-v-423f0a90] {
   min-height: var(--rs-control-height-md);
 }
-.rs-btn--text.rs-btn--lg[data-v-cd44e899] {
+.rs-btn--text.rs-btn--lg[data-v-423f0a90] {
   min-height: var(--rs-control-height-lg);
 }
-.rs-btn--text[data-v-cd44e899]:hover:not(:disabled) {
+.rs-btn--text[data-v-423f0a90]:hover:not(:disabled) {
   background: color-mix(in srgb, var(--rs-btn-tone, var(--rs-text)) 8%, transparent);
   border-color: transparent;
   color: var(--rs-btn-tone-hover, var(--rs-btn-tone, var(--rs-text)));
 }
-.rs-btn--text[data-v-cd44e899]:active:not(:disabled) {
+.rs-btn--text[data-v-423f0a90]:active:not(:disabled) {
   background: color-mix(in srgb, var(--rs-btn-tone, var(--rs-text)) 12%, transparent);
 }
 
 /* tone：色相 token，供所有变体消费（形态 × 色相） */
-.rs-btn--tone-neutral[data-v-cd44e899] {
+.rs-btn--tone-neutral[data-v-423f0a90] {
   --rs-btn-tone: var(--rs-text);
   --rs-btn-tone-hover: var(--rs-text);
   --rs-btn-tone-fg: var(--rs-text);
   --rs-btn-tone-container: var(--rs-btn-secondary-bg, var(--rs-surface-hover));
   --rs-btn-tone-on-container: var(--rs-text);
 }
-.rs-btn--tone-primary[data-v-cd44e899] {
+.rs-btn--tone-primary[data-v-423f0a90] {
   --rs-btn-tone: var(--rs-primary);
   --rs-btn-tone-hover: var(--rs-primary-hover);
   --rs-btn-tone-fg: var(--rs-primary-foreground);
   --rs-btn-tone-container: var(--rs-primary-container);
   --rs-btn-tone-on-container: var(--rs-on-primary-container);
 }
-.rs-btn--tone-danger[data-v-cd44e899] {
+.rs-btn--tone-danger[data-v-423f0a90] {
   --rs-btn-tone: var(--rs-danger);
   --rs-btn-tone-hover: var(--rs-danger);
-  --rs-btn-tone-fg: #fff;
+  --rs-btn-tone-fg: var(--rs-text-inverse);
   --rs-btn-tone-container: var(--rs-danger-container);
   --rs-btn-tone-on-container: var(--rs-on-danger-container);
 }
-.rs-btn--tone-success[data-v-cd44e899] {
+.rs-btn--tone-success[data-v-423f0a90] {
   --rs-btn-tone: var(--rs-success, #18a058);
   --rs-btn-tone-hover: var(--rs-success, #18a058);
-  --rs-btn-tone-fg: #fff;
+  --rs-btn-tone-fg: var(--rs-text-inverse);
   --rs-btn-tone-container: var(--rs-success-container, color-mix(in srgb, var(--rs-success, #18a058) 14%, var(--rs-surface)));
   --rs-btn-tone-on-container: var(--rs-on-success-container, var(--rs-success, #18a058));
 }
-.rs-btn--tone-warning[data-v-cd44e899] {
+.rs-btn--tone-warning[data-v-423f0a90] {
   --rs-btn-tone: var(--rs-warning, #f0a020);
   --rs-btn-tone-hover: var(--rs-warning, #f0a020);
-  --rs-btn-tone-fg: #fff;
+  --rs-btn-tone-fg: var(--rs-text-inverse);
   --rs-btn-tone-container: var(--rs-warning-container, color-mix(in srgb, var(--rs-warning, #f0a020) 14%, var(--rs-surface)));
   --rs-btn-tone-on-container: var(--rs-on-warning-container, var(--rs-warning, #f0a020));
 }
-.rs-btn--tone-info[data-v-cd44e899] {
+.rs-btn--tone-info[data-v-423f0a90] {
   --rs-btn-tone: var(--rs-info, #2080f0);
   --rs-btn-tone-hover: var(--rs-info, #2080f0);
-  --rs-btn-tone-fg: #fff;
+  --rs-btn-tone-fg: var(--rs-text-inverse);
   --rs-btn-tone-container: var(--rs-info-container, color-mix(in srgb, var(--rs-info, #2080f0) 14%, var(--rs-surface)));
   --rs-btn-tone-on-container: var(--rs-on-info-container, var(--rs-info, #2080f0));
 }
 
 /* default + 语义色：轮廓 + 浅底（Ant outlined / Element plain） */
-.rs-btn--default[data-v-cd44e899]:not(.rs-btn--tone-neutral) {
+.rs-btn--default[data-v-423f0a90]:not(.rs-btn--tone-neutral) {
   color: var(--rs-btn-tone-on-container);
   border-color: color-mix(in srgb, var(--rs-btn-tone) 42%, var(--rs-border));
   background: var(--rs-btn-tone-container);
 }
-.rs-btn--default[data-v-cd44e899]:not(.rs-btn--tone-neutral):hover:not(:disabled) {
+.rs-btn--default[data-v-423f0a90]:not(.rs-btn--tone-neutral):hover:not(:disabled) {
   color: var(--rs-btn-tone);
   border-color: var(--rs-btn-tone);
   background: color-mix(in srgb, var(--rs-btn-tone) 14%, var(--rs-btn-tone-container));
 }
-.rs-btn--default[data-v-cd44e899]:not(.rs-btn--tone-neutral):active:not(:disabled) {
+.rs-btn--default[data-v-423f0a90]:not(.rs-btn--tone-neutral):active:not(:disabled) {
   color: var(--rs-btn-tone-hover);
   border-color: var(--rs-btn-tone-hover);
   background: color-mix(in srgb, var(--rs-btn-tone) 20%, var(--rs-btn-tone-container));
 }
 
 /* primary + 非主色：实心语义色 */
-.rs-btn--primary[data-v-cd44e899]:not(.rs-btn--tone-primary) {
+.rs-btn--primary[data-v-423f0a90]:not(.rs-btn--tone-primary) {
   background: var(--rs-btn-tone);
   color: var(--rs-btn-tone-fg);
   border-color: transparent;
 }
-.rs-btn--primary[data-v-cd44e899]:not(.rs-btn--tone-primary):hover:not(:disabled) {
+.rs-btn--primary[data-v-423f0a90]:not(.rs-btn--tone-primary):hover:not(:disabled) {
   background: var(--rs-btn-tone-hover);
 }
 
 /* ghost + 语义色：描边跟色相 */
-.rs-btn--ghost[data-v-cd44e899]:not(.rs-btn--tone-neutral) {
+.rs-btn--ghost[data-v-423f0a90]:not(.rs-btn--tone-neutral) {
   border-color: color-mix(in srgb, var(--rs-btn-tone) 45%, var(--rs-border));
 }
-.rs-btn--ghost[data-v-cd44e899]:not(.rs-btn--tone-neutral):hover:not(:disabled) {
+.rs-btn--ghost[data-v-423f0a90]:not(.rs-btn--tone-neutral):hover:not(:disabled) {
   border-color: var(--rs-btn-tone);
+  background: color-mix(in srgb, var(--rs-btn-tone) 14%, var(--rs-surface));
+  color: var(--rs-btn-tone);
 }
-.rs-btn__spinner[data-v-cd44e899] {
+.rs-btn__spinner[data-v-423f0a90] {
   display: inline-flex;
   align-items: center;
   justify-content: center;
@@ -273,7 +278,7 @@
   flex-shrink: 0;
   pointer-events: none;
 }
-.rs-btn__spinner-ring[data-v-cd44e899] {
+.rs-btn__spinner-ring[data-v-423f0a90] {
   display: block;
   width: 100%;
   height: 100%;
@@ -281,27 +286,27 @@
   border-top-color: var(--rs-primary);
   border-radius: var(--rs-radius-full);
   transform-origin: center center;
-  animation: rs-spin-cd44e899 0.75s linear infinite;
+  animation: rs-spin-423f0a90 0.75s linear infinite;
 }
-.rs-btn--default .rs-btn__spinner-ring[data-v-cd44e899],
-.rs-btn--ghost .rs-btn__spinner-ring[data-v-cd44e899] {
+.rs-btn--default .rs-btn__spinner-ring[data-v-423f0a90],
+.rs-btn--ghost .rs-btn__spinner-ring[data-v-423f0a90] {
   border-color: color-mix(in srgb, var(--rs-btn-tone, var(--rs-primary)) 28%, transparent);
   border-top-color: var(--rs-btn-tone, var(--rs-primary));
 }
-.rs-btn--text .rs-btn__spinner-ring[data-v-cd44e899],
-.rs-btn--link .rs-btn__spinner-ring[data-v-cd44e899] {
+.rs-btn--text .rs-btn__spinner-ring[data-v-423f0a90],
+.rs-btn--link .rs-btn__spinner-ring[data-v-423f0a90] {
   border-color: color-mix(in srgb, var(--rs-btn-tone, var(--rs-primary)) 28%, transparent);
   border-top-color: var(--rs-btn-tone, var(--rs-primary));
 }
-.rs-btn--primary .rs-btn__spinner-ring[data-v-cd44e899] {
+.rs-btn--primary .rs-btn__spinner-ring[data-v-423f0a90] {
   border-color: color-mix(in srgb, currentcolor 35%, transparent);
   border-top-color: currentcolor;
 }
-.rs-btn--danger .rs-btn__spinner-ring[data-v-cd44e899] {
+.rs-btn--danger .rs-btn__spinner-ring[data-v-423f0a90] {
   border-color: color-mix(in srgb, var(--rs-danger) 28%, transparent);
   border-top-color: var(--rs-danger);
 }
-.rs-btn__icon[data-v-cd44e899] {
+.rs-btn__icon[data-v-423f0a90] {
   display: inline-flex;
   flex-shrink: 0;
   align-items: center;
@@ -310,7 +315,7 @@
   color: inherit;
 }
 /* 插槽内自定义图标+文案时也能水平对齐 */
-.rs-btn__label[data-v-cd44e899] {
+.rs-btn__label[data-v-423f0a90] {
   display: inline-flex;
   align-items: center;
   gap: inherit;
@@ -318,7 +323,7 @@
   line-height: 1;
   white-space: nowrap;
 }
-.rs-btn__label--reveal[data-v-cd44e899] {
+.rs-btn__label--reveal[data-v-423f0a90] {
   display: inline-block;
   max-width: 0;
   opacity: 0;
@@ -329,13 +334,14 @@
     max-width 0.2s ease,
     opacity 0.15s ease;
 }
-.rs-btn--reveal-label:hover:not(:disabled) .rs-btn__label--reveal[data-v-cd44e899],
-.rs-btn--reveal-label:focus-visible .rs-btn__label--reveal[data-v-cd44e899] {
+.rs-btn--reveal-label:hover:not(:disabled) .rs-btn__label--reveal[data-v-423f0a90],
+.rs-btn--reveal-label:focus-visible .rs-btn__label--reveal[data-v-423f0a90] {
   max-width: 12rem;
   opacity: 1;
 }
-.rs-btn__tooltip[data-v-cd44e899] {
+.rs-btn__tooltip[data-v-423f0a90] {
   position: fixed;
+  /* Portal 挂 body，必须高于 Dialog/Drawer（100/101），与 RsTooltip 同一档 */
   z-index: calc(var(--rs-z-modal) + 2);
   padding: 0.25rem 0.5rem;
   border-radius: var(--rs-radius-sm);
@@ -349,8 +355,18 @@
   box-shadow: var(--rs-shadow-sm);
   pointer-events: none;
 }
-@keyframes rs-spin-cd44e899 {
+@keyframes rs-spin-423f0a90 {
 to {
     transform: rotate(360deg);
 }
 }
+@media (prefers-reduced-motion: reduce) {
+.rs-btn[data-v-423f0a90],
+  .rs-btn__label--reveal[data-v-423f0a90] {
+    transition: none;
+}
+.rs-btn__spinner-ring[data-v-423f0a90] {
+    animation: none;
+    border-top-color: transparent;
+}
+}

package/dist/components/button/src/RsButton.d.ts

@@ -15,7 +15,10 @@ type __VLS_Props = {
     type?: 'button' | 'submit' | 'reset';
     disabled?: boolean;
     loading?: boolean;
-    /** 是否显示外边框；text 变体默认无边框 */
+    /**
+     * 是否显示外边框。未传时 text / link 无边，其余有边。
+     * 默认必须是 undefined：Vue 会把未传的 Boolean 收成 false。
+     */
     bordered?: boolean;
     /** 前缀图标（Lucide kebab-case 名称） */
     icon?: string;
@@ -23,8 +26,8 @@ type __VLS_Props = {
     /** 仅显示图标，文字通过 tooltip / slot 悬浮展示 */
     iconOnly?: boolean;
     /**
-     * 悬浮提示。打开时 Teleport 到 `document.body`（对齐 WAI-ARIA APG Tooltip / Reka Portal）。
-     * 仅图标按钮时作可视提示；无障碍名称仍走 `aria-label`，避免与 tip 重复朗读。
+     * 悬浮提示。Teleport 到 `document.body`，避免被 overflow 裁切。
+     * 仅图标时作可视提示；可访问名称走 `aria-label`，避免读两遍。
      */
     tooltip?: string;
     /** icon-only 时无障碍标签（与 tooltip 二选一，避免与外部 RsTooltip 重复） */
@@ -43,6 +46,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {},
     variant: RsButtonVariant;
     disabled: boolean;
     loading: boolean;
+    bordered: boolean;
     iconOnly: boolean;
     revealLabel: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/components/button/src/RsButton.impl.js

@@ -1,6 +1,6 @@
 import { RS_COMPONENT_SIZE_ICON_PX } from "../../../theme/types.js";
 import RsIcon_default from "../../icon/src/RsIcon.js";
-import { resolveRsButtonTone, resolveRsButtonVariant } from "./button-utils.js";
+import { placeRsButtonTip, resolveRsButtonTone, resolveRsButtonVariant } from "./button-utils.js";
 import { useResolvedRsComponentSize } from "../../_shared/src/resolve-size.js";
 import { rsRadiusCss, useResolvedRsRadius } from "../../_shared/src/resolve-radius.js";
 import { Fragment, Teleport, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, defineComponent, nextTick, normalizeClass, normalizeStyle, onUnmounted, openBlock, ref, renderSlot, toDisplayString, unref, useId, useSlots, watch } from "vue";
@@ -21,6 +21,7 @@ var _hoisted_2 = {
 var _hoisted_3 = ["id"];
 var TOOLTIP_DELAY_MS = 300;
 var RsButton_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsButton",
 	__name: "RsButton",
 	props: {
 		variant: { default: "primary" },
@@ -36,7 +37,10 @@ var RsButton_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineC
 			type: Boolean,
 			default: false
 		},
-		bordered: { type: Boolean },
+		bordered: {
+			type: Boolean,
+			default: void 0
+		},
 		icon: {},
 		iconSize: {},
 		iconOnly: {
@@ -82,8 +86,9 @@ var RsButton_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineC
 			if (!props.iconOnly) return void 0;
 			return props.ariaLabel || props.tooltip || void 0;
 		});
-		/** 与 RsTooltipProvider 默认一致：避免路过按钮时闪一下 */
+		/** 避免路过按钮时闪一下 */
 		const tipId = useId();
+		const tipRef = ref(null);
 		const tipOpen = ref(false);
 		const tipStyle = ref({});
 		let openTimer = null;
@@ -97,24 +102,24 @@ var RsButton_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineC
 		}
 		function updateTipPosition() {
 			const el = btnRef.value;
-			if (!el) return;
+			if (!el || typeof window === "undefined") return;
 			const rect = el.getBoundingClientRect();
-			const mid = rect.left + rect.width / 2;
-			const vw = window.innerWidth;
-			const gap = 6;
-			let left = mid;
-			let transform = "translateX(-50%)";
-			if (mid > vw * .72) {
-				left = rect.right;
-				transform = "translateX(-100%)";
-			} else if (mid < vw * .28) {
-				left = rect.left;
-				transform = "none";
-			}
+			const tip = tipRef.value?.getBoundingClientRect();
+			const box = placeRsButtonTip({
+				top: rect.top,
+				left: rect.left,
+				width: rect.width,
+				height: rect.height
+			}, {
+				width: tip?.width ?? 96,
+				height: tip?.height ?? 28
+			}, {
+				width: window.innerWidth,
+				height: window.innerHeight
+			});
 			tipStyle.value = {
-				top: `${Math.round(rect.bottom + gap)}px`,
-				left: `${Math.round(left)}px`,
-				transform
+				top: `${box.top}px`,
+				left: `${box.left}px`
 			};
 		}
 		function scheduleTipPosition() {
@@ -148,11 +153,16 @@ var RsButton_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineC
 		}
 		function openTipNow() {
 			if (!showFloatingText.value || props.disabled || props.loading) return;
-			updateTipPosition();
 			if (!tipOpen.value) {
 				tipOpen.value = true;
 				bindTipFollow(true);
 			}
+			nextTick(() => updateTipPosition());
+		}
+		function onActivate(event) {
+			if (!props.loading) return;
+			event.preventDefault();
+			event.stopImmediatePropagation();
 		}
 		function scheduleOpenTip() {
 			if (!showFloatingText.value || props.disabled || props.loading) return;
@@ -181,8 +191,9 @@ var RsButton_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineC
 			if (!el) return;
 			if (loading) {
 				await nextTick();
-				const w = el.offsetWidth;
-				if (w > 0) el.style.minWidth = `${w}px`;
+				if (!btnRef.value) return;
+				const w = btnRef.value.offsetWidth;
+				if (w > 0) btnRef.value.style.minWidth = `${w}px`;
 			} else el.style.minWidth = "";
 		});
 		onUnmounted(() => {
@@ -200,6 +211,7 @@ var RsButton_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineC
 				"aria-disabled": __props.disabled || __props.loading || void 0,
 				"aria-label": ariaLabel.value,
 				"aria-describedby": tipDescribedBy.value,
+				onClickCapture: onActivate,
 				onMouseenter: scheduleOpenTip,
 				onMouseleave: closeTip,
 				onFocus,
@@ -210,24 +222,24 @@ var RsButton_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineC
 					key: 1,
 					class: "rs-btn__icon",
 					name: __props.icon,
-					size: resolvedIconSize.value,
-					label: __props.iconOnly && __props.tooltip ? __props.tooltip : void 0
-				}, null, 8, [
-					"name",
-					"size",
-					"label"
-				])) : createCommentVNode("", true),
+					size: resolvedIconSize.value
+				}, null, 8, ["name", "size"])) : createCommentVNode("", true),
 				hasLabel.value && !__props.iconOnly ? (openBlock(), createElementBlock("span", {
 					key: 2,
 					class: normalizeClass(["rs-btn__label", { "rs-btn__label--reveal": __props.revealLabel && __props.icon }])
 				}, [renderSlot(_ctx.$slots, "default", {}, void 0, true)], 2)) : createCommentVNode("", true),
-				(openBlock(), createBlock(Teleport, { to: "body" }, [tipOpen.value ? (openBlock(), createElementBlock("span", {
+				showFloatingText.value ? (openBlock(), createBlock(Teleport, {
+					key: 3,
+					to: "body"
+				}, [tipOpen.value ? (openBlock(), createElementBlock("span", {
 					key: 0,
+					ref_key: "tipRef",
+					ref: tipRef,
 					id: unref(tipId),
 					class: "rs-btn__tooltip",
 					style: normalizeStyle(tipStyle.value),
 					role: "tooltip"
-				}, [__props.tooltip ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [createTextVNode(toDisplayString(__props.tooltip), 1)], 64)) : __props.iconOnly ? renderSlot(_ctx.$slots, "default", {}, void 0, true, 1) : createCommentVNode("", true)], 12, _hoisted_3)) : createCommentVNode("", true)]))
+				}, [__props.tooltip ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [createTextVNode(toDisplayString(__props.tooltip), 1)], 64)) : __props.iconOnly ? renderSlot(_ctx.$slots, "default", {}, void 0, true, 1) : createCommentVNode("", true)], 12, _hoisted_3)) : createCommentVNode("", true)])) : createCommentVNode("", true)
 			], 46, _hoisted_1);
 		};
 	}

package/dist/components/button/src/RsButton.js

@@ -3,6 +3,6 @@ import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_exp
 import RsButton_vue_vue_type_script_setup_true_lang_default from "./RsButton.impl.js";
 
 //#region src/components/button/src/RsButton.vue
-var RsButton_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsButton_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-cd44e899"]]);
+var RsButton_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsButton_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-423f0a90"]]);
 //#endregion
 export { RsButton_default as default };

package/dist/components/button/src/button-utils.d.ts

@@ -24,3 +24,20 @@ export declare function resolveRsButtonTone(variant?: RsButtonVariant, tone?: Rs
 export declare function isRsButtonFilledVariant(variant: RsButtonVariant): boolean;
 /** 所有变体都可叠加 tone（形态 × 色相）。 */
 export declare function supportsRsButtonTone(_variant?: RsButtonVariant): boolean;
+export interface RsButtonTipBox {
+    top: number;
+    left: number;
+}
+/** 把内置 tip 贴到按钮：优先下方，贴边时夹进视口。供测试与 SSR 无 window 调用。 */
+export declare function placeRsButtonTip(anchor: {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}, popup: {
+    width: number;
+    height: number;
+}, viewport: {
+    width: number;
+    height: number;
+}, gap?: number): RsButtonTipBox;

package/dist/components/button/src/button-utils.js

@@ -24,5 +24,18 @@ function isRsButtonFilledVariant(variant) {
 function supportsRsButtonTone(_variant) {
 	return true;
 }
+/** 把内置 tip 贴到按钮：优先下方，贴边时夹进视口。供测试与 SSR 无 window 调用。 */
+function placeRsButtonTip(anchor, popup, viewport, gap = 6) {
+	const below = anchor.top + anchor.height + gap;
+	const above = anchor.top - popup.height - gap;
+	const top = below + popup.height <= viewport.height || above < gap ? below : Math.max(gap, above);
+	const width = Math.min(popup.width, Math.max(0, viewport.width - gap * 2));
+	const preferred = anchor.left + anchor.width / 2 - width / 2;
+	const maxLeft = Math.max(gap, viewport.width - width - gap);
+	return {
+		top: Math.round(top),
+		left: Math.round(Math.min(Math.max(gap, preferred), maxLeft))
+	};
+}
 //#endregion
-export { isRsButtonFilledVariant, resolveRsButtonTone, resolveRsButtonVariant, supportsRsButtonTone };
+export { isRsButtonFilledVariant, placeRsButtonTip, resolveRsButtonTone, resolveRsButtonVariant, supportsRsButtonTone };

package/dist/components/cascader/src/RsCascader.d.ts

@@ -25,10 +25,10 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {},
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
 }>, {
     disabled: boolean;
-    separator: string;
     allowClear: boolean;
     changeOnSelect: boolean;
     expandTrigger: RsCascaderExpandTrigger;
+    separator: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -1 +1,2 @@
 export { default as RsDivider } from './src/RsDivider.js';
+export type { RsDividerOrientation } from './src/divider-utils';