@cloudtower/eagle 4100.0.9 → 4100.0.10

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

@@ -1,5 +1,6 @@
 /// <reference types="react" />
 import { ButtonProps } from "../../core/Button";
+import { SafeReactNode } from "../../spec";
 import { ModalProps as AntdModalProps } from "antd/lib/modal";
 /**
  * 沉浸式全屏对话框，支持左中右三栏布局。适合复杂操作、大面积内容展示。通过 usePushModal 打开。
@@ -147,7 +148,7 @@ export type ImmersiveDialogProps = React.PropsWithChildren<AntdModalProps & {
      * 与 initializing 配合使用：先设 initializing=true 开始加载，
      * 失败时设 initializing=false 并设置 initializingError。
      */
-    initializingError?: string | React.ReactNode;
+    initializingError?: string | SafeReactNode;
     /**
      * 测试标识符前缀，用于自动化测试定位元素。
      * 派生子 testid：`${testId}-cancel`、`${testId}-ok`、`${testId}-close`

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

@@ -1,4 +1,5 @@
 import { ButtonProps } from "../../core/Button";
+import { SafeReactNode } from "../../spec";
 import React from "react";
 /**
  * @description 小尺寸弹窗组件，固定宽度 492px，适用于确认操作、简短表单、信息提示等场景。
@@ -73,13 +74,13 @@ export interface SmallDialogProps {
      */
     width?: number | string;
     /** 弹窗标题，支持 ReactNode 自定义渲染 */
-    title: React.ReactNode;
+    title: SafeReactNode;
     /**
      * 自定义标题渲染组件，替换默认的标题渲染逻辑。
      * 默认标题使用 `Typo.Display.d2_bold_title` 样式。
      */
     TitleRender?: React.FC<{
-        title?: React.ReactNode;
+        title?: SafeReactNode;
     }>;
     /** 取消按钮文案，默认根据 `showOk` 决定：showOk=true 时为"取消"，showOk=false 时为"关闭" */
     cancelText?: string;
