@cloudtower/eagle 0.33.16 → 0.33.18

package/dist/src/core/CTModalFooterError/CTModalFooterError.style.d.ts

@@ -0,0 +1 @@
+export declare const CTModalFooterErrorStyle: import("@linaria/core").LinariaClassName;

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

@@ -0,0 +1,56 @@
+import React from "react";
+import { CTError } from "../../utils/cterror";
+import { UseCTErrorMsgOptions } from "../../hooks/useCTErrorMsg";
+/**
+ * 错误详情渲染器的 props
+ */
+export interface ErrorItemRenderProps {
+    /** 单条错误消息 */
+    errorMsg: string | undefined;
+    /** 错误索引 */
+    index: number;
+}
+/**
+ * 错误容器渲染器的 props
+ */
+export interface ErrorContainerRenderProps {
+    /** 自定义类名 */
+    className?: string;
+    /** 子元素 */
+    children?: React.ReactNode;
+    /** 错误信息 */
+    errorMsgs: (string | undefined)[];
+}
+/**
+ * CTModalFooterError 组件的 props
+ */
+export interface CTModalFooterErrorProps {
+    /**
+     * 错误对象，支持多种格式的错误
+     * - AxiosError: Axios 请求错误
+     * - CloudTowerErrorResponse: 服务端响应错误
+     * - 其他类型: 会被转换为字符串显示
+     */
+    error: CTError;
+    /**
+     * 自定义类名，会应用到错误容器上
+     */
+    className?: string;
+    /**
+     * 自定义错误容器渲染器
+     * 用于自定义整个错误信息的容器样式和结构
+     * @default 使用内置的 span 容器，应用了默认样式
+     */
+    ErrorContainerRender?: React.FC<ErrorContainerRenderProps>;
+    /**
+     * 自定义错误详情渲染器
+     * 用于自定义单条错误信息的渲染方式
+     * 如果不提供，多条错误会被拼接成一个字符串显示
+     */
+    ErrorItemRender?: React.FC<ErrorItemRenderProps>;
+    /**
+     * 错误消息处理选项
+     * 用于配置国际化命名空间和其他翻译选项
+     */
+    errorMsgOptions?: UseCTErrorMsgOptions;
+}

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

@@ -0,0 +1,3 @@
+import React from "react";
+import { CTModalFooterErrorProps } from "./CTModalFooterError.type";
+export declare const CTModalFooterError: React.FC<CTModalFooterErrorProps>;

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

@@ -6,5 +6,10 @@ import React from "react";
 export type ConfigProps = {
     antd4Configs?: ConfigProviderProps;
     antd5Configs?: Antd5ConfigProviderProps;
+    config?: {
+        /** CTError i18n 命名空间 */
+        ctErrorI18nNs?: string;
+    };
 };
-export declare const ConfigProvider: React.FC<ConfigProps>;
+export declare const useConfig: () => ConfigProps["config"];
+export declare const ConfigProvider: React.FC<React.PropsWithChildren<ConfigProps>>;

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

@@ -21,6 +21,7 @@ export * from "./Card";
 export * from "./Cascader";
 export * from "./Checkbox";
 export * from "./ConfigProvider";
+export * from "./CTModalFooterError";
 export * from "./DeprecatedProgress";
 export * from "./DetailCard";
 export * from "./DonutChart";

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

@@ -46,3 +46,4 @@ export { default as SummaryTable } from "./SummaryTable";
 export { default as SwitchWithText } from "./SwitchWithText";
 export { default as TabMenu } from "./TabMenu";
 export { default as UnitWithChart } from "./UnitWithChart";
+export { default as KubeConfigModal } from "./KubeConfigModal";

package/dist/src/hooks/__tests__/useCTErrorMsg.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -1,2 +1,3 @@
+export * from "./useCTErrorMsg";
 export { default as useElementResize } from "./useElementResize";
 export { default as useElementsSize } from "./useElementsSize";

package/dist/src/hooks/useCTErrorMsg.d.ts

@@ -0,0 +1,7 @@
+import { CTError } from "../utils/cterror";
+import { TOptions } from "i18next";
+export type UseCTErrorMsgOptions = {
+    CTErrorI18nNs?: string;
+    tOptions?: TOptions;
+};
+export declare const useCTErrorMsg: (error: CTError, options?: UseCTErrorMsgOptions) => (string | undefined)[];

