@cloudtower/eagle 4100.0.20 → 4100.0.22

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

@@ -135,10 +135,24 @@ export type ImmersiveDialogProps = React.PropsWithChildren<AntdModalProps & {
      * 渲染在 footer 左侧，与确定/取消按钮分居两端。
      */
     footerLeftAction?: React.ReactNode;
+    /**
+     * 是否仅初始化一次。首次初始化成功后，忽略后续的 `initializing` 和 `initializingError`。
+     *
+     * @description
+     * `initializing` 为 false 或未传入，且 `initializingError` 无值时，视为初始化成功；
+     * 首次渲染就满足该条件时也会记录成功。成功前允许失败后重试，再次进入加载状态。
+     * 记录在组件卸载后重置，仅切换 `visible` 不重置；切换资源可通过 `key` 重新挂载。
+     * 延迟启动请求时，需要在准备期间保持 `initializing=true`。
+     * 设为 false 时，两项初始化状态完全跟随外部传入的值。
+     *
+     * @default true
+     */
+    initializeOnce?: boolean;
     /**
      * 是否处于初始化加载中状态。
      * 为 true 时标题区显示骨架屏，内容区显示 4 行骨架屏加载占位，footer 隐藏。
      * 加载完成后设为 false 显示正常内容。
+     * 默认仅在首次初始化成功前生效；设 `initializeOnce=false` 可反复进入加载状态。
      * @default false
      */
     initializing?: boolean;
@@ -147,6 +161,7 @@ export type ImmersiveDialogProps = React.PropsWithChildren<AntdModalProps & {
      * 标题自动变为"加载失败"，确定按钮文本自动变为"重试"。
      * 与 initializing 配合使用：先设 initializing=true 开始加载，
      * 失败时设 initializing=false 并设置 initializingError。
+     * 默认在首次初始化成功后被忽略。
      */
     initializingError?: string | SafeReactNode;
     /**

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

@@ -158,10 +158,24 @@ export interface SmallDialogProps {
      * @default false
      */
     confirmLoading?: boolean;
+    /**
+     * 是否仅初始化一次。首次初始化成功后，忽略后续的 `initializing` 和 `initializingError`。
+     *
+     * @description
+     * `initializing` 为 false 或未传入，且 `initializingError` 无值时，视为初始化成功；
+     * 首次渲染就满足该条件时也会记录成功。成功前允许失败后重试，再次进入加载状态。
+     * 记录在组件卸载后重置。同一实例切换资源时，可通过 `key` 重新挂载。
+     * 延迟启动请求时，需要在准备期间保持 `initializing=true`。
+     * 设为 false 时，两项初始化状态完全跟随外部传入的值。
+     *
+     * @default true
+     */
+    initializeOnce?: boolean;
     /**
      * 是否处于初始化加载中状态。为 true 时，标题显示骨架屏、
      * 内容区域显示骨架屏（行数由 `initializingSkeletonRows` 控制）、footer 隐藏。
      * 初始化完成后设为 false，若加载失败可设置 `initializingError` 展示错误状态。
+     * 默认仅在首次初始化成功前生效；设 `initializeOnce=false` 可反复进入加载状态。
      */
     initializing?: boolean;
     /**
@@ -169,6 +183,7 @@ export interface SmallDialogProps {
      * 内容区域显示错误详情，确认按钮文案变为"重试"。
      * 与 `initializing` 配合使用：先设 initializing=true 加载，
      * 失败时设 initializing=false 且 initializingError="错误信息"。
+     * 默认在首次初始化成功后被忽略。
      */
     initializingError?: string | SafeReactNode;
     /**

package/dist/src/core/SmallDialog/__test__/initialization.test.d.ts

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

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

@@ -0,0 +1,6 @@
+import type { SmallDialogProps } from "./SmallDialog.type";
+/** 记录一次挂载周期内的首次初始化成功，成功前仍允许失败重试。 */
+export declare const useDialogInitialization: ({ initializeOnce, initializing, initializingError, }: Pick<SmallDialogProps, "initializeOnce" | "initializing" | "initializingError">) => {
+    initializing: boolean | undefined;
+    initializingError: import("../..").SafeReactNode;
+};

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

@@ -121,6 +121,7 @@ declare const meta: {
         right?: React.ReactNode;
         rightClassName?: string | undefined;
         footerLeftAction?: React.ReactNode;
+        initializeOnce?: boolean | undefined;
         initializing?: boolean | undefined;
         initializingError?: import("../../../src").SafeReactNode;
         "data-testid"?: string | undefined;
@@ -149,6 +150,11 @@ export declare const Initializing: {
     (): React.JSX.Element;
     storyName: string;
 };
+/** 对比默认的一次初始化与 initializeOnce=false 的完全受控行为。 */
+export declare const InitializeOnce: {
+    (): React.JSX.Element;
+    storyName: string;
+};
 /**
  * 不展示 footer
  */

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

@@ -80,6 +80,11 @@ export declare const Initializing: {
     (): React.JSX.Element;
     storyName: string;
 };
+/** 对比默认的一次初始化与 initializeOnce=false 的完全受控行为。 */
+export declare const InitializeOnce: {
+    (): React.JSX.Element;
+    storyName: string;
+};
 /**
  * 不展示 footer
  *

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

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