@e-xi/xion 0.0.6

package/dist/main/theme/theme-manager-abstract.d.ts

@@ -0,0 +1,93 @@
+import type { XoAppAbstract } from '../app/xo-app-abstract';
+import type { AppStore } from '../store/app-store';
+/**
+ * 主题管理器抽象类
+ * @class ThemeManagerAbstract
+ */
+export declare abstract class ThemeManagerAbstract {
+    /**
+     * Xion 应用
+     * @type {XoAppAbstract}
+     * @protected
+     */
+    protected readonly xoApp: XoAppAbstract;
+    /**
+     * 是否已初始化
+     * @private
+     */
+    private initialized;
+    /**
+     * 构造函数
+     * @param {XoAppAbstract} xoApp Xion 应用
+     */
+    constructor(xoApp: XoAppAbstract);
+    /**
+     * 获取 App 设置存储
+     * @returns {AppStore}
+     */
+    protected getAppStore(): AppStore;
+    /**
+     * 初始化主题
+     * @returns {boolean}
+     */
+    initialize(): boolean;
+    /**
+     * 设置APP主题和主题缓存
+     * @param {XoTheme.Source} themeSource 主题来源
+     */
+    setSource(themeSource: XoTheme.Source): void;
+    /**
+     * 获取主题状态
+     * @returns {XoTheme.State}
+     */
+    getState(window?: Electron.BrowserWindow): XoTheme.State;
+    /**
+     * 是否启用标题栏覆盖
+     * @param {Electron.BrowserWindow} window 窗口
+     * @returns {boolean}
+     * @protected
+     */
+    protected titleBarOverlayEnabled(window?: Electron.BrowserWindow): boolean;
+    /**
+     * 标题栏覆盖配置
+     * @param {Electron.BrowserWindow} window 窗口
+     * @returns {Electron.TitleBarOverlayOptions}
+     * @protected
+     */
+    titleBarOverlay(window?: Electron.BrowserWindow): Electron.TitleBarOverlayOptions;
+    /**
+     * 配置中的标题栏覆盖配置
+     * @param {Electron.BrowserWindow} window 窗口
+     * @returns {Electron.TitleBarOverlayOptions}
+     * @protected
+     */
+    protected configuredTitleBarOverlay(window?: Electron.BrowserWindow): Electron.TitleBarOverlayOptions;
+    /**
+     * 同步主题到窗口和渲染进程
+     */
+    syncToAllWindows(): void;
+    /**
+     * 同步主题到指定窗口和渲染进程
+     * @param {Electron.BrowserWindow} window 窗口
+     */
+    syncToWindow(window: Electron.BrowserWindow): void;
+    /**
+     * 更新窗口主题
+     * @param {Electron.BrowserWindow} window 窗口
+     * @protected
+     */
+    protected updateWindowTheme(window: Electron.BrowserWindow): void;
+    /**
+     * 是否需要透明窗口背景
+     * @param {Electron.BrowserWindow} window 窗口
+     * @returns {boolean}
+     * @protected
+     */
+    protected needsTransparentBackground(window: Electron.BrowserWindow): boolean;
+    /**
+     * 通知渲染进程主题已更新
+     * @param {Electron.BrowserWindow} window 窗口
+     * @protected
+     */
+    protected notifyWindow(window: Electron.BrowserWindow): void;
+}

package/dist/main/theme/theme-manager.d.ts

@@ -0,0 +1,7 @@
+import { ThemeManagerAbstract } from './theme-manager-abstract';
+/**
+ * Xion 默认主题管理器
+ * @class ThemeManager
+ */
+export declare class ThemeManager extends ThemeManagerAbstract {
+}

package/dist/main/theme/types/theme.d.ts

