seam-react 0.13.1 → 0.13.3

package/README.md

@@ -45,7 +45,7 @@ export function Root() {
 - Form 提供组合式字段、同步/异步规则、服务端错误和失败聚焦；安装 `valibot` 后可通过 `seam-react/valibot` 接入 schema 校验。
 - Sidebar 提供可折叠 Group、可配置分组间距，以及互斥的轨道与背景 hover 模式。
 
-完整文档：[chenhaojie9527.github.io/ui-kit](https://chenhaojie9527.github.io/ui-kit/)
+完整文档：[ui-kit.cn](https://ui-kit.cn/)
 
 ## License
 

package/dist/Badge.d.ts

@@ -1,14 +1,25 @@
 import { type ForwardRefExoticComponent, type HTMLAttributes, type KeyboardEvent, type MouseEvent, type ReactNode, type RefAttributes } from "react";
-export type BadgeVariant = "default" | "primary" | "success" | "warning" | "danger";
+export type BadgeVariant = "default" | "primary" | "success" | "warning" | "danger" | "loading";
+export type BadgeSize = "sm" | "md";
 export type BadgeDismissEvent = MouseEvent<HTMLButtonElement> | KeyboardEvent<HTMLButtonElement>;
 export interface BadgeProps extends Omit<HTMLAttributes<HTMLSpanElement>, "onChange"> {
-    /** 视觉与语义颜色，默认 default。 */
+    /** 视觉与语义颜色；loading 会显示 spinner 并默认开启脉冲。 */
     variant?: BadgeVariant;
+    /** 尺寸，默认 md 保持既有高度与字号。 */
+    size?: BadgeSize;
     /** 简短的状态或元数据内容；Badge 不自动截断或换行。 */
     children: ReactNode;
+    /** 覆盖当前 variant 的默认状态图标；图标需要控制在 1em 见方内。 */
+    icon?: ReactNode;
+    /** 是否显示状态图标，默认 true。 */
+    showIcon?: boolean;
+    /** 是否显示脉冲；默认只在 variant 为 loading 时开启。 */
+    pulse?: boolean;
+    /** 状态切换动画的稳定 key；默认取 children（文本）或 variant。 */
+    contentKey?: string | number;
     /** 激活关闭按钮时调用；不会自动移除 Badge。 */
     onDismiss?: (event: BadgeDismissEvent) => void;
-    /** 是否显示关闭按钮，默认 Boolean(onDismiss)。 */
+    /** 是否显示关闭按钮，默认 Boolean(onDismiss)；loading 时始终隐藏。 */
     dismissible?: boolean;
     /** 关闭按钮的无障碍名称，建议明确指出被移除的对象。 */
     dismissLabel?: string;
@@ -20,7 +31,8 @@ export interface BadgeProps extends Omit<HTMLAttributes<HTMLSpanElement>, "onCha
 /**
  * 紧凑的内联状态或元数据标签。
  *
- * 默认只渲染语义中性的 span，不添加 live region 或入场动画。提供
- * onDismiss 时显示原生关闭按钮；是否移除 Badge 始终由调用方控制。
+ * 按 variant 自动配状态图标；loading 使用 spinner 与轻脉冲。状态或文案变化时
+ * 图标和文字做一次短距离滚动替换，宽度通过共享 layout 连续过渡。默认不添加
+ * live region，也不做挂载入场动画。
  */
 export declare const Badge: ForwardRefExoticComponent<BadgeProps & RefAttributes<HTMLSpanElement>>;