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

package/dist/index.d.cts

@@ -92,6 +92,8 @@ interface ThemeColors {
     border: string;
     input: string;
     ring: string;
+    shadow: string;
+    innerShadow: string;
 }
 interface ThemeRadius {
     sm: string;
@@ -104,9 +106,14 @@ interface ThemeTypography {
     fontSize: string;
 }
 interface ThemeShadow {
-    sm: string;
-    md: string;
-    lg: string;
+    sm: ThemeBoxShadow;
+    md: ThemeBoxShadow;
+    lg: ThemeBoxShadow;
+}
+interface ThemeBoxShadow {
+    offsetX: string;
+    offsetY: string;
+    blur: string;
 }
 interface IAppTheme {
     useGlobalTheme?: boolean;
@@ -161,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 {
@@ -178,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;
 }
 
@@ -252,6 +267,31 @@ declare class AppConfig {
     static readonly LAUNCH_AT_STARTUP = "CONFIG_LAUNCH_AT_STARTUP";
 }
 
+interface AiConfig {
+    id: string;
+    model: string;
+    apiKey: string;
+    apiBaseUrl: string;
+}
+interface IAiApi {
+    addConfig: (config: AiConfig) => Promise<AiConfig>;
+    deleteConfig: (id: string) => Promise<void>;
+    updateConfig: (config: AiConfig) => Promise<void>;
+    getConfigList: () => Promise<AiConfig[]>;
+    setConfigList: (configs: AiConfig[]) => Promise<void>;
+    getConfig: (id: string) => Promise<AiConfig | undefined>;
+}
+/**
+ * AiApiEvent
+ */
+declare enum AiApiEvent {
+    /**
+     * Configuration update event
+     */
+    CONFIG_UPDATED = "channel::cn.widgetjs.core.ai.config.updated"
+}
+type AiApiMethods = keyof IAiApi;
+
 interface Language {
     baseName: string;
     language: string;
@@ -570,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>
      */
@@ -607,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>;
@@ -725,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"
 }
@@ -750,200 +790,527 @@ 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"
 }
 
-/**
- * DialogApi 提供文件、文件夹选择功能
- */
-interface IDialogApi {
-    /**
-     * 选取单个文件
-     * @param extensions 允许的文件后缀格式，如：["txt","docx","gif"]
-     */
-    pickFile: (extensions?: string[]) => Promise<string | undefined>;
-    /**
-     * 选取文件夹
-     */
-    pickFolder: () => Promise<string | undefined>;
-}
-type DialogApiMethods = keyof IDialogApi;
+type WidgetPermission = 'keyboard' | 'mouse' | 'clipboard' | 'notification' | 'storage' | 'network' | 'cpu' | 'system-info';
 
-/**
- * WidgetPackageApi 提供了组件包的升级、获取、安装等功能
- */
-interface IWidgetPackageApi {
-    /**
-     * 升级组件包
-     * @param packageName   组件包名称
-     * @param remoteUrlInfo
-     */
-    upgrade: (packageName: string, remoteUrlInfo: RemotePackageUrlInfo) => Promise<void>;
+interface MetaInfo {
+    [key: string]: string | number | boolean;
+}
+interface IWindowSize {
+    width: number;
+    height: number;
+    maxWidth?: number;
+    maxHeight?: number;
+    minWidth?: number;
+    minHeight?: number;
+}
+interface IPageOptions extends IWindowSize {
+    name: string;
     /**
-     * 获取组件包的首页url信息
-     * @param packageName
+     * 当showInSearch为true时,此项必填
      */
-    getIndexUrl: (packageName: string) => Promise<string | null>;
+    title: LanguageTextMap;
     /**
-     * 获取组件包入口url信息
-     * @param packageName
+     * 当showInSearch为true时,此项必填
      */
-    getEntryUrl: (packageName: string) => Promise<string | null>;
+    description?: LanguageTextMap;
     /**
-     * 通过包名获取组件包信息
-     * @param name
+     * 当showInSearch为true时,此项必填
      */
-    getPackage: (name: string) => Promise<WidgetPackage | undefined>;
+    keywords?: WidgetKeyword[];
+    lang: LanguageCode;
+    packageName?: string;
+    icon?: string;
     /**
-     * 获取已经安装的组件包
+     * 当showInSearch为true时,此项必填
      */
-    getPackages: () => Promise<WidgetPackage[]>;
+    previewImage?: string;
     /**
-     * Install a widget package, if the package is a string, it will be treated as a path or http url to install the widget.zip file.
-     * @param widgetPackage
+     * 是否在搜索中显示
      */
-    install: (widgetPackage: WidgetPackage | string) => Promise<void>;
+    showInSearch?: boolean;
     /**
-     * Uninstall a widget package by package name.
-     * @param packageName
-     * @param clearData    Whether to clear the data of the widget package, default is false.
+     * 悬浮窗模式 是否可移动
+     * @deprecated
      */
-    uninstall: (widgetPackage: WidgetPackage | string, clearData?: boolean) => Promise<void>;
-}
-type WidgetPackageApiMethods = keyof IWidgetPackageApi;
-/**
- * WidgetPackageApiEvent
- */
-declare enum WidgetPackageApiEvent {
+    movable?: boolean;
     /**
-     * 组件包升级事件
+     * @deprecated
      */
-    PACKAGE_UPGRADE = "event::cn.widgetjs.core.widget.package.upgraded",
+    resizable?: boolean;
     /**
-     * 组件包安装事件
+     * @deprecated
      */
-    PACKAGE_INSTALLED = "event::cn.widgetjs.core.widget.package.installed"
-}
-
-/**
- * LogApi提供了日志输出的方法，日志会保存在用户的`当前用户名/文档/桌面组件/logs/日期/组件包名.log`文件中
- */
-interface ILogApi {
-    info: (...data: any[]) => void;
-    error: (...data: any[]) => void;
-    warn: (...data: any[]) => void;
-    log: (...data: any[]) => void;
-    json: (data: any) => void;
-}
-type LogApiMethods = keyof ILogApi;
-
-/**
- * ProcessApi 提供进程信息获取功能
- */
-interface IProcessApi {
-    getBlinkMemoryInfo: () => Promise<Electron.BlinkMemoryInfo>;
-    getHeapStatistics: () => Promise<Electron.HeapStatistics>;
+    backgroundThrottling?: boolean;
+    security?: boolean;
     /**
-     * 获取系统版本信息
-     * @example '10.0.17763'
+     * @deprecated
      */
-    getSystemVersion: () => Promise<string>;
+    webviewTag?: boolean;
+    path: string;
     /**
-     * 获取当前应用内存信息
+     * 是否只能添加一次
      */
-    getProcessMemoryInfo: () => Promise<Electron.ProcessMemoryInfo>;
+    singleton?: boolean;
+    permissions?: WidgetPermission[];
+    meta?: MetaInfo;
+    broadcastChannels?: string[];
 }
-type ProcessApiMethods = keyof IProcessApi;
-
-/**
- * MouseApi
- */
-interface IMouseApi {
+interface IPage {
+    readonly name: string;
     /**
-     * Create a mouse screen edge hotspot, usually used for edge-hiding windows.
-     * @param rect
+     * 窗口标题，显示在界面上的，
+     * https://zh.m.wikipedia.org/zh-hans/ISO_639-1
      */
-    createHotspot: (rect: Rectangle) => Promise<void>;
+    readonly title: LanguageTextMap;
+    readonly permissions: WidgetPermission[];
+    readonly webviewTag: boolean;
     /**
-     * Remove the mouse screen edge hotspot.
+     * 窗口介绍
      */
-    removeHotspot: () => Promise<void>;
-}
-/**
- * SystemApiEvent
- */
-declare enum MouseApiEvent {
+    readonly description: LanguageTextMap;
+    readonly keywords: WidgetKeyword[];
     /**
-     * Triggered when the mouse enters the hotspot area.
+     * 组件默认语言
      */
-    HOTSPOT_ACTIVE = "event::cn.widgetjs.core.mouse.hotspot.active"
-}
-type MouseApiMethods = keyof IMouseApi;
-
-/**
- *  @see https://electronjs.org/docs/api/structures/size
- */
-interface Size {
-    height: number;
-    width: number;
-}
-
-/**
- * @see https://electronjs.org/docs/api/structures/display
- */
-interface Display {
+    readonly lang: LanguageCode;
+    readonly width: number;
+    packageName?: string | null;
+    readonly height: number;
+    readonly maxWidth: number;
+    readonly maxHeight: number;
+    readonly minWidth: number;
+    readonly minHeight: number;
+    readonly movable: boolean;
+    readonly singleton: boolean;
+    readonly resizable: boolean;
+    readonly path: string;
+    readonly meta: {
+        [key: string]: string | number | boolean;
+    };
+    readonly backgroundThrottling: boolean;
     /**
-     * Can be `available`, `unavailable`, `unknown`.
+     * 预览图片，可以是GIF
      */
-    accelerometerSupport: ('available' | 'unavailable' | 'unknown');
+    readonly previewImage?: string;
+}
+declare class Page implements IPage {
     /**
-     * the bounds of the display in DIP points.
+     * 页面名称,名称必须以包名开头，如果以.开头，会自动加上包名<br>
+     * 假设包名为`example.com`，以下两种写法等价
+     * @example example.com.countdown
+     * @example .countdown
      */
-    bounds: Rectangle;
+    name: string;
     /**
-     * The number of bits per pixel.
+     * 窗口标题，显示在界面上的，
+     * @see https://zh.m.wikipedia.org/zh-hans/ISO_639-1
      */
-    colorDepth: number;
+    readonly title: LanguageTextMap;
     /**
-     *  represent a color space (three-dimensional object which contains all realizable
-     * color combinations) for the purpose of color conversions
+     * 窗口介绍
      */
-    colorSpace: string;
+    readonly description: LanguageTextMap;
+    readonly keywords: WidgetKeyword[];
+    readonly security: boolean;
+    readonly permissions: WidgetPermission[];
     /**
-     * The number of bits per color component.
+     * 组件默认语言
      */
-    depthPerComponent: number;
+    readonly lang: LanguageCode;
+    readonly width: number;
+    packageName?: string | null;
+    readonly height: number;
+    readonly maxWidth: number;
     /**
-     * The display refresh rate.
+     * @deprecated
      */
-    displayFrequency: number;
+    readonly webviewTag: boolean;
+    readonly maxHeight: number;
+    readonly minWidth: number;
+    readonly minHeight: number;
+    readonly movable: boolean;
+    readonly singleton: boolean;
+    readonly resizable: boolean;
+    readonly path: string;
+    readonly icon?: string;
+    readonly meta: MetaInfo;
+    readonly backgroundThrottling: boolean;
     /**
-     * Unique identifier associated with the display.
+     * 预览图片，可以是GIF
      */
-    id: number;
+    readonly previewImage?: string;
+    constructor(options: IPageOptions);
     /**
-     * `true` for an internal display and `false` for an external display
+     * 获取组件标题
+     * @param lang 语言环境，不传则获取默认语言
      */
-    internal: boolean;
+    getTitle(lang?: LanguageCode): string | undefined;
     /**
-     * User-friendly label, determined by the platform.
+     * 获取组件描述
+     * @param lang 语言环境，不传则获取默认标题
      */
-    label: string;
+    getDescription(lang?: LanguageCode): string | undefined;
+    static parseJSON(json: string): Page;
+    static parseObject(obj: any): Page;
+    isResizable(): boolean;
+}
+
+type SocialType = 'qq' | 'wechat' | 'qq-group' | 'discord' | 'telegram' | 'tiktok' | 'douyin' | 'youtube' | 'instagram' | 'twitter' | 'facebook' | 'kuaishou' | 'bilibili' | 'github' | 'email' | 'gitee' | 'homepage';
+declare class SocialInfo {
+    content: string;
+    name: SocialType;
+    constructor(name: SocialType, content: string);
+}
+interface SocialLink {
+    name: SocialType;
+    link: string;
+}
+
+/**
+ * @see [Web Manifest Categories]https://developer.mozilla.org/en-US/docs/Web/Manifest/categories
+ * @see [W3C Categories](https://github.com/w3c/manifest/wiki/Categories)
+ */
+type Category = 'news' | 'photo' | 'productivity' | 'social' | 'utilities' | 'weather'
+/**
+ * @deprecated
+ */
+ | 'calendar' | 'fun'
+/**
+ * @deprecated
+ */
+ | 'countdown' | 'time' | 'finance' | 'ai';
+
+interface IWidgetOptions extends IWindowSize, IPageOptions {
+    supportDeployMode?: DeployMode;
+    configPagePath?: string;
+    /**
+     * 如果为true，组件将不会添加到组件包中
+     */
+    disabled?: boolean;
+    previewImage: string;
+    /**
+     * whether the widget data can be synchronized
+     */
+    synchronizable?: boolean;
+    categories?: Category[];
+    /**
+     * 组件包所需的App版本
+     */
+    requiredAppVersion?: string;
+    description: LanguageTextMap;
+    keywords: WidgetKeyword[];
+    /**
+     * @deprecated
+     */
+    routes?: WidgetRoute[];
+    /**
+     * 一般用于填写教程链接
+     */
+    socialLinks?: SocialLink[];
+    browserWindowOptions?: Pick<BrowserWindowOptions, 'backgroundThrottling'>;
+    trayOptions?: TrayWidgetOptions;
+}
+interface IBackgroundWidgetOptions extends Omit<IWidgetOptions, 'width' | 'height'> {
+    width?: number;
+    height?: number;
+    browserWindowOptions?: BrowserWindowOptions;
+}
+/**
+ * @deprecated
+ */
+interface WidgetRoute {
+    url: string;
+    name: string;
+}
+interface TrayWidgetOptions {
+    closeOnBlur?: boolean;
+    hideOnBlur?: boolean;
+}
+declare class Widget extends Page {
+    readonly previewImage: string;
+    readonly categories?: Category[];
+    readonly supportDeployMode: number;
+    readonly trayOptions?: TrayWidgetOptions;
+    /**
+     * 组件包所需的App版本
+     */
+    readonly requiredAppVersion?: string;
+    /**
+     * 如果为true，组件将不会添加到组件包中
+     */
+    readonly disabled?: boolean;
+    readonly synchronizable?: boolean;
+    /**
+     * 配置页面路径，没有则不能修改
+     */
+    readonly configPagePath?: string;
+    /**
+     * @deprecated
+     */
+    readonly routes: WidgetRoute[];
+    protected browserWindowOptions?: BrowserWindowOptions;
+    readonly socialLinks?: SocialLink[];
+    constructor(options: IWidgetOptions);
+    static parseJSON(json: string): Widget;
+    static parseObject(obj: any): Widget;
+    /**
+     * 是否支持悬浮窗
+     */
+    isSupportOverlap(): boolean;
+    isSupportBackground(): boolean;
+    isSupportTray(): boolean;
+    /**
+     * 是否支持普通模式
+     */
+    isSupportNormal(): boolean;
+    isConfigurable(): boolean;
+}
+declare class BackgroundWidget extends Widget {
+    constructor(options: IBackgroundWidgetOptions);
+}
+declare enum WidgetKeyword {
+    RECOMMEND = "recommend",
+    TOOLS = "tools",
+    EFFICIENCY = "efficiency",
+    PICTURE = "picture",
+    LIFE = "life",
+    SHORTCUT = "shortcut",
+    COUNTDOWN = "countdown",
+    TIMER = "timer",
+    INFO = "info",
+    DASHBOARD = "dashboard"
+}
+
+declare class WidgetParams {
+    static readonly PARAM_PREFIX = "w_";
+    static readonly PARAM_ID = "id";
+    static readonly PARAM_LANG = "lang";
+    static readonly PARAM_THEME = "theme";
+    static readonly PARAM_MODE = "mode";
+    static readonly PARAM_NAME = "name";
+    static readonly PARAM_TITLE = "title";
+    static readonly PARAM_PREVIEW = "preview";
+    static readonly PARAMS: string[];
+    id?: string;
+    width?: number;
+    widthPx?: number;
+    heightPx?: number;
+    height?: number;
+    x?: number;
+    y?: number;
+    preview?: boolean;
+    lang?: string;
+    theme?: ThemeMode;
+    mode?: DeployMode;
+    radius?: number;
+    name?: string;
+    title?: string;
+    /**
+     * 将组件参数转为url参数
+     * @param object
+     * @return URLSearchParams  w_w=2&w_h=2&w_id=21&w_width=156&w_height=156
+     */
+    toUrlParams(): URLSearchParams;
+    getPersistKey(): string;
+    /**
+     * 从当前地址解析组件参数：
+     * http://localhost:8080/#/widget/config/labor_progress?w_w=2&w_h=2&w_width=156&w_height=156
+     * =>
+     *  {width:2,height:2,id:21,width_px:156,height_px:156}
+     */
+    static fromCurrentLocation(): WidgetParams;
+    static fromLocation(url: string): WidgetParams;
+    private static setValue;
+    /**
+     * 从对象键值对中初始化组件参数
+     * {w_width:2,w_height:2,w_id:21,w_width_px:156,w_height_px:156}=>
+     *  {width:2,height:2,id:21,width_px:156,height_px:156}
+     * @param object
+     */
+    static fromObject(object: any): WidgetParams;
+}
+declare enum ThemeMode {
+    AUTO = "auto",
+    LIGHT = "LIGHT",
+    DARK = "DARK"
+}
+
+declare abstract class BaseApi<T extends string> {
+    abstract getChannel(): string;
+    protected invokeMethod(method: T, ...args: any[]): Promise<any>;
+    protected invoke(...args: any[]): Promise<any>;
+}
+
+interface AddWidgetOption {
+    widgetName: string;
+    widgetTitle?: string;
+    deployMode: DeployMode;
+    packageJsonUrl?: string;
+    hostname?: string;
+}
+type DeployedWidgetApiMethods = keyof IDeployedWidgetApi;
+declare class DeployedWidgetApiImpl extends BaseApi<DeployedWidgetApiMethods> implements IDeployedWidgetApi {
+    getChannel(): string;
+    /**
+     * 移除组件
+     * @param id
+     */
+    removeDeployedWidget(id?: string): Promise<any>;
+    addWidget(options: AddWidgetOption): Promise<Widget[]>;
+    createDesktopShortcut(widgetName: string): Promise<boolean>;
+    /**
+     * 通过组件名移除已添加的组件
+     * @param name  组件名
+     */
+    removeDeployedWidgetByName(name: string): Promise<DeployedWidget[]>;
+    /**
+     * 获取已添加的组件
+     * @param name  组件名，可以不传
+     */
+    getDeployedWidgets(name?: string): Promise<DeployedWidget[]>;
+    getDeployedWidget(id: string): Promise<DeployedWidget>;
+    /**
+     * Opens the dev tools for a widget with the specified ID.
+     *
+     * @param {string} widgetId - The ID of the widget to open the dev tools for.
+     * @return {Promise} A Promise that resolves when the dev tools are opened.
+     */
+    openDevTools(widgetId: string): Promise<any>;
+    openConfigPage(widgetId?: string, params?: WidgetParams): Promise<any>;
+    /**
+     * 注册激活、呼出、置顶组件快捷键
+     * @param widgetId  组件id
+     * @param shortcut  如果传空或者不传，则会取消快捷键。更多快捷键配置，请查看Accelerator用法
+     *                  https://www.electronjs.org/docs/latest/api/accelerator
+     */
+    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;
+
+/**
+ * DeployedWidgetApi provides methods for managing deployed widgets within the application.
+ * It allows for the removal, retrieval, and configuration of deployed widgets,
+ * as well as the ability to manipulate their settings and behavior.
+ * @remarks
+ */
+interface IDeployedWidgetApi {
+    removeDeployedWidget: (id?: string) => Promise<void>;
+    removeDeployedWidgetByName: (name: string) => Promise<DeployedWidget[]>;
+    getDeployedWidgets: () => Promise<DeployedWidget[]>;
+    openDevTools: (id: string) => Promise<void>;
+    /**
+     * @deprecated Use WidgetApi.openConfigPage instead
+     * @param id
+     */
+    openConfigPage: (id?: string, params?: WidgetParams) => Promise<void>;
+    registerActiveShortcut: (id: string, shortcut: string) => Promise<boolean>;
+    /**
+     * Set proxy for the widget, this will reload the widget after setting the proxy.
+     * @param id
+     * @param proxy
+     */
+    setProxy: (id: string, proxy: string) => Promise<boolean>;
+    getDeployedWidget: (id: string) => Promise<DeployedWidget>;
+    /**
+     * Adds a new widget with the specified options.
+     * If in browser environment, it will open widget://widgetjs.cn/widget?packageUrl=xxx&name=xxx&package
+     * @param options - The options for the widget to be added.
+     * @returns A promise that resolves with an array of added widgets.
+     */
+    addWidget: (options: AddWidgetOption) => Promise<Widget[]>;
+    /**
+     * 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"
+}
+
+/**
+ *  @see https://electronjs.org/docs/api/structures/size
+ */
+interface Size {
+    height: number;
+    width: number;
+}
+
+/**
+ * @see https://electronjs.org/docs/api/structures/display
+ */
+interface Display {
+    /**
+     * Can be `available`, `unavailable`, `unknown`.
+     */
+    accelerometerSupport: ('available' | 'unavailable' | 'unknown');
+    /**
+     * the bounds of the display in DIP points.
+     */
+    bounds: Rectangle;
+    /**
+     * The number of bits per pixel.
+     */
+    colorDepth: number;
+    /**
+     *  represent a color space (three-dimensional object which contains all realizable
+     * color combinations) for the purpose of color conversions
+     */
+    colorSpace: string;
+    /**
+     * The number of bits per color component.
+     */
+    depthPerComponent: number;
+    /**
+     * The display refresh rate.
+     */
+    displayFrequency: number;
+    /**
+     * Unique identifier associated with the display.
+     */
+    id: number;
+    /**
+     * `true` for an internal display and `false` for an external display
+     */
+    internal: boolean;
+    /**
+     * User-friendly label, determined by the platform.
+     */
+    label: string;
     /**
      * Whether or not the display is a monochrome display.
      */
@@ -1052,6 +1419,22 @@ interface IDeviceApi {
     isCapsLockOn: () => Promise<boolean>;
 }
 
+/**
+ * DialogApi provides file and folder selection functions
+ */
+interface IDialogApi {
+    /**
+     * 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>;
+}
+type DialogApiMethods = keyof IDialogApi;
+
 interface Metadata {
     /** Number value of the EXIF Orientation header, if present */
     orientation?: number | undefined;
@@ -2225,8 +2608,63 @@ interface IFileApi {
 }
 
 /**
- * MenuApi 接口定义了一系列用于控制窗口的方法，这些方法提供了窗口的显示、隐藏、移动、调整大小等功能
- * @remarks 注意：桌面类型组件不支持窗口移动、调整大小、最大化、最小化等操作
+ * 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;
+    error: (...data: any[]) => void;
+    warn: (...data: any[]) => void;
+    log: (...data: any[]) => void;
+    json: (data: any) => void;
+}
+type LogApiMethods = keyof ILogApi;
+
+/**
+ * MouseApi
+ */
+interface IMouseApi {
+    /**
+     * Create a mouse screen edge hotspot, usually used for edge-hiding windows.
+     * @param rect
+     */
+    createHotspot: (rect: Rectangle) => Promise<void>;
+    /**
+     * Remove the mouse screen edge hotspot.
+     */
+    removeHotspot: () => Promise<void>;
+}
+/**
+ * SystemApiEvent
+ */
+declare enum MouseApiEvent {
+    /**
+     * Triggered when the mouse enters the hotspot area.
+     */
+    HOTSPOT_ACTIVE = "event::cn.widgetjs.core.mouse.hotspot.active"
+}
+type MouseApiMethods = keyof IMouseApi;
+
+/**
+ * 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 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 {
     /**
@@ -2234,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>;
@@ -2248,7 +2686,7 @@ interface IMenuApi {
      */
     removeMenuItem: (menuItemIds: string[]) => Promise<void>;
     /**
-     * 显示自定义菜单
+     * Show custom menu
      * @param options ShowMenuOption
      */
     showMenu: (options: ShowMenuOption) => Promise<void>;
@@ -2369,522 +2807,256 @@ interface ITrayApi {
      */
     setTray: (options: AddTrayOptions) => Promise<void>;
     /**
-     * Remove the tray icon and free native resources.
-     * Resolves when the tray has been removed.
-     */
-    removeTray: () => Promise<void>;
-    /**
-     * Displays a balloon notification.
-     * @param options DisplayBalloonOptions
-     */
-    displayBalloon: (options: DisplayBalloonOptions) => Promise<void>;
-    /**
-     * Removes a balloon notification.
-     */
-    removeBalloon: () => Promise<void>;
-    /**
-     * Set the context menu for the tray icon.
-     * Replaces any previously set menu.
-     * @param menus Array of WidgetMenuItem describing the menu structure
-     */
-    setContextMenu: (menus: WidgetMenuItem[]) => Promise<void>;
-    /**
-     * Close any open context menu for the tray (if supported by the platform).
-     */
-    closeContextMenu: () => Promise<void>;
-    /**
-     * Programmatically pop up a context menu at the optional screen position.
-     * On some platforms the position may be ignored.
-     * @param menus menu items to show
-     * @param position optional screen point where the menu should appear
-     */
-    popUpContextMenu: (menus: WidgetMenuItem[], position?: Point) => Promise<void>;
-    /**
-     * Returns whether the underlying native tray object has been destroyed.
-     * Useful to check before calling other tray methods.
-     */
-    isDestroyed: () => Promise<boolean>;
-    /**
-     * Get the bounds of the tray icon on screen.
-     * Returns a Rectangle when available, or `null` if the bounds cannot be determined
-     * on the current platform or if the tray is not present.
-     */
-    getBounds: () => Promise<Rectangle | null>;
-    /**
-     * Bring the application to the foreground or focus the window associated with the tray.
-     * Exact behavior depends on platform and application window state.
-     */
-    focus: () => Promise<void>;
-}
-/**
- * TrayApiEvent
- *
- * Events emitted from the tray icon. Channels are stable strings used for internal
- * event routing; subscribers should listen to these channels to react to user
- * interactions with the tray icon.
- */
-declare enum TrayApiEvent {
-    /**
-     * Emitted when the tray icon is clicked (usually left-button click).
-     * Channel: 'channel::cn.widgetjs.core.tray.click'
-     */
-    CLICK = "channel::cn.widgetjs.core.tray.click",
-    /**
-     * Emitted when the tray icon receives a right-button click.
-     * Channel: 'channel::cn.widgetjs.core.tray.right-click'
-     */
-    RIGHT_CLICK = "channel::cn.widgetjs.core.tray.right-click",
-    /**
-     * Emitted when the tray icon receives a middle-button click (if supported).
-     * Channel: 'channel::cn.widgetjs.core.tray.middle-click'
-     */
-    MIDDLE_CLICK = "channel::cn.widgetjs.core.tray.middle-click",
-    /**
-     * Emitted when the mouse pointer enters the tray icon area (hover start).
-     * Channel: 'channel::cn.widgetjs.core.tray.mouse-enter'
-     */
-    MOUSE_ENTER = "channel::cn.widgetjs.core.tray.mouse-enter",
-    /**
-     * Emitted when the mouse pointer leaves the tray icon area (hover end).
-     * Channel: 'channel::cn.widgetjs.core.tray.mouse-leave'
-     */
-    MOUSE_LEAVE = "channel::cn.widgetjs.core.tray.mouse-leave"
-}
-type TrayApiMethods = keyof ITrayApi;
-
-interface IUserApi {
-    /**
-     * Login with user info.
-     * @param token
-     */
-    login: (session: AuthSession) => Promise<void>;
-    /**
-     * Clear user auth token and user info.
-     */
-    logout: () => Promise<void>;
-    /**
-     * Get current logged in user info. If no user is logged in, return null.
-     */
-    getUser: () => Promise<AuthUser | null>;
-    updateSession: (session: AuthSession) => Promise<void>;
-    getSession: () => Promise<AuthSession | null>;
-    updateUser: (user: AuthUser) => Promise<void>;
-}
-/**
- * ShortcutApiEvent
- */
-declare enum UserApiEvent {
-    /**
-     * 快捷键触发事件
-     */
-    USER_UPDATED = "channel::cn.widgetjs.core.user.updated",
-    SIGNED_OUT = "channel::cn.widgetjs.core.user.signed.out",
-    SIGNED_IN = "channel::cn.widgetjs.core.user.signed.in",
-    TOKEN_REFRESHED = "channel::cn.widgetjs.core.user.token.refreshed"
-}
-type UserApiMethods = keyof IUserApi;
-
-interface AiConfig {
-    id: string;
-    model: string;
-    apiKey: string;
-    apiBaseUrl: string;
-}
-interface IAiApi {
-    addConfig(config: AiConfig): Promise<AiConfig>;
-    deleteConfig(id: string): Promise<void>;
-    updateConfig(config: AiConfig): Promise<void>;
-    getConfigList(): Promise<AiConfig[]>;
-    setConfigList(configs: AiConfig[]): Promise<void>;
-    getConfig(id: string): Promise<AiConfig | undefined>;
-}
-/**
- * AiApiEvent
- */
-declare enum AiApiEvent {
-    /**
-     * 配置更新事件
-     */
-    CONFIG_UPDATED = "channel::cn.widgetjs.core.ai.config.updated"
-}
-type AiApiMethods = keyof IAiApi;
-
-declare const AppApi: IAppApi;
-
-declare abstract class BaseApi<T extends string> {
-    abstract getChannel(): string;
-    protected invokeMethod(method: T, ...args: any[]): Promise<any>;
-    protected invoke(...args: any[]): Promise<any>;
-}
-
-/**
- * WidgetApi 接口定义了一系列用于控制组件的方法，这些方法提供了组件的注册、升级、获取、打开设置页面、重新加载等功能
- */
-interface IWidgetApi {
-    /**
-     * 注册组件
-     * @param widgets
-     */
-    registerWidgets: (widgets: Widget[]) => Promise<void>;
-    /**
-     * @deprecated
-     */
-    registerWidgetPackage: (widgetPackage: WidgetPackage) => Promise<void>;
-    /**
-     * ignore mouse events
-     * @param widgetId
-     * @param ignore
-     */
-    setIgnoreMouseEvents: (widgetId: string, ignore: boolean) => Promise<void>;
-    /**
-     * Check if the widget is ignoring mouse events.
-     * @param widgetId
-     */
-    isIgnoreMouseEvents: (widgetId?: string) => Promise<boolean>;
-    /**
-     * 设置组件是否可以左键拖动
-     * @param draggable boolean true-启用左键拖动 false-禁用左键拖动
-     * @remarks 注意：只对悬浮窗组件(DeployMode.OVERLAP)有效
-     */
-    setMouseDraggable: (draggable: boolean) => Promise<void>;
-    /**
-     * 升级组件包
-     * @param packageName 组件包名
-     */
-    upgradePackage: (packageName: string) => Promise<void>;
-    /**
-     * 获取所有组件
-     * @return Promise<Widget[]>
-     */
-    getWidgets: () => Promise<Widget[]>;
-    /**
-     * 通过组件名称获取组件
-     * @param name string 组件名
-     * @return Promise<Widget>
-     */
-    getWidget: (name: string) => Promise<Widget>;
-    /**
-     * @param name
-     * @deprecated
-     */
-    getWidgetPackage: (name: string) => Promise<WidgetPackage | undefined>;
-    /**
-     * @deprecated
-     */
-    getWidgetPackages: () => Promise<WidgetPackage[]>;
-    /**
-     * 打开组件设置页面
-     * @param id string 组件id
+     * Remove the tray icon and free native resources.
+     * Resolves when the tray has been removed.
      */
-    openConfigPage: (id?: string) => Promise<void>;
+    removeTray: () => Promise<void>;
     /**
-     * @param name
+     * Displays a balloon notification.
+     * @param options DisplayBalloonOptions
      */
-    openConfigPageByName: (name: string) => Promise<void>;
+    displayBalloon: (options: DisplayBalloonOptions) => Promise<void>;
     /**
-     * 重新加载组件
+     * Removes a balloon notification.
      */
-    reload: (id?: string) => Promise<void>;
+    removeBalloon: () => Promise<void>;
     /**
-     *
-     * @param packageName
-     * @deprecated
+     * Set the context menu for the tray icon.
+     * Replaces any previously set menu.
+     * @param menus Array of WidgetMenuItem describing the menu structure
      */
-    getWidgetPackageUrl: (packageName: string) => Promise<string | null>;
-    restartWidgets: (mode?: DeployMode) => Promise<void>;
-    updateSyncInfo: () => Promise<void>;
-    getSyncInfo: (widgetName?: string) => Promise<WidgetSyncInfo | null>;
-}
-
-type WidgetPermission = 'keyboard' | 'mouse' | 'clipboard' | 'notification' | 'storage' | 'network' | 'cpu' | 'system-info';
-
-interface MetaInfo {
-    [key: string]: string | number | boolean;
-}
-interface IWindowSize {
-    width: number;
-    height: number;
-    maxWidth?: number;
-    maxHeight?: number;
-    minWidth?: number;
-    minHeight?: number;
-}
-interface IPageOptions extends IWindowSize {
-    name: string;
+    setContextMenu: (menus: WidgetMenuItem[]) => Promise<void>;
     /**
-     * 当showInSearch为true时,此项必填
+     * Close any open context menu for the tray (if supported by the platform).
      */
-    title: LanguageTextMap;
+    closeContextMenu: () => Promise<void>;
     /**
-     * 当showInSearch为true时,此项必填
+     * Programmatically pop up a context menu at the optional screen position.
+     * On some platforms the position may be ignored.
+     * @param menus menu items to show
+     * @param position optional screen point where the menu should appear
      */
-    description?: LanguageTextMap;
+    popUpContextMenu: (menus: WidgetMenuItem[], position?: Point) => Promise<void>;
     /**
-     * 当showInSearch为true时,此项必填
+     * Returns whether the underlying native tray object has been destroyed.
+     * Useful to check before calling other tray methods.
      */
-    keywords?: WidgetKeyword[];
-    lang: LanguageCode;
-    packageName?: string;
-    icon?: string;
+    isDestroyed: () => Promise<boolean>;
     /**
-     * 当showInSearch为true时,此项必填
+     * Get the bounds of the tray icon on screen.
+     * Returns a Rectangle when available, or `null` if the bounds cannot be determined
+     * on the current platform or if the tray is not present.
      */
-    previewImage?: string;
+    getBounds: () => Promise<Rectangle | null>;
     /**
-     * 是否在搜索中显示
+     * Bring the application to the foreground or focus the window associated with the tray.
+     * Exact behavior depends on platform and application window state.
      */
-    showInSearch?: boolean;
+    focus: () => Promise<void>;
+}
+/**
+ * TrayApiEvent
+ *
+ * Events emitted from the tray icon. Channels are stable strings used for internal
+ * event routing; subscribers should listen to these channels to react to user
+ * interactions with the tray icon.
+ */
+declare enum TrayApiEvent {
     /**
-     * 悬浮窗模式 是否可移动
-     * @deprecated
+     * Emitted when the tray icon is clicked (usually left-button click).
+     * Channel: 'channel::cn.widgetjs.core.tray.click'
      */
-    movable?: boolean;
+    CLICK = "channel::cn.widgetjs.core.tray.click",
     /**
-     * @deprecated
+     * Emitted when the tray icon receives a right-button click.
+     * Channel: 'channel::cn.widgetjs.core.tray.right-click'
      */
-    resizable?: boolean;
+    RIGHT_CLICK = "channel::cn.widgetjs.core.tray.right-click",
     /**
-     * @deprecated
+     * Emitted when the tray icon receives a middle-button click (if supported).
+     * Channel: 'channel::cn.widgetjs.core.tray.middle-click'
      */
-    backgroundThrottling?: boolean;
-    security?: boolean;
+    MIDDLE_CLICK = "channel::cn.widgetjs.core.tray.middle-click",
     /**
-     * @deprecated
+     * Emitted when the mouse pointer enters the tray icon area (hover start).
+     * Channel: 'channel::cn.widgetjs.core.tray.mouse-enter'
      */
-    webviewTag?: boolean;
-    path: string;
+    MOUSE_ENTER = "channel::cn.widgetjs.core.tray.mouse-enter",
     /**
-     * 是否只能添加一次
+     * Emitted when the mouse pointer leaves the tray icon area (hover end).
+     * Channel: 'channel::cn.widgetjs.core.tray.mouse-leave'
      */
-    singleton?: boolean;
-    permissions?: WidgetPermission[];
-    meta?: MetaInfo;
-    broadcastChannels?: string[];
+    MOUSE_LEAVE = "channel::cn.widgetjs.core.tray.mouse-leave"
 }
-interface IPage {
-    readonly name: string;
-    /**
-     * 窗口标题，显示在界面上的，
-     * https://zh.m.wikipedia.org/zh-hans/ISO_639-1
-     */
-    readonly title: LanguageTextMap;
-    readonly permissions: WidgetPermission[];
-    readonly webviewTag: boolean;
+type TrayApiMethods = keyof ITrayApi;
+
+interface IUserApi {
     /**
-     * 窗口介绍
+     * Login with user info.
+     * @param token
      */
-    readonly description: LanguageTextMap;
-    readonly keywords: WidgetKeyword[];
+    login: (session: AuthSession) => Promise<void>;
     /**
-     * 组件默认语言
+     * Clear user auth token and user info.
      */
-    readonly lang: LanguageCode;
-    readonly width: number;
-    packageName?: string | null;
-    readonly height: number;
-    readonly maxWidth: number;
-    readonly maxHeight: number;
-    readonly minWidth: number;
-    readonly minHeight: number;
-    readonly movable: boolean;
-    readonly singleton: boolean;
-    readonly resizable: boolean;
-    readonly path: string;
-    readonly meta: {
-        [key: string]: string | number | boolean;
-    };
-    readonly backgroundThrottling: boolean;
+    logout: () => Promise<void>;
     /**
-     * 预览图片，可以是GIF
+     * Get current logged in user info. If no user is logged in, return null.
      */
-    readonly previewImage?: string;
+    getUser: () => Promise<AuthUser | null>;
+    updateSession: (session: AuthSession) => Promise<void>;
+    getSession: () => Promise<AuthSession | null>;
+    updateUser: (user: AuthUser) => Promise<void>;
 }
-declare class Page implements IPage {
+/**
+ * ShortcutApiEvent
+ */
+declare enum UserApiEvent {
     /**
-     * 页面名称,名称必须以包名开头，如果以.开头，会自动加上包名<br>
-     * 假设包名为`example.com`，以下两种写法等价
-     * @example example.com.countdown
-     * @example .countdown
+     * User updated event
      */
-    name: string;
+    USER_UPDATED = "channel::cn.widgetjs.core.user.updated",
+    SIGNED_OUT = "channel::cn.widgetjs.core.user.signed.out",
+    SIGNED_IN = "channel::cn.widgetjs.core.user.signed.in",
+    TOKEN_REFRESHED = "channel::cn.widgetjs.core.user.token.refreshed"
+}
+type UserApiMethods = keyof IUserApi;
+
+/**
+ * WidgetPackageApi provides functions such as upgrading, retrieving, and installing widget packages
+ */
+interface IWidgetPackageApi {
     /**
-     * 窗口标题，显示在界面上的，
-     * @see https://zh.m.wikipedia.org/zh-hans/ISO_639-1
+     * Upgrade widget package
+     * @param packageName   Widget package name
+     * @param remoteUrlInfo
      */
-    readonly title: LanguageTextMap;
+    upgrade: (packageName: string, remoteUrlInfo: RemotePackageUrlInfo) => Promise<void>;
     /**
-     * 窗口介绍
+     * Get index url information of the widget package
+     * @param packageName
      */
-    readonly description: LanguageTextMap;
-    readonly keywords: WidgetKeyword[];
-    readonly security: boolean;
-    readonly permissions: WidgetPermission[];
+    getIndexUrl: (packageName: string) => Promise<string | null>;
     /**
-     * 组件默认语言
+     * Get entry url information of the widget package
+     * @param packageName
      */
-    readonly lang: LanguageCode;
-    readonly width: number;
-    packageName?: string | null;
-    readonly height: number;
-    readonly maxWidth: number;
+    getEntryUrl: (packageName: string) => Promise<string | null>;
     /**
-     * @deprecated
+     * Get widget package information by package name
+     * @param name
      */
-    readonly webviewTag: boolean;
-    readonly maxHeight: number;
-    readonly minWidth: number;
-    readonly minHeight: number;
-    readonly movable: boolean;
-    readonly singleton: boolean;
-    readonly resizable: boolean;
-    readonly path: string;
-    readonly icon?: string;
-    readonly meta: MetaInfo;
-    readonly backgroundThrottling: boolean;
+    getPackage: (name: string) => Promise<WidgetPackage | undefined>;
     /**
-     * 预览图片，可以是GIF
+     * Get installed widget packages
      */
-    readonly previewImage?: string;
-    constructor(options: IPageOptions);
+    getPackages: () => Promise<WidgetPackage[]>;
     /**
-     * 获取组件标题
-     * @param lang 语言环境，不传则获取默认语言
+     * Install a widget package, if the package is a string, it will be treated as a path or http url to install the widget.zip file.
+     * @param widgetPackage
      */
-    getTitle(lang?: LanguageCode): string | undefined;
+    install: (widgetPackage: WidgetPackage | string) => Promise<void>;
     /**
-     * 获取组件描述
-     * @param lang 语言环境，不传则获取默认标题
+     * Uninstall a widget package by package name.
+     * @param packageName
+     * @param clearData    Whether to clear the data of the widget package, default is false.
      */
-    getDescription(lang?: LanguageCode): string | undefined;
-    static parseJSON(json: string): Page;
-    static parseObject(obj: any): Page;
-    isResizable(): boolean;
-}
-
-type SocialType = 'qq' | 'wechat' | 'qq-group' | 'discord' | 'telegram' | 'tiktok' | 'douyin' | 'youtube' | 'instagram' | 'twitter' | 'facebook' | 'kuaishou' | 'bilibili' | 'github' | 'email' | 'gitee' | 'homepage';
-declare class SocialInfo {
-    content: string;
-    name: SocialType;
-    constructor(name: SocialType, content: string);
-}
-interface SocialLink {
-    name: SocialType;
-    link: string;
+    uninstall: (widgetPackage: WidgetPackage | string, clearData?: boolean) => Promise<void>;
 }
-
-/**
- * @see [Web Manifest Categories]https://developer.mozilla.org/en-US/docs/Web/Manifest/categories
- * @see [W3C Categories](https://github.com/w3c/manifest/wiki/Categories)
- */
-type Category = 'news' | 'photo' | 'productivity' | 'social' | 'utilities' | 'weather'
+type WidgetPackageApiMethods = keyof IWidgetPackageApi;
 /**
- * @deprecated
+ * WidgetPackageApiEvent
  */
- | 'calendar' | 'fun'
+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"
+}
+
+declare const AppApi: IAppApi;
+
 /**
- * @deprecated
+ * WidgetApi interface defines a series of methods for controlling widgets, providing functions such as widget registration, upgrade, retrieval, opening settings page, reloading, etc.
  */
- | 'countdown' | 'time' | 'finance' | 'ai';
-
-interface IWidgetOptions extends IWindowSize, IPageOptions {
-    supportDeployMode?: DeployMode;
-    configPagePath?: string;
+interface IWidgetApi {
     /**
-     * 如果为true，组件将不会添加到组件包中
+     * Register widgets
+     * @param widgets
      */
-    disabled?: boolean;
-    previewImage: string;
+    registerWidgets: (widgets: Widget[]) => Promise<void>;
     /**
-     * whether the widget data can be synchronized
+     * @deprecated
      */
-    synchronizable?: boolean;
-    categories?: Category[];
+    registerWidgetPackage: (widgetPackage: WidgetPackage) => Promise<void>;
     /**
-     * 组件包所需的App版本
+     * ignore mouse events
+     * @param widgetId
+     * @param ignore
      */
-    requiredAppVersion?: string;
-    description: LanguageTextMap;
-    keywords: WidgetKeyword[];
+    setIgnoreMouseEvents: (widgetId: string, ignore: boolean) => Promise<void>;
     /**
-     * @deprecated
+     * Check if the widget is ignoring mouse events.
+     * @param widgetId
      */
-    routes?: WidgetRoute[];
+    isIgnoreMouseEvents: (widgetId?: string) => Promise<boolean>;
     /**
-     * 一般用于填写教程链接
+     * 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)
      */
-    socialLinks?: SocialLink[];
-    browserWindowOptions?: Pick<BrowserWindowOptions, 'backgroundThrottling'>;
-    trayOptions?: TrayWidgetOptions;
-}
-interface IBackgroundWidgetOptions extends Omit<IWidgetOptions, 'width' | 'height'> {
-    width?: number;
-    height?: number;
-    browserWindowOptions?: BrowserWindowOptions;
-}
-/**
- * @deprecated
- */
-interface WidgetRoute {
-    url: string;
-    name: string;
-}
-interface TrayWidgetOptions {
-    closeOnBlur?: boolean;
-    hideOnBlur?: boolean;
-}
-declare class Widget extends Page {
-    readonly previewImage: string;
-    readonly categories?: Category[];
-    readonly supportDeployMode: number;
-    readonly trayOptions?: TrayWidgetOptions;
+    setMouseDraggable: (draggable: boolean) => Promise<void>;
     /**
-     * 组件包所需的App版本
+     * Upgrade widget package
+     * @param packageName Widget package name
      */
-    readonly requiredAppVersion?: string;
+    upgradePackage: (packageName: string) => Promise<void>;
     /**
-     * 如果为true，组件将不会添加到组件包中
+     * Get all widgets
+     * @return Promise<Widget[]>
      */
-    readonly disabled?: boolean;
-    readonly synchronizable?: boolean;
+    getWidgets: () => Promise<Widget[]>;
     /**
-     * 配置页面路径，没有则不能修改
+     * Get widget by widget name
+     * @param name string Widget name
+     * @return Promise<Widget>
      */
-    readonly configPagePath?: string;
+    getWidget: (name: string) => Promise<Widget>;
     /**
+     * @param name
      * @deprecated
      */
-    readonly routes: WidgetRoute[];
-    protected browserWindowOptions?: BrowserWindowOptions;
-    readonly socialLinks?: SocialLink[];
-    constructor(options: IWidgetOptions);
-    static parseJSON(json: string): Widget;
-    static parseObject(obj: any): Widget;
+    getWidgetPackage: (name: string) => Promise<WidgetPackage | undefined>;
     /**
-     * 是否支持悬浮窗
+     * @deprecated
      */
-    isSupportOverlap(): boolean;
-    isSupportBackground(): boolean;
-    isSupportTray(): boolean;
+    getWidgetPackages: () => Promise<WidgetPackage[]>;
     /**
-     * 是否支持普通模式
+     * Open widget settings page
+     * @param id string Widget id
      */
-    isSupportNormal(): boolean;
-    isConfigurable(): boolean;
-}
-declare class BackgroundWidget extends Widget {
-    constructor(options: IBackgroundWidgetOptions);
-}
-declare enum WidgetKeyword {
-    RECOMMEND = "recommend",
-    TOOLS = "tools",
-    EFFICIENCY = "efficiency",
-    PICTURE = "picture",
-    LIFE = "life",
-    SHORTCUT = "shortcut",
-    COUNTDOWN = "countdown",
-    TIMER = "timer",
-    INFO = "info",
-    DASHBOARD = "dashboard"
+    openConfigPage: (id?: string) => Promise<void>;
+    /**
+     * @param name
+     */
+    openConfigPageByName: (name: string) => Promise<void>;
+    /**
+     * Reload widget
+     */
+    reload: (id?: string) => Promise<void>;
+    /**
+     *
+     * @param packageName
+     * @deprecated
+     */
+    getWidgetPackageUrl: (packageName: string) => Promise<string | null>;
+    restartWidgets: (mode?: DeployMode) => Promise<void>;
+    updateSyncInfo: () => Promise<void>;
+    getSyncInfo: (widgetName?: string) => Promise<WidgetSyncInfo | null>;
 }
 
 interface LocalPackageUrlInfo {
@@ -3050,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>;
@@ -3090,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')
      * ```
      */
@@ -3121,7 +3294,7 @@ interface IShortcutApi {
  */
 declare enum ShortcutApiEvent {
     /**
-     * 快捷键触发事件
+     * Shortcut triggered event
      */
     TRIGGERED = "channel::cn.widgetjs.core.shortcut.triggered"
 }
@@ -3141,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>
@@ -3319,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>;
     /**
@@ -3550,139 +3723,6 @@ declare enum Channel {
     AI = "channel::cn.widgetjs.core.ai"
 }
 
-declare class WidgetParams {
-    static readonly PARAM_PREFIX = "w_";
-    static readonly PARAM_ID = "id";
-    static readonly PARAM_LANG = "lang";
-    static readonly PARAM_THEME = "theme";
-    static readonly PARAM_MODE = "mode";
-    static readonly PARAM_NAME = "name";
-    static readonly PARAM_TITLE = "title";
-    static readonly PARAM_PREVIEW = "preview";
-    static readonly PARAMS: string[];
-    id?: string;
-    width?: number;
-    widthPx?: number;
-    heightPx?: number;
-    height?: number;
-    x?: number;
-    y?: number;
-    preview?: boolean;
-    lang?: string;
-    theme?: ThemeMode;
-    mode?: DeployMode;
-    radius?: number;
-    name?: string;
-    title?: string;
-    /**
-     * 将组件参数转为url参数
-     * @param object
-     * @return URLSearchParams  w_w=2&w_h=2&w_id=21&w_width=156&w_height=156
-     */
-    toUrlParams(): URLSearchParams;
-    getPersistKey(): string;
-    /**
-     * 从当前地址解析组件参数：
-     * http://localhost:8080/#/widget/config/labor_progress?w_w=2&w_h=2&w_width=156&w_height=156
-     * =>
-     *  {width:2,height:2,id:21,width_px:156,height_px:156}
-     */
-    static fromCurrentLocation(): WidgetParams;
-    static fromLocation(url: string): WidgetParams;
-    private static setValue;
-    /**
-     * 从对象键值对中初始化组件参数
-     * {w_width:2,w_height:2,w_id:21,w_width_px:156,w_height_px:156}=>
-     *  {width:2,height:2,id:21,width_px:156,height_px:156}
-     * @param object
-     */
-    static fromObject(object: any): WidgetParams;
-}
-declare enum ThemeMode {
-    AUTO = "auto",
-    LIGHT = "LIGHT",
-    DARK = "DARK"
-}
-
-/**
- * DeployedWidgetApi provides methods for managing deployed widgets within the application.
- * It allows for the removal, retrieval, and configuration of deployed widgets,
- * as well as the ability to manipulate their settings and behavior.
- * @remarks
- */
-interface IDeployedWidgetApi {
-    removeDeployedWidget: (id?: string) => Promise<void>;
-    removeDeployedWidgetByName: (name: string) => Promise<DeployedWidget[]>;
-    getDeployedWidgets: () => Promise<DeployedWidget[]>;
-    openDevTools: (id: string) => Promise<void>;
-    /**
-     * @deprecated 使用WidgetApi.openConfigPage代替
-     * @param id
-     */
-    openConfigPage: (id?: string, params?: WidgetParams) => Promise<void>;
-    registerActiveShortcut: (id: string, shortcut: string) => Promise<boolean>;
-    /**
-     * Set proxy for the widget, this will reload the widget after setting the proxy.
-     * @param id
-     * @param proxy
-     */
-    setProxy: (id: string, proxy: string) => Promise<boolean>;
-    getDeployedWidget: (id: string) => Promise<DeployedWidget>;
-    /**
-     * Adds a new widget with the specified options.
-     * If in browser environment, it will open widget://widgetjs.cn/widget?packageUrl=xxx&name=xxx&package
-     * @param options - The options for the widget to be added.
-     * @returns A promise that resolves with an array of added widgets.
-     */
-    addWidget: (options: AddWidgetOption) => Promise<Widget[]>;
-}
-
-interface AddWidgetOption {
-    widgetName: string;
-    widgetTitle?: string;
-    deployMode: DeployMode;
-    packageJsonUrl?: string;
-    hostname?: string;
-}
-type DeployedWidgetApiMethods = keyof IDeployedWidgetApi;
-declare class DeployedWidgetApiImpl extends BaseApi<DeployedWidgetApiMethods> implements IDeployedWidgetApi {
-    getChannel(): string;
-    /**
-     * 移除组件
-     * @param id
-     */
-    removeDeployedWidget(id?: string): Promise<any>;
-    addWidget(options: AddWidgetOption): Promise<Widget[]>;
-    /**
-     * 通过组件名移除已添加的组件
-     * @param name  组件名
-     */
-    removeDeployedWidgetByName(name: string): Promise<DeployedWidget[]>;
-    /**
-     * 获取已添加的组件
-     * @param name  组件名，可以不传
-     */
-    getDeployedWidgets(name?: string): Promise<DeployedWidget[]>;
-    getDeployedWidget(id: string): Promise<DeployedWidget>;
-    /**
-     * Opens the dev tools for a widget with the specified ID.
-     *
-     * @param {string} widgetId - The ID of the widget to open the dev tools for.
-     * @return {Promise} A Promise that resolves when the dev tools are opened.
-     */
-    openDevTools(widgetId: string): Promise<any>;
-    openConfigPage(widgetId?: string, params?: WidgetParams): Promise<any>;
-    /**
-     * 注册激活、呼出、置顶组件快捷键
-     * @param widgetId  组件id
-     * @param shortcut  如果传空或者不传，则会取消快捷键。更多快捷键配置，请查看Accelerator用法
-     *                  https://www.electronjs.org/docs/latest/api/accelerator
-     */
-    registerActiveShortcut(widgetId: string, shortcut?: string): Promise<boolean>;
-    setProxy(widgetId: string, proxy: string): Promise<boolean>;
-}
-declare const DeployedWidgetApi: DeployedWidgetApiImpl;
-
 type DeviceApiMethods = keyof IDeviceApi;
 declare const DeviceApi: IDeviceApi;
 
@@ -3716,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>;
@@ -3787,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>;
 }
@@ -4575,4 +4615,4 @@ declare class GridSystem extends GridRect {
     getHeight(): number;
 }
 
-export { type AddTrayOptions, type AddWidgetOption, AiApiEvent, type AiApiMethods, type AiConfig, type AlignPosition, ApiConstants, AppApi, AppApiConstants, AppApiEvent, type AppApiMethods, AppConfig, AppEvent, type AppMouseEvent, AppNotification, AppReminderNotification, type AppRoutes, type AppRuntimeInfo, AppTheme, type AudioData, BackgroundWidget, BaseApi, type BaseboardData, type BatteryData, type BiosData, type BlockDevicesData, type BluetoothDeviceData, BroadcastApi, type BroadcastApiMethods, BroadcastEvent, type BroadcastEventType, BrowserWindowApi, BrowserWindowApiEvent, type BrowserWindowApiMethods, type BrowserWindowOptions, type CallNotificationOption, type Category, Channel, type ChassisData, ClipboardApi, ClipboardApiEvent, type ClipboardApiMethods, type CountdownNotificationOption, type CpuCacheData, type CpuCurrentSpeedData, type CpuData, type CpuTemperatureData, type CurrentLoadCpuData, type CurrentLoadData, type DeepPartial, DefaultTheme, DefaultThemeDark, DefaultThemeLight, DefaultWidgetTheme, DeployMode, DeployedPage, DeployedWidget, DeployedWidgetApi, type DeployedWidgetApiMethods, type DevOptions, DeviceApi, type DeviceApiMethods, DialogApi, type DialogApiMethods, type DiskLayoutData, type DisksIoData, type Display, type DisplayBalloonOptions, type DockerContainerData, type DockerContainerMountData, type DockerContainerProcessData, type DockerContainerStatsData, type DockerImageData, type DockerInfoData, type DockerVolumeData, type DownloadUrlOptions, type DynamicData, ElectronApi, ElectronUtils, FileApi, type FileApiMethods, type FsOpenFilesData, type FsSizeData, type FsStatsData, type GraphicsControllerData, type GraphicsData, type GraphicsDisplayData, Gravity, GridRect, GridSystem, HostedMode, HttpApi, type HttpApiMethods, type IAiApi, type IAppApi, type IAppTheme, type IBackgroundWidgetOptions, type IDeviceApi, type IDialogApi, type IFileApi, type IGridRect, type ILogApi, type IMouseApi, type IPage, type IPageOptions, type IProcessApi, type ITrayApi, type IUserApi, type IWidgetDataApi, type IWidgetOptions, type IWidgetPackageApi, type IWidgetTheme, type IWindowSize, type InetChecksiteData, type InfoNotificationOption, type Language, type LanguageCode, LanguageMap, type LanguageTextMap, LanguageUtils, type LocalPackageUrlInfo, type LocationQuery, type LocationQueryRaw, type LocationQueryValue, type LocationQueryValueRaw, LogApi, type LogApiMethods, type MemData, type MemLayoutData, MenuApi, MenuApiEvent, type MenuApiMethods, type MetaInfo, type Metadata, MouseApi, MouseApiEvent, type MouseApiMethods, type NativeKeyboardEvent, type NetworkConnectionsData, type NetworkInterfacesData, type NetworkStatsData, type NormalizeOptions, NotificationApi, NotificationApiEvent, type NotificationApiMethods, type NotificationOption, NotificationSize, type NotificationType, type OsData, Page, type Point, type Position, type PrinterData, ProcessApi, type ProcessApiMethods, type ProcessesData, type ProcessesProcessData, type ProcessesProcessLoadData, type ProxyConfig, type RaspberryRevisionData, type ReadDirOptions, type Rectangle, type ReminderNotificationOption, type RemotePackageUrlInfo, type SaveWidgetOption, type ServicesData, type SetPositionOptions, ShortcutApi, ShortcutApiEvent, type ShortcutApiMethods, type ShortcutDetails, type ShowMenuOption, type Size, type SmartData, SocialInfo, type SocialLink, type SocialType, type StaticData, StorageApi, type StorageApiMethods, StoreApi, type StoreApiMethods, SystemApi, SystemApiEvent, type SystemApiMethods, type SystemData, type SystemFile, type SystemInfoMethods, type SystemInfoResultMap, type ThemeColors, ThemeMode, type ThemeRadius, type ThemeShadow, type ThemeTypography, type TimeData, TrayApi, TrayApiEvent, type TrayApiMethods, type TrayWidgetOptions, type UsbData, UserApi, UserApiEvent, type UserApiMethods, type UserData, type UuidData, type VboxInfoData, type VersionData, WebSocketEvent, WebSocketEventType, Widget, WidgetApi, WidgetApiEvent, type WidgetApiMethods, WidgetData, WidgetDataApi, type WidgetDataApiMethods, WidgetKeyword, type WidgetMenuItem, WidgetPackage, WidgetPackageApi, WidgetPackageApiEvent, type WidgetPackageApiMethods, type WidgetPackageOptions, WidgetPackageUtils, WidgetParams, type WidgetPermission, type WidgetRoute, type WidgetSyncInfo, WidgetTheme, type WidgetThemeKey, type WidgetThemeProperty, WidgetUtils, type WifiConnectionData, type WifiInterfaceData, type WifiNetworkData, delay, normalizeUrl, parseQuery, stringifyQuery };
+export { type AddTrayOptions, type AddWidgetOption, AiApiEvent, type AiApiMethods, type AiConfig, type AlignPosition, ApiConstants, AppApi, AppApiConstants, AppApiEvent, type AppApiMethods, AppConfig, AppEvent, type AppMouseEvent, AppNotification, AppReminderNotification, type AppRoutes, type AppRuntimeInfo, AppTheme, type AudioData, BackgroundWidget, BaseApi, type BaseboardData, type BatteryData, type BiosData, type BlockDevicesData, type BluetoothDeviceData, BroadcastApi, type BroadcastApiMethods, BroadcastEvent, type BroadcastEventType, BrowserWindowApi, BrowserWindowApiEvent, type BrowserWindowApiMethods, type BrowserWindowOptions, type CallNotificationOption, type Category, Channel, type ChassisData, ClipboardApi, ClipboardApiEvent, type ClipboardApiMethods, type CountdownNotificationOption, type CpuCacheData, type CpuCurrentSpeedData, type CpuData, type CpuTemperatureData, type CurrentLoadCpuData, type CurrentLoadData, type DeepPartial, DefaultTheme, DefaultThemeDark, DefaultThemeLight, DefaultWidgetTheme, DeployMode, DeployedPage, DeployedWidget, DeployedWidgetApi, DeployedWidgetApiEvent, type DeployedWidgetApiMethods, type DevOptions, DeviceApi, type DeviceApiMethods, DialogApi, type DialogApiMethods, type DiskLayoutData, type DisksIoData, type Display, type DisplayBalloonOptions, type DockerContainerData, type DockerContainerMountData, type DockerContainerProcessData, type DockerContainerStatsData, type DockerImageData, type DockerInfoData, type DockerVolumeData, type DownloadUrlOptions, type DynamicData, ElectronApi, ElectronUtils, FileApi, type FileApiMethods, type FsOpenFilesData, type FsSizeData, type FsStatsData, type GraphicsControllerData, type GraphicsData, type GraphicsDisplayData, Gravity, GridRect, GridSystem, HostedMode, HttpApi, type HttpApiMethods, type IAiApi, type IAppApi, type IAppTheme, type IBackgroundWidgetOptions, type IDeployedWidgetApi, type IDeviceApi, type IDialogApi, type IFileApi, type IGridRect, type ILogApi, type IMouseApi, type IPage, type IPageOptions, type IProcessApi, type ITrayApi, type IUserApi, type IWidgetDataApi, type IWidgetOptions, type IWidgetPackageApi, type IWidgetTheme, type IWindowSize, type InetChecksiteData, type InfoNotificationOption, type Language, type LanguageCode, LanguageMap, type LanguageTextMap, LanguageUtils, type LocalPackageUrlInfo, type LocationQuery, type LocationQueryRaw, type LocationQueryValue, type LocationQueryValueRaw, LogApi, type LogApiMethods, type MemData, type MemLayoutData, MenuApi, MenuApiEvent, type MenuApiMethods, type MetaInfo, type Metadata, MouseApi, MouseApiEvent, type MouseApiMethods, type NativeKeyboardEvent, type NetworkConnectionsData, type NetworkInterfacesData, type NetworkStatsData, type NormalizeOptions, NotificationApi, NotificationApiEvent, type NotificationApiMethods, type NotificationOption, NotificationSize, type NotificationType, type OsData, Page, type Point, type Position, type PrinterData, ProcessApi, type ProcessApiMethods, type ProcessesData, type ProcessesProcessData, type ProcessesProcessLoadData, type ProxyConfig, type RaspberryRevisionData, type ReadDirOptions, type Rectangle, type ReminderNotificationOption, type RemotePackageUrlInfo, type SaveWidgetOption, type ServicesData, type SetPositionOptions, ShortcutApi, ShortcutApiEvent, type ShortcutApiMethods, type ShortcutDetails, type ShowMenuOption, type Size, type SmartData, SocialInfo, type SocialLink, type SocialType, type StaticData, StorageApi, type StorageApiMethods, StoreApi, type StoreApiMethods, SystemApi, SystemApiEvent, type SystemApiMethods, type SystemData, type SystemFile, type SystemInfoMethods, type SystemInfoResultMap, type ThemeBoxShadow, type ThemeColors, ThemeMode, type ThemeRadius, type ThemeShadow, type ThemeTypography, type TimeData, TrayApi, TrayApiEvent, type TrayApiMethods, type TrayWidgetOptions, type UsbData, UserApi, UserApiEvent, type UserApiMethods, type UserData, type UuidData, type VboxInfoData, type VersionData, WebSocketEvent, WebSocketEventType, Widget, WidgetApi, WidgetApiEvent, type WidgetApiMethods, WidgetData, WidgetDataApi, type WidgetDataApiMethods, WidgetKeyword, type WidgetMenuItem, WidgetPackage, WidgetPackageApi, WidgetPackageApiEvent, type WidgetPackageApiMethods, type WidgetPackageOptions, WidgetPackageUtils, WidgetParams, type WidgetPermission, type WidgetRoute, type WidgetSyncInfo, WidgetTheme, type WidgetThemeKey, type WidgetThemeProperty, WidgetUtils, type WifiConnectionData, type WifiInterfaceData, type WifiNetworkData, delay, normalizeUrl, parseQuery, stringifyQuery };