@@ -0,0 +1,38 @@
+import type {ThemeSources} from '../consts/theme-sources'
+
+declare global {
+
+    // Theme
+    namespace XoTheme {
+
+        // 主题源
+        type Source = typeof ThemeSources[number]
+
+        // 主题状态
+        interface State {
+            // 主题来源
+            themeSource: Source
+            // 是否应使用深色
+            shouldUseDarkColors: boolean
+            // 是否启用原生标题栏覆盖
+            titleBarOverlayEnabled: boolean
+            // 当前标题栏覆盖配置
+            titleBarOverlay: Electron.TitleBarOverlayOptions
+            // 当前标题栏配置背景色
+            titleBarOverlayBackground?: string
+        }
+
+        // 主题更新监听器
+        type UpdatedListener = (state: State) => void
+
+        // 标题栏覆盖配置
+        interface TitleBarOverlayConfig {
+            // 浅色主题标题栏覆盖配置
+            light?: Electron.TitleBarOverlayOptions
+            // 深色主题标题栏覆盖配置
+            dark?: Electron.TitleBarOverlayOptions
+        }
+    }
+}
+
+export {}

package/dist/main/tray/consts/tray-animation-name.d.ts

@@ -0,0 +1 @@
+export declare const TrayAnimationNamePrefix: "TrayAnimation_";

package/dist/main/tray/consts/tray-icon-name.d.ts

@@ -0,0 +1 @@
+export declare const TrayIconNamePrefix: "TrayIcon_";

package/dist/main/tray/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './consts/tray-animation-name';
+export * from './consts/tray-icon-name';
+export * from './tray-animation';
+export * from './tray-icon';
+export * from './tray-lifecycle-abstract';
+export * from './tray-lifecycle';
+export * from './tray-manager';
+export type * from './types/tray';

package/dist/main/tray/index.js

@@ -0,0 +1,27 @@
+import {
+  TrayAnimationNamePrefix,
+  TrayIconNamePrefix
+} from "../../chunk-files/chunk-3R6EJDYR.js";
+import {
+  TrayAnimation,
+  TrayIcon,
+  TrayManager
+} from "../../chunk-files/chunk-D5ZV4VMI.js";
+import "../../chunk-files/chunk-EQTU45UO.js";
+import "../../chunk-files/chunk-YLZRRUY7.js";
+import {
+  TrayLifecycle,
+  TrayLifecycleAbstract
+} from "../../chunk-files/chunk-Q7YMMN7J.js";
+import "../../chunk-files/chunk-DEODEAKM.js";
+import "../../chunk-files/chunk-Y3OEXVQ2.js";
+import "../../chunk-files/chunk-RODB64YF.js";
+export {
+  TrayAnimation,
+  TrayAnimationNamePrefix,
+  TrayIcon,
+  TrayIconNamePrefix,
+  TrayLifecycle,
+  TrayLifecycleAbstract,
+  TrayManager
+};

package/dist/main/tray/tray-animation.d.ts

@@ -0,0 +1,48 @@
+import { TrayIcon } from './tray-icon';
+/**
+ * Xion 托盘动画
+ * @class TrayAnimation
+ */
+export declare class TrayAnimation {
+    /**
+     * 托盘配置
+     * @type {XoTray.Config | undefined}
+     * @private
+     */
+    private readonly config?;
+    /**
+     * 托盘图标
+     * @type {TrayIcon}
+     * @private
+     */
+    private readonly trayIcon;
+    /**
+     * 构造函数
+     * @param {XoTray.Config} config   托盘配置
+     * @param {TrayIcon}      trayIcon 托盘图标
+     */
+    constructor(config?: XoTray.Config, trayIcon?: TrayIcon);
+    /**
+     * 内置动画集合
+     * @returns {Record<XoTray.BuiltInAnimationName, XoTray.Animation>}
+     */
+    builtInAnimations(): Record<XoTray.BuiltInAnimationName, XoTray.Animation>;
+    /**
+     * 创建动画映射表
+     * @returns {Map<XoTray.AnimationName, XoTray.Animation>}
+     */
+    toMap(): Map<XoTray.AnimationName, XoTray.Animation>;
+    /**
+     * 获取动画
+     * @param {XoTray.AnimationName} name 动画名称
+     * @returns {XoTray.Animation | undefined}
+     */
+    getAnimation(name: XoTray.AnimationName): XoTray.Animation | undefined;
+    /**
+     * 解析动画帧
+     * @param {XoTray.AnimationName} name             动画名称
+     * @param {XoTray.IconName}      fallbackIconName 回退图标名称
+     * @returns {XoTray.Icon[]}
+     */
+    resolveFrames(name: XoTray.AnimationName, fallbackIconName: XoTray.IconName): XoTray.Icon[];
+}

