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

package/dist/index.d.ts

@@ -3,6 +3,287 @@ import { FileTypeResult } from 'file-type';
 import { FormatEnum, ColourspaceEnum, Channels, LevelMetadata } from 'sharp';
 import { AuthSession, AuthUser } from '@supabase/supabase-js';
 
+type NotificationType = 'countdown' | 'advance-countdown' | 'error' | 'success' | 'warning' | 'info' | 'reminder' | 'url' | 'call';
+declare enum NotificationSize {
+    SMALL = "small",
+    NORMAL = "normal",
+    LARGE = "large"
+}
+interface CountdownNotificationOption extends InfoNotificationOption {
+    targetTime?: string;
+}
+interface InfoNotificationOption {
+    message: string;
+    duration?: number;
+    /**
+     * 图片名，目前只支持mingcute图标。
+     * https://www.mingcute.com/
+     */
+    icon?: string;
+    color?: string;
+    size?: NotificationSize;
+    backgroundColor?: string;
+}
+interface CallNotificationOption extends InfoNotificationOption {
+    lyric?: string;
+    audio?: string;
+    avatar?: string;
+}
+interface ReminderNotificationOption extends InfoNotificationOption {
+    confirmButtonText?: string;
+    cancelButtonText?: string;
+    title?: string;
+    cancelBroadcast?: string;
+    confirmBroadcast?: string;
+}
+interface NotificationOption extends InfoNotificationOption, ReminderNotificationOption, CountdownNotificationOption, CallNotificationOption {
+    type?: NotificationType;
+}
+declare class AppNotification {
+    type: NotificationType;
+    message: string;
+    title?: string;
+    targetTime?: string;
+    /**
+     * 持续时间，单位毫秒
+     */
+    duration: number;
+    /**
+     * IconPark图标
+     * @example close-one
+     * @see [IconPark](https://iconpark.oceanengine.com/official)
+     */
+    icon?: string;
+    color?: string;
+    backgroundColor?: string;
+    confirmButtonText?: string;
+    cancelButtonText?: string;
+    cancelBroadcast?: string;
+    confirmBroadcast?: string;
+    size: NotificationSize;
+    url?: string;
+    avatar?: string;
+    audio?: string;
+    lyric?: string;
+    createdAt: string;
+    constructor(option: NotificationOption);
+}
+declare class AppReminderNotification extends AppNotification {
+    constructor(option: ReminderNotificationOption);
+}
+
+interface ThemeColors {
+    background: string;
+    foreground: string;
+    card: string;
+    cardForeground: string;
+    popover: string;
+    popoverForeground: string;
+    primary: string;
+    primaryForeground: string;
+    secondary: string;
+    secondaryForeground: string;
+    muted: string;
+    mutedForeground: string;
+    accent: string;
+    accentForeground: string;
+    destructive: string;
+    destructiveForeground: string;
+    border: string;
+    input: string;
+    ring: string;
+    shadow: string;
+    innerShadow: string;
+}
+interface ThemeRadius {
+    sm: string;
+    md: string;
+    lg: string;
+    full: string;
+}
+interface ThemeTypography {
+    fontFamily: string;
+    fontSize: string;
+}
+interface ThemeShadow {
+    sm: ThemeBoxShadow;
+    md: ThemeBoxShadow;
+    lg: ThemeBoxShadow;
+}
+interface ThemeBoxShadow {
+    offsetX: string;
+    offsetY: string;
+    blur: string;
+}
+interface IAppTheme {
+    useGlobalTheme?: boolean;
+    mode?: 'light' | 'dark';
+    colors: ThemeColors;
+    radius: ThemeRadius;
+    typography: ThemeTypography;
+    shadow: ThemeShadow;
+    spacing?: string;
+}
+type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+declare const DefaultThemeDark: IAppTheme;
+declare const DefaultThemeLight: IAppTheme;
+declare const DefaultTheme: IAppTheme;
+declare class AppTheme implements IAppTheme {
+    useGlobalTheme?: boolean;
+    mode?: 'light' | 'dark';
+    colors: ThemeColors;
+    radius: ThemeRadius;
+    typography: ThemeTypography;
+    shadow: ThemeShadow;
+    spacing?: string;
+    constructor(options?: DeepPartial<IAppTheme> | string);
+    static fromJSON(json: string): AppTheme;
+    /**
+     * 兼容 V1 版本的 CSS 变量
+     */
+    toLegacyCSSVariables(prefix?: string): Record<string, string>;
+    /**
+     * flatten tokens → CSS variables
+     */
+    toCSSVariables(prefix?: string): Record<string, string>;
+    toCSS(selector?: string): string;
+    injectCSS(el?: HTMLElement): void;
+    removeCSS(el?: HTMLElement): void;
+    /**
+     * 支持主题切换（light/dark）
+     */
+    setMode(mode: 'light' | 'dark'): void;
+    copy(partial?: DeepPartial<IAppTheme>): AppTheme;
+    static fromCSS(css: string): AppTheme;
+}
+
+interface IDeployedPage {
+    id: string;
+    name: string;
+    packageName: string;
+    x: number;
+    y: number;
+    height: number;
+    width: number;
+    proxy?: string;
+    isIgnoreMouseEvents?: boolean;
+}
+declare class DeployedPage implements IDeployedPage {
+    name: string;
+    packageName: string;
+    x: number;
+    y: number;
+    height: number;
+    width: number;
+    proxy?: string;
+    id: string;
+    isIgnoreMouseEvents?: boolean;
+}
+
+declare class DeployedWidget extends DeployedPage {
+    shortcut?: string;
+    deployMode: number;
+    isOverlap(): boolean;
+}
+
+/**
+ * @deprecated use DeployedMode instead
+ */
+declare enum HostedMode {
+    NORMAL = 1,
+    /**
+     * 悬浮窗
+     */
+    OVERLAP = 16,
+    WALLPAPER = 256,
+    SCREEN = 4096,
+    BACKGROUND = 65536,
+    /**
+     * 页面
+     */
+    PAGE = 1048576,
+    ALL = 1118481
+}
+declare enum DeployMode {
+    /**
+     * 桌面组件，默认
+     */
+    NORMAL = 1,
+    /**
+     * 悬浮窗
+     */
+    OVERLAP = 16,
+    /**
+     * 后台组件，没有界面，一般在后台执行定时任务
+     */
+    BACKGROUND = 65536,
+    /**
+     * System tray
+     */
+    TRAY = 256,
+    /**
+     * 全部支持
+     */
+    ALL = 1118481
+}
+
+interface AppMouseEvent {
+    handled: boolean;
+    wheelScrolled: boolean;
+    clicked: boolean;
+    isMouseButtonDown: boolean;
+    isMouseButtonUp: boolean;
+    timestamp: number;
+    button: number;
+    clicks: number;
+    x: number;
+    y: number;
+    delta: number;
+    location: string;
+}
+
+declare class ApiConstants {
+    static readonly CONFIG_LAUNCH_AT_STARTUP = "CONFIG_LAUNCH_AT_STARTUP";
+    static readonly CONFIG_WIDGET_TITLE_COLOR = "CONFIG_WIDGET_TITLE_COLOR";
+    static readonly CONFIG_DEBUG_MODE = "cn.widgetjs.config.debug";
+    static readonly CONFIG_GRID_CELL_SIZE = "cn.widgetjs.config.grid.size";
+    static readonly SHORTCUT_PIN_DESKTOP_WIDGETS = "cn.widgetjs.config.shortcut.pin_desktop_widgets";
+}
+declare class AppEvent {
+    static readonly LANGUAGE_CHANGED = "event::cn.widgetjs.core.app.language.changed";
+}
+declare class AppConfig {
+    static readonly LANGUAGE = "cn.widgetjs.config.app.language";
+    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;
@@ -74,204 +355,35 @@ type LanguageTextMap = {
     [key in LanguageCode]?: string;
 };
 
-declare class ElectronApi {
-    static addIpcListener(key: string, f: Function): Promise<void>;
-    static removeIpcListener(key: string): Promise<void>;
-}
-
-interface IWidgetTheme {
+/**
+ * 设置窗口位置的选项
+ */
+interface BrowserWindowOptions {
     /**
-     * 是否使用全局主题，
-     * 默认true
+     * 分区
+     * @deprecated
      */
-    useGlobalTheme?: boolean;
-    borderRadius?: CSS.Properties['borderRadius'];
-    backgroundColor?: CSS.Properties['color'];
+    partition?: string;
     /**
-     * 背景边框颜色
+     * 是否使用外部浏览器打开
      */
-    backgroundBorderColor?: CSS.Properties['color'];
-    backgroundBoxShadowColor?: CSS.Properties['color'];
-    fontSize?: CSS.Properties['fontSize'];
-    dividerColor?: CSS.Properties['color'];
+    external?: boolean;
     /**
-     * 主色调
+     * Window's width in pixels. Default is `800`.
      */
-    primaryColor?: CSS.Properties['color'];
+    width?: number;
     /**
-     * 文字颜色
+     * Window's height in pixels. Default is `600`.
      */
-    color?: CSS.Properties['color'];
-    fontFamily?: CSS.Properties['fontFamily'];
-    shadowColor?: CSS.Properties['color'];
-    padding?: CSS.Properties['padding'];
-    borderColor?: CSS.Properties['borderColor'];
-}
-type WidgetThemeProperty = keyof IWidgetTheme;
-declare class WidgetTheme implements IWidgetTheme {
-    borderRadius?: CSS.Properties['borderRadius'];
-    backgroundColor?: CSS.Properties['color'];
-    fontSize?: CSS.Properties['fontSize'];
-    dividerColor?: CSS.Properties['color'];
+    height?: number;
     /**
-     * 主色调
+     * (**required** if y is used) Window's left offset from screen. Default is to
+     * center the window.
      */
-    primaryColor?: CSS.Properties['color'];
-    backgroundBorderColor?: CSS.Properties['color'];
-    backgroundBoxShadowColor?: CSS.Properties['color'];
+    x?: number;
     /**
-     * 文字颜色
-     */
-    color?: CSS.Properties['color'];
-    fontFamily?: CSS.Properties['fontFamily'];
-    shadowColor?: CSS.Properties['color'];
-    padding?: CSS.Properties['padding'];
-    borderColor?: CSS.Properties['borderColor'];
-    useGlobalTheme?: boolean;
-    constructor(options?: IWidgetTheme | string);
-    static fromJSON(json: string): WidgetTheme;
-    /**
-     * Injects the style properties as css variable.
-     * @param selector default is 'body'
-     */
-    toCSS(selector?: string): string;
-    /**
-     * Injects the style properties as css variable.
-     * @param rootElement The rootElement to inject the css.
-     * @remarks Only works in a browser environment.
-     */
-    injectCSS(rootElement?: HTMLElement): void;
-    removeCSS(rootElement?: HTMLElement): void;
-    copy(options?: IWidgetTheme): WidgetTheme;
-    /**
-     * Gets the style properties from the widget's style object.
-     * @returns A record representing CSS custom variable and their values.
-     */
-    toCSSVariable(): Record<string, string>;
-    toCSSProperties(): Record<string, string>;
-    static fromCSS(css: string): WidgetTheme;
-}
-type WidgetThemeKey = keyof WidgetTheme;
-/**
- * Widget default theme, this object is immutable. Clone it before use.
- */
-declare const DefaultWidgetTheme: WidgetTheme;
-
-/**
- * 组件配置数据，用于存储组件自定义页面所设置的数据
- * @deprecated
- */
-declare class WidgetData {
-    /**
-     * 组件id
-     */
-    id?: string;
-    /**
-     * 组件名
-     */
-    name: string;
-    /**
-     * 背景颜色
-     * @deprecated
-     */
-    backgroundColor?: string;
-    /**
-     * 文字颜色
-     * @deprecated
-     */
-    color?: string;
-    /**
-     * 字体大小
-     * @deprecated
-     */
-    fontSize?: number;
-    /**
-     * 字体
-     * @deprecated
-     */
-    fontFamily?: string;
-    /**
-     * 圆角半径
-     * @deprecated
-     */
-    borderRadius?: number;
-    /**
-     * 组件样式
-     * @deprecated
-     */
-    theme: WidgetTheme;
-    constructor(name: string, id?: string);
-    parseJSON(json: any): void;
-    /**
-     * Gets the style properties from the widget's style object.
-     * @returns A record representing CSS custom properties and their values.
-     */
-    getThemeProperties(): Record<string, string>;
-    /**
-     * Injects the style properties as css variable.
-     * @remarks Only works in a browser environment.
-     */
-    injectThemeProperties(): void;
-}
-
-interface SaveWidgetOption {
-    sendBroadcast?: boolean;
-    id?: string;
-    storeName?: string;
-}
-/**
- * 用户处理浏览器数据，只在浏览器环境下有用
- * @deprecated
- */
-interface IWidgetDataApi {
-    findByName: (<T extends WidgetData>(name: string, type: {
-        new (name: string, id?: string): T;
-    }) => Promise<T | undefined>) & (<T extends WidgetData>(data: T) => Promise<T | undefined>);
-    save: (data: WidgetData, options?: SaveWidgetOption) => Promise<string>;
-    /**
-     * 获取组件 LocalForage 存储实例
-     * @param widgetName  组件名
-     * @param storeName   存储名
-     * @see https://localforage.docschina.org/
-     */
-    getStore: (widgetName: string, storeName?: string) => LocalForage;
-    saveByName: <T extends WidgetData>(data: T, options?: SaveWidgetOption) => Promise<string>;
-    find: <T extends WidgetData>(name: string, id: string, type: {
-        new (name: string, id?: string): T;
-    }) => Promise<T | undefined>;
-}
-type WidgetDataApiMethods = keyof IWidgetDataApi;
-declare const WidgetDataApi: IWidgetDataApi;
-
-/**
- * 设置窗口位置的选项
- */
-interface BrowserWindowOptions {
-    /**
-     * 分区
-     * @deprecated
-     */
-    partition?: string;
-    /**
-     * 是否使用外部浏览器打开
-     */
-    external?: boolean;
-    /**
-     * Window's width in pixels. Default is `800`.
-     */
-    width?: number;
-    /**
-     * Window's height in pixels. Default is `600`.
-     */
-    height?: number;
-    /**
-     * (**required** if y is used) Window's left offset from screen. Default is to
-     * center the window.
-     */
-    x?: number;
-    /**
-     * (**required** if x is used) Window's top offset from screen. Default is to
-     * center the window.
+     * (**required** if x is used) Window's top offset from screen. Default is to
+     * center the window.
      */
     y?: number;
     /**
@@ -488,1030 +600,651 @@ interface AppRuntimeInfo {
     systemName: string;
 }
 
-declare abstract class BaseApi<T extends string> {
-    abstract getChannel(): string;
-    protected invokeMethod(method: T, ...args: any[]): Promise<any>;
-    protected invoke(...args: any[]): Promise<any>;
-}
-
+type AppRoutes = '/widget/search' | '/widget/package' | '/setting/common' | '/setting/theme' | '/setting/ai' | '/setting/proxy' | '/setting/info' | '/user/profile';
 /**
- * BrowserWindowApi 接口定义了一系列用于控制窗口的方法，这些方法提供了窗口的显示、隐藏、移动、调整大小等功能
- * @remarks 注意：桌面类型组件不支持窗口移动、调整大小、最大化、最小化等操作
+ * AppApi 接口定义了与应用程序相关的一系列方法。这些方法提供了应用程序配置管理、版本信息获取、路径获取以及应用内置窗口操作等功能。
+ * @see [Electron API App](https://www.electronjs.org/docs/latest/api/app)
  */
-interface IBrowserWindowApi {
+interface IAppApi {
     /**
-     * 设置是否忽略鼠标事件
-     * @param ignore boolean
+     * 设置配置
+     * @param key string
+     * @param value string | number | boolean
      */
-    setIgnoreMouseEvent: (ignore: boolean) => Promise<void>;
+    setConfig: (key: string | AppApiConstants, value: string | number | boolean) => Promise<any>;
     /**
-     * 显示窗口
+     * 获取配置
+     * @param key
+     * @param defaultValue
+     * @return Promise<string | number | boolean>
      */
-    show: () => Promise<void>;
+    getConfig: <T extends string | number | boolean>(key: string | AppApiConstants, defaultValue: T) => Promise<T>;
     /**
-     * 设置窗口是否有阴影
-     * @param hasShadow boolean
+     * 获取版本信息
+     * @param type string - 可选。指定要获取的版本类型。
+     *      <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>
+     *      </ol>
+     * @return Promise<string>
      */
-    setHasShadow: (hasShadow: boolean) => Promise<void>;
+    getVersion: (type?: 'app' | 'electron' | 'chrome' | 'node' | 'v8') => Promise<string>;
     /**
-     * 隐藏窗口
+     * Get App's runtime info (e.g. app name, os/electron/node version, etc.)
      */
-    hide: () => Promise<void>;
+    getRuntimeInfo: () => Promise<AppRuntimeInfo>;
     /**
-     * 关闭窗口
+     * 获取Preload JS路径
+     * @see [Using Preload Scripts](https://www.electronjs.org/docs/latest/tutorial/tutorial-preload)
+     * @return Promise<string>
      */
-    close: () => Promise<void>;
+    getPreloadPath: () => Promise<string>;
     /**
-     * 以不激活窗口的方式显示窗口
+     * 获取应用安装路径
+     * @return Promise<string>
      */
-    showInactive: () => Promise<void>;
+    getAppPath: () => Promise<string>;
     /**
-     * 将窗口居中
+     * Open the app's add/search widget window
+     * @deprecated Use `showAppWindow('/widget/add', options)` instead, which is more flexible and supports custom routes.
      */
-    center: () => Promise<void>;
+    openAddWidgetWindow: () => Promise<void>;
     /**
-     * 最小化窗口
+     * Show a new window with specified route and options
+     * support routes:
+     * /user/profile
+     * /auth/register
+     *
+     * @param route
+     * @param options
      */
-    minimize: () => Promise<void>;
+    showAppWindow: (route: string | AppRoutes, options?: BrowserWindowOptions) => Promise<void>;
     /**
-     * 还原窗口
+     * Open the app's setting window
+     * @deprecated Use `showAppWindow('/setting/common', options)` instead, which is more flexible and supports custom routes.
      */
-    restore: () => Promise<void>;
+    openSettingWindow: () => Promise<void>;
     /**
-     * 窗口是否最小后
-     * @return  Promise<boolean>
+     * Open the app's update window
+     * @deprecated Use `showAppWindow('/widget/info', options)` instead, which is more flexible and supports custom routes.
      */
-    isMinimized: () => Promise<boolean>;
+    openCheckUpdateWindow: () => Promise<void>;
     /**
-     * 检查窗口是否最大化
-     * @return  Promise<boolean>
+     *  open the app's widget manager window
+     *  @deprecated Use `showAppWindow('/widget/search', options)` instead, which is more flexible and supports custom routes.
      */
-    isMaximized: () => Promise<boolean>;
+    openWidgetManagerWindow: () => Promise<void>;
     /**
-     * 检查窗口是否可见
-     * @return  Promise<boolean>
+     * @deprecated Use `showAppWindow('/widget/package', options)` instead, which is more flexible and supports custom routes.
      */
-    isVisible: () => Promise<boolean>;
+    openWidgetPackageManagerWindow: () => Promise<void>;
     /**
-     * 检查窗口是否可调整大小
-     * @since 24.1.1-beta.6
-     * @return  Promise<boolean>
+     * Open the app's runtime info window
+     * @deprecated Use `showAppWindow('/setting/info', options)` instead, which is more flexible and supports custom routes.
      */
-    isResizable: () => Promise<boolean>;
+    openRuntimeInfoWindow: () => Promise<void>;
     /**
-     * 最大化窗口
+     * Get the app's icon file path
+     * @return Promise<string>
      */
-    maximize: () => Promise<void>;
+    getIconFile: () => Promise<string>;
     /**
-     * 停止拖动窗口
-     */
-    stopDraggingWindow: () => Promise<void>;
-    /**
-     * 开始拖动窗口
+     * Check if the app is running as Windows Store app (appx)
+     * @return Promise<boolean>
      */
-    startDraggingWindow: () => Promise<void>;
+    isWindowsStore: () => Promise<boolean>;
     /**
-     * 检查窗口是否正在拖动
-     * @return  Promise<boolean>
+     * Get app's language, if user has not set, return `navigator.language`
      */
-    isDraggingWindow: () => Promise<boolean>;
+    getLanguageCode: () => Promise<string>;
     /**
-     * 设置窗口是否总在最前
-     * @param alwaysOnTop boolean
+     * Set app's language
+     * @param code
      */
-    setAlwaysOnTop: (alwaysOnTop: boolean) => Promise<void>;
+    setLanguageCode: (code: LanguageCode) => Promise<void>;
     /**
-     * 检查窗口是否总在最前
-     * @return  Promise<boolean>
+     * Set app's global proxy settings, set empty string to disable proxy
+     * @param config
+     * @example
+     * ```typescript
+     * AppApi.setProxy({
+     *     proxyRules:'socks5://127.0.0.1:7890'
+     * })
+     * ```
      */
-    isAlwaysOnTop: () => Promise<boolean>;
+    setProxy: (config: ProxyConfig) => Promise<void>;
+    getProxy: () => Promise<ProxyConfig>;
     /**
-     * 打开指定的 URL
-     * @param url string 要打开的 URL
-     * @param option OpenUrlOptions - 可选参数，用于配置 URL 打开的方式
+     * Set app's global theme CSS
+     * @param css
      */
-    openUrl: (url: string, option?: BrowserWindowOptions) => Promise<void>;
+    setThemeCSS: (css: string) => Promise<void>;
     /**
-     * 将窗口置于最前
+     * Get the app's global theme CSS
+     * @return Promise<string> If the theme CSS is not set, return empty string
      */
-    moveTop: () => Promise<void>;
+    getThemeCSS: () => Promise<string>;
     /**
-     * 取消最大化窗口
+     * enable/disable developer mode
      */
-    unmaximize: () => Promise<void>;
+    setDevMode: (enable: boolean) => Promise<void>;
     /**
-     * 重新加载窗口
+     * get developer mode is enabled
      */
-    reload: () => Promise<void>;
+    getDevMode: () => Promise<boolean>;
     /**
-     * 设置窗口大小
-     * @param width boolean - 窗口宽度
-     * @param height boolean - 窗口高度
-     * @param animate boolean - 是否使用动画（可选）
+     * Get the app's desktop grid system cell size
      */
-    setSize: (width: number, height: number, animate?: boolean) => Promise<void>;
+    getGridCellSize: () => Promise<number>;
     /**
-     * 获取窗口大小
-     * @since 24.1.1-beta.6
-     * @returns Promise<number[]>
+     * Set the app's desktop grid system cell size
+     * @param size
      */
-    getSize: () => Promise<number[]>;
+    setGridCellSize: (size: number) => Promise<void>;
     /**
-     * 打开开发者工具
+     * exit application
      */
-    openDevTools: () => Promise<void>;
+    exit: () => Promise<void>;
+}
+type AppApiMethods = keyof IAppApi;
+/**
+ * AppApiEvent
+ */
+declare enum AppApiEvent {
     /**
-     * 设置窗口位置
-     * @param {SetPositionOptions} options - 配置窗口位置的选项
+     * 应用设置变更时触发
      */
-    setPosition: (options: SetPositionOptions) => Promise<void>;
+    CONFIG_CHANGED = "event::cn.widgetjs.core.app.config.changed",
     /**
-     * 获取窗口位置
-     * @returns {Promise<Position>} 返回一个 Promise，解析为窗口的位置
+     * 桌面组件网格窗口移动时触发
      */
-    getPosition: () => Promise<Position>;
+    MOVING_GRID_WINDOW = "event::cn.widgetjs.core.app.moving.grid.window",
     /**
-     * 使窗口失去焦点
+     * 桌面组件网格窗口停止移动时触发
      */
-    blur: () => Promise<void>;
+    STOP_MOVING_GRID_WINDOW = "event::cn.widgetjs.core.app.moving.grid.window.stop",
     /**
-     * 聚焦窗口
+     * 应用代理发生变化
      */
-    focus: () => Promise<void>;
+    PROXY_CHANGED = "event::cn.widgetjs.core.app.proxy.changed",
     /**
-     * 设置窗口是否可调整大小
-     * @param resizable boolean - 是否可调整大小
+     * 应用语言发生变化
      */
-    setResizable: (resizable: boolean) => Promise<void>;
+    LANGUAGE_CHANGED = "event::cn.widgetjs.core.app.language.changed"
+}
+/**
+ * AppApiConstants
+ */
+declare enum AppApiConstants {
     /**
-     * 设置窗口是否可移动
-     * @param movable boolean - 是否可移动
+     * 桌面组件网格大小
      */
-    setMovable: (movable: boolean) => Promise<void>;
+    CONFIG_GRID_CELL_SIZE = "cn.widgetjs.config.grid.size",
     /**
-     * 获取窗口边界
-     * @returns Promise<Rectangle>
+     * 应用主题CSS设置
      */
-    getBounds: () => Promise<Rectangle>;
+    CONFIG_WIDGET_THEME_CSS = "cn.widgetjs.config.widget.theme.css",
     /**
-     * 设置窗口边界
-     * @param {Partial<Rectangle>} bounds - 窗口的边界矩形
-     * @param {boolean} animate - 是否启用动画
+     * 应用全局代理设置
      */
-    setBounds: (bounds: Partial<Rectangle>, animate: boolean) => Promise<void>;
+    CONFIG_PROXY = "cn.widgetjs.config.app.proxy",
+    CONFIG_DEV_MODE = "cn.widgetjs.config.app.dev.mode",
     /**
-     * 将窗口对齐到当前屏幕
-     * @param align string 对齐位置
-     *  <ol>
-     *    <li>'top-left'</li>
-     *    <li>'top-center'</li>
-     *    <li>'top-right'</li>
-     *    <li>'bottom-left'</li>
-     *    <li>'bottom-center'</li>
-     *    <li>'bottom-right'</li>
-     *    </ol>
+     * 应用语言设置
      */
-    alignToScreen: (align: AlignPosition) => Promise<void>;
+    CONFIG_LANGUAGE = "cn.widgetjs.config.app.language"
+}
+
+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;
     /**
-     * 检查指定 URL 是否存在
-     * @param {string} url - 要检查的 URL
-     * @return  Promise<boolean>
+     * 当showInSearch为true时,此项必填
      */
-    existsByUrl: (url: string) => Promise<boolean>;
+    title: LanguageTextMap;
     /**
-     * 获取窗口的最大尺寸
-     * @returns {Promise<number[]>} 返回一个 Promise，解析为一个数组，包含窗口的最大宽度和高度
+     * 当showInSearch为true时,此项必填
      */
-    getMaximumSize: () => Promise<number[]>;
+    description?: LanguageTextMap;
     /**
-     * 获取窗口的最小尺寸
-     * @returns {Promise<number[]>} 返回一个 Promise，解析为一个数组，包含窗口的最小宽度和高度
+     * 当showInSearch为true时,此项必填
      */
-    getMinimumSize: () => Promise<number[]>;
+    keywords?: WidgetKeyword[];
+    lang: LanguageCode;
+    packageName?: string;
+    icon?: string;
     /**
-     * 设置窗口的最大尺寸
-     * @param {number} width - 最大宽度
-     * @param {number} height - 最大高度
+     * 当showInSearch为true时,此项必填
      */
-    setMaximumSize: (width: number, height: number) => Promise<void>;
+    previewImage?: string;
     /**
-     * 设置窗口的最小尺寸
-     * @param {number} width - 最大宽度
-     * @param {number} height - 最大高度
+     * 是否在搜索中显示
      */
-    setMinimumSize: (width: number, height: number) => Promise<void>;
+    showInSearch?: boolean;
     /**
-     * 更改缩放等级 原始尺寸为 0，每升高或将顶代表缩放20%，大和小限制默认分区为 300% 和 50% 缩放公式为 scale := 1.2 ^ level.
-     * @param level number - 缩放等级，默认为 0
+     * 悬浮窗模式 是否可移动
+     * @deprecated
      */
-    setZoomLevel: (level: number) => Promise<void>;
+    movable?: boolean;
     /**
-     * 更改缩放倍数 缩放系数是缩放百分比除以 100，即 300% = 3.0
-     * @param factor Double - 缩放系数，默认为 1.0
-     * @remarks 系数必须大于0.0
+     * @deprecated
      */
-    setZoomFactor: (factor: number) => Promise<void>;
+    resizable?: boolean;
     /**
-     * Set the proxy config for window. All requests will be sent through the proxy server.
-     * Proxy config will be lost once the window is closed. If you want to set a persistent proxy for widget window, use `DeployWidgetApi.setProxy` instead.
-     * @remarks All links will be disconnected after setting, it is best to refresh the page (window.location.reload())
-     * @param config
-     * @example
-     * ```typescript
-     * BrowserWindowApi.setProxy({
-     *     proxyRules:'socks5://127.0.0.1:7890'
-     * })
-     * ```
+     * @deprecated
      */
-    setProxy: (config: ProxyConfig) => Promise<void>;
-    getProxy: () => Promise<ProxyConfig | undefined>;
+    backgroundThrottling?: boolean;
+    security?: boolean;
     /**
-     * @return Promise<boolean>
+     * @deprecated
      */
-    isFocused: () => Promise<boolean>;
+    webviewTag?: boolean;
+    path: string;
     /**
-     * A top-level window created with this style does not become the foreground window when the user clicks it. The system does not bring this window to the foreground when the user minimizes or closes the foreground window.
-     * The window should not be activated through programmatic access or via keyboard navigation by accessible technology, such as Narrator.
-     * @see [Extended Window Styles](https://learn.microsoft.com/en-us/windows/win32/winmsg/extended-window-styles)
+     * 是否只能添加一次
      */
-    setNoActivate: () => Promise<void>;
+    singleton?: boolean;
+    permissions?: WidgetPermission[];
+    meta?: MetaInfo;
+    broadcastChannels?: string[];
+}
+interface IPage {
+    readonly name: string;
     /**
-     * Controls whether or not this window's WebContents will throttle animations and timers when the page becomes backgrounded. This also affects the Page Visibility API.
-     * @param enabled
-     * @see https://www.electronjs.org/docs/latest/api/web-contents#contentssetbackgroundthrottlingallowed
+     * 窗口标题，显示在界面上的，
+     * https://zh.m.wikipedia.org/zh-hans/ISO_639-1
      */
-    setBackgroundThrottling: (enabled: boolean) => Promise<void>;
-    getBackgroundThrottling: () => Promise<boolean>;
+    readonly title: LanguageTextMap;
+    readonly permissions: WidgetPermission[];
+    readonly webviewTag: boolean;
     /**
-     * Makes the window not show in the taskbar.
-     * @param boolean
+     * 窗口介绍
      */
-    setSkipTaskbar: (boolean: boolean) => Promise<void>;
-}
-
-type BrowserWindowApiMethods = keyof IBrowserWindowApi;
-type AlignPosition = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
-interface SetPositionOptions {
-    x?: number;
-    y?: number;
+    readonly description: LanguageTextMap;
+    readonly keywords: WidgetKeyword[];
     /**
-     * Only works on macOS
+     * 组件默认语言
      */
-    animation?: boolean;
-}
-declare enum BrowserWindowApiEvent {
-    BLUR = "event::cn.widgetjs.core.browser-window.blur",
-    MOVED = "event::cn.widgetjs.core.browser-window.moved",
-    FOCUS = "event::cn.widgetjs.core.browser-window.focus",
-    CLOSE = "event::cn.widgetjs.core.browser-window.close",
-    SNAP_TO_EDGE = "event::cn.widgetjs.core.browser-window.snap_to_edge",
-    RESIZED = "event::cn.widgetjs.core.browser-window.resized",
-    CANCEL_SNAP_TO_EDGE = "event::cn.widgetjs.core.browser-window.cancel_snap_to_edge"
-}
-interface SetupOptions {
-    width: number;
-    height: number;
-    minWidth?: number;
-    minHeight?: number;
-    maxWidth?: number;
-    maxHeight?: number;
-    resizable?: boolean;
-    movable?: boolean;
-    center?: boolean;
-    alwaysOnTop?: boolean;
-    x?: number;
-    y?: number;
-    skipTaskbar?: boolean;
-}
-declare class BrowserWindowApiImpl extends BaseApi<BrowserWindowApiMethods> implements IBrowserWindowApi {
-    getProxy(): Promise<ProxyConfig | undefined>;
-    setBackgroundThrottling(enabled: boolean): Promise<void>;
-    getBackgroundThrottling(): Promise<boolean>;
-    isResizable(): Promise<boolean>;
-    setHasShadow(hasShadow: boolean): Promise<void>;
-    isDraggingWindow(): Promise<boolean>;
-    setNoActivate(): Promise<void>;
-    isVisible(): Promise<boolean>;
-    getChannel(): string;
-    setIgnoreMouseEvent(ignore: boolean): Promise<void>;
-    show(): Promise<void>;
-    showInactive(): Promise<void>;
-    hide(): Promise<void>;
-    center(): Promise<void>;
-    setAlwaysOnTop(alwaysOnTop: boolean): Promise<void>;
-    isAlwaysOnTop(): Promise<boolean>;
-    openUrl(url: string, option?: BrowserWindowOptions): Promise<void>;
-    moveTop(): Promise<void>;
-    openDevTools(): Promise<void>;
-    setPosition(options: SetPositionOptions): Promise<void>;
-    getPosition(): Promise<Position>;
-    blur(): Promise<any>;
-    focus(): Promise<any>;
-    /**
-     * 设置窗口是否可以拉伸
-     * @param resizable
-     */
-    setResizable(resizable: boolean): Promise<any>;
-    getBounds(): Promise<Rectangle>;
-    setBounds(bounds: Partial<Rectangle>, animate?: boolean): Promise<void>;
-    alignToScreen(align: AlignPosition): Promise<any>;
-    startDraggingWindow(): Promise<any>;
-    stopDraggingWindow(): Promise<any>;
-    /**
-     * 通过url检测窗口是否存在
-     * @param url
-     */
-    existsByUrl(url: string): Promise<boolean>;
-    getMaximumSize(): Promise<number[]>;
-    minimize(): Promise<void>;
-    maximize(): Promise<void>;
-    isMaximized(): Promise<boolean>;
-    isMinimized(): Promise<boolean>;
-    restore(): Promise<void>;
-    unmaximize(): Promise<void>;
-    setZoomLevel(level: number): Promise<void>;
-    reload(): Promise<void>;
-    setMovable(movable: boolean): Promise<void>;
-    setSize(width: number, height: number, animate?: boolean): Promise<void>;
-    isFocused(): Promise<boolean>;
-    setMaximumSize(width: number, height: number): Promise<void>;
-    setMinimumSize(width: number, height: number): Promise<void>;
-    getMinimumSize(): Promise<number[]>;
-    close(): Promise<void>;
-    setZoomFactor(factor: number): Promise<void>;
-    setup(options: SetupOptions): Promise<void>;
-    setProxy(config: Electron.Config): Promise<void>;
-    getSize(): Promise<number[]>;
-    setSkipTaskbar(skip: boolean): Promise<void>;
-}
-declare const BrowserWindowApi: BrowserWindowApiImpl;
-
-type NotificationType = 'countdown' | 'advance-countdown' | 'error' | 'success' | 'warning' | 'info' | 'reminder' | 'url' | 'call';
-declare enum NotificationSize {
-    SMALL = "small",
-    NORMAL = "normal",
-    LARGE = "large"
-}
-interface CountdownNotificationOption extends InfoNotificationOption {
-    targetTime?: string;
-}
-interface InfoNotificationOption {
-    message: string;
-    duration?: number;
-    /**
-     * 图片名，目前只支持mingcute图标。
-     * https://www.mingcute.com/
-     */
-    icon?: string;
-    color?: string;
-    size?: NotificationSize;
-    backgroundColor?: string;
-}
-interface CallNotificationOption extends InfoNotificationOption {
-    lyric?: string;
-    audio?: string;
-    avatar?: string;
-}
-interface ReminderNotificationOption extends InfoNotificationOption {
-    confirmButtonText?: string;
-    cancelButtonText?: string;
-    title?: string;
-    cancelBroadcast?: string;
-    confirmBroadcast?: string;
-}
-interface NotificationOption extends InfoNotificationOption, ReminderNotificationOption, CountdownNotificationOption, CallNotificationOption {
-    type?: NotificationType;
-}
-declare class AppNotification {
-    type: NotificationType;
-    message: string;
-    title?: string;
-    targetTime?: string;
-    /**
-     * 持续时间，单位毫秒
-     */
-    duration: number;
-    /**
-     * IconPark图标
-     * @example close-one
-     * @see [IconPark](https://iconpark.oceanengine.com/official)
-     */
-    icon?: string;
-    color?: string;
-    backgroundColor?: string;
-    confirmButtonText?: string;
-    cancelButtonText?: string;
-    cancelBroadcast?: string;
-    confirmBroadcast?: string;
-    size: NotificationSize;
-    url?: string;
-    avatar?: string;
-    audio?: string;
-    lyric?: string;
-    createdAt: string;
-    constructor(option: NotificationOption);
-}
-declare class AppReminderNotification extends AppNotification {
-    constructor(option: ReminderNotificationOption);
-}
-
-/**
- * NotificationApi提供了发送通知的能力
- */
-interface INotificationApi {
-    /**
-     * 发送自定义通知
-     * @param notification
-     */
-    send: (notification: AppNotification) => Promise<void>;
-    /**
-     * 隐藏通知
-     */
-    hide: () => Promise<void>;
-    /**
-     * @param message string
-     * @param duration number  持续时间，单位毫秒，默认5000
-     */
-    success: (message: string, duration?: number) => Promise<void>;
-    /**
-     * @param message string
-     * @param duration number  持续时间，单位毫秒，默认5000
-     */
-    error: (message: string, duration?: number) => Promise<void>;
-    /**
-     * @param message string
-     * @param duration number  持续时间，单位毫秒，默认5000
-     */
-    warning: (message: string, duration?: number) => Promise<void>;
-    /**
-     * @param message string
-     * @param duration number  持续时间，单位毫秒，默认5000
-     */
-    info: (message: string, duration?: number) => Promise<void>;
-    reminder: (option: ReminderNotificationOption) => Promise<void>;
-}
-
-type NotificationApiMethods = keyof INotificationApi;
-declare enum NotificationApiEvent {
-    CONFIRM = "event::cn.widgetjs.core.notification.confirm",
-    CANCEL = "event::cn.widgetjs.core.notification.cancel",
-    HIDE = "event::cn.widgetjs.core.notification.hide"
-}
-declare class NotificationApiImpl extends BaseApi<NotificationApiMethods> implements INotificationApi {
-    /**
-     * 来电
-     * @param avatar    头像地址
-     * @param audio     音频地址
-     * @param title     标题文件
-     * @param message   初始消息
-     * @param lyric     歌词字符串
-     */
-    call(avatar: string, audio: string, title: string, message: string, lyric: string): Promise<void>;
-    send(notification: AppNotification): Promise<any>;
-    reminder(option: ReminderNotificationOption): Promise<any>;
-    advanceCountdown(message: string, targetTime: string, title?: string): Promise<any>;
-    countdown(message: string, targetTime: string): Promise<void>;
-    success(message: string, duration?: number): Promise<void>;
-    error(message: string, duration?: number): Promise<void>;
-    warning(message: string, duration?: number): Promise<void>;
-    info(message: string, duration?: number): Promise<void>;
-    /**
-     * 隐藏通知
-     */
-    hide(): Promise<void>;
-    getChannel(): string;
-}
-declare const NotificationApi: NotificationApiImpl;
-
-/**
- * @deprecated use DeployedMode instead
- */
-declare enum HostedMode {
-    NORMAL = 1,
-    /**
-     * 悬浮窗
-     */
-    OVERLAP = 16,
-    WALLPAPER = 256,
-    SCREEN = 4096,
-    BACKGROUND = 65536,
-    /**
-     * 页面
-     */
-    PAGE = 1048576,
-    ALL = 1118481
-}
-declare enum DeployMode {
-    /**
-     * 桌面组件，默认
-     */
-    NORMAL = 1,
-    /**
-     * 悬浮窗
-     */
-    OVERLAP = 16,
-    /**
-     * 后台组件，没有界面，一般在后台执行定时任务
-     */
-    BACKGROUND = 65536,
-    /**
-     * System tray
-     */
-    TRAY = 256,
-    /**
-     * 全部支持
-     */
-    ALL = 1118481
-}
-
-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"
-}
-
-interface IDeployedPage {
-    id: string;
-    name: string;
-    packageName: string;
-    x: number;
-    y: number;
-    height: number;
-    width: number;
-    proxy?: string;
-    isIgnoreMouseEvents?: boolean;
-}
-declare class DeployedPage implements IDeployedPage {
-    name: string;
-    packageName: string;
-    x: number;
-    y: number;
-    height: number;
-    width: number;
-    proxy?: string;
-    id: string;
-    isIgnoreMouseEvents?: boolean;
-}
-
-declare class DeployedWidget extends DeployedPage {
-    shortcut?: string;
-    deployMode: number;
-    isOverlap(): boolean;
-}
-
-/**
- * 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 AppRoutes = '/widget/search' | '/widget/package' | '/setting/common' | '/setting/theme' | '/setting/ai' | '/setting/proxy' | '/setting/info' | '/user/profile';
-/**
- * AppApi 接口定义了与应用程序相关的一系列方法。这些方法提供了应用程序配置管理、版本信息获取、路径获取以及应用内置窗口操作等功能。
- * @see [Electron API App](https://www.electronjs.org/docs/latest/api/app)
- */
-interface IAppApi {
-    /**
-     * 设置配置
-     * @param key string
-     * @param value string | number | boolean
-     */
-    setConfig: (key: string | AppApiConstants, value: string | number | boolean) => Promise<any>;
-    /**
-     * 获取配置
-     * @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 - 可选。指定要获取的版本类型。
-     *      <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>
-     *      </ol>
-     * @return Promise<string>
-     */
-    getVersion: (type?: 'app' | 'electron' | 'chrome' | 'node' | 'v8') => Promise<string>;
-    /**
-     * Get App's runtime info (e.g. app name, os/electron/node version, etc.)
-     */
-    getRuntimeInfo: () => Promise<AppRuntimeInfo>;
-    /**
-     * 获取Preload JS路径
-     * @see [Using Preload Scripts](https://www.electronjs.org/docs/latest/tutorial/tutorial-preload)
-     * @return Promise<string>
-     */
-    getPreloadPath: () => Promise<string>;
-    /**
-     * 获取应用安装路径
-     * @return Promise<string>
-     */
-    getAppPath: () => Promise<string>;
-    /**
-     * Open the app's add/search widget window
-     * @deprecated Use `showAppWindow('/widget/add', options)` instead, which is more flexible and supports custom routes.
-     */
-    openAddWidgetWindow: () => Promise<void>;
-    /**
-     * Show a new window with specified route and options
-     * support routes:
-     * /user/profile
-     * /auth/register
-     *
-     * @param route
-     * @param options
-     */
-    showAppWindow: (route: string | AppRoutes, options?: BrowserWindowOptions) => Promise<void>;
-    /**
-     * Open the app's setting window
-     * @deprecated Use `showAppWindow('/setting/common', options)` instead, which is more flexible and supports custom routes.
-     */
-    openSettingWindow: () => Promise<void>;
-    /**
-     * Open the app's update window
-     * @deprecated Use `showAppWindow('/widget/info', options)` instead, which is more flexible and supports custom routes.
-     */
-    openCheckUpdateWindow: () => Promise<void>;
-    /**
-     *  open the app's widget manager window
-     *  @deprecated Use `showAppWindow('/widget/search', options)` instead, which is more flexible and supports custom routes.
-     */
-    openWidgetManagerWindow: () => 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;
     /**
-     * @deprecated Use `showAppWindow('/widget/package', options)` instead, which is more flexible and supports custom routes.
+     * 预览图片，可以是GIF
      */
-    openWidgetPackageManagerWindow: () => Promise<void>;
+    readonly previewImage?: string;
+}
+declare class Page implements IPage {
     /**
-     * Open the app's runtime info window
-     * @deprecated Use `showAppWindow('/setting/info', options)` instead, which is more flexible and supports custom routes.
+     * 页面名称,名称必须以包名开头，如果以.开头，会自动加上包名<br>
+     * 假设包名为`example.com`，以下两种写法等价
+     * @example example.com.countdown
+     * @example .countdown
      */
-    openRuntimeInfoWindow: () => Promise<void>;
+    name: string;
     /**
-     * Get the app's icon file path
-     * @return Promise<string>
+     * 窗口标题，显示在界面上的，
+     * @see https://zh.m.wikipedia.org/zh-hans/ISO_639-1
      */
-    getIconFile: () => Promise<string>;
+    readonly title: LanguageTextMap;
     /**
-     * Check if the app is running as Windows Store app (appx)
-     * @return Promise<boolean>
+     * 窗口介绍
      */
-    isWindowsStore: () => Promise<boolean>;
+    readonly description: LanguageTextMap;
+    readonly keywords: WidgetKeyword[];
+    readonly security: boolean;
+    readonly permissions: WidgetPermission[];
     /**
-     * Get app's language, if user has not set, return `navigator.language`
+     * 组件默认语言
      */
-    getLanguageCode: () => Promise<string>;
+    readonly lang: LanguageCode;
+    readonly width: number;
+    packageName?: string | null;
+    readonly height: number;
+    readonly maxWidth: number;
     /**
-     * Set app's language
-     * @param code
+     * @deprecated
      */
-    setLanguageCode: (code: LanguageCode) => Promise<void>;
+    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;
     /**
-     * Set app's global proxy settings, set empty string to disable proxy
-     * @param config
-     * @example
-     * ```typescript
-     * AppApi.setProxy({
-     *     proxyRules:'socks5://127.0.0.1:7890'
-     * })
-     * ```
+     * 预览图片，可以是GIF
      */
-    setProxy: (config: ProxyConfig) => Promise<void>;
-    getProxy: () => Promise<ProxyConfig>;
+    readonly previewImage?: string;
+    constructor(options: IPageOptions);
     /**
-     * Set app's global theme CSS
-     * @param css
+     * 获取组件标题
+     * @param lang 语言环境，不传则获取默认语言
      */
-    setThemeCSS: (css: string) => Promise<void>;
+    getTitle(lang?: LanguageCode): string | undefined;
     /**
-     * Get the app's global theme CSS
-     * @return Promise<string> If the theme CSS is not set, return empty string
+     * 获取组件描述
+     * @param lang 语言环境，不传则获取默认标题
      */
-    getThemeCSS: () => Promise<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;
     /**
-     * enable/disable developer mode
+     * 如果为true，组件将不会添加到组件包中
      */
-    setDevMode: (enable: boolean) => Promise<void>;
+    disabled?: boolean;
+    previewImage: string;
     /**
-     * get developer mode is enabled
+     * whether the widget data can be synchronized
      */
-    getDevMode: () => Promise<boolean>;
+    synchronizable?: boolean;
+    categories?: Category[];
     /**
-     * Get the app's desktop grid system cell size
+     * 组件包所需的App版本
      */
-    getGridCellSize: () => Promise<number>;
+    requiredAppVersion?: string;
+    description: LanguageTextMap;
+    keywords: WidgetKeyword[];
     /**
-     * Set the app's desktop grid system cell size
-     * @param size
+     * @deprecated
      */
-    setGridCellSize: (size: number) => Promise<void>;
+    routes?: WidgetRoute[];
     /**
-     * exit application
+     * 一般用于填写教程链接
      */
-    exit: () => Promise<void>;
+    socialLinks?: SocialLink[];
+    browserWindowOptions?: Pick<BrowserWindowOptions, 'backgroundThrottling'>;
+    trayOptions?: TrayWidgetOptions;
+}
+interface IBackgroundWidgetOptions extends Omit<IWidgetOptions, 'width' | 'height'> {
+    width?: number;
+    height?: number;
+    browserWindowOptions?: BrowserWindowOptions;
 }
-type AppApiMethods = keyof IAppApi;
 /**
- * AppApiEvent
+ * @deprecated
  */
-declare enum AppApiEvent {
+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版本
      */
-    CONFIG_CHANGED = "event::cn.widgetjs.core.app.config.changed",
+    readonly requiredAppVersion?: string;
     /**
-     * 桌面组件网格窗口移动时触发
+     * 如果为true，组件将不会添加到组件包中
      */
-    MOVING_GRID_WINDOW = "event::cn.widgetjs.core.app.moving.grid.window",
+    readonly disabled?: boolean;
+    readonly synchronizable?: boolean;
     /**
-     * 桌面组件网格窗口停止移动时触发
+     * 配置页面路径，没有则不能修改
      */
-    STOP_MOVING_GRID_WINDOW = "event::cn.widgetjs.core.app.moving.grid.window.stop",
+    readonly configPagePath?: string;
     /**
-     * 应用代理发生变化
+     * @deprecated
      */
-    PROXY_CHANGED = "event::cn.widgetjs.core.app.proxy.changed",
+    readonly routes: WidgetRoute[];
+    protected browserWindowOptions?: BrowserWindowOptions;
+    readonly socialLinks?: SocialLink[];
+    constructor(options: IWidgetOptions);
+    static parseJSON(json: string): Widget;
+    static parseObject(obj: any): Widget;
     /**
-     * 应用语言发生变化
+     * 是否支持悬浮窗
      */
-    LANGUAGE_CHANGED = "event::cn.widgetjs.core.app.language.changed"
-}
-/**
- * AppApiConstants
- */
-declare enum AppApiConstants {
+    isSupportOverlap(): boolean;
+    isSupportBackground(): boolean;
+    isSupportTray(): boolean;
     /**
-     * 桌面组件网格大小
+     * 是否支持普通模式
      */
-    CONFIG_GRID_CELL_SIZE = "cn.widgetjs.config.grid.size",
+    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;
     /**
-     * 应用主题CSS设置
+     * 将组件参数转为url参数
+     * @param object
+     * @return URLSearchParams  w_w=2&w_h=2&w_id=21&w_width=156&w_height=156
      */
-    CONFIG_WIDGET_THEME_CSS = "cn.widgetjs.config.widget.theme.css",
+    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}
      */
-    CONFIG_PROXY = "cn.widgetjs.config.app.proxy",
-    CONFIG_DEV_MODE = "cn.widgetjs.config.app.dev.mode",
+    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
      */
-    CONFIG_LANGUAGE = "cn.widgetjs.config.app.language"
+    static fromObject(object: any): WidgetParams;
+}
+declare enum ThemeMode {
+    AUTO = "auto",
+    LIGHT = "LIGHT",
+    DARK = "DARK"
 }
 
-/**
- * DialogApi 提供文件、文件夹选择功能
- */
-interface IDialogApi {
-    /**
-     * 选取单个文件
-     * @param extensions 允许的文件后缀格式，如：["txt","docx","gif"]
-     */
-    pickFile: (extensions?: string[]) => Promise<string | undefined>;
-    /**
-     * 选取文件夹
-     */
-    pickFolder: () => Promise<string | undefined>;
+declare abstract class BaseApi<T extends string> {
+    abstract getChannel(): string;
+    protected invokeMethod(method: T, ...args: any[]): Promise<any>;
+    protected invoke(...args: any[]): Promise<any>;
 }
-type DialogApiMethods = keyof IDialogApi;
 
-/**
- * WidgetPackageApi 提供了组件包的升级、获取、安装等功能
- */
-interface IWidgetPackageApi {
-    /**
-     * 升级组件包
-     * @param packageName   组件包名称
-     * @param remoteUrlInfo
-     */
-    upgrade: (packageName: string, remoteUrlInfo: RemotePackageUrlInfo) => Promise<void>;
-    /**
-     * 获取组件包的首页url信息
-     * @param packageName
-     */
-    getIndexUrl: (packageName: string) => Promise<string | null>;
-    /**
-     * 获取组件包入口url信息
-     * @param packageName
-     */
-    getEntryUrl: (packageName: string) => Promise<string | null>;
-    /**
-     * 通过包名获取组件包信息
-     * @param name
-     */
-    getPackage: (name: string) => Promise<WidgetPackage | undefined>;
+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
      */
-    getPackages: () => Promise<WidgetPackage[]>;
+    removeDeployedWidget(id?: string): Promise<any>;
+    addWidget(options: AddWidgetOption): Promise<Widget[]>;
+    createDesktopShortcut(widgetName: string): Promise<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
+     * 通过组件名移除已添加的组件
+     * @param name  组件名
      */
-    install: (widgetPackage: WidgetPackage | string) => Promise<void>;
+    removeDeployedWidgetByName(name: string): Promise<DeployedWidget[]>;
     /**
-     * Uninstall a widget package by package name.
-     * @param packageName
-     * @param clearData    Whether to clear the data of the widget package, default is false.
+     * 获取已添加的组件
+     * @param name  组件名，可以不传
      */
-    uninstall: (widgetPackage: WidgetPackage | string, clearData?: boolean) => Promise<void>;
-}
-type WidgetPackageApiMethods = keyof IWidgetPackageApi;
-/**
- * WidgetPackageApiEvent
- */
-declare enum WidgetPackageApiEvent {
+    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.
      */
-    PACKAGE_UPGRADE = "event::cn.widgetjs.core.widget.package.upgraded",
+    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
      */
-    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;
+    registerActiveShortcut(widgetId: string, shortcut?: string): Promise<boolean>;
+    setProxy(widgetId: string, proxy: string): Promise<boolean>;
 }
-type LogApiMethods = keyof ILogApi;
+declare const DeployedWidgetApi: DeployedWidgetApiImpl;
 
 /**
- * ProcessApi 提供进程信息获取功能
+ * 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 IProcessApi {
-    getBlinkMemoryInfo: () => Promise<Electron.BlinkMemoryInfo>;
-    getHeapStatistics: () => Promise<Electron.HeapStatistics>;
+interface IDeployedWidgetApi {
+    removeDeployedWidget: (id?: string) => Promise<void>;
+    removeDeployedWidgetByName: (name: string) => Promise<DeployedWidget[]>;
+    getDeployedWidgets: () => Promise<DeployedWidget[]>;
+    openDevTools: (id: string) => Promise<void>;
     /**
-     * 获取系统版本信息
-     * @example '10.0.17763'
+     * @deprecated 使用WidgetApi.openConfigPage代替
+     * @param id
      */
-    getSystemVersion: () => Promise<string>;
+    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
      */
-    getProcessMemoryInfo: () => Promise<Electron.ProcessMemoryInfo>;
-}
-type ProcessApiMethods = keyof IProcessApi;
-
-/**
- * MouseApi
- */
-interface IMouseApi {
+    setProxy: (id: string, proxy: string) => Promise<boolean>;
+    getDeployedWidget: (id: string) => Promise<DeployedWidget>;
     /**
-     * Create a mouse screen edge hotspot, usually used for edge-hiding windows.
-     * @param rect
+     * 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.
      */
-    createHotspot: (rect: Rectangle) => Promise<void>;
+    addWidget: (options: AddWidgetOption) => Promise<Widget[]>;
     /**
-     * Remove the mouse screen edge hotspot.
+     * 创建桌面快捷方式
+     * @param widgetName 组件名
+     * @returns 成功返回 true，否则返回 false
      */
-    removeHotspot: () => Promise<void>;
+    createDesktopShortcut: (widgetName: string) => Promise<boolean>;
 }
 /**
- * SystemApiEvent
+ * AiApiEvent
  */
-declare enum MouseApiEvent {
+declare enum DeployedWidgetApiEvent {
     /**
-     * Triggered when the mouse enters the hotspot area.
+     * 第二实例启动事件
      */
-    HOTSPOT_ACTIVE = "event::cn.widgetjs.core.mouse.hotspot.active"
+    SECOND_INSTANCE = "channel::cn.widgetjs.core.deployed_widget.second_instance"
 }
-type MouseApiMethods = keyof IMouseApi;
 
 /**
  *  @see https://electronjs.org/docs/api/structures/size
@@ -1670,6 +1403,22 @@ interface IDeviceApi {
     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 */
     orientation?: number | undefined;
@@ -2834,13 +2583,68 @@ interface IFileApi {
      *
      * @param path
      */
-    openPath: (path: string) => Promise<void>;
+    openPath: (path: string) => Promise<void>;
+    /**
+     *
+     * @param path path to the item to be moved to the trash.
+     */
+    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>;
     /**
-     *
-     * @param path path to the item to be moved to the trash.
+     * 获取当前应用内存信息
      */
-    trashItem: (path: string) => Promise<void>;
+    getProcessMemoryInfo: () => Promise<Electron.ProcessMemoryInfo>;
 }
+type ProcessApiMethods = keyof IProcessApi;
 
 /**
  * MenuApi 接口定义了一系列用于控制窗口的方法，这些方法提供了窗口的显示、隐藏、移动、调整大小等功能
@@ -2966,776 +2770,1044 @@ interface DisplayBalloonOptions {
     /**
      * Do not play the associated sound. Default is `false`. Maps to `NIIF_NOSOUND`.
      */
-    noSound?: boolean;
+    noSound?: boolean;
+    /**
+     * Do not display the balloon notification if the current user is in "quiet time".
+     * Default is `false`. Maps to `NIIF_RESPECT_QUIET_TIME`.
+     */
+    respectQuietTime?: boolean;
+}
+/**
+ * ITrayApi
+ *
+ * API for interacting with the native system tray / status bar icon.
+ * All methods return a Promise and should be awaited in callers where timing matters.
+ */
+interface ITrayApi {
+    /**
+     * Create or update the tray icon with given options.
+     * Resolves once the native tray object is created/updated.
+     * @param options AddTrayOptions - image and optional tooltip
+     */
+    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;
+
+/**
+ * WidgetPackageApi 提供了组件包的升级、获取、安装等功能
+ */
+interface IWidgetPackageApi {
+    /**
+     * 升级组件包
+     * @param packageName   组件包名称
+     * @param remoteUrlInfo
+     */
+    upgrade: (packageName: string, remoteUrlInfo: RemotePackageUrlInfo) => Promise<void>;
+    /**
+     * 获取组件包的首页url信息
+     * @param packageName
+     */
+    getIndexUrl: (packageName: string) => Promise<string | null>;
+    /**
+     * 获取组件包入口url信息
+     * @param packageName
+     */
+    getEntryUrl: (packageName: string) => Promise<string | null>;
+    /**
+     * 通过包名获取组件包信息
+     * @param name
+     */
+    getPackage: (name: string) => Promise<WidgetPackage | undefined>;
+    /**
+     * 获取已经安装的组件包
+     */
+    getPackages: () => Promise<WidgetPackage[]>;
+    /**
+     * 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>;
+    /**
+     * Uninstall a widget package by package name.
+     * @param packageName
+     * @param clearData    Whether to clear the data of the widget package, default is false.
+     */
+    uninstall: (widgetPackage: WidgetPackage | string, clearData?: boolean) => Promise<void>;
+}
+type WidgetPackageApiMethods = keyof IWidgetPackageApi;
+/**
+ * WidgetPackageApiEvent
+ */
+declare enum WidgetPackageApiEvent {
+    /**
+     * 组件包升级事件
+     */
+    PACKAGE_UPGRADE = "event::cn.widgetjs.core.widget.package.upgraded",
+    /**
+     * 组件包安装事件
+     */
+    PACKAGE_INSTALLED = "event::cn.widgetjs.core.widget.package.installed"
+}
+
+declare const AppApi: IAppApi;
+
+/**
+ * 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[]>;
     /**
-     * Do not display the balloon notification if the current user is in "quiet time".
-     * Default is `false`. Maps to `NIIF_RESPECT_QUIET_TIME`.
+     * 打开组件设置页面
+     * @param id string 组件id
      */
-    respectQuietTime?: boolean;
-}
-/**
- * ITrayApi
- *
- * API for interacting with the native system tray / status bar icon.
- * All methods return a Promise and should be awaited in callers where timing matters.
- */
-interface ITrayApi {
+    openConfigPage: (id?: string) => Promise<void>;
     /**
-     * Create or update the tray icon with given options.
-     * Resolves once the native tray object is created/updated.
-     * @param options AddTrayOptions - image and optional tooltip
+     * @param name
      */
-    setTray: (options: AddTrayOptions) => Promise<void>;
+    openConfigPageByName: (name: string) => Promise<void>;
     /**
-     * Remove the tray icon and free native resources.
-     * Resolves when the tray has been removed.
+     * 重新加载组件
      */
-    removeTray: () => Promise<void>;
+    reload: (id?: string) => Promise<void>;
     /**
-     * Displays a balloon notification.
-     * @param options DisplayBalloonOptions
+     *
+     * @param packageName
+     * @deprecated
      */
-    displayBalloon: (options: DisplayBalloonOptions) => Promise<void>;
+    getWidgetPackageUrl: (packageName: string) => Promise<string | null>;
+    restartWidgets: (mode?: DeployMode) => Promise<void>;
+    updateSyncInfo: () => Promise<void>;
+    getSyncInfo: (widgetName?: string) => Promise<WidgetSyncInfo | null>;
+}
+
+interface LocalPackageUrlInfo {
     /**
-     * Removes a balloon notification.
+     * 入口文件，默认为index.html，也可以是/
+     * @example remote package: https://rtugeek.gitee.io/hotspot/index.html
+     * @example local package: index.html
+     * @deprecated use entryFile instead
      */
-    removeBalloon: () => Promise<void>;
+    entry?: string;
     /**
-     * Set the context menu for the tray icon.
-     * Replaces any previously set menu.
-     * @param menus Array of WidgetMenuItem describing the menu structure
+     * 需以 / 开头
+     * @example /index.html
      */
-    setContextMenu: (menus: WidgetMenuItem[]) => Promise<void>;
+    entryFile?: string;
     /**
-     * Close any open context menu for the tray (if supported by the platform).
+     * 是否使用hash路由
      */
-    closeContextMenu: () => Promise<void>;
+    hash?: boolean;
+}
+interface RemotePackageUrlInfo extends LocalPackageUrlInfo {
     /**
-     * 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
+     * 部署到服务器的base path，只在远程组件包中生效，需以/开始
+     * @example /hotspot
      */
-    popUpContextMenu: (menus: WidgetMenuItem[], position?: Point) => Promise<void>;
+    base?: string;
     /**
-     * Returns whether the underlying native tray object has been destroyed.
-     * Useful to check before calling other tray methods.
+     * 域名地址，不带协议
+     * @example widgetjs.cn
      */
-    isDestroyed: () => Promise<boolean>;
+    hostname: string;
+}
+interface WidgetPackageOptions extends LocalPackageUrlInfo {
+    name: string;
+    version?: string;
+    author: string;
+    homepage?: string;
+    title: LanguageTextMap;
+    permissions?: WidgetPermission[];
+    description: LanguageTextMap;
+    zipUrl?: string;
     /**
-     * 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.
+     * 远程组件包入口文件
+     * @deprecated
      */
-    getBounds: () => Promise<Rectangle | null>;
+    remoteEntry?: string;
     /**
-     * Bring the application to the foreground or focus the window associated with the tray.
-     * Exact behavior depends on platform and application window state.
+     * @deprecated
      */
-    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 {
+    remotePackage?: string;
+    remote?: RemotePackageUrlInfo;
+    icon?: string;
+    lang?: LanguageCode;
+    widgets?: Widget[];
     /**
-     * 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",
+    development?: boolean;
+    devOptions?: DevOptions;
+    requiredAppVersion?: string;
     /**
-     * Emitted when the tray icon receives a right-button click.
-     * Channel: 'channel::cn.widgetjs.core.tray.right-click'
+     * social links, generally used for tutorial links or source code
      */
-    RIGHT_CLICK = "channel::cn.widgetjs.core.tray.right-click",
+    socialLinks?: SocialLink[];
+}
+declare class WidgetPackage implements Omit<RemotePackageUrlInfo, 'hostname'> {
     /**
-     * Emitted when the tray icon receives a middle-button click (if supported).
-     * Channel: 'channel::cn.widgetjs.core.tray.middle-click'
+     * 组件包名,一般为域名倒写，e.g. com.example
      */
-    MIDDLE_CLICK = "channel::cn.widgetjs.core.tray.middle-click",
+    readonly name: string;
     /**
-     * Emitted when the mouse pointer enters the tray icon area (hover start).
-     * Channel: 'channel::cn.widgetjs.core.tray.mouse-enter'
+     * 组件包版本，可以为空，默认采用package.json里的版本
+     * e.g. 1.0.2
      */
-    MOUSE_ENTER = "channel::cn.widgetjs.core.tray.mouse-enter",
+    version?: string;
     /**
-     * Emitted when the mouse pointer leaves the tray icon area (hover end).
-     * Channel: 'channel::cn.widgetjs.core.tray.mouse-leave'
+     * 组件包所需的App版本
      */
-    MOUSE_LEAVE = "channel::cn.widgetjs.core.tray.mouse-leave"
-}
-type TrayApiMethods = keyof ITrayApi;
-
-interface IUserApi {
+    requiredAppVersion?: string;
     /**
-     * Login with user info.
-     * @param token
+     * 组件作者署名
      */
-    login: (session: AuthSession) => Promise<void>;
+    readonly author: string;
+    development?: boolean;
     /**
-     * Clear user auth token and user info.
+     * 组件首页
      */
-    logout: () => Promise<void>;
+    readonly homepage?: string;
     /**
-     * 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 {
+    readonly title: {
+        [key: LanguageCode | string]: 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;
-
-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 {
+    readonly description: {
+        [key: LanguageCode | string]: string;
+    };
     /**
-     * 配置更新事件
+     * 本地组件入口文件，通常为 index.html
      */
-    CONFIG_UPDATED = "channel::cn.widgetjs.core.ai.config.updated"
-}
-type AiApiMethods = keyof IAiApi;
-
-type DeviceApiMethods = keyof IDeviceApi;
-declare const DeviceApi: IDeviceApi;
-
-declare enum Channel {
-    NOTIFICATION = "channel::cn.widgetjs.core.notification",
-    BROWSER_WINDOW = "channel::cn.widgetjs.core.browser_window",
-    BROADCAST = "channel::cn.widgetjs.core.broadcast",
-    WIDGET = "channel::cn.widgetjs.core.widget",
-    WIDGET_PACKAGE = "channel::cn.widgetjs.core.widget.package",
-    DEPLOYED_WIDGET = "channel::cn.widgetjs.core.deployed_widget",
-    APP = "channel::cn.widgetjs.core.app",
-    SYSTEM = "channel::cn.widgetjs.core.system",
-    DIALOG = "channel::cn.widgetjs.core.dialog",
-    HTTP = "channel::cn.widgetjs.core.http",
-    CLIPBOARD = "channel::cn.widgetjs.core.clipboard",
-    FILE = "channel::cn.widgetjs.core.file",
-    SCREEN = "channel::cn.widgetjs.core.screen",
-    MENU = "channel::cn.widgetjs.core.menu",
-    SHORTCUT = "channel::cn.widgetjs.core.shortcut",
-    LOG = "channel::cn.widgetjs.core.log",
-    DEVICE = "channel::cn.widgetjs.core.device",
-    MOUSE = "channel::cn.widgetjs.core.mouse",
-    KEYBOARD = "channel::cn.widgetjs.core.keyboard",
+    entry: string | 'index.html';
     /**
+     * 远程组件包入口文件
      * @deprecated
      */
-    STORE = "channel::cn.widgetjs.core.store",
-    STORAGE = "channel::cn.widgetjs.core.storage",
-    PROCESS = "channel::cn.widgetjs.core.process",
-    USER = "channel::cn.widgetjs.core.user",
-    TRAY = "channel::cn.widgetjs.core.tray",
-    AI = "channel::cn.widgetjs.core.ai"
-}
-
-interface IClipboardApi {
-    getSelectedText(): Promise<string | undefined>;
-    getText(): Promise<string | undefined>;
-    writeText(text: string): Promise<void>;
-}
-type ClipboardApiMethods = keyof IClipboardApi;
-declare enum ClipboardApiEvent {
-    CHANGED = "clipboard-changed"
-}
-declare const ClipboardApi: IClipboardApi;
-
-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;
+    remoteEntry?: string;
     /**
-     * 当showInSearch为true时,此项必填
+     * 组件包json文件路径
+     * @deprecated
+     * @example https://rtugeek.gitee.io/hotspot/widget.json
      */
-    title: LanguageTextMap;
+    readonly remotePackage?: string;
+    readonly local?: LocalPackageUrlInfo;
+    readonly remote?: RemotePackageUrlInfo;
     /**
-     * 当showInSearch为true时,此项必填
+     * zip package url, used for downloading the package
      */
-    description?: LanguageTextMap;
+    zipUrl?: string;
     /**
-     * 当showInSearch为true时,此项必填
+     * 组件包图标
      */
-    keywords?: WidgetKeyword[];
-    lang: LanguageCode;
-    packageName?: string;
-    icon?: string;
+    readonly icon?: string;
     /**
-     * 当showInSearch为true时,此项必填
+     * Hash路由模式，默认为true
      */
-    previewImage?: string;
+    readonly hash: boolean;
     /**
-     * 是否在搜索中显示
+     * 可能是网络地址，或者本地路径（解压后的文件夹路径）,
+     * 网络地址：https://www.bilibili.com
+     * 本地地址：file:///C:/Users/neo/Desktop
+     * 在测试时。地址通常为: http://127.0.0.1:8080
      */
-    showInSearch?: boolean;
+    url: string;
+    readonly widgets: Widget[];
+    readonly pages: Page[];
+    devOptions?: DevOptions;
+    constructor(options: WidgetPackageOptions);
+    static parseJSON(json: string): WidgetPackage;
+    static parseObject(obj: any): WidgetPackage;
     /**
-     * 悬浮窗模式 是否可移动
-     * @deprecated
+     * 获取组件包标题
+     * @param lang 语言环境，不传则获取默认语言
      */
-    movable?: boolean;
+    getTitle(lang?: LanguageCode): string | undefined;
     /**
-     * @deprecated
+     * 获取组件包描述
+     * @param lang 语言环境，不传则获取默认标题
      */
-    resizable?: boolean;
+    getDescription(lang?: LanguageCode): string | undefined;
+}
+interface DevOptions {
+    folder?: string;
+    route?: boolean;
+    devUrl?: string;
+    remoteEntry?: string;
+}
+
+type WidgetApiMethods = keyof IWidgetApi;
+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"
+}
+declare class WidgetApiImpl extends BaseApi<WidgetApiMethods> implements IWidgetApi {
+    getSyncInfo(widgetName?: string): Promise<WidgetSyncInfo | null>;
+    updateSyncInfo(): Promise<void>;
+    reload(id?: string): Promise<void>;
+    getChannel(): string;
+    registerWidgets(widgets: Widget[]): Promise<any>;
+    registerWidgetPackage(widgetPackage: WidgetPackage): Promise<any>;
+    getWidgets(): Promise<Widget[]>;
+    openConfigPage(widgetId?: string): Promise<any>;
+    openConfigPageByName(widgetName: string): Promise<any>;
     /**
      * @deprecated
      */
-    backgroundThrottling?: boolean;
-    security?: boolean;
+    getWidgetPackages(): Promise<WidgetPackage[]>;
     /**
-     * @deprecated
+     *
+     * @param name package name
      */
-    webviewTag?: boolean;
-    path: string;
+    getWidget(name: string): Promise<Widget>;
     /**
-     * 是否只能添加一次
+     * @param name package name
+     * @deprecated
      */
-    singleton?: boolean;
-    permissions?: WidgetPermission[];
-    meta?: MetaInfo;
-    broadcastChannels?: string[];
-}
-interface IPage {
-    readonly name: string;
+    getWidgetPackage(name: string): Promise<WidgetPackage | undefined>;
+    getWidgetPackageUrl(packageName: string): Promise<string | null>;
+    upgradePackage(packageName: string): Promise<void>;
     /**
-     * 窗口标题，显示在界面上的，
-     * https://zh.m.wikipedia.org/zh-hans/ISO_639-1
+     * 阻止拖动窗口，只能用于悬浮窗口 DeployMode.OVERLAP
+     * @param draggable
      */
-    readonly title: LanguageTextMap;
-    readonly permissions: WidgetPermission[];
-    readonly webviewTag: boolean;
+    setMouseDraggable(draggable: boolean): Promise<void>;
+    isIgnoreMouseEvents(widgetId: string | undefined): Promise<boolean>;
+    setIgnoreMouseEvents(widgetId: string, ignore: boolean): Promise<void>;
+    restartWidgets(mode?: DeployMode): Promise<void>;
+}
+declare const WidgetApi: WidgetApiImpl;
+
+/**
+ * ShortcutApi 提供了注册快捷键的能力，当快捷键被触发时，会发送广播事件 {@link BroadcastEvent}
+ */
+interface IShortcutApi {
     /**
-     * 窗口介绍
+     * 注册快捷键, 如果注册成功, 触发快捷键时，会发送广播事件 {@link BroadcastEvent}
+     * @see [Electron Accelerator](https://www.electronjs.org/docs/latest/api/accelerator)
+     * @param shortcut string
+     * @return Promise<boolean> true 注册成功，false 注册失败
+     * @example
+     * ```typescript
+     * //Meta 通常为windows键
+     * ShortcutApi.register('Ctrl+Meta+Y')
+     * ```
      */
-    readonly description: LanguageTextMap;
-    readonly keywords: WidgetKeyword[];
+    register: (shortcut: string) => Promise<boolean>;
     /**
-     * 组件默认语言
+     * 注销快捷键
+     * @param shortcut string
+     * @example
+     * ```typescript
+     * //Meta 通常为windows键
+     * ShortcutApi.unregister('Ctrl+Meta+Y')
+     * ```
      */
-    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;
+    unregister: (shortcut: string) => void;
+}
+/**
+ * ShortcutApiEvent
+ */
+declare enum ShortcutApiEvent {
     /**
-     * 预览图片，可以是GIF
+     * 快捷键触发事件
      */
-    readonly previewImage?: string;
+    TRIGGERED = "channel::cn.widgetjs.core.shortcut.triggered"
 }
