@widget-js/core 24.1.1-beta.88 → 24.1.1-beta.89

package/dist/index.d.ts

@@ -168,6 +168,10 @@ interface IDeployedPage {
     height: number;
     width: number;
     proxy?: string;
+    minWidth?: number;
+    minHeight?: number;
+    maxWidth?: number;
+    maxHeight?: number;
     isIgnoreMouseEvents?: boolean;
 }
 declare class DeployedPage implements IDeployedPage {
@@ -185,6 +189,10 @@ declare class DeployedPage implements IDeployedPage {
 declare class DeployedWidget extends DeployedPage {
     shortcut?: string;
     deployMode: number;
+    minWidth?: number;
+    minHeight?: number;
+    maxWidth?: number;
+    maxHeight?: number;
     isOverlap(): boolean;
 }
 
@@ -278,7 +286,7 @@ interface IAiApi {
  */
 declare enum AiApiEvent {
     /**
-     * 配置更新事件
+     * Configuration update event
      */
     CONFIG_UPDATED = "channel::cn.widgetjs.core.ai.config.updated"
 }
@@ -602,34 +610,34 @@ interface AppRuntimeInfo {
 
 type AppRoutes = '/widget/search' | '/widget/package' | '/setting/common' | '/setting/theme' | '/setting/ai' | '/setting/proxy' | '/setting/info' | '/user/profile';
 /**
- * AppApi 接口定义了与应用程序相关的一系列方法。这些方法提供了应用程序配置管理、版本信息获取、路径获取以及应用内置窗口操作等功能。
+ * AppApi interface defines a series of methods related to the application. These methods provide functions such as application configuration management, version information retrieval, path retrieval, and application built-in window operations.
  * @see [Electron API App](https://www.electronjs.org/docs/latest/api/app)
  */
 interface IAppApi {
     /**
-     * 设置配置
+     * Set configuration
      * @param key string
      * @param value string | number | boolean
      */
     setConfig: (key: string | AppApiConstants, value: string | number | boolean) => Promise<any>;
     /**
-     * 获取配置
+     * Get configuration
      * @param key
      * @param defaultValue
      * @return Promise<string | number | boolean>
      */
     getConfig: <T extends string | number | boolean>(key: string | AppApiConstants, defaultValue: T) => Promise<T>;
     /**
-     * 获取版本信息
-     * @param type string - 可选。指定要获取的版本类型。
+     * Get version information
+     * @param type string - Optional. Specify the type of version to get.
      *      <ol>
      *        <li>`app`: Get app's version with Semantic Versioning format.
      *        The version is different from Microsoft store's version.
      *        For example, if the app's version is `24.1.1`, Microsoft store's version will be `24.1.1.0`</li>
-     *        <li>`electron`: 获取 Electron 框架的版本。</li>
-     *        <li>`chrome`: 获取 Electron 使用的 Chromium 版本。</li>
-     *        <li>`node`: 获取 Node.js 的版本。</li>
-     *        <li>`v8`: 获取 V8 引擎的版本。</li>
+     *        <li>`electron`: Get the version of the Electron framework.</li>
+     *        <li>`chrome`: Get the Chromium version used by Electron.</li>
+     *        <li>`node`: Get the Node.js version.</li>
+     *        <li>`v8`: Get the V8 engine version.</li>
      *      </ol>
      * @return Promise<string>
      */
@@ -639,13 +647,13 @@ interface IAppApi {
      */
     getRuntimeInfo: () => Promise<AppRuntimeInfo>;
     /**
-     * 获取Preload JS路径
+     * Get Preload JS path
      * @see [Using Preload Scripts](https://www.electronjs.org/docs/latest/tutorial/tutorial-preload)
      * @return Promise<string>
      */
     getPreloadPath: () => Promise<string>;
     /**
-     * 获取应用安装路径
+     * Get application installation path
      * @return Promise<string>
      */
     getAppPath: () => Promise<string>;
@@ -757,23 +765,23 @@ type AppApiMethods = keyof IAppApi;
  */
 declare enum AppApiEvent {
     /**
-     * 应用设置变更时触发
+     * Triggered when application settings change
      */
     CONFIG_CHANGED = "event::cn.widgetjs.core.app.config.changed",
     /**
-     * 桌面组件网格窗口移动时触发
+     * Triggered when the desktop widget grid window moves
      */
     MOVING_GRID_WINDOW = "event::cn.widgetjs.core.app.moving.grid.window",
     /**
-     * 桌面组件网格窗口停止移动时触发
+     * Triggered when the desktop widget grid window stops moving
      */
     STOP_MOVING_GRID_WINDOW = "event::cn.widgetjs.core.app.moving.grid.window.stop",
     /**
-     * 应用代理发生变化
+     * Application proxy changed
      */
     PROXY_CHANGED = "event::cn.widgetjs.core.app.proxy.changed",
     /**
-     * 应用语言发生变化
+     * Application language changed
      */
     LANGUAGE_CHANGED = "event::cn.widgetjs.core.app.language.changed"
 }
@@ -782,20 +790,20 @@ declare enum AppApiEvent {
  */
 declare enum AppApiConstants {
     /**
-     * 桌面组件网格大小
+     * Desktop widget grid size
      */
     CONFIG_GRID_CELL_SIZE = "cn.widgetjs.config.grid.size",
     /**
-     * 应用主题CSS设置
+     * Application theme CSS settings
      */
     CONFIG_WIDGET_THEME_CSS = "cn.widgetjs.config.widget.theme.css",
     /**
-     * 应用全局代理设置
+     * Application global proxy settings
      */
     CONFIG_PROXY = "cn.widgetjs.config.app.proxy",
     CONFIG_DEV_MODE = "cn.widgetjs.config.app.dev.mode",
     /**
-     * 应用语言设置
+     * Application language settings
      */
     CONFIG_LANGUAGE = "cn.widgetjs.config.app.language"
 }
@@ -1195,6 +1203,7 @@ declare class DeployedWidgetApiImpl extends BaseApi<DeployedWidgetApiMethods> im
      */
     registerActiveShortcut(widgetId: string, shortcut?: string): Promise<boolean>;
     setProxy(widgetId: string, proxy: string): Promise<boolean>;
+    setSize(widgetId: string, width: number, height: number): Promise<void>;
 }
 declare const DeployedWidgetApi: DeployedWidgetApiImpl;
 
@@ -1210,7 +1219,7 @@ interface IDeployedWidgetApi {
     getDeployedWidgets: () => Promise<DeployedWidget[]>;
     openDevTools: (id: string) => Promise<void>;
     /**
-     * @deprecated 使用WidgetApi.openConfigPage代替
+     * @deprecated Use WidgetApi.openConfigPage instead
      * @param id
      */
     openConfigPage: (id?: string, params?: WidgetParams) => Promise<void>;
@@ -1230,18 +1239,25 @@ interface IDeployedWidgetApi {
      */
     addWidget: (options: AddWidgetOption) => Promise<Widget[]>;
     /**
-     * 创建桌面快捷方式
-     * @param widgetName 组件名
-     * @returns 成功返回 true，否则返回 false
+     * Create a desktop shortcut
+     * @param widgetName Widget name
+     * @returns Returns true on success, false otherwise
      */
     createDesktopShortcut: (widgetName: string) => Promise<boolean>;
+    /**
+     * Set widget size
+     * @param widgetId Widget ID
+     * @param width Width
+     * @param height Height
+     */
+    setSize: (widgetId: string, width: number, height: number) => Promise<void>;
 }
 /**
  * AiApiEvent
  */
 declare enum DeployedWidgetApiEvent {
     /**
-     * 第二实例启动事件
+     * Second instance start event
      */
     SECOND_INSTANCE = "channel::cn.widgetjs.core.deployed_widget.second_instance"
 }
@@ -1404,16 +1420,16 @@ interface IDeviceApi {
 }
 
 /**
- * DialogApi 提供文件、文件夹选择功能
+ * DialogApi provides file and folder selection functions
  */
 interface IDialogApi {
     /**
-     * 选取单个文件
-     * @param extensions 允许的文件后缀格式，如：["txt","docx","gif"]
+     * Pick a single file
+     * @param extensions Allowed file extension formats, e.g., ["txt", "docx", "gif"]
      */
     pickFile: (extensions?: string[]) => Promise<string | undefined>;
     /**
-     * 选取文件夹
+     * Pick a folder
      */
     pickFolder: () => Promise<string | undefined>;
 }
@@ -2592,7 +2608,7 @@ interface IFileApi {
 }
 
 /**
- * LogApi提供了日志输出的方法，日志会保存在用户的`当前用户名/文档/桌面组件/logs/日期/组件包名.log`文件中
+ * LogApi provides log output methods, logs will be saved in the user's current username/Documents/widgets/logs/date/widget_package_name.log file
  */
 interface ILogApi {
     info: (...data: any[]) => void;
@@ -2629,26 +2645,26 @@ declare enum MouseApiEvent {
 type MouseApiMethods = keyof IMouseApi;
 
 /**
- * ProcessApi 提供进程信息获取功能
+ * ProcessApi provides process information retrieval functions
  */
 interface IProcessApi {
     getBlinkMemoryInfo: () => Promise<Electron.BlinkMemoryInfo>;
     getHeapStatistics: () => Promise<Electron.HeapStatistics>;
     /**
-     * 获取系统版本信息
+     * Get system version information
      * @example '10.0.17763'
      */
     getSystemVersion: () => Promise<string>;
     /**
-     * 获取当前应用内存信息
+     * Get current application memory information
      */
     getProcessMemoryInfo: () => Promise<Electron.ProcessMemoryInfo>;
 }
 type ProcessApiMethods = keyof IProcessApi;
 
 /**
- * MenuApi 接口定义了一系列用于控制窗口的方法，这些方法提供了窗口的显示、隐藏、移动、调整大小等功能
- * @remarks 注意：桌面类型组件不支持窗口移动、调整大小、最大化、最小化等操作
+ * MenuApi interface defines a series of methods for controlling windows, providing functions such as showing, hiding, moving, and resizing windows
+ * @remarks Note: Desktop-type widgets do not support window moving, resizing, maximizing, minimizing, etc.
  */
 interface IMenuApi {
     /**
@@ -2656,12 +2672,12 @@ interface IMenuApi {
      */
     addMenuItem: (menuItems: WidgetMenuItem[]) => Promise<void>;
     /**
-     * 添加上下文菜单项，最多支持二级菜单
+     * Add context menu items, up to two levels of menus are supported
      * @param menuItems
      */
     addContextMenuItem: (menuItems: WidgetMenuItem[]) => Promise<void>;
     /**
-     * 移除上下文菜单项
+     * Remove context menu items
      * @param menuItemIds
      */
     removeContextMenuItem: (menuItemIds: string[]) => Promise<void>;
@@ -2670,7 +2686,7 @@ interface IMenuApi {
      */
     removeMenuItem: (menuItemIds: string[]) => Promise<void>;
     /**
-     * 显示自定义菜单
+     * Show custom menu
      * @param options ShowMenuOption
      */
     showMenu: (options: ShowMenuOption) => Promise<void>;
@@ -2897,7 +2913,7 @@ interface IUserApi {
  */
 declare enum UserApiEvent {
     /**
-     * 快捷键触发事件
+     * User updated event
      */
     USER_UPDATED = "channel::cn.widgetjs.core.user.updated",
     SIGNED_OUT = "channel::cn.widgetjs.core.user.signed.out",
@@ -2907,32 +2923,32 @@ declare enum UserApiEvent {
 type UserApiMethods = keyof IUserApi;
 
 /**
- * WidgetPackageApi 提供了组件包的升级、获取、安装等功能
+ * WidgetPackageApi provides functions such as upgrading, retrieving, and installing widget packages
  */
 interface IWidgetPackageApi {
     /**
-     * 升级组件包
-     * @param packageName   组件包名称
+     * Upgrade widget package
+     * @param packageName   Widget package name
      * @param remoteUrlInfo
      */
     upgrade: (packageName: string, remoteUrlInfo: RemotePackageUrlInfo) => Promise<void>;
     /**
-     * 获取组件包的首页url信息
+     * Get index url information of the widget package
      * @param packageName
      */
     getIndexUrl: (packageName: string) => Promise<string | null>;
     /**
-     * 获取组件包入口url信息
+     * Get entry url information of the widget package
      * @param packageName
      */
     getEntryUrl: (packageName: string) => Promise<string | null>;
     /**
-     * 通过包名获取组件包信息
+     * Get widget package information by package name
      * @param name
      */
     getPackage: (name: string) => Promise<WidgetPackage | undefined>;
     /**
-     * 获取已经安装的组件包
+     * Get installed widget packages
      */
     getPackages: () => Promise<WidgetPackage[]>;
     /**
@@ -2953,11 +2969,11 @@ type WidgetPackageApiMethods = keyof IWidgetPackageApi;
  */
 declare enum WidgetPackageApiEvent {
     /**
-     * 组件包升级事件
+     * Widget package upgraded event
      */
     PACKAGE_UPGRADE = "event::cn.widgetjs.core.widget.package.upgraded",
     /**
-     * 组件包安装事件
+     * Widget package installed event
      */
     PACKAGE_INSTALLED = "event::cn.widgetjs.core.widget.package.installed"
 }
@@ -2965,11 +2981,11 @@ declare enum WidgetPackageApiEvent {
 declare const AppApi: IAppApi;
 
 /**
- * WidgetApi 接口定义了一系列用于控制组件的方法，这些方法提供了组件的注册、升级、获取、打开设置页面、重新加载等功能
+ * WidgetApi interface defines a series of methods for controlling widgets, providing functions such as widget registration, upgrade, retrieval, opening settings page, reloading, etc.
  */
 interface IWidgetApi {
     /**
-     * 注册组件
+     * Register widgets
      * @param widgets
      */
     registerWidgets: (widgets: Widget[]) => Promise<void>;
@@ -2989,24 +3005,24 @@ interface IWidgetApi {
      */
     isIgnoreMouseEvents: (widgetId?: string) => Promise<boolean>;
     /**
-     * 设置组件是否可以左键拖动
-     * @param draggable boolean true-启用左键拖动 false-禁用左键拖动
-     * @remarks 注意：只对悬浮窗组件(DeployMode.OVERLAP)有效
+     * Set whether the widget can be dragged with the left mouse button
+     * @param draggable boolean true-enable left click drag false-disable left click drag
+     * @remarks Note: Only effective for floating window widgets (DeployMode.OVERLAP)
      */
     setMouseDraggable: (draggable: boolean) => Promise<void>;
     /**
-     * 升级组件包
-     * @param packageName 组件包名
+     * Upgrade widget package
+     * @param packageName Widget package name
      */
     upgradePackage: (packageName: string) => Promise<void>;
     /**
-     * 获取所有组件
+     * Get all widgets
      * @return Promise<Widget[]>
      */
     getWidgets: () => Promise<Widget[]>;
     /**
-     * 通过组件名称获取组件
-     * @param name string 组件名
+     * Get widget by widget name
+     * @param name string Widget name
      * @return Promise<Widget>
      */
     getWidget: (name: string) => Promise<Widget>;
@@ -3020,8 +3036,8 @@ interface IWidgetApi {
      */
     getWidgetPackages: () => Promise<WidgetPackage[]>;
     /**
-     * 打开组件设置页面
-     * @param id string 组件id
+     * Open widget settings page
+     * @param id string Widget id
      */
     openConfigPage: (id?: string) => Promise<void>;
     /**
@@ -3029,7 +3045,7 @@ interface IWidgetApi {
      */
     openConfigPageByName: (name: string) => Promise<void>;
     /**
-     * 重新加载组件
+     * Reload widget
      */
     reload: (id?: string) => Promise<void>;
     /**
@@ -3206,7 +3222,8 @@ declare enum WidgetApiEvent {
     DATA_CHANGED = "event::cn.widgetjs.core.widget.data-changed",
     EDIT_DESKTOP_WIDGETS = "event::cn.widgetjs.core.widget.desktop.edit",
     PACKAGE_UPGRADE = "event::cn.widgetjs.core.widget.package.upgraded",
-    PACKAGE_INSTALLED = "event::cn.widgetjs.core.widget.package.installed"
+    PACKAGE_INSTALLED = "event::cn.widgetjs.core.widget.package.installed",
+    WIDGET_REMOVED = "event::cn.widgetjs.core.widget.removed"
 }
 declare class WidgetApiImpl extends BaseApi<WidgetApiMethods> implements IWidgetApi {
     getSyncInfo(widgetName?: string): Promise<WidgetSyncInfo | null>;
@@ -3246,27 +3263,27 @@ declare class WidgetApiImpl extends BaseApi<WidgetApiMethods> implements IWidget
 declare const WidgetApi: WidgetApiImpl;
 
 /**
- * ShortcutApi 提供了注册快捷键的能力，当快捷键被触发时，会发送广播事件 {@link BroadcastEvent}
+ * ShortcutApi provides the ability to register shortcuts. When a shortcut is triggered, a broadcast event {@link BroadcastEvent} will be sent.
  */
 interface IShortcutApi {
     /**
-     * 注册快捷键, 如果注册成功, 触发快捷键时，会发送广播事件 {@link BroadcastEvent}
+     * Register shortcut, if successful, when the shortcut is triggered, a broadcast event {@link BroadcastEvent} will be sent.
      * @see [Electron Accelerator](https://www.electronjs.org/docs/latest/api/accelerator)
      * @param shortcut string
-     * @return Promise<boolean> true 注册成功，false 注册失败
+     * @return Promise<boolean> true on success, false on failure
      * @example
      * ```typescript
-     * //Meta 通常为windows键
+     * // Meta is usually the Windows key
      * ShortcutApi.register('Ctrl+Meta+Y')
      * ```
      */
     register: (shortcut: string) => Promise<boolean>;
     /**
-     * 注销快捷键
+     * Unregister shortcut
      * @param shortcut string
      * @example
      * ```typescript
-     * //Meta 通常为windows键
+     * // Meta is usually the Windows key
      * ShortcutApi.unregister('Ctrl+Meta+Y')
      * ```
      */
@@ -3277,7 +3294,7 @@ interface IShortcutApi {
  */
 declare enum ShortcutApiEvent {
     /**
-     * 快捷键触发事件
+     * Shortcut triggered event
      */
     TRIGGERED = "channel::cn.widgetjs.core.shortcut.triggered"
 }
@@ -3297,173 +3314,173 @@ declare enum ClipboardApiEvent {
 declare const ClipboardApi: IClipboardApi;
 
 /**
- * BrowserWindowApi 接口定义了一系列用于控制窗口的方法，这些方法提供了窗口的显示、隐藏、移动、调整大小等功能
- * @remarks 注意：桌面类型组件不支持窗口移动、调整大小、最大化、最小化等操作
+ * BrowserWindowApi interface defines a series of methods for controlling windows, providing functions such as showing, hiding, moving, and resizing windows
+ * @remarks Note: Desktop-type widgets do not support window moving, resizing, maximizing, minimizing, etc.
  */
 interface IBrowserWindowApi {
     /**
-     * 设置是否忽略鼠标事件
+     * Set whether to ignore mouse events
      * @param ignore boolean
      */
     setIgnoreMouseEvent: (ignore: boolean) => Promise<void>;
     /**
-     * 显示窗口
+     * Show window
      */
     show: () => Promise<void>;
     /**
-     * 设置窗口是否有阴影
+     * Set whether the window has a shadow
      * @param hasShadow boolean
      */
     setHasShadow: (hasShadow: boolean) => Promise<void>;
     /**
-     * 隐藏窗口
+     * Hide window
      */
     hide: () => Promise<void>;
     /**
-     * 关闭窗口
+     * Close window
      */
     close: () => Promise<void>;
     /**
-     * 以不激活窗口的方式显示窗口
+     * Show window without activating it
      */
     showInactive: () => Promise<void>;
     /**
-     * 将窗口居中
+     * Center window
      */
     center: () => Promise<void>;
     /**
-     * 最小化窗口
+     * Minimize window
      */
     minimize: () => Promise<void>;
     /**
-     * 还原窗口
+     * Restore window
      */
     restore: () => Promise<void>;
     /**
-     * 窗口是否最小后
+     * Whether the window is minimized
      * @return  Promise<boolean>
      */
     isMinimized: () => Promise<boolean>;
     /**
-     * 检查窗口是否最大化
+     * Check if the window is maximized
      * @return  Promise<boolean>
      */
     isMaximized: () => Promise<boolean>;
     /**
-     * 检查窗口是否可见
+     * Check if the window is visible
      * @return  Promise<boolean>
      */
     isVisible: () => Promise<boolean>;
     /**
-     * 检查窗口是否可调整大小
+     * Check if the window is resizable
      * @since 24.1.1-beta.6
      * @return  Promise<boolean>
      */
     isResizable: () => Promise<boolean>;
     /**
-     * 最大化窗口
+     * Maximize window
      */
     maximize: () => Promise<void>;
     /**
-     * 停止拖动窗口
+     * Stop dragging the window
      */
     stopDraggingWindow: () => Promise<void>;
     /**
-     * 开始拖动窗口
+     * Start dragging the window
      */
     startDraggingWindow: () => Promise<void>;
     /**
-     * 检查窗口是否正在拖动
+     * Check if the window is being dragged
      * @return  Promise<boolean>
      */
     isDraggingWindow: () => Promise<boolean>;
     /**
-     * 设置窗口是否总在最前
+     * Set whether the window is always on top
      * @param alwaysOnTop boolean
      */
     setAlwaysOnTop: (alwaysOnTop: boolean) => Promise<void>;
     /**
-     * 检查窗口是否总在最前
+     * Check if the window is always on top
      * @return  Promise<boolean>
      */
     isAlwaysOnTop: () => Promise<boolean>;
     /**
-     * 打开指定的 URL
-     * @param url string 要打开的 URL
-     * @param option OpenUrlOptions - 可选参数，用于配置 URL 打开的方式
+     * Open specified URL
+     * @param url string The URL to open
+     * @param option OpenUrlOptions - Optional parameters for configuring how the URL is opened
      */
     openUrl: (url: string, option?: BrowserWindowOptions) => Promise<void>;
     /**
-     * 将窗口置于最前
+     * Move the window to the top
      */
     moveTop: () => Promise<void>;
     /**
-     * 取消最大化窗口
+     * Unmaximize window
      */
     unmaximize: () => Promise<void>;
     /**
-     * 重新加载窗口
+     * Reload window
      */
     reload: () => Promise<void>;
     /**
-     * 设置窗口大小
-     * @param width boolean - 窗口宽度
-     * @param height boolean - 窗口高度
-     * @param animate boolean - 是否使用动画（可选）
+     * Set window size
+     * @param width boolean - Window width
+     * @param height boolean - Window height
+     * @param animate boolean - Whether to use animation (optional)
      */
     setSize: (width: number, height: number, animate?: boolean) => Promise<void>;
     /**
-     * 获取窗口大小
+     * Get window size
      * @since 24.1.1-beta.6
      * @returns Promise<number[]>
      */
     getSize: () => Promise<number[]>;
     /**
-     * 打开开发者工具
+     * Open developer tools
      */
     openDevTools: () => Promise<void>;
     /**
-     * 设置窗口位置
-     * @param {SetPositionOptions} options - 配置窗口位置的选项
+     * Set window position
+     * @param {SetPositionOptions} options - Options for configuring the window position
      */
     setPosition: (options: SetPositionOptions) => Promise<void>;
     /**
-     * 获取窗口位置
-     * @returns {Promise<Position>} 返回一个 Promise，解析为窗口的位置
+     * Get window position
+     * @returns {Promise<Position>} Returns a Promise that resolves to the window's position
      */
     getPosition: () => Promise<Position>;
     /**
-     * 使窗口失去焦点
+     * Blur window
      */
     blur: () => Promise<void>;
     /**
-     * 聚焦窗口
+     * Focus window
      */
     focus: () => Promise<void>;
     /**
-     * 设置窗口是否可调整大小
-     * @param resizable boolean - 是否可调整大小
+     * Set whether the window is resizable
+     * @param resizable boolean - Whether it is resizable
      */
     setResizable: (resizable: boolean) => Promise<void>;
     /**
-     * 设置窗口是否可移动
-     * @param movable boolean - 是否可移动
+     * Set whether the window is movable
+     * @param movable boolean - Whether it is movable
      */
     setMovable: (movable: boolean) => Promise<void>;
     /**
-     * 获取窗口边界
+     * Get window bounds
      * @returns Promise<Rectangle>
      */
     getBounds: () => Promise<Rectangle>;
     /**
-     * 设置窗口边界
-     * @param {Partial<Rectangle>} bounds - 窗口的边界矩形
-     * @param {boolean} animate - 是否启用动画
+     * Set window bounds
+     * @param {Partial<Rectangle>} bounds - The bounds rectangle of the window
+     * @param {boolean} animate - Whether to enable animation
      */
     setBounds: (bounds: Partial<Rectangle>, animate: boolean) => Promise<void>;
     /**
-     * 将窗口对齐到当前屏幕
-     * @param align string 对齐位置
+     * Align the window to the current screen
+     * @param align string Alignment position
      *  <ol>
      *    <li>'top-left'</li>
      *    <li>'top-center'</li>
@@ -3475,42 +3492,42 @@ interface IBrowserWindowApi {
      */
     alignToScreen: (align: AlignPosition) => Promise<void>;
     /**
-     * 检查指定 URL 是否存在
-     * @param {string} url - 要检查的 URL
+     * Check if the specified URL exists
+     * @param {string} url - The URL to check
      * @return  Promise<boolean>
      */
     existsByUrl: (url: string) => Promise<boolean>;
     /**
-     * 获取窗口的最大尺寸
-     * @returns {Promise<number[]>} 返回一个 Promise，解析为一个数组，包含窗口的最大宽度和高度
+     * Get the maximum size of the window
+     * @returns {Promise<number[]>} Returns a Promise that resolves to an array containing the maximum width and height of the window
      */
     getMaximumSize: () => Promise<number[]>;
     /**
-     * 获取窗口的最小尺寸
-     * @returns {Promise<number[]>} 返回一个 Promise，解析为一个数组，包含窗口的最小宽度和高度
+     * Get the minimum size of the window
+     * @returns {Promise<number[]>} Returns a Promise that resolves to an array containing the minimum width and height of the window
      */
     getMinimumSize: () => Promise<number[]>;
     /**
-     * 设置窗口的最大尺寸
-     * @param {number} width - 最大宽度
-     * @param {number} height - 最大高度
+     * Set the maximum size of the window
+     * @param {number} width - Maximum width
+     * @param {number} height - Maximum height
      */
     setMaximumSize: (width: number, height: number) => Promise<void>;
     /**
-     * 设置窗口的最小尺寸
-     * @param {number} width - 最大宽度
-     * @param {number} height - 最大高度
+     * Set the minimum size of the window
+     * @param {number} width - Maximum width
+     * @param {number} height - Maximum height
      */
     setMinimumSize: (width: number, height: number) => Promise<void>;
     /**
-     * 更改缩放等级 原始尺寸为 0，每升高或将顶代表缩放20%，大和小限制默认分区为 300% 和 50% 缩放公式为 scale := 1.2 ^ level.
-     * @param level number - 缩放等级，默认为 0
+     * Change the zoom level. Original size is 0, each increment or decrement represents a 20% zoom. The default upper and lower limits are 300% and 50%. The zoom formula is scale := 1.2 ^ level.
+     * @param level number - Zoom level, default is 0
      */
     setZoomLevel: (level: number) => Promise<void>;
     /**
-     * 更改缩放倍数 缩放系数是缩放百分比除以 100，即 300% = 3.0
-     * @param factor Double - 缩放系数，默认为 1.0
-     * @remarks 系数必须大于0.0
+     * Change zoom factor. The zoom factor is the zoom percentage divided by 100, i.e., 300% = 3.0
+     * @param factor Double - Zoom factor, default is 1.0
+     * @remarks The factor must be greater than 0.0
      */
     setZoomFactor: (factor: number) => Promise<void>;
     /**
@@ -3739,36 +3756,36 @@ declare const LogApi: ILogApi;
 declare const MouseApi: IMouseApi;
 
 /**
- * NotificationApi提供了发送通知的能力
+ * NotificationApi provides the ability to send notifications
  */
 interface INotificationApi {
     /**
-     * 发送自定义通知
+     * Send custom notification
      * @param notification
      */
     send: (notification: AppNotification) => Promise<void>;
     /**
-     * 隐藏通知
+     * Hide notification
      */
     hide: () => Promise<void>;
     /**
      * @param message string
-     * @param duration number  持续时间，单位毫秒，默认5000
+     * @param duration number Duration in milliseconds, default 5000
      */
     success: (message: string, duration?: number) => Promise<void>;
     /**
      * @param message string
-     * @param duration number  持续时间，单位毫秒，默认5000
+     * @param duration number Duration in milliseconds, default 5000
      */
     error: (message: string, duration?: number) => Promise<void>;
     /**
      * @param message string
-     * @param duration number  持续时间，单位毫秒，默认5000
+     * @param duration number Duration in milliseconds, default 5000
      */
     warning: (message: string, duration?: number) => Promise<void>;
     /**
      * @param message string
-     * @param duration number  持续时间，单位毫秒，默认5000
+     * @param duration number Duration in milliseconds, default 5000
      */
     info: (message: string, duration?: number) => Promise<void>;
     reminder: (option: ReminderNotificationOption) => Promise<void>;
@@ -3810,53 +3827,53 @@ declare const ProcessApi: IProcessApi;
 
 type BaseType = string | number | boolean;
 /**
- * StorageApi 接口定义了用于存储和检索数据的方法，包括加密和解密功能。
+ * StorageApi interface defines methods for storing and retrieving data, including encryption and decryption functions.
  */
 interface IStorageApi {
     /**
-     * 获取存储中的值。
-     * @param key 键名
-     * @param defaultValue 可选，默认值
+     * Get value from storage.
+     * @param key Key name
+     * @param defaultValue Optional, default value
      */
     get: <T extends BaseType>(key: string, defaultValue?: T) => Promise<T | null>;
     /**
-     * 设置存储中的值。
-     * @param key 键名
-     * @param value 要存储的值，可以是 BaseType 或对象
+     * Set value in storage.
+     * @param key Key name
+     * @param value Value to store, can be BaseType or object
      */
     set: (key: string, value: BaseType | object) => Promise<string>;
     /**
-     * 获取存储中的对象值。
-     * @param key 键名
-     * @param defaultValue 可选，默认值
+     * Get object value from storage.
+     * @param key Key name
+     * @param defaultValue Optional, default value
      */
     getObject: <T>(key: string, defaultValue?: T) => Promise<T | undefined>;
     /**
-     * 删除存储中的值。
-     * @param key 键名
+     * Delete value from storage.
+     * @param key Key name
      */
     delete: (key: string) => Promise<void>;
     /**
-     * 使用 [DPAPI](https://learn.microsoft.com/en-us/windows/win32/api/dpapi/nf-dpapi-cryptprotectdata) 生成的加密密钥对字符串进行加密。根据 Windows 文档：“通常，只有与加密数据的用户具有相同登录凭据的用户才可以解密数据”。因此，内容受到同一计算机上其他用户的保护，但不受同一用户空间中运行的其他应用程序的保护。
-     * @param value 要加密的字符串
+     * Encrypt a string with the encryption key generated by [DPAPI](https://learn.microsoft.com/en-us/windows/win32/api/dpapi/nf-dpapi-cryptprotectdata). According to Windows documentation: "Typically, only a user with the same logon credential as the user who encrypted the data can decrypt the data". Therefore, the content is protected from other users on the same computer, but not from other applications running in the same user space.
+     * @param value String to encrypt
      * @see [Safe Storage](https://www.electronjs.org/docs/latest/api/safe-storage)
      */
     encryptString: (value: string) => Promise<string>;
     /**
-     * 对加密的字符串进行解密。
-     * @param value 要解密的字符串
+     * Decrypt the encrypted string.
+     * @param value String to decrypt
      */
     decryptString: (value: string) => Promise<string>;
     /**
-     * 对字符串进行加密并存储。
-     * @param key 键名
-     * @param value 要加密并存储的字符串
+     * Encrypt string and store.
+     * @param key Key name
+     * @param value String to encrypt and store
      */
     encryptSet: (key: string, value: string) => Promise<string>;
     /**
-     * 获取加密存储中的字符串值。
-     * @param key 键名
-     * @param defaultValue 可选，默认值
+     * Get string value from encrypted storage.
+     * @param key Key name
+     * @param defaultValue Optional, default value
      */
     decryptGet: (key: string, defaultValue?: string) => Promise<string | undefined>;
 }