package/dist/main/tray/tray-icon.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Xion 托盘图标
+ * @class TrayIcon
+ */
+export declare class TrayIcon {
+    /**
+     * 托盘配置
+     * @type {XoTray.Config | undefined}
+     * @private
+     */
+    private readonly config?;
+    /**
+     * 构造函数
+     * @param {XoTray.Config} config 托盘配置
+     */
+    constructor(config?: XoTray.Config);
+    /**
+     * 内置图标键值表
+     * @returns {Record<XoTray.BuiltInIconName, string>}
+     */
+    builtInIcons(): Record<XoTray.BuiltInIconName, string>;
+    /**
+     * 创建图标映射表
+     * @returns {Map<XoTray.IconName, XoTray.Icon>}
+     */
+    toMap(): Map<XoTray.IconName, XoTray.Icon>;
+    /**
+     * 解析图标
+     * @param {XoTray.IconName} name 图标名称
+     * @returns {XoTray.Icon|undefined}
+     */
+    resolve(name?: XoTray.IconName): XoTray.Icon | undefined;
+    /**
+     * 解析图标
+     * @param {XoTray.IconName} name 图标名称
+     * @returns {XoTray.Icon}
+     */
+    requireResolve(name: XoTray.IconName): XoTray.Icon;
+    /**
+     * 转换成 NativeImage
+     * @param {XoTray.Icon} icon 图标
+     * @returns {Electron.NativeImage}
+     */
+    toNativeImage(icon: XoTray.Icon): Electron.NativeImage;
+    /**
+     * 判断图标是否可用
+     * @param {XoTray.Icon | undefined} icon 图标
+     * @returns {boolean}
+     */
+    valid(icon?: XoTray.Icon): boolean;
+}

package/dist/main/tray/tray-lifecycle-abstract.d.ts