-declare class Page implements IPage {
+
+type ShortcutApiMethods = keyof IShortcutApi;
+declare const ShortcutApi: IShortcutApi;
+
+interface IClipboardApi {
+    getSelectedText(): Promise<string | undefined>;
+    getText(): Promise<string | undefined>;
+    writeText(text: string): Promise<void>;
+}
+type ClipboardApiMethods = keyof IClipboardApi;
+declare enum ClipboardApiEvent {
+    CHANGED = "clipboard-changed"
+}
+declare const ClipboardApi: IClipboardApi;
+
+/**
+ * BrowserWindowApi 接口定义了一系列用于控制窗口的方法，这些方法提供了窗口的显示、隐藏、移动、调整大小等功能
+ * @remarks 注意：桌面类型组件不支持窗口移动、调整大小、最大化、最小化等操作
+ */
+interface IBrowserWindowApi {
     /**
-     * 页面名称,名称必须以包名开头，如果以.开头，会自动加上包名<br>
-     * 假设包名为`example.com`，以下两种写法等价
-     * @example example.com.countdown
-     * @example .countdown
+     * 设置是否忽略鼠标事件
+     * @param ignore boolean
      */
-    name: string;
+    setIgnoreMouseEvent: (ignore: boolean) => Promise<void>;
     /**
-     * 窗口标题，显示在界面上的，
-     * @see https://zh.m.wikipedia.org/zh-hans/ISO_639-1
+     * 显示窗口
      */
-    readonly title: LanguageTextMap;
+    show: () => Promise<void>;
     /**
-     * 窗口介绍
+     * 设置窗口是否有阴影
+     * @param hasShadow boolean
      */
-    readonly description: LanguageTextMap;
-    readonly keywords: WidgetKeyword[];
-    readonly security: boolean;
-    readonly permissions: WidgetPermission[];
+    setHasShadow: (hasShadow: boolean) => Promise<void>;
     /**
-     * 组件默认语言
+     * 隐藏窗口
      */
-    readonly lang: LanguageCode;
-    readonly width: number;
-    packageName?: string | null;
-    readonly height: number;
-    readonly maxWidth: number;
+    hide: () => Promise<void>;
     /**
-     * @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;
+    close: () => Promise<void>;
     /**
-     * 预览图片，可以是GIF
+     * 以不激活窗口的方式显示窗口
      */
-    readonly previewImage?: string;
-    constructor(options: IPageOptions);
+    showInactive: () => Promise<void>;
     /**
-     * 获取组件标题
-     * @param lang 语言环境，不传则获取默认语言
+     * 将窗口居中
      */
-    getTitle(lang?: LanguageCode): string | undefined;
+    center: () => Promise<void>;
     /**
-     * 获取组件描述
-     * @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;
-}
-
-interface LocalPackageUrlInfo {
+    minimize: () => Promise<void>;
     /**
-     * 入口文件，默认为index.html，也可以是/
-     * @example remote package: https://rtugeek.gitee.io/hotspot/index.html
-     * @example local package: index.html
-     * @deprecated use entryFile instead
+     * 还原窗口
      */
-    entry?: string;
+    restore: () => Promise<void>;
     /**
-     * 需以 / 开头
-     * @example /index.html
+     * 窗口是否最小后
+     * @return  Promise<boolean>
      */
-    entryFile?: string;
+    isMinimized: () => Promise<boolean>;
     /**
-     * 是否使用hash路由
+     * 检查窗口是否最大化
+     * @return  Promise<boolean>
      */
-    hash?: boolean;
-}
-interface RemotePackageUrlInfo extends LocalPackageUrlInfo {
+    isMaximized: () => Promise<boolean>;
     /**
-     * 部署到服务器的base path，只在远程组件包中生效，需以/开始
-     * @example /hotspot
+     * 检查窗口是否可见
+     * @return  Promise<boolean>
      */
-    base?: string;
+    isVisible: () => Promise<boolean>;
     /**
-     * 域名地址，不带协议
-     * @example widgetjs.cn
+     * 检查窗口是否可调整大小
+     * @since 24.1.1-beta.6
+     * @return  Promise<boolean>
      */
-    hostname: string;
-}
-interface WidgetPackageOptions extends LocalPackageUrlInfo {
-    name: string;
-    version?: string;
-    author: string;
-    homepage?: string;
-    title: LanguageTextMap;
-    permissions?: WidgetPermission[];
-    description: LanguageTextMap;
-    zipUrl?: string;
+    isResizable: () => Promise<boolean>;
     /**
-     * 远程组件包入口文件
-     * @deprecated
+     * 最大化窗口
      */
-    remoteEntry?: string;
+    maximize: () => Promise<void>;
     /**
-     * @deprecated
+     * 停止拖动窗口
      */
-    remotePackage?: string;
-    remote?: RemotePackageUrlInfo;
-    icon?: string;
-    lang?: LanguageCode;
-    widgets?: Widget[];
+    stopDraggingWindow: () => Promise<void>;
     /**
-     * 是否处于开发模式
+     * 开始拖动窗口
      */
-    development?: boolean;
-    devOptions?: DevOptions;
-    requiredAppVersion?: string;
+    startDraggingWindow: () => Promise<void>;
     /**
-     * social links, generally used for tutorial links or source code
+     * 检查窗口是否正在拖动
+     * @return  Promise<boolean>
      */
-    socialLinks?: SocialLink[];
-}
-declare class WidgetPackage implements Omit<RemotePackageUrlInfo, 'hostname'> {
+    isDraggingWindow: () => Promise<boolean>;
     /**
-     * 组件包名,一般为域名倒写，e.g. com.example
+     * 设置窗口是否总在最前
+     * @param alwaysOnTop boolean
      */
-    readonly name: string;
+    setAlwaysOnTop: (alwaysOnTop: boolean) => Promise<void>;
     /**
-     * 组件包版本，可以为空，默认采用package.json里的版本
-     * e.g. 1.0.2
+     * 检查窗口是否总在最前
+     * @return  Promise<boolean>
      */
-    version?: string;
+    isAlwaysOnTop: () => Promise<boolean>;
     /**
-     * 组件包所需的App版本
+     * 打开指定的 URL
+     * @param url string 要打开的 URL
+     * @param option OpenUrlOptions - 可选参数，用于配置 URL 打开的方式
      */
-    requiredAppVersion?: string;
+    openUrl: (url: string, option?: BrowserWindowOptions) => Promise<void>;
     /**
-     * 组件作者署名
+     * 将窗口置于最前
      */
-    readonly author: string;
-    development?: boolean;
+    moveTop: () => Promise<void>;
     /**
-     * 组件首页
+     * 取消最大化窗口
      */
-    readonly homepage?: string;
+    unmaximize: () => Promise<void>;
     /**
-     * 组件描述
+     * 重新加载窗口
      */
-    readonly title: {
-        [key: LanguageCode | string]: string;
-    };
+    reload: () => Promise<void>;
     /**
-     * 组件描述
+     * 设置窗口大小
+     * @param width boolean - 窗口宽度
+     * @param height boolean - 窗口高度
+     * @param animate boolean - 是否使用动画（可选）
      */
-    readonly description: {
-        [key: LanguageCode | string]: string;
-    };
+    setSize: (width: number, height: number, animate?: boolean) => Promise<void>;
     /**
-     * 本地组件入口文件，通常为 index.html
+     * 获取窗口大小
+     * @since 24.1.1-beta.6
+     * @returns Promise<number[]>
      */
-    entry: string | 'index.html';
+    getSize: () => Promise<number[]>;
     /**
-     * 远程组件包入口文件
-     * @deprecated
+     * 打开开发者工具
      */
-    remoteEntry?: string;
+    openDevTools: () => Promise<void>;
     /**
-     * 组件包json文件路径
-     * @deprecated
-     * @example https://rtugeek.gitee.io/hotspot/widget.json
+     * 设置窗口位置
+     * @param {SetPositionOptions} options - 配置窗口位置的选项
      */
-    readonly remotePackage?: string;
-    readonly local?: LocalPackageUrlInfo;
-    readonly remote?: RemotePackageUrlInfo;
+    setPosition: (options: SetPositionOptions) => Promise<void>;
     /**
-     * zip package url, used for downloading the package
+     * 获取窗口位置
+     * @returns {Promise<Position>} 返回一个 Promise，解析为窗口的位置
      */
-    zipUrl?: string;
+    getPosition: () => Promise<Position>;
     /**
-     * 组件包图标
+     * 使窗口失去焦点
      */
-    readonly icon?: string;
+    blur: () => Promise<void>;
     /**
-     * Hash路由模式，默认为true
+     * 聚焦窗口
      */
-    readonly hash: boolean;
+    focus: () => Promise<void>;
     /**
-     * 可能是网络地址，或者本地路径（解压后的文件夹路径）,
-     * 网络地址：https://www.bilibili.com
-     * 本地地址：file:///C:/Users/neo/Desktop
-     * 在测试时。地址通常为: http://127.0.0.1:8080
+     * 设置窗口是否可调整大小
+     * @param resizable boolean - 是否可调整大小
      */
-    url: string;
-    readonly widgets: Widget[];
-    readonly pages: Page[];
-    devOptions?: DevOptions;
-    constructor(options: WidgetPackageOptions);
-    static parseJSON(json: string): WidgetPackage;
-    static parseObject(obj: any): WidgetPackage;
+    setResizable: (resizable: boolean) => Promise<void>;
     /**
-     * 获取组件包标题
-     * @param lang 语言环境，不传则获取默认语言
+     * 设置窗口是否可移动
+     * @param movable boolean - 是否可移动
      */
-    getTitle(lang?: LanguageCode): string | undefined;
+    setMovable: (movable: boolean) => Promise<void>;
     /**
-     * 获取组件包描述
-     * @param lang 语言环境，不传则获取默认标题
+     * 获取窗口边界
+     * @returns Promise<Rectangle>
      */
-    getDescription(lang?: LanguageCode): string | undefined;
-}
-interface DevOptions {
-    folder?: string;
-    route?: boolean;
-    devUrl?: string;
-    remoteEntry?: string;
-}
-
-/**
- * WidgetApi 接口定义了一系列用于控制组件的方法，这些方法提供了组件的注册、升级、获取、打开设置页面、重新加载等功能
- */
-interface IWidgetApi {
+    getBounds: () => Promise<Rectangle>;
     /**
-     * 注册组件
-     * @param widgets
+     * 设置窗口边界
+     * @param {Partial<Rectangle>} bounds - 窗口的边界矩形
+     * @param {boolean} animate - 是否启用动画
      */
-    registerWidgets: (widgets: Widget[]) => Promise<void>;
+    setBounds: (bounds: Partial<Rectangle>, animate: boolean) => Promise<void>;
     /**
-     * @deprecated
+     * 将窗口对齐到当前屏幕
+     * @param align string 对齐位置
+     *  <ol>
+     *    <li>'top-left'</li>
+     *    <li>'top-center'</li>
+     *    <li>'top-right'</li>
+     *    <li>'bottom-left'</li>
+     *    <li>'bottom-center'</li>
+     *    <li>'bottom-right'</li>
+     *    </ol>
      */
-    registerWidgetPackage: (widgetPackage: WidgetPackage) => Promise<void>;
+    alignToScreen: (align: AlignPosition) => Promise<void>;
     /**
-     * ignore mouse events
-     * @param widgetId
-     * @param ignore
+     * 检查指定 URL 是否存在
+     * @param {string} url - 要检查的 URL
+     * @return  Promise<boolean>
      */
-    setIgnoreMouseEvents: (widgetId: string, ignore: boolean) => Promise<void>;
+    existsByUrl: (url: string) => Promise<boolean>;
     /**
-     * Check if the widget is ignoring mouse events.
-     * @param widgetId
+     * 获取窗口的最大尺寸
+     * @returns {Promise<number[]>} 返回一个 Promise，解析为一个数组，包含窗口的最大宽度和高度
      */
-    isIgnoreMouseEvents: (widgetId?: string) => Promise<boolean>;
+    getMaximumSize: () => Promise<number[]>;
     /**
-     * 设置组件是否可以左键拖动
-     * @param draggable boolean true-启用左键拖动 false-禁用左键拖动
-     * @remarks 注意：只对悬浮窗组件(DeployMode.OVERLAP)有效
+     * 获取窗口的最小尺寸
+     * @returns {Promise<number[]>} 返回一个 Promise，解析为一个数组，包含窗口的最小宽度和高度
      */
-    setMouseDraggable: (draggable: boolean) => Promise<void>;
+    getMinimumSize: () => Promise<number[]>;
     /**
-     * 升级组件包
-     * @param packageName 组件包名
+     * 设置窗口的最大尺寸
+     * @param {number} width - 最大宽度
+     * @param {number} height - 最大高度
      */
-    upgradePackage: (packageName: string) => Promise<void>;
+    setMaximumSize: (width: number, height: number) => Promise<void>;
     /**
-     * 获取所有组件
-     * @return Promise<Widget[]>
+     * 设置窗口的最小尺寸
+     * @param {number} width - 最大宽度
+     * @param {number} height - 最大高度
+     */
+    setMinimumSize: (width: number, height: number) => Promise<void>;
+    /**
+     * 更改缩放等级 原始尺寸为 0，每升高或将顶代表缩放20%，大和小限制默认分区为 300% 和 50% 缩放公式为 scale := 1.2 ^ level.
+     * @param level number - 缩放等级，默认为 0
+     */
+    setZoomLevel: (level: number) => Promise<void>;
+    /**
+     * 更改缩放倍数 缩放系数是缩放百分比除以 100，即 300% = 3.0
+     * @param factor Double - 缩放系数，默认为 1.0
+     * @remarks 系数必须大于0.0
+     */
+    setZoomFactor: (factor: number) => Promise<void>;
+    /**
+     * Set the proxy config for window. All requests will be sent through the proxy server.
+     * Proxy config will be lost once the window is closed. If you want to set a persistent proxy for widget window, use `DeployWidgetApi.setProxy` instead.
+     * @remarks All links will be disconnected after setting, it is best to refresh the page (window.location.reload())
+     * @param config
+     * @example
+     * ```typescript
+     * BrowserWindowApi.setProxy({
+     *     proxyRules:'socks5://127.0.0.1:7890'
+     * })
+     * ```
      */
-    getWidgets: () => Promise<Widget[]>;
+    setProxy: (config: ProxyConfig) => Promise<void>;
+    getProxy: () => Promise<ProxyConfig | undefined>;
     /**
-     * 通过组件名称获取组件
-     * @param name string 组件名
-     * @return Promise<Widget>
+     * @return Promise<boolean>
      */
-    getWidget: (name: string) => Promise<Widget>;
+    isFocused: () => Promise<boolean>;
     /**
-     * @param name
-     * @deprecated
+     * A top-level window created with this style does not become the foreground window when the user clicks it. The system does not bring this window to the foreground when the user minimizes or closes the foreground window.
+     * The window should not be activated through programmatic access or via keyboard navigation by accessible technology, such as Narrator.
+     * @see [Extended Window Styles](https://learn.microsoft.com/en-us/windows/win32/winmsg/extended-window-styles)
      */
-    getWidgetPackage: (name: string) => Promise<WidgetPackage | undefined>;
+    setNoActivate: () => Promise<void>;
     /**
-     * @deprecated
+     * Controls whether or not this window's WebContents will throttle animations and timers when the page becomes backgrounded. This also affects the Page Visibility API.
+     * @param enabled
+     * @see https://www.electronjs.org/docs/latest/api/web-contents#contentssetbackgroundthrottlingallowed
      */
-    getWidgetPackages: () => Promise<WidgetPackage[]>;
+    setBackgroundThrottling: (enabled: boolean) => Promise<void>;
+    getBackgroundThrottling: () => Promise<boolean>;
     /**
-     * 打开组件设置页面
-     * @param id string 组件id
+     * Makes the window not show in the taskbar.
+     * @param boolean
      */
-    openConfigPage: (id?: string) => Promise<void>;
+    setSkipTaskbar: (boolean: boolean) => Promise<void>;
+}
+
+type BrowserWindowApiMethods = keyof IBrowserWindowApi;
+type AlignPosition = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+interface SetPositionOptions {
+    x?: number;
+    y?: number;
     /**
-     * @param name
+     * Only works on macOS
      */
-    openConfigPageByName: (name: string) => Promise<void>;
+    animation?: boolean;
+}
+declare enum BrowserWindowApiEvent {
+    BLUR = "event::cn.widgetjs.core.browser-window.blur",
+    MOVED = "event::cn.widgetjs.core.browser-window.moved",
+    FOCUS = "event::cn.widgetjs.core.browser-window.focus",
+    CLOSE = "event::cn.widgetjs.core.browser-window.close",
+    SNAP_TO_EDGE = "event::cn.widgetjs.core.browser-window.snap_to_edge",
+    RESIZED = "event::cn.widgetjs.core.browser-window.resized",
+    CANCEL_SNAP_TO_EDGE = "event::cn.widgetjs.core.browser-window.cancel_snap_to_edge"
+}
+interface SetupOptions {
+    width: number;
+    height: number;
+    minWidth?: number;
+    minHeight?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+    resizable?: boolean;
+    movable?: boolean;
+    center?: boolean;
+    alwaysOnTop?: boolean;
+    x?: number;
+    y?: number;
+    skipTaskbar?: boolean;
+}
+declare class BrowserWindowApiImpl extends BaseApi<BrowserWindowApiMethods> implements IBrowserWindowApi {
+    getProxy(): Promise<ProxyConfig | undefined>;
+    setBackgroundThrottling(enabled: boolean): Promise<void>;
+    getBackgroundThrottling(): Promise<boolean>;
+    isResizable(): Promise<boolean>;
+    setHasShadow(hasShadow: boolean): Promise<void>;
+    isDraggingWindow(): Promise<boolean>;
+    setNoActivate(): Promise<void>;
+    isVisible(): Promise<boolean>;
+    getChannel(): string;
+    setIgnoreMouseEvent(ignore: boolean): Promise<void>;
+    show(): Promise<void>;
+    showInactive(): Promise<void>;
+    hide(): Promise<void>;
+    center(): Promise<void>;
+    setAlwaysOnTop(alwaysOnTop: boolean): Promise<void>;
+    isAlwaysOnTop(): Promise<boolean>;
+    openUrl(url: string, option?: BrowserWindowOptions): Promise<void>;
+    moveTop(): Promise<void>;
+    openDevTools(): Promise<void>;
+    setPosition(options: SetPositionOptions): Promise<void>;
+    getPosition(): Promise<Position>;
+    blur(): Promise<any>;
+    focus(): Promise<any>;
     /**
-     * 重新加载组件
+     * 设置窗口是否可以拉伸
+     * @param resizable
      */
-    reload: (id?: string) => Promise<void>;
+    setResizable(resizable: boolean): Promise<any>;
+    getBounds(): Promise<Rectangle>;
+    setBounds(bounds: Partial<Rectangle>, animate?: boolean): Promise<void>;
+    alignToScreen(align: AlignPosition): Promise<any>;
+    startDraggingWindow(): Promise<any>;
+    stopDraggingWindow(): Promise<any>;
     /**
-     *
-     * @param packageName
-     * @deprecated
+     * 通过url检测窗口是否存在
+     * @param url
      */
-    getWidgetPackageUrl: (packageName: string) => Promise<string | null>;
-    restartWidgets: (mode?: DeployMode) => Promise<void>;
-    updateSyncInfo: () => Promise<void>;
-    getSyncInfo: (widgetName?: string) => Promise<WidgetSyncInfo | null>;
+    existsByUrl(url: string): Promise<boolean>;
+    getMaximumSize(): Promise<number[]>;
+    minimize(): Promise<void>;
+    maximize(): Promise<void>;
+    isMaximized(): Promise<boolean>;
+    isMinimized(): Promise<boolean>;
+    restore(): Promise<void>;
+    unmaximize(): Promise<void>;
+    setZoomLevel(level: number): Promise<void>;
+    reload(): Promise<void>;
+    setMovable(movable: boolean): Promise<void>;
+    setSize(width: number, height: number, animate?: boolean): Promise<void>;
+    isFocused(): Promise<boolean>;
+    setMaximumSize(width: number, height: number): Promise<void>;
+    setMinimumSize(width: number, height: number): Promise<void>;
+    getMinimumSize(): Promise<number[]>;
+    close(): Promise<void>;
+    setZoomFactor(factor: number): Promise<void>;
+    setup(options: SetupOptions): Promise<void>;
+    setProxy(config: Electron.Config): Promise<void>;
+    getSize(): Promise<number[]>;
+    setSkipTaskbar(skip: boolean): Promise<void>;
 }
+declare const BrowserWindowApi: BrowserWindowApiImpl;
 
-type WidgetApiMethods = keyof IWidgetApi;
-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"
-}
-declare class WidgetApiImpl extends BaseApi<WidgetApiMethods> implements IWidgetApi {
-    getSyncInfo(widgetName?: string): Promise<WidgetSyncInfo | null>;
-    updateSyncInfo(): Promise<void>;
-    reload(id?: string): Promise<void>;
-    getChannel(): string;
-    registerWidgets(widgets: Widget[]): Promise<any>;
-    registerWidgetPackage(widgetPackage: WidgetPackage): Promise<any>;
-    getWidgets(): Promise<Widget[]>;
-    openConfigPage(widgetId?: string): Promise<any>;
-    openConfigPageByName(widgetName: string): Promise<any>;
+/**
+ * BroadcastApi provides the ability to send and listen to broadcast events,
+ * typically used for component packages to listen for system or application events,
+ * or for communication and data transfer between component packages.
+ */
+interface IBroadcastApi {
     /**
-     * @deprecated
+     * send broadcast event
+     * @param event
      */
-    getWidgetPackages(): Promise<WidgetPackage[]>;
+    send: (event: BroadcastEvent) => Promise<void>;
     /**
-     *
-     * @param name package name
+     * register listener for broadcast event
+     * @param event
      */
-    getWidget(name: string): Promise<Widget>;
+    register: (...event: BroadcastEventType[]) => Promise<void>;
     /**
-     * @param name package name
-     * @deprecated
+     * Unregister broadcast event
+     * @param event
      */
-    getWidgetPackage(name: string): Promise<WidgetPackage | undefined>;
-    getWidgetPackageUrl(packageName: string): Promise<string | null>;
-    upgradePackage(packageName: string): Promise<void>;
+    unregister: (...event: BroadcastEventType[]) => Promise<void>;
+}
+
+type BroadcastEventType = string | WidgetApiEvent | BrowserWindowApiEvent | ShortcutApiEvent | ClipboardApiEvent | MouseApiEvent;
+type BroadcastApiMethods = keyof IBroadcastApi;
+declare const BroadcastApi: IBroadcastApi;
+
+declare enum Channel {
+    NOTIFICATION = "channel::cn.widgetjs.core.notification",
+    BROWSER_WINDOW = "channel::cn.widgetjs.core.browser_window",
+    BROADCAST = "channel::cn.widgetjs.core.broadcast",
+    WIDGET = "channel::cn.widgetjs.core.widget",
+    WIDGET_PACKAGE = "channel::cn.widgetjs.core.widget.package",
+    DEPLOYED_WIDGET = "channel::cn.widgetjs.core.deployed_widget",
+    APP = "channel::cn.widgetjs.core.app",
+    SYSTEM = "channel::cn.widgetjs.core.system",
+    DIALOG = "channel::cn.widgetjs.core.dialog",
+    HTTP = "channel::cn.widgetjs.core.http",
+    CLIPBOARD = "channel::cn.widgetjs.core.clipboard",
+    FILE = "channel::cn.widgetjs.core.file",
+    SCREEN = "channel::cn.widgetjs.core.screen",
+    MENU = "channel::cn.widgetjs.core.menu",
+    SHORTCUT = "channel::cn.widgetjs.core.shortcut",
+    LOG = "channel::cn.widgetjs.core.log",
+    DEVICE = "channel::cn.widgetjs.core.device",
+    MOUSE = "channel::cn.widgetjs.core.mouse",
+    KEYBOARD = "channel::cn.widgetjs.core.keyboard",
     /**
-     * 阻止拖动窗口，只能用于悬浮窗口 DeployMode.OVERLAP
-     * @param draggable
+     * @deprecated
      */
-    setMouseDraggable(draggable: boolean): Promise<void>;
-    isIgnoreMouseEvents(widgetId: string | undefined): Promise<boolean>;
-    setIgnoreMouseEvents(widgetId: string, ignore: boolean): Promise<void>;
-    restartWidgets(mode?: DeployMode): Promise<void>;
+    STORE = "channel::cn.widgetjs.core.store",
+    STORAGE = "channel::cn.widgetjs.core.storage",
+    PROCESS = "channel::cn.widgetjs.core.process",
+    USER = "channel::cn.widgetjs.core.user",
+    TRAY = "channel::cn.widgetjs.core.tray",
+    AI = "channel::cn.widgetjs.core.ai"
 }
-declare const WidgetApi: WidgetApiImpl;
 
-declare class ApiConstants {
-    static readonly CONFIG_LAUNCH_AT_STARTUP = "CONFIG_LAUNCH_AT_STARTUP";
-    static readonly CONFIG_WIDGET_TITLE_COLOR = "CONFIG_WIDGET_TITLE_COLOR";
-    static readonly CONFIG_DEBUG_MODE = "cn.widgetjs.config.debug";
-    static readonly CONFIG_GRID_CELL_SIZE = "cn.widgetjs.config.grid.size";
-    static readonly SHORTCUT_PIN_DESKTOP_WIDGETS = "cn.widgetjs.config.shortcut.pin_desktop_widgets";
-}
-declare class AppEvent {
-    static readonly LANGUAGE_CHANGED = "event::cn.widgetjs.core.app.language.changed";
+type DeviceApiMethods = keyof IDeviceApi;
+declare const DeviceApi: IDeviceApi;
+
+declare const DialogApi: IDialogApi;
+
+declare class ElectronApi {
+    static addIpcListener(key: string, f: Function): Promise<void>;
+    static removeIpcListener(key: string): Promise<void>;
 }
-declare class AppConfig {
-    static readonly LANGUAGE = "cn.widgetjs.config.app.language";
-    static readonly LAUNCH_AT_STARTUP = "CONFIG_LAUNCH_AT_STARTUP";
+
+interface IHttpApi {
+    /**
+     * Simple HTTP GET request
+     * @param url
+     * @param params
+     */
+    get: (url: string, params?: Record<string, any>) => Promise<string>;
+    /**
+     * Simple HTTP POST request
+     * @param url
+     * @param params
+     */
+    post: (url: string, data?: Record<string, any>) => Promise<string>;
 }
+type HttpApiMethods = keyof IHttpApi;
+
+declare const HttpApi: IHttpApi;
+
+declare const LogApi: ILogApi;
+
+declare const MouseApi: IMouseApi;
 
 /**
- * ShortcutApi 提供了注册快捷键的能力，当快捷键被触发时，会发送广播事件 {@link BroadcastEvent}
+ * NotificationApi提供了发送通知的能力
  */
-interface IShortcutApi {
+interface INotificationApi {
     /**
-     * 注册快捷键, 如果注册成功, 触发快捷键时，会发送广播事件 {@link BroadcastEvent}
-     * @see [Electron Accelerator](https://www.electronjs.org/docs/latest/api/accelerator)
-     * @param shortcut string
-     * @return Promise<boolean> true 注册成功，false 注册失败
-     * @example
-     * ```typescript
-     * //Meta 通常为windows键
-     * ShortcutApi.register('Ctrl+Meta+Y')
-     * ```
+     * 发送自定义通知
+     * @param notification
      */
-    register: (shortcut: string) => Promise<boolean>;
+    send: (notification: AppNotification) => Promise<void>;
     /**
-     * 注销快捷键
-     * @param shortcut string
-     * @example
-     * ```typescript
-     * //Meta 通常为windows键
-     * ShortcutApi.unregister('Ctrl+Meta+Y')
-     * ```
+     * 隐藏通知
      */
-    unregister: (shortcut: string) => void;
-}
-/**
- * ShortcutApiEvent
- */
-declare enum ShortcutApiEvent {
+    hide: () => Promise<void>;
     /**
-     * 快捷键触发事件
+     * @param message string
+     * @param duration number  持续时间，单位毫秒，默认5000
      */
-    TRIGGERED = "channel::cn.widgetjs.core.shortcut.triggered"
-}
-
-type ShortcutApiMethods = keyof IShortcutApi;
-declare const ShortcutApi: IShortcutApi;
-
-interface BroadcastEventOptions {
-    event: WidgetApiEvent | AppApiEvent | string;
+    success: (message: string, duration?: number) => Promise<void>;
     /**
-     * 发送人，用于标记发送源，一般为组件名，如：com.example.widgets.countdown
+     * @param message string
+     * @param duration number  持续时间，单位毫秒，默认5000
      */
-    sender?: string;
+    error: (message: string, duration?: number) => Promise<void>;
     /**
-     * 广播事件携带的数据，只支持部分数据类型。
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm
+     * @param message string
+     * @param duration number  持续时间，单位毫秒，默认5000
      */
-    payload?: any;
-}
-declare class BroadcastEvent {
-    readonly event: string;
-    readonly sender?: string;
-    payload?: any;
-    constructor(options: BroadcastEventOptions);
-}
-
-/**
- * BroadcastApi provides the ability to send and listen to broadcast events,
- * typically used for component packages to listen for system or application events,
- * or for communication and data transfer between component packages.
- */
-interface IBroadcastApi {
+    warning: (message: string, duration?: number) => Promise<void>;
     /**
-     * send broadcast event
-     * @param event
+     * @param message string
+     * @param duration number  持续时间，单位毫秒，默认5000
      */
-    send: (event: BroadcastEvent) => Promise<void>;
+    info: (message: string, duration?: number) => Promise<void>;
+    reminder: (option: ReminderNotificationOption) => Promise<void>;
+}
+
+type NotificationApiMethods = keyof INotificationApi;
+declare enum NotificationApiEvent {
+    CONFIRM = "event::cn.widgetjs.core.notification.confirm",
+    CANCEL = "event::cn.widgetjs.core.notification.cancel",
+    HIDE = "event::cn.widgetjs.core.notification.hide"
+}
+declare class NotificationApiImpl extends BaseApi<NotificationApiMethods> implements INotificationApi {
     /**
-     * register listener for broadcast event
-     * @param event
+     * 来电
+     * @param avatar    头像地址
+     * @param audio     音频地址
+     * @param title     标题文件
+     * @param message   初始消息
+     * @param lyric     歌词字符串
      */
-    register: (...event: BroadcastEventType[]) => Promise<void>;
+    call(avatar: string, audio: string, title: string, message: string, lyric: string): Promise<void>;
+    send(notification: AppNotification): Promise<any>;
+    reminder(option: ReminderNotificationOption): Promise<any>;
+    advanceCountdown(message: string, targetTime: string, title?: string): Promise<any>;
+    countdown(message: string, targetTime: string): Promise<void>;
+    success(message: string, duration?: number): Promise<void>;
+    error(message: string, duration?: number): Promise<void>;
+    warning(message: string, duration?: number): Promise<void>;
+    info(message: string, duration?: number): Promise<void>;
     /**
-     * Unregister broadcast event
-     * @param event
+     * 隐藏通知
      */
-    unregister: (...event: BroadcastEventType[]) => Promise<void>;
+    hide(): Promise<void>;
+    getChannel(): string;
 }
-
-type BroadcastEventType = string | WidgetApiEvent | BrowserWindowApiEvent | ShortcutApiEvent | ClipboardApiEvent | MouseApiEvent;
-type BroadcastApiMethods = keyof IBroadcastApi;
-declare const BroadcastApi: IBroadcastApi;
+declare const NotificationApi: NotificationApiImpl;
 
 declare const ProcessApi: IProcessApi;
 
-declare const AppApi: IAppApi;
-
-declare const DialogApi: IDialogApi;
-
 type BaseType = string | number | boolean;
 /**
  * StorageApi 接口定义了用于存储和检索数据的方法，包括加密和解密功能。
@@ -3802,54 +3874,226 @@ declare const StorageApi: IStorageApi;
  */
 declare const StoreApi: IStoreApi;
 
-declare const LogApi: ILogApi;
-
 /**
  *
  * SystemApi provides functionality for retrieving system information or interacting with the system.
  */
 interface ISystemApi {
     /**
-     * Get system wallpaper absolute path
+     * Get system wallpaper absolute path
+     */
+    getWallpaper: () => Promise<string>;
+    /**
+     * Get system information based on the provided valuesObject. The valuesObject can contain specific keys to retrieve certain information.
+     * @param valuesObject
+     * @see   https://systeminformation.io/general.html
+     */
+    getInfo: (valuesObject: any) => Promise<any>;
+    /**
+     * Get system uptime in seconds
+     * @return Promise<number>
+     */
+    getUptime: () => Promise<number>;
+    /**
+     * Launches the full product details page (PDP) for a product at Microsoft Store.
+     * @see   https://learn.microsoft.com/en-us/windows/apps/develop/launch/launch-store-app
+     * @param storeId
+     */
+    launchStoreDetailsPage: (storeId?: string) => Promise<void>;
+    /**
+     * @see https://learn.microsoft.com/en-us/windows/apps/develop/launch/launch-settings-app
+     * @param uri Use this URI scheme to launch the Windows Settings app to specific settings pages.
+     * @example ms-settings:defaultapps
+     * @example ms-settings:startupapps
+     */
+    launchWindowsSettings: (uri: string) => Promise<void>;
+}
+/**
+ * SystemApiEvent
+ */
+declare enum SystemApiEvent {
+    /**
+     * Date changed event
+     */
+    DATE_CHANGED = "event::cn.widgetjs.core.sys.date.changed"
+}
+
+type SystemApiMethods = keyof ISystemApi;
+declare const SystemApi: ISystemApi;
+
+declare const TrayApi: ITrayApi;
+
+declare const UserApi: IUserApi;
+
+/**
+ * @deprecated 已迁移到 AppTheme
+ */
+interface IWidgetTheme {
+    /**
+     * 是否使用全局主题，
+     * 默认true
+     */
+    useGlobalTheme?: boolean;
+    borderRadius?: CSS.Properties['borderRadius'];
+    backgroundColor?: CSS.Properties['color'];
+    /**
+     * 背景边框颜色
+     */
+    backgroundBorderColor?: CSS.Properties['color'];
+    backgroundBoxShadowColor?: CSS.Properties['color'];
+    fontSize?: CSS.Properties['fontSize'];
+    dividerColor?: CSS.Properties['color'];
+    /**
+     * 主色调
+     */
+    primaryColor?: CSS.Properties['color'];
+    /**
+     * 文字颜色
+     */
+    color?: CSS.Properties['color'];
+    fontFamily?: CSS.Properties['fontFamily'];
+    shadowColor?: CSS.Properties['color'];
+    padding?: CSS.Properties['padding'];
+    borderColor?: CSS.Properties['borderColor'];
+}
+type WidgetThemeProperty = keyof IWidgetTheme;
+/**
+ * @deprecated 已迁移到 AppTheme
+ */
+declare class WidgetTheme implements IWidgetTheme {
+    borderRadius?: CSS.Properties['borderRadius'];
+    backgroundColor?: CSS.Properties['color'];
+    fontSize?: CSS.Properties['fontSize'];
+    dividerColor?: CSS.Properties['color'];
+    /**
+     * 主色调
+     */
+    primaryColor?: CSS.Properties['color'];
+    backgroundBorderColor?: CSS.Properties['color'];
+    backgroundBoxShadowColor?: CSS.Properties['color'];
+    /**
+     * 文字颜色
+     */
+    color?: CSS.Properties['color'];
+    fontFamily?: CSS.Properties['fontFamily'];
+    shadowColor?: CSS.Properties['color'];
+    padding?: CSS.Properties['padding'];
+    borderColor?: CSS.Properties['borderColor'];
+    useGlobalTheme?: boolean;
+    constructor(options?: IWidgetTheme | string);
+    static fromJSON(json: string): WidgetTheme;
+    /**
+     * Injects the style properties as css variable.
+     * @param selector default is 'body'
+     */
+    toCSS(selector?: string): string;
+    /**
+     * Injects the style properties as css variable.
+     * @param rootElement The rootElement to inject the css.
+     * @remarks Only works in a browser environment.
+     */
+    injectCSS(rootElement?: HTMLElement): void;
+    removeCSS(rootElement?: HTMLElement): void;
+    copy(options?: IWidgetTheme): WidgetTheme;
+    /**
+     * Gets the style properties from the widget's style object.
+     * @returns A record representing CSS custom variable and their values.
+     */
+    toCSSVariable(): Record<string, string>;
+    toCSSProperties(): Record<string, string>;
+    static fromCSS(css: string): WidgetTheme;
+}
+type WidgetThemeKey = keyof WidgetTheme;
+/**
+ * Widget default theme, this object is immutable. Clone it before use.
+ */
+declare const DefaultWidgetTheme: WidgetTheme;
+
+/**
+ * 组件配置数据，用于存储组件自定义页面所设置的数据
+ * @deprecated
+ */
+declare class WidgetData {
+    /**
+     * 组件id
+     */
+    id?: string;
+    /**
+     * 组件名
      */
-    getWallpaper: () => Promise<string>;
+    name: string;
     /**
-     * Get system information based on the provided valuesObject. The valuesObject can contain specific keys to retrieve certain information.
-     * @param valuesObject
-     * @see   https://systeminformation.io/general.html
+     * 背景颜色
+     * @deprecated
      */
-    getInfo: (valuesObject: any) => Promise<any>;
+    backgroundColor?: string;
     /**
-     * Get system uptime in seconds
-     * @return Promise<number>
+     * 文字颜色
+     * @deprecated
      */
-    getUptime: () => Promise<number>;
+    color?: string;
     /**
-     * Launches the full product details page (PDP) for a product at Microsoft Store.
-     * @see   https://learn.microsoft.com/en-us/windows/apps/develop/launch/launch-store-app
-     * @param storeId
+     * 字体大小
+     * @deprecated
      */
-    launchStoreDetailsPage: (storeId?: string) => Promise<void>;
+    fontSize?: number;
     /**
-     * @see https://learn.microsoft.com/en-us/windows/apps/develop/launch/launch-settings-app
-     * @param uri Use this URI scheme to launch the Windows Settings app to specific settings pages.
-     * @example ms-settings:defaultapps
-     * @example ms-settings:startupapps
+     * 字体
+     * @deprecated
      */
-    launchWindowsSettings: (uri: string) => Promise<void>;
+    fontFamily?: string;
+    /**
+     * 圆角半径
+     * @deprecated
+     */
+    borderRadius?: number;
+    /**
+     * 组件样式
+     * @deprecated
+     */
+    theme: WidgetTheme;
+    constructor(name: string, id?: string);
+    parseJSON(json: any): void;
+    /**
+     * Gets the style properties from the widget's style object.
+     * @returns A record representing CSS custom properties and their values.
+     */
+    getThemeProperties(): Record<string, string>;
+    /**
+     * Injects the style properties as css variable.
+     * @remarks Only works in a browser environment.
+     */
+    injectThemeProperties(): void;
+}
+
+interface SaveWidgetOption {
+    sendBroadcast?: boolean;
+    id?: string;
+    storeName?: string;
 }
 /**
- * SystemApiEvent
+ * 用户处理浏览器数据，只在浏览器环境下有用
+ * @deprecated
  */
-declare enum SystemApiEvent {
+interface IWidgetDataApi {
+    findByName: (<T extends WidgetData>(name: string, type: {
+        new (name: string, id?: string): T;
+    }) => Promise<T | undefined>) & (<T extends WidgetData>(data: T) => Promise<T | undefined>);
+    save: (data: WidgetData, options?: SaveWidgetOption) => Promise<string>;
     /**
-     * Date changed event
+     * 获取组件 LocalForage 存储实例
+     * @param widgetName  组件名
+     * @param storeName   存储名
+     * @see https://localforage.docschina.org/
      */
-    DATE_CHANGED = "event::cn.widgetjs.core.sys.date.changed"
+    getStore: (widgetName: string, storeName?: string) => LocalForage;
+    saveByName: <T extends WidgetData>(data: T, options?: SaveWidgetOption) => Promise<string>;
+    find: <T extends WidgetData>(name: string, id: string, type: {
+        new (name: string, id?: string): T;
+    }) => Promise<T | undefined>;
 }
-
-type SystemApiMethods = keyof ISystemApi;
-declare const SystemApi: ISystemApi;
+type WidgetDataApiMethods = keyof IWidgetDataApi;
+declare const WidgetDataApi: IWidgetDataApi;
 
 declare class WidgetPackageApiImpl extends BaseApi<WidgetPackageApiMethods> implements IWidgetPackageApi {
     getChannel(): string;
@@ -3867,145 +4111,30 @@ declare class WidgetPackageApiImpl extends BaseApi<WidgetPackageApiMethods> impl
 }
 declare const WidgetPackageApi: WidgetPackageApiImpl;
 
-declare const MouseApi: IMouseApi;
-
-interface IHttpApi {
-    /**
-     * Simple HTTP GET request
-     * @param url
-     * @param params
-     */
-    get: (url: string, params?: Record<string, any>) => Promise<string>;
-    /**
-     * Simple HTTP POST request
-     * @param url
-     * @param params
-     */
-    post: (url: string, data?: Record<string, any>) => Promise<string>;
-}
-type HttpApiMethods = keyof IHttpApi;
-
-declare const HttpApi: IHttpApi;
-
-declare const UserApi: IUserApi;
-
-declare const TrayApi: ITrayApi;
-
-declare const AiApi: IAiApi;
-
-/**
- * @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[];
+interface BroadcastEventOptions {
+    event: WidgetApiEvent | AppApiEvent | string;
     /**
-     * @deprecated
+     * 发送人，用于标记发送源，一般为组件名，如：com.example.widgets.countdown
      */
-    routes?: WidgetRoute[];
+    sender?: string;
     /**
-     * 一般用于填写教程链接
+     * 广播事件携带的数据，只支持部分数据类型。
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm
      */
-    socialLinks?: SocialLink[];
-    browserWindowOptions?: Pick<BrowserWindowOptions, 'backgroundThrottling'>;
-    trayOptions?: TrayWidgetOptions;
+    payload?: any;
 }
-interface IBackgroundWidgetOptions extends Omit<IWidgetOptions, 'width' | 'height'> {
-    width?: number;
-    height?: number;
-    browserWindowOptions?: BrowserWindowOptions;
+declare class BroadcastEvent {
+    readonly event: string;
+    readonly sender?: string;
+    payload?: any;
+    constructor(options: BroadcastEventOptions);
 }
-/**
- * @deprecated
- */
-interface WidgetRoute {
-    url: string;
+
+interface NativeKeyboardEvent {
     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"
+    keyCode: number;
+    scanCode: number;
+    isKeyUp: boolean;
 }
 
 declare enum WebSocketEventType {
@@ -4017,28 +4146,6 @@ declare class WebSocketEvent {
     constructor(type: WebSocketEventType, payload: any);
 }
 
-interface NativeKeyboardEvent {
-    name: string;
-    keyCode: number;
-    scanCode: number;
-    isKeyUp: boolean;
-}
-
-interface AppMouseEvent {
-    handled: boolean;
-    wheelScrolled: boolean;
-    clicked: boolean;
-    isMouseButtonDown: boolean;
-    isMouseButtonUp: boolean;
-    timestamp: number;
-    button: number;
-    clicks: number;
-    x: number;
-    y: number;
-    delta: number;
-    location: string;
-}
-
 interface WidgetSyncInfo {
     widgetName: string;
     latestSyncTime: Date;
@@ -4491,4 +4598,4 @@ declare class GridSystem extends GridRect {
     getHeight(): number;
 }
 
-export { type AddTrayOptions, type AddWidgetOption, AiApi, AiApiEvent, type AiApiMethods, type AiConfig, type AlignPosition, ApiConstants, AppApi, AppApiConstants, AppApiEvent, type AppApiMethods, AppConfig, AppEvent, type AppMouseEvent, AppNotification, AppReminderNotification, type AppRoutes, type AppRuntimeInfo, 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, 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 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, ThemeMode, 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 };