package/dist/src/utils/__test__/cterror.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/cterror.d.ts

@@ -0,0 +1,29 @@
+import { CTErrorType as CloudTowerErrorResponse } from "../utils/type";
+import { AxiosError } from "axios";
+type ParsedCTErrorItem = {
+    code?: string;
+    params?: CloudTowerErrorResponse["params"];
+    message?: string;
+} | {
+    message: string;
+};
+type ParsedCTError = ParsedCTErrorItem[];
+export type CTError = AxiosError<CloudTowerErrorResponse> | CloudTowerErrorResponse;
+export declare const isResponseCTError: (error: unknown) => error is CloudTowerErrorResponse;
+/**
+ * 处理响应错误
+ */
+export declare const handleResponseCTError: (error: CloudTowerErrorResponse) => ParsedCTError;
+type AxiosCTError = AxiosError<CloudTowerErrorResponse>;
+export declare const isAxiosCTError: (error: unknown) => error is AxiosCTError;
+/**
+ * 处理 Axios 错误
+ */
+export declare const handleAxiosCTError: (error: AxiosCTError) => ParsedCTError;
+/**
+ * 统一错误处理函数
+ * @param error - 各种类型的错误对象
+ * @returns 解析后的错误信息，包含 code 或 message
+ */
+export declare const parseCTError: (error: CTError) => ParsedCTError;
+export {};

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

@@ -6,3 +6,4 @@ export * from "./formatValue";
 export * from "./icon";
 export * from "./isStringArr";
 export * from "./time";
+export * from "./cterror";

package/dist/src/utils/type.d.ts

@@ -1 +1,33 @@
 export type { SizeType as Antd5SizeType } from "antd5/lib/config-provider/SizeContext";
+export type CTErrorType = {
+    code?: string;
+    /**
+     * @type array | undefined
+     */
+    details?: {
+        /**
+         * @type string | undefined
+         */
+        message?: string;
+        /**
+         * @type object | undefined
+         */
+        params?: {
+            [key: string]: any;
+        };
+        /**
+         * @type string | undefined
+         */
+        reason?: string;
+    }[];
+    /**
+     * @type string
+     */
+    message?: string;
+    /**
+     * @type object | undefined
+     */
+    params?: {
+        [key: string]: any;
+    };
+};

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

@@ -0,0 +1,47 @@
+import { Meta, StoryObj } from "@storybook/react";
+import { CTModalFooterError } from "../../../src/core/CTModalFooterError";
+/**
+ * CTModalFooterError 组件用于在 Modal 底部显示错误信息，支持多种错误格式和自定义渲染。
+ *
+ * - 支持多种错误格式（Axios 错误、服务端响应错误等）
+ * - 内置 i18n 支持
+ * - 支持自定义容器和详情渲染器
+ */
+declare const meta: Meta<typeof CTModalFooterError>;
+export default meta;
+type Story = StoryObj<typeof CTModalFooterError>;
+/**
+ * 基本用法 - 显示简单的错误消息
+ *
+ * 传入一个简单的 Error 对象，组件会自动提取并显示错误消息。
+ */
+export declare const Basic: Story;
+/**
+ * 显示来自服务端的结构化错误，传入一个包含错误代码和消息的服务端响应错误对象，组件会自动提取并显示错误消息。
+ */
+export declare const ServerError: Story;
+/**
+ * 多条错误 - 显示包含多个错误详情的错误
+ */
+export declare const MultipleErrors: Story;
+/**
+ * Axios 请求错误
+ */
+export declare const NetworkError: Story;
+/**
+ * 自定义容器渲染器
+ */
+export declare const CustomContainer: Story;
+/**
+ * 自定义错误详情渲染器
+ */
+export declare const CustomErrorDetail: Story;
+/**
+ * 空错误处理
+ * 当传入 null 或 undefined 时，组件会自动处理并显示默认信息。
+ */
+export declare const EmptyError: Story;
+/**
+ * 可以通过 ConfigProvider 配置 i18n 命名空间和组件 options 配置 i18n 的命名空间。 优先使用组件 options 配置的命名空间。都不配置时，默认使用 CTError 命名空间。
+ */
+export declare const Intl: Story;