@@ -0,0 +1,154 @@
+import type { XoAppAbstract } from '../app/xo-app-abstract';
+/**
+ * Xion 托盘生命周期抽象类
+ * @class TrayLifecycleAbstract
+ */
+export declare abstract class TrayLifecycleAbstract {
+    /**
+     * Xion 应用
+     * @type {XoAppAbstract}
+     * @protected
+     */
+    protected readonly xoApp: XoAppAbstract;
+    /**
+     * 托盘实例
+     * @type {Electron.Tray}
+     * @protected
+     */
+    protected readonly tray: Electron.Tray;
+    /**
+     * 构造函数
+     * @param {XoAppAbstract}  xoApp Xion 应用
+     * @param {Electron.Tray} tray  托盘实例
+     */
+    constructor(xoApp: XoAppAbstract, tray: Electron.Tray);
+    /**
+     * 托盘创建前
+     * @returns {Promise<void>}
+     */
+    beforeCreated(): Promise<void>;
+    /**
+     * 托盘创建后
+     * @returns {Promise<void>}
+     */
+    afterCreated(): Promise<void>;
+    /**
+     * 单击托盘
+     * @param {Electron.Rectangle}     bounds   托盘区域
+     * @param {Electron.Point}         position 鼠标位置
+     * @param {Electron.KeyboardEvent} event    事件对象
+     * @returns {Promise<void>}
+     */
+    onClick(bounds: Electron.Rectangle, position: Electron.Point, event: Electron.KeyboardEvent): Promise<void>;
+    /**
+     * 双击托盘
+     * @param {Electron.Rectangle}     bounds 托盘区域
+     * @param {Electron.KeyboardEvent} event  事件对象
+     * @returns {Promise<void>}
+     */
+    onDoubleClick(bounds: Electron.Rectangle, event: Electron.KeyboardEvent): Promise<void>;
+    /**
+     * 右键点击托盘
+     * @param {Electron.Rectangle}     bounds 托盘区域
+     * @param {Electron.KeyboardEvent} event  事件对象
+     * @returns {Promise<void>}
+     */
+    onRightClick(bounds: Electron.Rectangle, event: Electron.KeyboardEvent): Promise<void>;
+    /**
+     * 中键点击托盘
+     * @param {Electron.Rectangle}     bounds 托盘区域
+     * @param {Electron.KeyboardEvent} event  事件对象
+     * @returns {Promise<void>}
+     */
+    onMiddleClick(bounds: Electron.Rectangle, event: Electron.KeyboardEvent): Promise<void>;
+    /**
+     * 托盘鼠标按下
+     * @param {Electron.Point}         position 鼠标位置
+     * @param {Electron.KeyboardEvent} event    事件对象
+     * @returns {Promise<void>}
+     */
+    onMouseDown(position: Electron.Point, event: Electron.KeyboardEvent): Promise<void>;
+    /**
+     * 托盘鼠标抬起
+     * @param {Electron.Point}         position 鼠标位置
+     * @param {Electron.KeyboardEvent} event    事件对象
+     * @returns {Promise<void>}
+     */
+    onMouseUp(position: Electron.Point, event: Electron.KeyboardEvent): Promise<void>;
+    /**
+     * 鼠标进入托盘
+     * @param {Electron.Point}         position 鼠标位置
+     * @param {Electron.KeyboardEvent} event    事件对象
+     * @returns {Promise<void>}
+     */
+    onMouseEnter(position: Electron.Point, event: Electron.KeyboardEvent): Promise<void>;
+    /**
+     * 鼠标离开托盘
+     * @param {Electron.Point}         position 鼠标位置
+     * @param {Electron.KeyboardEvent} event    事件对象
+     * @returns {Promise<void>}
+     */
+    onMouseLeave(position: Electron.Point, event: Electron.KeyboardEvent): Promise<void>;
+    /**
+     * 托盘鼠标移动
+     * @param {Electron.Point}         position 鼠标位置
+     * @param {Electron.KeyboardEvent} event    事件对象
+     * @returns {Promise<void>}
+     */
+    onMouseMove(position: Electron.Point, event: Electron.KeyboardEvent): Promise<void>;
+    /**
+     * 托盘通知气泡显示
+     * @returns {Promise<void>}
+     */
+    onBalloonShow(): Promise<void>;
+    /**
+     * 点击托盘通知气泡
+     * @returns {Promise<void>}
+     */
+    onBalloonClick(): Promise<void>;
+    /**
+     * 托盘通知气泡关闭
+     * @returns {Promise<void>}
+     */
+    onBalloonClosed(): Promise<void>;
+    /**
+     * 拖拽进入托盘
+     * @returns {Promise<void>}
+     */
+    onDragEnter(): Promise<void>;
+    /**
+     * 拖拽离开托盘
+     * @returns {Promise<void>}
+     */
+    onDragLeave(): Promise<void>;
+    /**
+     * 拖拽结束
+     * @returns {Promise<void>}
+     */
+    onDragEnd(): Promise<void>;
+    /**
+     * 拖拽放入托盘
+     * @returns {Promise<void>}
+     */
+    onDrop(): Promise<void>;
+    /**
+     * 文件拖拽到托盘
+     * @param {Electron.KeyboardEvent} event 事件对象
+     * @param {string[]}               files 文件路径
+     * @returns {Promise<void>}
+     */
+    onDropFiles(event: Electron.Event, files: string[]): Promise<void>;
+    /**
+     * 文本拖拽到托盘
+     * @param {Electron.Event} event 事件对象
+     * @param {string}         text  拖拽文本
+     * @returns {Promise<void>}
+     */
+    onDropText(event: Electron.Event, text: string): Promise<void>;
+    /**
+     * 托盘生命周期错误
+     * @param {XoTray.LifecycleError} error 错误信息
+     * @returns {Promise<void>}
+     */
+    onError(error: XoTray.LifecycleError): Promise<void>;
+}

package/dist/main/tray/tray-lifecycle.d.ts

@@ -0,0 +1,7 @@
+import { TrayLifecycleAbstract } from './tray-lifecycle-abstract';
+/**
+ * Xion 默认托盘生命周期
+ * @class TrayLifecycle
+ */
+export declare class TrayLifecycle extends TrayLifecycleAbstract {
+}

package/dist/main/tray/tray-manager.d.ts

