@cloudtower/eagle 0.0.0-config-rc-9 → 0.0.0-data-testid

package/dist/stories/docs/core/Second.stories.d.ts

@@ -1,22 +1,57 @@
-import React from "react";
-declare const _default: import("@storybook/types").ComponentAnnotations<import("@storybook/react/dist/types-0fc72a6d").R, import("../../../src").RawValue & {
-    emptyProps?: import("../../../src").IEmptyProps | undefined;
-} & {
-    children?: React.ReactNode;
-}>;
-export default _default;
-export declare const Simple: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react/dist/types-0fc72a6d").R, import("../../../src").RawValue & {
-    emptyProps?: import("../../../src").IEmptyProps | undefined;
-} & {
-    children?: React.ReactNode;
-}>;
-export declare const Abbreviation: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react/dist/types-0fc72a6d").R, import("../../../src").RawValue & {
-    emptyProps?: import("../../../src").IEmptyProps | undefined;
-} & {
-    children?: React.ReactNode;
-}>;
-export declare const Empty: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react/dist/types-0fc72a6d").R, import("../../../src").RawValue & {
-    emptyProps?: import("../../../src").IEmptyProps | undefined;
-} & {
-    children?: React.ReactNode;
-}>;
+import Second from "../../../src/core/Second";
+import { StoryObj } from "@storybook/react";
+/**
+ * * Second 组件
+ * * 用于展示秒数，支持不同的展示形式
+ * * 提供标准、缩写和自定义空值展示等功能
+ * * 继承自基础的 Units 系列组件
+ */
+declare const meta: {
+    title: string;
+    component: import("../../../src").UnitFn;
+    parameters: {
+        docs: {
+            description: {
+                component: string;
+            };
+        };
+    };
+    tags: string[];
+};
+export default meta;
+type Story = StoryObj<typeof Second>;
+/**
+ * 基础秒数展示
+ * 展示最基本的秒数，不做任何特殊处理
+ */
+export declare const Basic: Story;
+/**
+ * 缩写形式展示
+ * 当需要节省空间时，可以使用缩写形式展示秒数
+ */
+export declare const Abbreviated: Story;
+/**
+ * 精确小数位展示
+ * 可以指定保留的小数位数，提高精确度
+ */
+export declare const WithDecimals: Story;
+/**
+ * 零值不带单位
+ * 当值为0时，可以选择不显示单位
+ */
+export declare const ZeroWithoutUnit: Story;
+/**
+ * 大数值展示
+ * 展示较大的秒数
+ */
+export declare const LargeValue: Story;
+/**
+ * 自定义空值展示
+ * 当没有有效值时的自定义展示
+ */
+export declare const CustomEmpty: Story;
+/**
+ * 自定义样式
+ * 可以通过自定义类名来调整展示样式
+ */
+export declare const CustomStyle: Story;

package/dist/stories/docs/core/Select.stories.d.ts

