@cloudtower/eagle 0.32.41 → 0.32.43

package/dist/src/core/LineChart/index.d.ts

@@ -2,7 +2,7 @@ import React from "react";
 import { LineChartProps } from "./type";
 declare const LineChart: React.ForwardRefExoticComponent<LineChartProps & React.RefAttributes<HTMLDivElement>>;
 export default LineChart;
-export * from "./type";
-export * from "./utils";
 export { default as LineChartLegend } from "./LineChartLegend";
 export * from "./LineChartLegend";
+export * from "./type";
+export * from "./utils";

package/dist/src/core/LineChart/type.d.ts

@@ -1,8 +1,8 @@
+import { IChartProps } from "../../core/LineChart/RenderChart";
+import { PickerDateRange } from "../../coreX/DateRangePicker/dateRangePicker.type";
 import { Dayjs } from "dayjs";
 import { TFunction } from "i18next";
 import { ReactElement } from "react";
-import { IChartProps } from "../../core/LineChart/RenderChart";
-import { PickerDateRange } from "../../coreX/DateRangePicker/dateRangePicker.type";
 export interface ILineChartMetricData {
     id: string;
 }

package/dist/src/core/LineChart/utils.d.ts

@@ -1,4 +1,4 @@
-import { ILineChartDateRange, ILineChartGraphType, ILineChartDataPoint, ILineChartMetric, ILineChartMetricUnit } from "../../core/LineChart/type";
+import { ILineChartDataPoint, ILineChartDateRange, ILineChartGraphType, ILineChartMetric, ILineChartMetricUnit } from "../../core/LineChart/type";
 import { formatBitPerSecond, formatBps, formatBytes, formatCount, formatFrequency, formatNanoSecond, formatPercent, formatTemperature } from "../../utils/tower";
 export declare function filterLineChartPointsByDateRange(points: ILineChartDataPoint[], dateRange?: ILineChartDateRange): ILineChartDataPoint[];
 export declare const parseLineChartRange: (range: string) => {

package/dist/src/core/Units/units.type.d.ts

@@ -1,17 +1,83 @@
 /// <reference types="react" />
 import { IEmptyProps } from "../Empty";
+/**
+ * 基础数值单位展示的接口定义
+ * @interface RawValue
+ */
 export interface RawValue {
+    /**
+     * 原始数值
+     * @type {number | null}
+     * @default undefined
+     * @example
+     * rawValue={1024} // 展示为 1024
+     * rawValue={null} // 展示为空
+     */
     rawValue?: number | null;
+    /**
+     * 保留小数位数
+     * @type {number}
+     * @default undefined
+     * @example
+     * decimals={2} // 1024.00
+     */
     decimals?: number;
+    /**
+     * 当值为0时是否隐藏单位
+     * @type {boolean}
+     * @default false
+     * @example
+     * noUnitOnZero={true} // 0
+     * noUnitOnZero={false} // 0 GB
+     */
     noUnitOnZero?: boolean;
+    /**
+     * 是否使用缩写形式
+     * @type {boolean}
+     * @default false
+     * @example
+     * abbreviate={true} // 1 min
+     * abbreviate={false} // 1 minute
+     */
     abbreviate?: boolean;
+    /**
+     * 数值部分的自定义类名
+     * @type {string}
+     */
     valueClassName?: string;
+    /**
+     * 单位部分的自定义类名
+     * @type {string}
+     */
     unitClassName?: string;
 }
+/**
+ * 百分比展示组件的属性类型
+ * @type PercentFn
+ */
 export type PercentFn = React.FC<RawValue & {
+    /**
+     * 是否为饱和值（超过100%）
+     * @type {boolean}
+     * @default false
+     * @example
+     * saturated={true} // 显示为饱和状态
+     */
     saturated?: boolean;
+    /**
+     * Empty组件的配置属性
+     * @type {IEmptyProps}
+     */
     emptyProps?: IEmptyProps;
 }>;
+/**
+ * 通用单位展示组件的属性类型
+ * @type UnitFn
+ */
 export type UnitFn = React.FC<RawValue & {
+    /**
+     * Empty组件的配置属性
+     * @type {IEmptyProps}
+     */
     emptyProps?: IEmptyProps;
 }>;

package/dist/src/core/index.d.ts

@@ -42,9 +42,9 @@ export * from "./InputPassword";
 export * from "./InputTagItem";
 export * from "./KitStoreProvider";
 export * from "./LegacySelect";
-export * from "./Link";
 export * from "./LineChart";
 export * from "./LineChart";
+export * from "./Link";
 export * from "./Loading";
 export * from "./message";
 export * from "./message-group";
@@ -143,8 +143,8 @@ export { default as InputPassword } from "./InputPassword";
 export { default as InputTagItem } from "./InputTagItem";
 export { default as KitStoreProvider } from "./KitStoreProvider";
 export { default as LegacySelect } from "./LegacySelect";
-export { default as Link } from "./Link";
 export { default as LineChart } from "./LineChart";
+export { default as Link } from "./Link";
 export { default as Loading } from "./Loading";
 export { default as message } from "./message";
 export { default as Metric } from "./Metric";

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;