@@ -0,0 +1,173 @@
+import type { XoAppAbstract } from '../app/xo-app-abstract';
+/**
+ * 托盘管理器
+ * @class TrayManager
+ */
+export declare class TrayManager {
+    /**
+     * Xion 应用
+     * @type {XoAppAbstract}
+     * @private
+     */
+    private readonly xoApp;
+    /**
+     * 托盘生命周期
+     * @type {TrayLifecycleAbstract}
+     * @private
+     */
+    private lifecycle?;
+    /**
+     * 托盘配置
+     * @type {XoTray.Config | undefined}
+     * @private
+     */
+    private readonly config?;
+    /**
+     * 托盘实例
+     * @type {Electron.Tray | null}
+     * @private
+     */
+    private tray;
+    /**
+     * 托盘图标管理器
+     * @type {TrayIcon}
+     * @private
+     */
+    private readonly trayIcon;
+    /**
+     * 托盘动画管理器
+     * @type {TrayAnimation}
+     * @private
+     */
+    private readonly trayAnimation;
+    /**
+     * 当前托盘图标名称
+     * @type {XoTray.IconName}
+     * @private
+     */
+    private iconName;
+    /**
+     * 动画定时器
+     * @type {NodeJS.Timeout | null}
+     * @private
+     */
+    private animationTimer;
+    /**
+     * 点击定时器
+     * @type {NodeJS.Timeout | null}
+     * @private
+     */
+    private clickTimer;
+    /**
+     * 构造函数
+     * @param {XoAppAbstract} xoApp Xion 应用
+     * @param {XoTray.Config}    config   托盘配置
+     */
+    constructor(xoApp: XoAppAbstract, config?: XoTray.Config);
+    /**
+     * 是否启用托盘
+     * @returns {boolean}
+     */
+    enabled(): boolean;
+    /**
+     * 获取托盘实例
+     * @returns {Electron.Tray | null}
+     */
+    getTray(): Electron.Tray | null;
+    /**
+     * 获取托盘配置
+     * @returns {XoTray.Config | undefined}
+     */
+    getConfig(): XoTray.Config | undefined;
+    /**
+     * 创建托盘
+     * @returns {Promise<Electron.Tray | null>}
+     */
+    create(): Promise<Electron.Tray | null>;
+    /**
+     * 设置聚焦时托盘提示（默认）
+     */
+    setFocusToolTip(): void;
+    /**
+     * 设置失焦时的托盘提示
+     */
+    setBlurToolTip(): void;
+    /**
+     * 设置托盘提示
+     * @param {string} tooltip 托盘提示
+     */
+    setToolTip(tooltip?: string): void;
+    /**
+     * 激活托盘气泡
+     * @param {Electron.DisplayBalloonOptions} options 气泡配置
+     */
+    displayBalloon(options: Electron.DisplayBalloonOptions): void;
+    /**
+     * 关闭托盘气泡
+     */
+    removeBalloon(): void;
+    /**
+     * 设置托盘图标
+     * @param {XoTray.IconName} name 图标名称
+     */
+    setIcon(name: XoTray.IconName): void;
+    /**
+     * 托盘聚焦
+     */
+    setFocus(): void;
+    /**
+     * 托盘失焦
+     */
+    setBlur(): void;
+    /**
+     * 销毁托盘
+     */
+    destroy(): void;
+    /**
+     * 启动托盘动画
+     * @param {XoTray.AnimationName} name 动画名称
+     */
+    startAnimation(name?: XoTray.AnimationName): void;
+    /**
+     * 停止托盘动画
+     * @param {XoTray.IconName} name 图标名称
+     */
+    stopAnimation(name?: XoTray.IconName): void;
+    /**
+     * 创建托盘生命周期
+     * @param {Electron.Tray} tray 托盘实例
+     * @returns {TrayLifecycleAbstract} 托盘生命周期
+     * @private
+     */
+    private createLifecycle;
+    /**
+     * 获取托盘生命周期
+     * @returns {TrayLifecycleAbstract} 托盘生命周期
+     * @private
+     */
+    private getLifecycle;
+    /**
+     * 绑定托盘生命周期
+     * @param {Electron.Tray} tray 托盘实例
+     * @private
+     */
+    private bindLifecycle;
+    /**
+     * 延迟执行单击
+     * @param {() => void} runner 单击执行器
+     * @private
+     */
+    private delayClick;
+    /**
+     * 清理单击定时器
+     * @private
+     */
+    private clearClickTimer;
+    /**
+     * 事件错误捕捉器
+     * @param {string}                     source 事件来源
+     * @param {() => Promise<void> | void} runner 事件处理器
+     * @private
+     */
+    private catcher;
+}