@@ -139,9 +140,9 @@ export interface SmallDialogProps {
     /** 取消按钮的额外属性，会透传给 Button 组件。若同时设置了 cancelText，cancelText 优先 */
     cancelButtonProps?: ButtonProps;
     /** 弹窗主体内容，当 `initializing` 为 true 时显示骨架屏，当 `initializingError` 有值时显示错误状态 */
-    children?: React.ReactNode;
+    children?: SafeReactNode;
     /** 展示在 footer 区域的错误文案，支持 ReactNode。最多显示 3 行，超出后 tooltip 展示完整内容 */
-    error?: React.ReactNode;
+    error?: SafeReactNode;
     /**
      * 是否隐藏 footer 区域（包括确认/取消按钮和错误信息）
      * @default false
@@ -169,7 +170,7 @@ export interface SmallDialogProps {
      * 与 `initializing` 配合使用：先设 initializing=true 加载，
      * 失败时设 initializing=false 且 initializingError="错误信息"。
      */
-    initializingError?: string | React.ReactNode;
+    initializingError?: string | SafeReactNode;
     /**
      * 初始化骨架屏行数，仅在 `initializing` 为 true 时生效
      * @default 2

package/dist/src/core/SmallDialog/SmallDialog.widget.d.ts

@@ -1,8 +1,9 @@
+import { SafeReactNode } from "../../spec";
 import React from "react";
 export declare const ModelTitleSkeleton: React.FC;
 export declare const ModelContentSkeleton: React.FC<{
     num?: number;
 }>;
 export declare const ModelInitializingError: React.FC<{
-    error?: string | React.ReactNode;
+    error?: string | SafeReactNode;
 }>;

package/dist/src/coreX/Dialogs/DeleteDialog/DeleteDialog.type.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 /**
  * DeleteDialog 是一个预设了删除确认样式的对话框组件，基于 SmallDialog 封装。
  * 确认按钮默认使用危险（红色）样式，适用于需要用户二次确认的删除操作。
@@ -73,13 +72,14 @@
  * @see SmallDialog 底层对话框组件，DeleteDialog 基于其封装
  * @see RejectDialog 操作被拒绝/不可执行时的反馈对话框
  */
+import { SafeReactNode } from "../../../spec";
 export interface DeleteDialogProps {
     /** 弹窗标题 */
-    title: React.ReactNode;
+    title: SafeReactNode;
     /** 主要描述文本，说明删除操作的影响 */
-    description?: React.ReactNode;
+    description?: SafeReactNode;
     /** 辅助说明文本，显示在 description 下方，使用次要颜色 */
-    secondaryDesc?: React.ReactNode;
+    secondaryDesc?: SafeReactNode;
     /**
      * 取消按钮文案
      * @default "取消"（i18n: common.cancel）
@@ -107,7 +107,7 @@ export interface DeleteDialogProps {
      */
     confirmLoading?: boolean;
     /** 展示在 modal footer 的错误文案，用于显示删除操作失败信息 */
-    error?: React.ReactNode;
+    error?: SafeReactNode;
     /**
      * 是否展示 modal footer 的错误图标
      * @default true

package/dist/src/coreX/Dialogs/RejectDialog/RejectDialog.type.d.ts

@@ -1,5 +1,5 @@
-/// <reference types="react" />
 import type { ButtonProps } from "../../../core/Button";
+import { SafeReactNode } from "../../../spec";
 /** 拒绝原因，字符串类型 */
 export type RejectReason = string;
 /** 多个对象的拒绝原因映射，key 为对象名称，value 为原因列表 */
@@ -22,11 +22,11 @@ export declare enum RejectDialogType {
  */
 interface BaseRejectDialogProps {
     /** 弹窗标题 */
-    title: React.ReactNode;
+    title: SafeReactNode;
     /** 在描述文本之前的自定义内容区域，用于展示背景信息 */
-    beforeDescription?: React.ReactNode;
+    beforeDescription?: SafeReactNode;
     /** 补充描述文本，显示在 beforeDescription 之后、拒绝内容之前 */
-    description?: React.ReactNode;
+    description?: SafeReactNode;
     /**
      * 取消按钮文案
      * @default "取消"（i18n: common.cancel）
@@ -60,9 +60,9 @@ interface SingleRejectDialogProps extends BaseRejectDialogProps {
      */
     listType?: "ordered" | "unordered" | "resource";
     /** 灰色的进一步描述，显示在拒绝原因上方 */
-    secondaryDesc?: React.ReactNode;
+    secondaryDesc?: SafeReactNode;
     /** 资源图标，仅当 listType 为 "resource" 时显示在每项前面 */
-    resourceIcon?: React.ReactNode;
+    resourceIcon?: SafeReactNode;
 }
 /**
  * 批量全部拒绝模式。
@@ -72,11 +72,11 @@ interface SingleRejectDialogProps extends BaseRejectDialogProps {
 interface MultiAllRejectDialogProps extends BaseRejectDialogProps {
     type: RejectDialogType.All;
     /** 灰色的进一步描述 */
-    secondaryDesc?: React.ReactNode;
+    secondaryDesc?: SafeReactNode;
     /** 多个对象的拒绝原因，格式为 { [对象名]: [原因1, 原因2, ...] } */
     content: RejectContent;
     /** 资源图标，显示在每个对象名称前面 */
-    resourceIcon?: React.ReactNode;
+    resourceIcon?: SafeReactNode;
 }
 /**
  * 批量部分拒绝模式。
@@ -86,13 +86,13 @@ interface MultiAllRejectDialogProps extends BaseRejectDialogProps {
 interface MultiPartialRejectDialogProps extends BaseRejectDialogProps {
     type: RejectDialogType.Part;
     /** 灰色的进一步描述 */
-    secondaryDesc?: React.ReactNode;
+    secondaryDesc?: SafeReactNode;
     /** 多个对象的拒绝原因，格式为 { [对象名]: [原因1, 原因2, ...] } */
     content: Record<string, string[]>;
     /** 资源图标，显示在每个对象名称前面 */
-    resourceIcon?: React.ReactNode;
+    resourceIcon?: SafeReactNode;
     /** 部分拒绝时的额外说明，展示在分割线下方，说明将跳过被拒绝的对象 */
-    partialDescription: React.ReactNode;
+    partialDescription: SafeReactNode;
     /** 确认按钮文案，如"部分升级" */
     okText?: string;
     /**
@@ -109,7 +109,7 @@ interface MultiPartialRejectDialogProps extends BaseRejectDialogProps {
 interface CustomRejectDialogProps extends BaseRejectDialogProps {
     type: RejectDialogType.Custom;
     /** 自定义内容区域，替代标准的拒绝原因列表 */
-    customContent: React.ReactNode;
+    customContent: SafeReactNode;
     /** 确认按钮文案 */
     okText?: string;
 }

package/dist/src/spec/base.d.ts

@@ -40,8 +40,17 @@ import { TreeProps as AntdTreeProps } from "antd/lib/tree";
 import type TreeSelect from "antd/lib/tree-select";
 import { TextProps } from "antd/lib/typography/Text";
 import { DraggerProps, UploadProps } from "antd/lib/upload";
-import React, { ForwardRefExoticComponent, PropsWithChildren, PropsWithoutRef, ReactNode, RefAttributes } from "react";
+import React, { ForwardRefExoticComponent, PropsWithChildren, PropsWithoutRef, ReactChild, ReactNode, ReactPortal, RefAttributes } from "react";
 import { SerializableObject } from "../utils/tower";
+/**
+ * 在 React 18 之前，ReactNode 包含 `{}` 类型，导致任意 object 都可以赋值给它，
+ * 存在类型安全漏洞。SafeReactNode 排除了 `{}`，同时保留了 ReactNode 的其他全部能力。
+ *
+ * @see https://github.com/DefinitelyTyped/DefinitelyTyped/pull/56210
+ */
+export interface SafeReactNodeArray extends Array<SafeReactNode> {
+}
+export type SafeReactNode = ReactChild | SafeReactNodeArray | ReactPortal | boolean | null | undefined;
 export type AntdTableComponentType = <RecordType extends object = any>(props: AntdTableProps<RecordType>) => JSX.Element;
 export type AntdTreeSelectComponentType<T> = TreeSelect<T>;
 interface EmptyType extends React.FC<EmptyProps> {

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

@@ -122,7 +122,7 @@ declare const meta: {
         rightClassName?: string | undefined;
         footerLeftAction?: React.ReactNode;
         initializing?: boolean | undefined;
-        initializingError?: React.ReactNode;
+        initializingError?: import("../../../src").SafeReactNode;
         "data-testid"?: string | undefined;
         children?: React.ReactNode;
     }>) => React.JSX.Element)[];

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