@@ -1,16 +1,97 @@
-import { Meta } from "@storybook/react";
-import React from "react";
-declare const meta: Meta;
-export default meta;
-export declare const Basic: {
-    (): React.JSX.Element;
-    story: {
-        name: string;
-        parameters: {
-            design: {
-                type: string;
-                url: string;
-            };
+import Select from "../../../src/core/Select";
+import type { StoryObj } from "@storybook/react";
+/**
+ * Select 组件是基于 antd Select 的封装，提供了更符合设计规范的样式和交互。
+ *
+ * ### 参数说明
+ *
+ * | 参数 | 说明 | 类型 | 默认值 |
+ * | --- | --- | --- | --- |
+ * | size | 选择器大小，large 用于表单场景，small 用于表格等紧凑场景 | 'large' \| 'middle' \| 'small' | 'middle' |
+ * | loading | 加载状态，显示加载中的动画效果 | boolean | false |
+ * | isLoadingValue | 是否正在加载选项值，用于异步加载选项时的加载状态 | boolean | false |
+ * | disabled | 是否禁用选择器，禁用后不可点击选择 | boolean | false |
+ * | mode | 设置选择模式，multiple 为多选，tags 为自由输入多选 | 'multiple' \| 'tags' | - |
+ * | showSearch | 是否可搜索，开启后可通过输入关键字过滤选项 | boolean | false |
+ * | danger | 错误状态，用于表单校验失败等场景 | boolean | false |
+ * | placeholder | 选择框默认文本 | string | - |
+ * | value | 指定当前选中的条目 | string \| string[] | - |
+ * | defaultValue | 指定默认选中的条目 | string \| string[] | - |
+ * | onChange | 选中值发生变化时的回调 | function(value, option) | - |
+ *
+ * 更多属性请参考 antd Select 组件文档
+ */
+declare const meta: {
+    component: import("../../../src/core").SelectComponentType<any, HTMLElement>;
+    title: "Core/Select | 选择器";
+    args: {
+        placeholder: string;
+        options: ({
+            value: string;
+            label: string;
+            disabled?: undefined;
+        } | {
+            value: string;
+            label: string;
+            disabled: true;
+        })[];
+        input: {
+            value: string;
         };
     };
 };
+export default meta;
+type Story = StoryObj<typeof Select>;
+/**
+ * Select 组件提供了三种尺寸:
+ * - large: 适用于表单中的主要选择器
+ * - middle: 默认尺寸，适用于大多数场景
+ * - small: 适用于表格等紧凑型界面
+ */
+export declare const Basic: Story;
+/**
+ * Select 组件支持在选项中添加前缀和后缀图标：
+ * - prefix: 在选项文本前显示图标，常用于表示状态或类型
+ * - suffix: 在选项文本后显示图标，常用于显示额外信息
+ */
+export declare const WithIcons: Story;
+/**
+ * 多选模式下可以选择多个选项，选中的选项会以 Tag 的形式展示。
+ * 支持以下特性：
+ * - 可以通过点击 Tag 的关闭按钮删除已选项
+ * - 可以通过键盘删除键（Backspace）删除最后一个已选项
+ * - 支持通过搜索快速定位选项
+ */
+export declare const Multiple: Story;
+/**
+ * Select 组件提供了两种加载状态：
+ * 1. loading: 原生的加载中
+ * 2. isLoadingValue: value 在加载，select 不能点击
+ */
+export declare const Loading: Story;
+/**
+ * 可搜索模式下，用户可以输入关键字过滤选项。
+ * 可以通过 filterOption 属性自定义搜索逻辑。
+ */
+export declare const SearchSelect: Story;
+/**
+ * Select 支持自定义触发器，可以替换默认的下拉箭头图标。
+ * 常见用法是使用自定义图标来表达特定的筛选含义。
+ */
+export declare const CustomTrigger: Story;
+/**
+ * 错误状态有两种实现方式：
+ * 1. 使用 className="select-error" 添加错误样式
+ * 2. 使用 danger 属性（推荐）
+ */
+export declare const Error: Story;
+/**
+ * 禁用状态下，选择器不可点击，显示为灰色。
+ */
+export declare const Disabled: Story;
+/**
+ * Select 组件可以通过特定的样式类实现组合效果：
+ * - LeftEndSelectStyle: 左侧圆角
+ * - RightEndSelectStyle: 右侧圆角
+ */
+export declare const Combined: Story;

package/dist/stories/docs/core/Sider.stories.d.ts

@@ -0,0 +1,21 @@
+import { SiderProps } from "../../../src/coreX/Sider";
+import { Meta, StoryObj } from "@storybook/react";
+/**
+ *
+ * Sider 组件用于展示侧边栏。
+ *
+ */
+declare const meta: Meta<SiderProps>;
+export default meta;
+/**
+ *
+ * Sider 的基本用法
+ *
+ */
+export declare const Default: StoryObj<SiderProps>;
+/**
+ *
+ * Sider 的收缩模式
+ *
+ */
+export declare const Shrink: StoryObj<SiderProps>;

package/dist/stories/docs/core/SmallDialog.stories.d.ts

@@ -0,0 +1,124 @@
+import { SmallDialog } from "../../../src/core";
+import { CoreMeta } from "../../types";
+import React from "react";
+/**
+ * SmallDialog 组件
+ *
+ * 一个轻量级的小尺寸对话框组件，适用于简单的确认、提示等场景。
+ *
+ * ### 特性
+ * - 固定宽度 492px，适合移动端和桌面端使用
+ * - 支持自定义标题、按钮文案和样式
+ * - 支持在底部显示错误信息
+ * - 可配置是否显示确认按钮、关闭按钮等
+ * - 支持点击遮罩层关闭
+ */
+declare const meta: CoreMeta<typeof SmallDialog>;
+export default meta;
+/**
+ * 基础用法
+ *
+ * 演示最基本的 SmallDialog 用法：通过 `usePushModal` 打开弹窗，
+ * 在 `onOk`/`onCancel` 回调中调用 `popModal()` 关闭弹窗。
+ */
+export declare const Basic: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+/**
+ * 确认删除对话框
+ *
+ * 演示危险操作确认场景：通过 `okButtonProps={{ danger: true }}` 将确认按钮标红，
+ * 自定义 `okText` 和 `cancelText` 按钮文案。
+ */
+/**
+ * 确认删除
+ *
+ * 演示用 SmallDialog 原始 API 实现删除确认弹窗。
+ * 生产环境中推荐直接使用 DeleteDialog，它已内置 danger 按钮和删除语义。
+ */
+export declare const DeleteConfirmation: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+/**
+ * 只有取消按钮
+ *
+ * 通过 `showOk={false}` 隐藏确认按钮，仅展示关闭按钮。
+ * 适用于纯信息提示场景。取消按钮样式自动从 `quiet` 变为 `ordinary`。
+ */
+export declare const CancelOnly: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+/**
+ * 带错误信息的对话框
+ *
+ * 演示 `error` 属性：在 footer 区域显示错误文案（最多 3 行，超出后 tooltip 展示）。
+ * 首次点击"提交"模拟验证失败并显示错误，再次点击成功关闭。
+ */
+export declare const WithError: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+/**
+ * 长内容对话框
+ *
+ * 演示内容溢出时的滚动行为。包含长标题截断和长内容滚动两种场景。
+ */
+export declare const LongContent: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+/**
+ * 初始化状态
+ *
+ * 演示 `initializing`、`initializingError` 属性的三种场景：
+ * 持续加载（骨架屏）、加载成功、加载失败后重试。
+ */
+export declare const Initializing: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+/**
+ * 不展示 footer
+ *
+ * 通过 `hideFooter` 隐藏底部按钮区域，适用于纯展示内容的场景。
+ * 用户仍可通过右上角关闭按钮或遮罩层关闭弹窗。
+ */
+export declare const NoFooter: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+/**
+ * 自定义标题渲染
+ *
+ * 通过 `TitleRender` 属性完全接管标题区域的渲染逻辑。
+ * 默认标题使用 `Typo.Display.d2_bold_title` 样式，
+ * 自定义时可添加图标、状态标签等额外元素。
+ */
+export declare const CustomTitle: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+/**
+ * 异步提交
+ *
+ * 演示 `confirmLoading` + `onOk` 异步提交的完整流程，
+ * 这是最常见的业务模式：点击确认后显示 loading 状态，
+ * 异步操作完成后关闭弹窗，失败时展示错误信息并保持弹窗打开。
+ */
+export declare const AsyncSubmit: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+/**
+ * 自定义按钮样式
+ *
+ * 通过 `okButtonProps` 和 `cancelButtonProps` 自定义确认和取消按钮的样式，
+ * 包括 `danger`、`disabled`、`type` 等属性。属性会透传给 Button 组件。
+ */
+export declare const ButtonCustomization: {
+    (): React.JSX.Element;
+    storyName: string;
+};

package/dist/stories/docs/core/Speed.stories.d.ts

@@ -1,17 +1,20 @@
 import React from "react";
 declare const _default: import("@storybook/types").ComponentAnnotations<import("@storybook/react/dist/types-0fc72a6d").R, import("../../../src").RawValue & {
     emptyProps?: import("../../../src").IEmptyProps | undefined;
+    "data-testid"?: string | undefined;
 } & {
     children?: React.ReactNode;
 }>;
 export default _default;
 export declare const Simple: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react/dist/types-0fc72a6d").R, import("../../../src").RawValue & {
     emptyProps?: import("../../../src").IEmptyProps | undefined;
+    "data-testid"?: string | undefined;
 } & {
     children?: React.ReactNode;
 }>;
 export declare const Empty: import("@storybook/types").AnnotatedStoryFn<import("@storybook/react/dist/types-0fc72a6d").R, import("../../../src").RawValue & {
     emptyProps?: import("../../../src").IEmptyProps | undefined;
+    "data-testid"?: string | undefined;
 } & {
     children?: React.ReactNode;
 }>;

package/dist/stories/docs/core/StatusCapsule.stories.d.ts

@@ -1,5 +1,13 @@
 import { StatusCapsuleColor, StatusCapsuleComponentType } from "../../../src/core/StatusCapsule/statusCapsule.type";
 import { Meta, StoryObj } from "@storybook/react";
+/**
+ * 状态胶囊，用于展示状态。
+ *
+ * 根据使用场景，可选:
+ *
+ * - 是否带计数
+ * - 背景色是否突出：Colorful 较突出、Off-White 较不突出
+ */
 declare const story: Meta<StatusCapsuleComponentType>;
 export declare const Basic: StoryObj<StatusCapsuleComponentType>;
 export declare const Default: StoryObj<{

package/dist/stories/docs/core/Tab.stories.d.ts

@@ -0,0 +1,65 @@
+import { Tab } from "../../../src/core/Tab/Tab";
+import type { StoryObj } from "@storybook/react";
+import React from "react";
+/**
+ * Tab 是一个标签页组件，支持多个标签页之间的切换。
+ *
+ * ### 参数说明
+ *
+ * | 参数 | 说明 | 类型 | 默认值 |
+ * | --- | --- | --- | --- |
+ * | className | 自定义类名 | string | - |
+ * | contentClassName | 内容区域的类名 | string | - |
+ * | selectedKey | 当前选中的标签页 key | string | - |
+ * | tabs | 标签页配置数组 | TabItem[] | [] |
+ * | onChange | 切换标签页时的回调 | (key: string) => void | - |
+ * | extraSlot | 额外的插槽内容，显示在标签栏右侧 | React.ReactNode | - |
+ *
+ * ### TabItem 参数说明
+ *
+ * | 参数 | 说明 | 类型 | 默认值 |
+ * | --- | --- | --- | --- |
+ * | key | 唯一标识符 | string | - |
+ * | title | 标签页标题，可以是字符串、ReactNode 或函数 | string \| ReactNode \| ((props: { isActive: boolean }) => ReactNode) | - |
+ * | onClick | 点击标签页时的回调 | () => void | - |
+ * | children | 标签页内容 | React.ReactNode | - |
+ *
+ * ### 特性
+ * - 支持响应式布局，当空间不够时自动将多余的标签页放入下拉菜单
+ * - 支持自定义标题（可通过函数形式获取激活状态）
+ * - 支持在标签栏右侧添加额外内容
+ * - 支持自定义内容区域的样式
+ */
+declare const meta: {
+    component: (props: import("../../../src/core/Tab/Tab.type").TabProps) => React.JSX.Element;
+    title: "Core/Tab | 标签页";
+};
+export default meta;
+type Story = StoryObj<typeof Tab>;
+/**
+ * 基础的标签页用法，展示如何创建和使用标签页组件
+ */
+export declare const Basic: Story;
+/**
+ * 当有大量标签页时，组件会自动计算可用空间，将无法完整显示的标签页放入下拉菜单中
+ */
+export declare const ResponsiveLayout: Story;
+/**
+ * 标签页标题支持函数形式，可以接收 isActive 参数来判断当前是否激活
+ */
+export declare const CustomTitle: Story;
+/**
+ * extraSlot 可以在标签栏右侧添加额外的内容，如按钮、图标等
+ */
+export declare const WithExtraSlot: Story;
+/**
+ * 展示实际业务场景中的使用方式，包含复杂的标签内容和操作
+ */
+export declare const ComplexContent: Story;
+/**
+ * 支持动态添加和删除标签页的场景。
+ * - 在 extraSlot 中提供"新增标签"按钮
+ * - 每个标签页标题右侧显示删除图标
+ * - 可以动态添加和删除标签页
+ */
+export declare const DynamicTabs: Story;

package/dist/stories/docs/core/Table.stories.d.ts

@@ -6,60 +6,61 @@ declare const meta: {
         id: string;
     }>(props: import("../../../src/core").TableProps<T>) => React.JSX.Element;
     title: "Core/Table | 表格组件";
+    parameters: {
+        docs: {
+            description: {
+                component: string;
+            };
+        };
+    };
 };
 export default meta;
 type Story = StoryObj<typeof Table>;
 /**
- * 在 loading error 不存在的情况下
- *
- * 显示表格数据
+ * 基础表格展示，仅配置 columns 和 dataSource。
  */
-export declare const ShowData: Story;
+export declare const Basic: Story;
 /**
- * 自定义骨架屏表头，表身高度
+ * 带排序功能的表格，点击表头触发排序回调。
  */
-export declare const CustomHeight: Story;
+export declare const WithSorter: Story;
 /**
- * 初始化 loading
+ * 带行选择的表格，支持多选和全选。
  */
-export declare const InitLoading: Story;
+export declare const WithRowSelection: Story;
+/**
+ * 带行操作菜单的表格，在每行末尾渲染操作按钮。
+ */
+export declare const WithRowMenu: Story;
 /**
- * 使用分页作为骨架数量 loading
+ * 加载状态，显示骨架屏动画。
  */
-export declare const LoadingSkeletonWithPageSize: Story;
+export declare const Loading: Story;
 /**
- * 在 loading error dataSource 存在值的情况下
- *
- * 显示 loading
+ * 自定义骨架屏配置，可调整行数、表头高度、行高度。
  */
-export declare const ShowLoadingWithDataAndError: Story;
+export declare const CustomSkeleton: Story;
 /**
- * 在 error dataSource 存在值的情况下
- *
- * 显示 error
+ * 错误状态，显示错误信息替代数据。
  */
-export declare const ShowError: Story;
+export declare const ErrorState: Story;
 /**
- * 在 loading dataSource 存在值的情况下
- *
- * 显示 loading
+ * 空数据状态，显示空状态提示。
  */
-export declare const ShowLoadingWithData: Story;
+export declare const Empty: Story;
 /**
- * 在 error loading dataSource 不存在值的情况下
- *
- * 显示空表格
+ * 固定表头，内容区滚动。
  */
-export declare const ShowEmpty: Story;
+export declare const FixedHeader: Story;
 /**
- * 仅存在 loading 的情况
- *
- * 显示 Loading
+ * 可展开行，点击展开显示详细信息。
  */
-export declare const ShowLoadingWithEmpty: Story;
+export declare const Expandable: Story;
 /**
- * 在 error false 的情况
- *
- * 显示 data
+ * 使用 onRow 设置行事件。
  */
-export declare const ErrorFalse: Story;
+export declare const WithOnRow: Story;
+/**
+ * @deprecated 请使用 loading 替代
+ */
+export declare const InitLoading: Story;

package/dist/stories/docs/core/TableForm.stories.d.ts

@@ -1,17 +1,66 @@
+import { TableFormHandle } from "../../../src/core/TableForm/types";
 import React from "react";
-declare const story: {
-    title: string;
-};
-export declare const Basic: {
-    (): React.JSX.Element;
-    story: {
-        name: string;
-        parameters: {
-            design: {
-                type: string;
-                url: string;
+declare const meta: {
+    component: React.ForwardRefExoticComponent<import("../../../src/core/TableForm").TableFormProps & React.RefAttributes<TableFormHandle>>;
+    title: "Core/TableForm | 表格表单";
+    parameters: {
+        docs: {
+            description: {
+                component: string;
             };
         };
+        design: {
+            type: string;
+            url: string;
+        };
     };
 };
-export default story;
+export default meta;
+export declare const Basic: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+export declare const BatchFilling: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+export declare const DynamicRows: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+export declare const DraggableRows: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+export declare const CustomColumnRender: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+export declare const ValidateModes: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+export declare const RowConfig: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+export declare const ErrorInjection: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+export declare const RefHandle: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+export declare const EmptyTable: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+export declare const TitleAndSubTitle: {
+    (): React.JSX.Element;
+    storyName: string;
+};
+export declare const ExtraAction: {
+    (): React.JSX.Element;
+    storyName: string;
+};

package/dist/stories/docs/core/Timeline.stories.d.ts

@@ -0,0 +1,41 @@
+import { Timeline } from "../../../src/core/Timeline";
+import { StoryObj } from "@storybook/react";
+import React from "react";
+/**
+ * * Timeline 时间线组件
+ * * 用于展示操作记录、系统事件的时间线
+ * * 支持多种状态展示：成功、失败、进行中、通知、空闲
+ * * 支持自定义标签和操作按钮
+ * * 支持使用 Area 组件灵活自定义辅助信息展示
+ */
+declare const meta: {
+    component: ({ items, emptyText, emptyRender, compact, timelineContainerClassName, emptyTextClassName, "data-testid": dataTestId, }: import("../../../src/core/Timeline").TimelineProps) => React.ReactElement<any, string | React.JSXElementConstructor<any>>;
+    title: string;
+    parameters: {
+        docs: {
+            description: {
+                component: string;
+            };
+            source: {
+                type: string;
+            };
+        };
+        controls: {
+            sort: string;
+        };
+    };
+};
+export default meta;
+type Story = StoryObj<typeof Timeline>;
+export declare const SuccessTimeline: Story;
+export declare const FailedTimeline: Story;
+export declare const EmptyTimeline: Story;
+export declare const CustomEmptyState: Story;
+export declare const CustomSecondaryTextStyle: Story;
+export declare const CustomErrorMessage: Story;
+export declare const CustomTags: Story;
+export declare const CustomInfoRender: Story;
+export declare const CustomSubInfoRender: Story;
+export declare const DetailMessages: Story;
+export declare const CustomDetailMessages: Story;
+export declare const CompatibilityTest: Story;

package/dist/stories/docs/core/Tooltip.stories.d.ts

@@ -8,7 +8,9 @@ import React from "react";
  *
  */
 declare const meta: {
-    component: React.FunctionComponent<import("../../../src/core/Tooltip").TooltipProps>;
+    component: React.FunctionComponent<import("../../../src/core/Tooltip").TooltipProps> & {
+        EllipsisContent: React.FC<import("../../../src/core/Tooltip").EllipsisContentType>;
+    };
     title: "Core/Tooltip | 悬浮提示";
     parameters: {
         design: {