@cloudtower/eagle 4100.0.23 → 4100.0.24

package/docs/core/ImmersiveDialog/guide.md

@@ -89,6 +89,23 @@ const App = () => {
 
 首次渲染没有加载和错误时也视为成功；延迟请求应在准备期间保持 `initializing=true`。更多调用约定见 [SmallDialog 初始化生命周期](../SmallDialog/guide.md#初始化生命周期)。
 
+## 暂时禁用关闭
+
+`closeDisabled` 默认为 `false`。设为 `true` 时保留灰色且原生禁用的右上角关闭按钮，同时阻止 Escape 和点击遮罩关闭。即使显式设置 `keyboard` 或 `maskClosable` 为 `true`，锁定期间也不会关闭；恢复为 `false` 后按这两项的原有配置处理。
+
+`closable={false}` 优先隐藏关闭按钮，自定义 `closeIcon` 在禁用期间仍会展示。此属性只锁定右上角关闭及其快捷入口，不影响 footer 取消按钮、确认按钮或业务主动调用 `popModal()`。异步任务需要锁定全部退出入口时，应同时设置 `cancelButtonProps.disabled`。
+
+```tsx
+<ImmersiveDialog
+  title="检查环境"
+  closeDisabled={checking}
+  cancelButtonProps={{ disabled: checking }}
+  okButtonProps={{ disabled: checking }}
+>
+  <EnvironmentCheck />
+</ImmersiveDialog>
+```
+
 ## 常见模式
 
 ### 模式一：三栏布局

package/docs/core/LogView/guide.md

@@ -173,6 +173,21 @@ const App = () => (
 );
 ```
 
+### 模式七：等待当前日志加载完成
+
+通过 `loading` 控制加载提示。组件会用深蓝背景遮住日志和搜索栏，居中显示旋转圆环及“正在获取日志信息...”。终端保持挂载，内容更新和 EventSource 连接继续运行；加载提示优先于自定义空态和错误态。
+
+```tsx
+import React from "react";
+import { LogView } from "@cloudtower/eagle";
+
+const App = ({ logs, isLoading }) => (
+  <LogView content={logs} loading={isLoading} rows={16} />
+);
+```
+
+`loading` 默认为 `false`，由调用方在当前日志完整读取后关闭。后续实时追加日志时保持 `false` 即可。
+
 ## 注意事项
 
 - `content` 适合静态日志或外部已合并好的实时日志；直接使用 SSE 时优先配置 `eventSource` 和 `eventSourceOptions`。

package/docs/core/WizardDialog/guide.md

@@ -301,6 +301,7 @@ const App = () => {
 
 ## 关键说明
 
+- **暂时禁用关闭**：继承 `closeDisabled`（默认 `false`），为 `true` 时保留灰色关闭按钮并阻止 Escape、遮罩关闭；`closable=false` 仍隐藏按钮。Footer 取消及步骤导航需独立控制。完整约定见 [ImmersiveDialog 暂时禁用关闭](../ImmersiveDialog/guide.md#暂时禁用关闭)。
 - **首次初始化**：继承 ImmersiveDialog 的 `initializeOnce`，默认为 `true`。成功前允许失败重试，首次成功后忽略后续的加载和初始化错误，避免刷新时卸载步骤内容。设为 false 可恢复完全受控行为；仅切换 `visible` 不重置记录。完整约定见 [ImmersiveDialog 初始化生命周期](../ImmersiveDialog/guide.md#初始化生命周期)。
 - **按钮文案自动切换**：非最后一步时，确认按钮文案自动显示为 `nextText`（默认"下一步"）；最后一步时显示为 `okText`（默认"确认"）。
 - **onNextStep 校验机制**：`onNextStep` 返回值严格等于 `false`（`=== false`）时阻止导航到下一步。返回 `undefined`、`null`、`true` 或其他值均不会阻止。这是该组件最核心的交互模式。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudtower/eagle",
-  "version": "4100.0.23",
+  "version": "4100.0.24",
   "main": "dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "dist/src/index.d.ts",
@@ -30,8 +30,8 @@
     "sync:typography": "node tools/sync-figma-typography.js --write"
   },
   "dependencies": {
-    "@cloudtower/icons-react": "^4100.0.23",
-    "@cloudtower/parrot": "^4100.0.23",
+    "@cloudtower/icons-react": "^4100.0.24",
+    "@cloudtower/parrot": "^4100.0.24",
     "@cloudtower/rc-notification": "^4.6.1",
     "@linaria/core": "^4.2.2",
     "@linaria/react": "^4.3.0",