@@ -122,3 +122,18 @@ export declare const ButtonCustomization: {
     (): React.JSX.Element;
     storyName: string;
 };
+/**
+ * Error 字段类型注入
+ *
+ * 演示 `error` 属性接受不同类型的 `SafeReactNode`：
+ * - `string`：纯文本错误信息
+ * - `ReactElement`：自定义元素（如带图标的多行提示）
+ * - `array`：由多个 SafeReactNode 组成的数组
+ * - `boolean`：布尔值（true/false 均不会渲染可见内容）
+ * - `null`：空值，不显示错误
+ * - `undefined`：未定义，不显示错误
+ */
+export declare const ErrorTypes: {
+    (): React.JSX.Element;
+    storyName: string;
+};

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

@@ -154,7 +154,7 @@ declare const story: {
         rightClassName?: string | undefined;
         footerLeftAction?: React.ReactNode;
         initializing?: boolean | undefined;
-        initializingError?: React.ReactNode;
+        initializingError?: import("../../../src").SafeReactNode;
         "data-testid"?: string | undefined;
         children?: React.ReactNode;
         step?: number | undefined;

package/dist/stories/docs/coreX/Dialogs/DeleteDialog.stories.d.ts

@@ -8,16 +8,16 @@ declare const meta: {
     title: "CoreX/Dialog/DeleteDialog | 删除确认对话框";
     component: React.FC<import("../../../../src/coreX").DeleteDialogProps>;
     decorators: ((Story: import("@storybook/types").PartialStoryFn<import("@storybook/react/dist/types-0fc72a6d").R, {
-        title: React.ReactNode;
-        description?: React.ReactNode;
-        secondaryDesc?: React.ReactNode;
+        title: import("../../../../src").SafeReactNode;
+        description?: import("../../../../src").SafeReactNode;
+        secondaryDesc?: import("../../../../src").SafeReactNode;
         cancelText?: string | undefined;
         okText?: string | undefined;
         onOk?: ((popModal: () => void) => void) | undefined;
         onCancel?: ((popModal: () => void) => void) | undefined;
         className?: string | undefined;
         confirmLoading?: boolean | undefined;
-        error?: React.ReactNode;
+        error?: import("../../../../src").SafeReactNode;
         showFooterErrorIcon?: boolean | undefined;
         children?: React.ReactNode;
     }>) => React.JSX.Element)[];

package/dist/stories/docs/coreX/Dialogs/RejectDialog.stories.d.ts

@@ -12,11 +12,11 @@ declare const meta: {
         type: RejectDialogType.Single;
         content: string | string[];
         listType?: "resource" | "ordered" | "unordered" | undefined;
-        secondaryDesc?: React.ReactNode;
-        resourceIcon?: React.ReactNode;
-        title: React.ReactNode;
-        beforeDescription?: React.ReactNode;
-        description?: React.ReactNode;
+        secondaryDesc?: import("../../../../src").SafeReactNode;
+        resourceIcon?: import("../../../../src").SafeReactNode;
+        title: import("../../../../src").SafeReactNode;
+        beforeDescription?: import("../../../../src").SafeReactNode;
+        description?: import("../../../../src").SafeReactNode;
         cancelText?: string | undefined;
         onCancel?: ((popModal: () => void) => void) | undefined;
         okButtonProps?: import("../../../../src/core").ButtonProps | undefined;
@@ -26,12 +26,12 @@ declare const meta: {
         children?: React.ReactNode;
     } | {
         type: RejectDialogType.All;
-        secondaryDesc?: React.ReactNode;
+        secondaryDesc?: import("../../../../src").SafeReactNode;
         content: import("../../../../src/coreX").RejectContent;
-        resourceIcon?: React.ReactNode;
-        title: React.ReactNode;
-        beforeDescription?: React.ReactNode;
-        description?: React.ReactNode;
+        resourceIcon?: import("../../../../src").SafeReactNode;
+        title: import("../../../../src").SafeReactNode;
+        beforeDescription?: import("../../../../src").SafeReactNode;
+        description?: import("../../../../src").SafeReactNode;
         cancelText?: string | undefined;
         onCancel?: ((popModal: () => void) => void) | undefined;
         okButtonProps?: import("../../../../src/core").ButtonProps | undefined;
@@ -41,15 +41,15 @@ declare const meta: {
         children?: React.ReactNode;
     } | {
         type: RejectDialogType.Part;
-        secondaryDesc?: React.ReactNode;
+        secondaryDesc?: import("../../../../src").SafeReactNode;
         content: Record<string, string[]>;
-        resourceIcon?: React.ReactNode;
-        partialDescription: React.ReactNode;
+        resourceIcon?: import("../../../../src").SafeReactNode;
+        partialDescription: import("../../../../src").SafeReactNode;
         okText?: string | undefined;
         onOk?: ((popModal: () => void) => void) | undefined;
-        title: React.ReactNode;
-        beforeDescription?: React.ReactNode;
-        description?: React.ReactNode;
+        title: import("../../../../src").SafeReactNode;
+        beforeDescription?: import("../../../../src").SafeReactNode;
+        description?: import("../../../../src").SafeReactNode;
         cancelText?: string | undefined;
         onCancel?: ((popModal: () => void) => void) | undefined;
         okButtonProps?: import("../../../../src/core").ButtonProps | undefined;
@@ -59,11 +59,11 @@ declare const meta: {
         children?: React.ReactNode;
     } | {
         type: RejectDialogType.Custom;
-        customContent: React.ReactNode;
+        customContent: import("../../../../src").SafeReactNode;
         okText?: string | undefined;
-        title: React.ReactNode;
-        beforeDescription?: React.ReactNode;
-        description?: React.ReactNode;
+        title: import("../../../../src").SafeReactNode;
+        beforeDescription?: import("../../../../src").SafeReactNode;
+        description?: import("../../../../src").SafeReactNode;
         cancelText?: string | undefined;
         onCancel?: ((popModal: () => void) => void) | undefined;
         okButtonProps?: import("../../../../src/core").ButtonProps | undefined;