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

package/dist/index.d.ts

@@ -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;
@@ -252,6 +259,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 {
+    /**
+     * 配置更新事件
+     */
+    CONFIG_UPDATED = "channel::cn.widgetjs.core.ai.config.updated"
+}
+type AiApiMethods = keyof IAiApi;
+
 interface Language {
     baseName: string;
     language: string;
@@ -768,173 +800,492 @@ declare enum AppApiConstants {
     CONFIG_LANGUAGE = "cn.widgetjs.config.app.language"
 }
 
-/**
- * DialogApi 提供文件、文件夹选择功能
- */
-interface IDialogApi {
-    /**
-     * 选取单个文件
-     * @param extensions 允许的文件后缀格式，如：["txt","docx","gif"]
-     */
-    pickFile: (extensions?: string[]) => Promise<string | undefined>;
+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;
     /**
-     * 选取文件夹
+     * 当showInSearch为true时,此项必填
      */
-    pickFolder: () => Promise<string | undefined>;
-}
-type DialogApiMethods = keyof IDialogApi;
-
-/**
- * WidgetPackageApi 提供了组件包的升级、获取、安装等功能
- */
-interface IWidgetPackageApi {
+    title: LanguageTextMap;
     /**
-     * 升级组件包
-     * @param packageName   组件包名称
-     * @param remoteUrlInfo
+     * 当showInSearch为true时,此项必填
      */
-    upgrade: (packageName: string, remoteUrlInfo: RemotePackageUrlInfo) => Promise<void>;
+    description?: LanguageTextMap;
     /**
-     * 获取组件包的首页url信息
-     * @param packageName
+     * 当showInSearch为true时,此项必填
      */
-    getIndexUrl: (packageName: string) => Promise<string | null>;
+    keywords?: WidgetKeyword[];
+    lang: LanguageCode;
+    packageName?: string;
+    icon?: string;
     /**
-     * 获取组件包入口url信息
-     * @param packageName
+     * 当showInSearch为true时,此项必填
      */
-    getEntryUrl: (packageName: string) => Promise<string | null>;
+    previewImage?: string;
     /**
-     * 通过包名获取组件包信息
-     * @param name
+     * 是否在搜索中显示
      */
-    getPackage: (name: string) => Promise<WidgetPackage | undefined>;
+    showInSearch?: boolean;
     /**
-     * 获取已经安装的组件包
+     * 悬浮窗模式 是否可移动
+     * @deprecated
      */
-    getPackages: () => Promise<WidgetPackage[]>;
+    movable?: boolean;
     /**
-     * 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
+     * @deprecated
      */
-    install: (widgetPackage: WidgetPackage | string) => Promise<void>;
+    resizable?: 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 {
+    backgroundThrottling?: boolean;
+    security?: boolean;
     /**
-     * 组件包升级事件
+     * @deprecated
      */
-    PACKAGE_UPGRADE = "event::cn.widgetjs.core.widget.package.upgraded",
+    webviewTag?: boolean;
+    path: string;
     /**
-     * 组件包安装事件
+     * 是否只能添加一次
      */
-    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;
+    singleton?: boolean;
+    permissions?: WidgetPermission[];
+    meta?: MetaInfo;
+    broadcastChannels?: string[];
 }
-type LogApiMethods = keyof ILogApi;
-
-/**
- * ProcessApi 提供进程信息获取功能
- */
-interface IProcessApi {
-    getBlinkMemoryInfo: () => Promise<Electron.BlinkMemoryInfo>;
-    getHeapStatistics: () => Promise<Electron.HeapStatistics>;
+interface IPage {
+    readonly name: string;
     /**
-     * 获取系统版本信息
-     * @example '10.0.17763'
+     * 窗口标题，显示在界面上的，
+     * https://zh.m.wikipedia.org/zh-hans/ISO_639-1
      */
-    getSystemVersion: () => Promise<string>;
+    readonly title: LanguageTextMap;
+    readonly permissions: WidgetPermission[];
+    readonly webviewTag: boolean;
     /**
-     * 获取当前应用内存信息
+     * 窗口介绍
      */
-    getProcessMemoryInfo: () => Promise<Electron.ProcessMemoryInfo>;
-}
-type ProcessApiMethods = keyof IProcessApi;
-
-/**
- * MouseApi
- */
-interface IMouseApi {
+    readonly description: LanguageTextMap;
+    readonly keywords: WidgetKeyword[];
     /**
-     * Create a mouse screen edge hotspot, usually used for edge-hiding windows.
-     * @param rect
+     * 组件默认语言
      */
-    createHotspot: (rect: Rectangle) => Promise<void>;
+    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;
     /**
-     * Remove the mouse screen edge hotspot.
+     * 预览图片，可以是GIF
      */
-    removeHotspot: () => Promise<void>;
+    readonly previewImage?: string;
 }
-/**
- * SystemApiEvent
- */
-declare enum MouseApiEvent {
+declare class Page implements IPage {
     /**
-     * Triggered when the mouse enters the hotspot area.
+     * 页面名称,名称必须以包名开头，如果以.开头，会自动加上包名<br>
+     * 假设包名为`example.com`，以下两种写法等价
+     * @example example.com.countdown
+     * @example .countdown
      */
-    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 {
+    name: string;
     /**
-     * Can be `available`, `unavailable`, `unknown`.
+     * 窗口标题，显示在界面上的，
+     * @see https://zh.m.wikipedia.org/zh-hans/ISO_639-1
      */
-    accelerometerSupport: ('available' | 'unavailable' | 'unknown');
+    readonly title: LanguageTextMap;
     /**
-     * the bounds of the display in DIP points.
+     * 窗口介绍
      */
-    bounds: Rectangle;
+    readonly description: LanguageTextMap;
+    readonly keywords: WidgetKeyword[];
+    readonly security: boolean;
+    readonly permissions: WidgetPermission[];
     /**
-     * The number of bits per pixel.
+     * 组件默认语言
      */
-    colorDepth: number;
+    readonly lang: LanguageCode;
+    readonly width: number;
+    packageName?: string | null;
+    readonly height: number;
+    readonly maxWidth: number;
     /**
-     *  represent a color space (three-dimensional object which contains all realizable
-     * color combinations) for the purpose of color conversions
+     * @deprecated
      */
-    colorSpace: string;
+    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;
     /**
-     * The number of bits per color component.
+     * 预览图片，可以是GIF
      */
-    depthPerComponent: number;
+    readonly previewImage?: string;
+    constructor(options: IPageOptions);
     /**
-     * The display refresh rate.
+     * 获取组件标题
+     * @param lang 语言环境，不传则获取默认语言
      */
-    displayFrequency: number;
+    getTitle(lang?: LanguageCode): string | undefined;
     /**
-     * Unique identifier associated with the display.
-     */
+     * 获取组件描述
+     * @param lang 语言环境，不传则获取默认标题
+     */
+    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>;
+}
+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 使用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[]>;
+    /**
+     * 创建桌面快捷方式
+     * @param widgetName 组件名
+     * @returns 成功返回 true，否则返回 false
+     */
+    createDesktopShortcut: (widgetName: string) => Promise<boolean>;
+}
+/**
+ * AiApiEvent
+ */
+declare enum DeployedWidgetApiEvent {
+    /**
+     * 第二实例启动事件
+     */
+    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
@@ -1049,8 +1400,24 @@ interface IDeviceApi {
      * Checks if Caps Lock is on.
      * @returns A promise that resolves to a boolean indicating if Caps Lock is on.
      */
-    isCapsLockOn: () => Promise<boolean>;
+    isCapsLockOn: () => Promise<boolean>;
+}
+
+/**
+ * DialogApi 提供文件、文件夹选择功能
+ */
+interface IDialogApi {
+    /**
+     * 选取单个文件
+     * @param extensions 允许的文件后缀格式，如：["txt","docx","gif"]
+     */
+    pickFile: (extensions?: string[]) => Promise<string | undefined>;
+    /**
+     * 选取文件夹
+     */
+    pickFolder: () => Promise<string | undefined>;
 }
+type DialogApiMethods = keyof IDialogApi;
 
 interface Metadata {
     /** Number value of the EXIF Orientation header, if present */
@@ -2224,6 +2591,61 @@ interface IFileApi {
     trashItem: (path: string) => Promise<void>;
 }
 
+/**
+ * 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;
+
+/**
+ * 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 提供进程信息获取功能
+ */
+interface IProcessApi {
+    getBlinkMemoryInfo: () => Promise<Electron.BlinkMemoryInfo>;
+    getHeapStatistics: () => Promise<Electron.HeapStatistics>;
+    /**
+     * 获取系统版本信息
+     * @example '10.0.17763'
+     */
+    getSystemVersion: () => Promise<string>;
+    /**
+     * 获取当前应用内存信息
+     */
+    getProcessMemoryInfo: () => Promise<Electron.ProcessMemoryInfo>;
+}
+type ProcessApiMethods = keyof IProcessApi;
+
 /**
  * MenuApi 接口定义了一系列用于控制窗口的方法，这些方法提供了窗口的显示、隐藏、移动、调整大小等功能
  * @remarks 注意：桌面类型组件不支持窗口移动、调整大小、最大化、最小化等操作
@@ -2387,504 +2809,238 @@ interface ITrayApi {
      * 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
-     */
-    openConfigPage: (id?: string) => Promise<void>;
-    /**
-     * @param name
-     */
-    openConfigPageByName: (name: string) => Promise<void>;
-    /**
-     * 重新加载组件
-     */
-    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>;
-}
-
-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;
+type TrayApiMethods = keyof ITrayApi;
+
+interface IUserApi {
     /**
-     * 窗口标题，显示在界面上的，
-     * https://zh.m.wikipedia.org/zh-hans/ISO_639-1
+     * Login with user info.
+     * @param token
      */
-    readonly title: LanguageTextMap;
-    readonly permissions: WidgetPermission[];
-    readonly webviewTag: boolean;
+    login: (session: AuthSession) => Promise<void>;
     /**
-     * 窗口介绍
+     * Clear user auth token and user info.
      */
-    readonly description: LanguageTextMap;
-    readonly keywords: WidgetKeyword[];
+    logout: () => Promise<void>;
     /**
-     * 组件默认语言
+     * Get current logged in user info. If no user is logged in, return null.
      */
-    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;
+    getUser: () => Promise<AuthUser | null>;
+    updateSession: (session: AuthSession) => Promise<void>;
+    getSession: () => Promise<AuthSession | null>;
+    updateUser: (user: AuthUser) => Promise<void>;
+}
+/**
+ * ShortcutApiEvent
+ */
+declare enum UserApiEvent {
     /**
-     * 预览图片，可以是GIF
+     * 快捷键触发事件
      */
-    readonly previewImage?: 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"
 }
-declare class Page implements IPage {
+type UserApiMethods = keyof IUserApi;
+
+/**
+ * WidgetPackageApi 提供了组件包的升级、获取、安装等功能
+ */
+interface IWidgetPackageApi {
     /**
-     * 页面名称,名称必须以包名开头，如果以.开头，会自动加上包名<br>
-     * 假设包名为`example.com`，以下两种写法等价
-     * @example example.com.countdown
-     * @example .countdown
+     * 升级组件包
+     * @param packageName   组件包名称
+     * @param remoteUrlInfo
      */
-    name: string;
+    upgrade: (packageName: string, remoteUrlInfo: RemotePackageUrlInfo) => Promise<void>;
     /**
-     * 窗口标题，显示在界面上的，
-     * @see https://zh.m.wikipedia.org/zh-hans/ISO_639-1
+     * 获取组件包的首页url信息
+     * @param packageName
      */
-    readonly title: LanguageTextMap;
+    getIndexUrl: (packageName: string) => Promise<string | null>;
     /**
-     * 窗口介绍
+     * 获取组件包入口url信息
+     * @param packageName
      */
-    readonly description: LanguageTextMap;
-    readonly keywords: WidgetKeyword[];
-    readonly security: boolean;
-    readonly permissions: WidgetPermission[];
+    getEntryUrl: (packageName: string) => Promise<string | null>;
     /**
-     * 组件默认语言
+     * 通过包名获取组件包信息
+     * @param name
      */
-    readonly lang: LanguageCode;
-    readonly width: number;
-    packageName?: string | null;
-    readonly height: number;
-    readonly maxWidth: number;
+    getPackage: (name: string) => Promise<WidgetPackage | undefined>;
     /**
-     * @deprecated
+     * 获取已经安装的组件包
      */
-    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;
+    getPackages: () => Promise<WidgetPackage[]>;
     /**
-     * 预览图片，可以是GIF
+     * 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
      */
-    readonly previewImage?: string;
-    constructor(options: IPageOptions);
+    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.
      */
-    getTitle(lang?: LanguageCode): string | undefined;
+    uninstall: (widgetPackage: WidgetPackage | string, clearData?: boolean) => Promise<void>;
+}
+type WidgetPackageApiMethods = keyof IWidgetPackageApi;
+/**
+ * WidgetPackageApiEvent
+ */
+declare enum WidgetPackageApiEvent {
     /**
-     * 获取组件描述
-     * @param lang 语言环境，不传则获取默认标题
+     * 组件包升级事件
      */
-    getDescription(lang?: LanguageCode): string | undefined;
-    static parseJSON(json: string): Page;
-    static parseObject(obj: any): Page;
-    isResizable(): boolean;
+    PACKAGE_UPGRADE = "event::cn.widgetjs.core.widget.package.upgraded",
+    /**
+     * 组件包安装事件
+     */
+    PACKAGE_INSTALLED = "event::cn.widgetjs.core.widget.package.installed"
 }
 
-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;
-}
+declare const AppApi: IAppApi;
 
 /**
- * @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
+ * WidgetApi 接口定义了一系列用于控制组件的方法，这些方法提供了组件的注册、升级、获取、打开设置页面、重新加载等功能
  */
- | 'countdown' | 'time' | 'finance' | 'ai';
-
-interface IWidgetOptions extends IWindowSize, IPageOptions {
-    supportDeployMode?: DeployMode;
-    configPagePath?: string;
+interface IWidgetApi {
     /**
-     * 如果为true，组件将不会添加到组件包中
+     * 注册组件
+     * @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>;
     /**
-     * 一般用于填写教程链接
+     * 设置组件是否可以左键拖动
+     * @param draggable boolean true-启用左键拖动 false-禁用左键拖动
+     * @remarks 注意：只对悬浮窗组件(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版本
+     * 升级组件包
+     * @param packageName 组件包名
      */
-    readonly requiredAppVersion?: string;
+    upgradePackage: (packageName: string) => Promise<void>;
     /**
-     * 如果为true，组件将不会添加到组件包中
+     * 获取所有组件
+     * @return Promise<Widget[]>
      */
-    readonly disabled?: boolean;
-    readonly synchronizable?: boolean;
+    getWidgets: () => Promise<Widget[]>;
     /**
-     * 配置页面路径，没有则不能修改
+     * 通过组件名称获取组件
+     * @param name string 组件名
+     * @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[]>;
     /**
-     * 是否支持普通模式
+     * 打开组件设置页面
+     * @param id string 组件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: (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 {
@@ -3550,139 +3706,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;
 
@@ -4575,4 +4598,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 };