aha-components 1.7.7 → 1.7.8

package/dist/components/Button/Button.stories.d.ts

@@ -3,12 +3,20 @@ import Button from './index';
 declare const meta: Meta<typeof Button>;
 export default meta;
 type Story = StoryObj<typeof Button>;
-export declare const Basic: Story;
-export declare const Types: Story;
+export declare const Playground: Story;
+/** Hierarchy：5 个层级 × default/focused/disabled/loading */
+export declare const Hierarchy: Story;
+/** Destructive：4 个 destructive 层级 × default/focused/disabled/loading */
+export declare const Destructive: Story;
+/** Size: sm / md / lg / xl */
 export declare const Sizes: Story;
-export declare const PrimarySizes: Story;
-export declare const Disabled: Story;
-export declare const Loading: Story;
+/** State：以 secondary 为例展示 4 个状态 */
+export declare const States: Story;
+/** Icon only：仅图标按钮（square） */
+export declare const IconOnly: Story;
+/** 图标位置：左（leading） */
 export declare const WithIcon: Story;
-export declare const LoadingWithIcon: Story;
-export declare const AllStates: Story;
+/** 图标位置：右（trailing） */
+export declare const IconTrailing: Story;
+/** 完整矩阵：size × hierarchy × state × icon-only */
+export declare const FullMatrix: Story;

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

@@ -1,28 +1,32 @@
 import React from 'react';
-export type ButtonType = 'default' | 'primary';
-export type ButtonSize = 'small' | 'mediumSmall' | 'medium' | 'large';
+/**
+ * 对齐 Figma: Untitled UI v7 — Buttons
+ * 维度：Size × Hierarchy × State × Icon only
+ *   Size:       sm(36) / md(40) / lg(44) / xl(48)
+ *   Hierarchy:  primary / secondary / tertiary / link-color / link-gray
+ *   State:      default / hover / focused / disabled / loading
+ *   Icon only:  boolean
+ */
+export type ButtonHierarchy = 'primary' | 'secondary' | 'tertiary' | 'link-color' | 'link-gray' | 'destructive-primary' | 'destructive-secondary' | 'destructive-tertiary' | 'destructive-link' | 'default';
+export type ButtonSize = 'sm' | 'md' | 'lg' | 'xl' | 'small' | 'mediumSmall' | 'medium' | 'large';
+export type ButtonType = ButtonHierarchy;
 export interface ButtonProps {
-    /** 按钮内容 */
     children?: React.ReactNode;
-    /** 按钮类型 */
-    type?: ButtonType;
-    /** 按钮尺寸 */
+    /** 按钮层级（对应 Figma Hierarchy）。`default` 为 `secondary` 的旧名 */
+    type?: ButtonHierarchy;
+    /** 按钮尺寸（对应 Figma Size）。旧名会映射到新尺寸 */
     size?: ButtonSize;
-    /** 是否禁用 */
     disabled?: boolean;
-    /** 是否加载中 */
     loading?: boolean;
-    /** 点击事件 */
-    onClick?: (e: React.MouseEvent<HTMLButtonElement, MouseEvent>) => void;
-    /** 按钮原生type */
+    /** 仅图标按钮。不传 `children`、仅传 `icon` 时自动开启 */
+    iconOnly?: boolean;
+    /** 受控的 Focused 视觉态，用于 Storybook 预览设计稿；真实键盘焦点由 :focus-visible 处理 */
+    focused?: boolean;
+    onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
     htmlType?: 'button' | 'submit' | 'reset';
-    /** 自定义类名 */
     className?: string;
-    /** 自定义样式 */
     style?: React.CSSProperties;
-    /** 图标 */
     icon?: React.ReactNode;
-    /** 图标位置 */
     iconPosition?: 'left' | 'right';
     [key: string]: any;
 }

package/dist/index.d.ts

@@ -1,30 +1,33 @@
 import React from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
-type ButtonType = 'default' | 'primary';
-type ButtonSize = 'small' | 'mediumSmall' | 'medium' | 'large';
+/**
+ * 对齐 Figma: Untitled UI v7 — Buttons
+ * 维度：Size × Hierarchy × State × Icon only
+ *   Size:       sm(36) / md(40) / lg(44) / xl(48)
+ *   Hierarchy:  primary / secondary / tertiary / link-color / link-gray
+ *   State:      default / hover / focused / disabled / loading
+ *   Icon only:  boolean
+ */
+type ButtonHierarchy = 'primary' | 'secondary' | 'tertiary' | 'link-color' | 'link-gray' | 'destructive-primary' | 'destructive-secondary' | 'destructive-tertiary' | 'destructive-link' | 'default';
+type ButtonSize = 'sm' | 'md' | 'lg' | 'xl' | 'small' | 'mediumSmall' | 'medium' | 'large';
 interface ButtonProps {
-    /** 按钮内容 */
     children?: React.ReactNode;
-    /** 按钮类型 */
-    type?: ButtonType;
-    /** 按钮尺寸 */
+    /** 按钮层级（对应 Figma Hierarchy）。`default` 为 `secondary` 的旧名 */
+    type?: ButtonHierarchy;
+    /** 按钮尺寸（对应 Figma Size）。旧名会映射到新尺寸 */
     size?: ButtonSize;
-    /** 是否禁用 */
     disabled?: boolean;
-    /** 是否加载中 */
     loading?: boolean;
-    /** 点击事件 */
-    onClick?: (e: React.MouseEvent<HTMLButtonElement, MouseEvent>) => void;
-    /** 按钮原生type */
+    /** 仅图标按钮。不传 `children`、仅传 `icon` 时自动开启 */
+    iconOnly?: boolean;
+    /** 受控的 Focused 视觉态，用于 Storybook 预览设计稿；真实键盘焦点由 :focus-visible 处理 */
+    focused?: boolean;
+    onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
     htmlType?: 'button' | 'submit' | 'reset';
-    /** 自定义类名 */
     className?: string;
-    /** 自定义样式 */
     style?: React.CSSProperties;
-    /** 图标 */
     icon?: React.ReactNode;
-    /** 图标位置 */
     iconPosition?: 'left' | 'right';
     [key: string]: any;
 }