@e-xi/xion 0.0.6

package/dist/main/renderer-protocol/types/renderer-protocol.d.ts

@@ -0,0 +1,34 @@
+import type {XoAppAbstract}                     from '../../app/xo-app-abstract'
+import type {RendererProtocolHandlersAbstract} from '../renderer-protocol-handlers-abstract'
+import type {Session}                           from 'electron'
+
+declare global {
+
+    // 渲染进程协议
+    namespace XoRendererProtocol {
+
+        // 处理器键，对应协议 URL 的主机名
+        type Key = string
+
+        // 协议处理上下文
+        interface Context {
+            // 原始请求
+            request: Request
+            // 解析后的请求地址
+            url: URL
+            // 当前协议请求所属 Session
+            session: Session
+        }
+
+        // 协议处理器
+        type Handler = (context: Context) => Response | Promise<Response>
+
+        // 协议处理器映射
+        type HandlerMap = Partial<Record<Key, Handler>>
+
+        // 协议处理器构造函数
+        type HandlersConstructor = new (xoApp: XoAppAbstract) => RendererProtocolHandlersAbstract
+    }
+}
+
+export {}

package/dist/main/shortcut/handlers/app-shortcut-handlers.d.ts

@@ -0,0 +1,11 @@
+import { ShortcutHandlersAbstract } from '../shortcut-handlers-abstract';
+/**
+ * 应用快捷键处理器（内置）
+ */
+export declare class AppShortcutHandlers extends ShortcutHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoShortcut.HandlerMap}
+     */
+    handlerMap(): XoShortcut.HandlerMap;
+}

package/dist/main/shortcut/handlers/window-shortcut-handlers.d.ts

@@ -0,0 +1,11 @@
+import { ShortcutHandlersAbstract } from '../shortcut-handlers-abstract';
+/**
+ * 窗口快捷键处理器（内置）
+ */
+export declare class WindowShortcutHandlers extends ShortcutHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoShortcut.HandlerMap}
+     */
+    handlerMap(): XoShortcut.HandlerMap;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './handlers/app-shortcut-handlers';
+export * from './handlers/window-shortcut-handlers';
+export * from './shortcut-handlers-abstract';
+export * from './shortcut-manager-abstract';
+export * from './shortcut-manager';
+export type * from './types/shortcut';

package/dist/main/shortcut/index.js

@@ -0,0 +1,17 @@
+import {
+  AppShortcutHandlers,
+  ShortcutHandlersAbstract,
+  ShortcutManager,
+  ShortcutManagerAbstract,
+  WindowShortcutHandlers
+} from "../../chunk-files/chunk-BJOPQNB2.js";
+import "../../chunk-files/chunk-Q7LCZIQP.js";
+import "../../chunk-files/chunk-GROGDGEL.js";
+import "../../chunk-files/chunk-6BOPFOZD.js";
+export {
+  AppShortcutHandlers,
+  ShortcutHandlersAbstract,
+  ShortcutManager,
+  ShortcutManagerAbstract,
+  WindowShortcutHandlers
+};

package/dist/main/shortcut/shortcut-handlers-abstract.d.ts

@@ -0,0 +1,18 @@
+import type { XoAppAbstract } from '../app/xo-app-abstract';
+/**
+ * 快捷键处理器抽象类
+ */
+export declare abstract class ShortcutHandlersAbstract {
+    /** Xion 应用 */
+    protected readonly xoApp: XoAppAbstract;
+    /**
+     * 构造函数
+     * @param {XoAppAbstract} xoApp Xion 应用
+     */
+    constructor(xoApp: XoAppAbstract);
+    /**
+     * 处理器映射
+     * @returns {XoShortcut.HandlerMap}
+     */
+    abstract handlerMap(): XoShortcut.HandlerMap;
+}

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

@@ -0,0 +1,121 @@
+import type { XoAppAbstract } from '../app/xo-app-abstract';
+/**
+ * 快捷键管理器
+ */
+export declare abstract class ShortcutManagerAbstract {
+    /** XionApp */
+    private readonly xoApp;
+    /** 是否已初始化 */
+    private initialized;
+    /** 快捷键处理器 */
+    private readonly handlers;
+    /** 已注册快捷键处理器类 */
+    private readonly registeredHandlerClasses;
+    /** 已注册的全局快捷键 */
+    private readonly globalAccelerators;
+    /** 应用内快捷键缓存 */
+    private appShortcuts;
+    /**
+     * 构造函数
+     * @param {XoAppAbstract} xoApp XionApp
+     */
+    constructor(xoApp: XoAppAbstract);
+    /**
+     * 初始化快捷键管理器
+     */
+    initialize(): void;
+    /**
+     * 重新注册全局快捷键
+     */
+    reRegisterGlobalShortcuts(): void;
+    /**
+     * 注册全局快捷键
+     * @param {XoShortcut.Key} shortcut 快捷键
+     */
+    private registerGlobalShortcut;
+    /**
+     * 注销全部全局快捷键
+     */
+    private unregisterGlobalShortcuts;
+    /**
+     * 注册快捷键处理器
+     * @param {XoShortcut.ID}      id      快捷键 ID
+     * @param {XoShortcut.Handler} handler 处理器
+     */
+    registerHandler(id: XoShortcut.ID, handler: XoShortcut.Handler): void;
+    /**
+     * 注销快捷键处理器
+     * @param {XoShortcut.ID} id 快捷键 ID
+     */
+    unregisterHandler(id: XoShortcut.ID): void;
+    /**
+     * 自定义快捷键处理器列表
+     * @returns {XoShortcut.HandlersConstructor[]}
+     * @protected
+     */
+    protected abstract handlerClasses(): XoShortcut.HandlersConstructor[];
+    /**
+     * 注册所有快捷键处理器
+     */
+    private registerHandlers;
+    /**
+     * 推导 Object.entries 的准确类型
+     * @param {Record<any, any>} value 对象
+     * @returns {Array<[any, any]>}
+     * @private
+     */
+    private objectEntries;
+    /**
+     * 获取快捷键缓存
+     * @returns {XoShortcut.KeyMap}
+     */
+    getStoreShortcuts(): XoShortcut.KeyMap;
+    /**
+     * 设置快捷键
+     * @param {XoShortcut.KeyMap} shortcuts 快捷键
+     */
+    setShortcuts(shortcuts: XoShortcut.KeyMap): void;
+    /**
+     * 设置单个快捷键
+     * @param {XoShortcut.Key} shortcut 快捷键
+     */
+    setShortcut(shortcut: XoShortcut.Key): void;
+    /**
+     * 删除快捷键
+     * @param {XoShortcut.ID} id 快捷键 ID
+     */
+    deleteShortcut(id: XoShortcut.ID): void;
+    /**
+     * 绑定应用内快捷键监听
+     * @param {Electron.BrowserWindow} window 窗口
+     */
+    private bindAppShortcut;
+    /**
+     * 查找匹配的应用内快捷键
+     * @param {Electron.Input} input 输入信息
+     * @returns {XoShortcut.Key | undefined}
+     */
+    private findAppShortcut;
+    /**
+     * 更新应用内快捷键缓存
+     * @param {XoShortcut.KeyMap} shortcuts 快捷键
+     */
+    private updateAppShortcuts;
+    /**
+     * 触发快捷键处理器
+     * @param {XoShortcut.TriggerPayload} payload 触发载荷
+     */
+    private trigger;
+    /**
+     * 标准化快捷键映射
+     * @param {XoShortcut.KeyMap} shortcuts 快捷键映射
+     * @returns {XoShortcut.KeyMap}
+     */
+    private normalizeShortcuts;
+    /**
+     * 标准化快捷键
+     * @param {XoShortcut.Key} shortcut 快捷键
+     * @returns {XoShortcut.Key}
+     */
+    private normalizeShortcut;
+}

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

@@ -0,0 +1,12 @@
+import { ShortcutManagerAbstract } from './shortcut-manager-abstract';
+/**
+ * 快捷键管理器
+ * @class ShortcutManager
+ */
+export declare class ShortcutManager extends ShortcutManagerAbstract {
+    /**
+     * 自定义快捷键处理器列表
+     * @returns {XoShortcut.HandlersConstructor[]}
+     */
+    protected handlerClasses(): XoShortcut.HandlersConstructor[];
+}

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

@@ -0,0 +1,50 @@
+import type {XoAppAbstract}            from '../../app/xo-app-abstract'
+import type {ShortcutHandlersAbstract} from '../shortcut-handlers-abstract'
+
+declare global {
+
+    // 快捷键
+    namespace XoShortcut {
+
+        // 快捷键作用域
+        type Scope = 'global' | 'app'
+
+        // 快捷键
+        interface Key {
+            // 快捷键 ID，用于存储和触发业务处理器
+            id: ID
+            // 是否启用
+            enabled?: boolean
+            // 作用域 global=全局快捷键 app=应用内快捷键
+            scope: Scope
+            // 原始组合键，使用 KeyboardEvent.code 小写值
+            keys: string[]
+        }
+
+        // 快捷键映射
+        type KeyMap = Record<ID, Key>
+
+        // 快捷键触发载荷
+        interface TriggerPayload {
+            // 触发来源
+            source: Scope
+            // 快捷键
+            shortcut: Key
+            // 触发窗口
+            window?: Electron.BrowserWindow
+            // 应用内快捷键输入信息
+            input?: Electron.Input
+        }
+
+        // 快捷键处理器
+        type Handler = (payload: TriggerPayload) => void | Promise<void>
+
+        // 快捷键处理器映射
+        type HandlerMap = Record<ID, Handler>
+
+        // 快捷键处理器构造函数
+        type HandlersConstructor = new (app: XoAppAbstract) => ShortcutHandlersAbstract
+    }
+}
+
+export {}

package/dist/main/store/app-store.d.ts

@@ -0,0 +1,179 @@
+/**
+ * App 设置存储
+ * @class AppStore
+ */
+export declare class AppStore {
+    /**
+     * 存储
+     * @type {ElectronStore<XoStore.AppSetting>} ElectronStore
+     * @private
+     */
+    private readonly store;
+    /**
+     * 构造函数
+     */
+    constructor();
+    /**
+     * 获取当前应用安装实例的设备标识
+     * @returns {string}
+     */
+    getDeviceId(): string;
+    /**
+     * 设置主题
+     * @param {XoStore.AppSetting['themeSource']} themeSource 主题
+     */
+    setThemeSource(themeSource: XoStore.AppSetting['themeSource']): void;
+    /**
+     * 获取主题
+     * @returns {XoStore.AppSetting['themeSource']}
+     */
+    getThemeSource(): XoStore.AppSetting['themeSource'];
+    /**
+     * 设置快捷键配置
+     * @param {XoStore.AppSetting['shortcuts']} shortcuts 快捷键配置
+     */
+    setShortcuts(shortcuts: XoStore.AppSetting['shortcuts']): void;
+    /**
+     * 获取快捷键配置
+     * @returns {XoShortcut.KeyMap}
+     */
+    getShortcuts(): XoShortcut.KeyMap;
+    /**
+     * 设置APP透明度
+     * @param {number} opacity App透明度
+     */
+    setOpacity(opacity: number): void;
+    /**
+     * 获取APP透明度
+     * @returns {number}
+     */
+    getOpacity(): number;
+    /**
+     * 设置快捷窗口材质
+     * @param {XoStore.AppSetting['windowMaterial']} windowMaterial 窗口材质
+     */
+    setWindowMaterial(windowMaterial: XoStore.AppSetting['windowMaterial']): void;
+    /**
+     * 获取快捷窗口材质
+     * @returns {XoStore.AppSetting['windowMaterial']}
+     */
+    getWindowMaterial(): XoStore.AppSetting['windowMaterial'];
+    /**
+     * 设置应用启动模式
+     * @param {XoStore.AppSetting['appLaunchMode']} appLaunchMode 应用启动模式
+     */
+    setAppLaunchMode(appLaunchMode: XoStore.AppSetting['appLaunchMode']): void;
+    /**
+     * 获取应用启动模式
+     * @returns {XoStore.AppSetting['appLaunchMode']}
+     */
+    getAppLaunchMode(): XoStore.AppSetting['appLaunchMode'];
+    /**
+     * 设置是否开机启动
+     * @param {XoStore.AppSetting['launchOnStartup']} launchOnStartup 是否开机启动
+     */
+    setLaunchOnStartup(launchOnStartup: XoStore.AppSetting['launchOnStartup']): void;
+    /**
+     * 获取是否开机启动
+     * @returns {XoStore.AppSetting['launchOnStartup']}
+     */
+    getLaunchOnStartup(): XoStore.AppSetting['launchOnStartup'];
+    /**
+     * 设置关闭窗口行为
+     * @param {XoStore.AppSetting['windowCloseBehavior']} windowCloseBehavior 关闭窗口行为
+     */
+    setWindowCloseBehavior(windowCloseBehavior: XoStore.AppSetting['windowCloseBehavior']): void;
+    /**
+     * 获取关闭窗口行为
+     * @returns {XoStore.AppSetting['windowCloseBehavior']}
+     */
+    getWindowCloseBehavior(): XoStore.AppSetting['windowCloseBehavior'];
+    /**
+     * 设置日志等级
+     * @param {XoStore.AppSetting['logLevel'] | undefined} logLevel 日志等级
+     */
+    setLogLevel(logLevel?: XoStore.AppSetting['logLevel']): void;
+    /**
+     * 获取日志等级
+     * @returns {XoStore.AppSetting['logLevel']}
+     */
+    getLogLevel(): XoStore.AppSetting['logLevel'];
+    /**
+     * 设置更新器用户设置
+     * @param {XoUpdater.UserSettings} settings 更新器用户设置
+     */
+    setUpdaterSettings(settings: XoUpdater.UserSettings): void;
+    /**
+     * 获取更新器用户设置
+     * @returns {XoUpdater.UserSettings}
+     */
+    getUpdaterSettings(): XoUpdater.UserSettings;
+    /**
+     * 重置更新器用户设置
+     */
+    resetUpdaterSettings(): void;
+    /**
+     * 设置远程服务用户设置
+     * @param {XoRemoteService.UserSettings} settings 远程服务用户设置
+     */
+    setRemoteServiceSettings(settings: XoRemoteService.UserSettings): void;
+    /**
+     * 获取远程服务用户设置
+     * @returns {XoRemoteService.UserSettings}
+     */
+    getRemoteServiceSettings(): XoRemoteService.UserSettings;
+    /**
+     * 重置远程服务用户设置
+     */
+    resetRemoteServiceSettings(): void;
+    /**
+     * 设置窗口是否置顶
+     * @param {XoWindow.TypeName} typeName 窗口类型名称
+     * @param {boolean}           onTop    窗口是否置顶
+     */
+    setWindowOnTop(typeName: XoWindow.TypeName, onTop: boolean): void;
+    /**
+     * 获取窗口是否置顶
+     * @param {XoWindow.TypeName} typeName 窗口类型名称
+     * @returns {boolean}
+     */
+    getWindowOnTop(typeName: XoWindow.TypeName): boolean;
+    /**
+     * 设置侧边栏是否折叠
+     * @param {XoWindow.TypeName} typeName      窗口类型名称
+     * @param {boolean}           sidebarFolded 侧边栏是否折叠
+     */
+    setSidebarFold(typeName: XoWindow.TypeName, sidebarFolded: boolean): void;
+    /**
+     * 获取侧边栏是否折叠
+     * @param {XoWindow.TypeName} typeName 窗口类型名称
+     * @returns {boolean}
+     */
+    getSidebarFold(typeName: XoWindow.TypeName): boolean;
+    /**
+     * 设置窗口位置和大小
+     * @param {XoWindow.TypeName}  typeName  窗口类型名称
+     * @param {Electron.Rectangle} rectangle 窗口位置和大小
+     */
+    setWindowRectangle(typeName: XoWindow.TypeName, rectangle: Electron.Rectangle): void;
+    /**
+     * 获取窗口位置和大小
+     * @param {XoWindow.TypeName} typeName 窗口类型名称
+     * @returns {Electron.Rectangle | undefined}
+     */
+    getWindowRectangle(typeName: XoWindow.TypeName): Electron.Rectangle | undefined;
+    /**
+     * 设置窗口配置
+     * @param {XoWindow.TypeName}    typeName 窗口类型名称
+     * @param {XoStore.WindowSetting} setting 窗口配置
+     * @private
+     */
+    private setWindowSetting;
+    /**
+     * 获取窗口配置
+     * @param {XoWindow.TypeName} typeName 窗口类型名称
+     * @returns {XoStore.WindowSetting}
+     * @private
+     */
+    private getWindowSetting;
+}

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

@@ -0,0 +1,7 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './app-store';
+export * from './jwt-auth-store';
+export type * from './types/app-store';
+export type * from './types/jwt-auth-store';

package/dist/main/store/index.js

@@ -0,0 +1,13 @@
+import {
+  AppStore
+} from "../../chunk-files/chunk-4HEDNQUP.js";
+import "../../chunk-files/chunk-SVTZ4T6S.js";
+import {
+  JwtAuthStore
+} from "../../chunk-files/chunk-B7DTBTWQ.js";
+import "../../chunk-files/chunk-WKVLVI6N.js";
+import "../../chunk-files/chunk-Y3OEXVQ2.js";
+export {
+  AppStore,
+  JwtAuthStore
+};

package/dist/main/store/jwt-auth-store.d.ts

@@ -0,0 +1,36 @@
+/**
+ * JWT 认证加密存储
+ * <p>磁盘中只保存 safeStorage 加密后的完整会话，不保存访问令牌</p>
+ * @class JwtAuthStore
+ */
+export declare class JwtAuthStore {
+    /** Electron Store */
+    private readonly store;
+    /**
+     * 构造函数
+     */
+    constructor();
+    /**
+     * 当前系统是否支持安全加密
+     * @returns {boolean}
+     */
+    isEncryptionAvailable(): boolean;
+    /**
+     * 加密并保存会话
+     * @template TUser 用户类型
+     * @param {XoAuth.StoredRefreshSession<TUser>} session 会话数据
+     * @returns {boolean} 是否已持久化
+     */
+    setSession<TUser = XoAuth.User>(session: XoAuth.StoredRefreshSession<TUser>): boolean;
+    /**
+     * 读取并解密会话
+     * @template TUser 用户类型
+     * @returns {XoAuth.StoredRefreshSession<TUser> | undefined}
+     */
+    getSession<TUser = XoAuth.User>(): XoAuth.StoredRefreshSession<TUser> | undefined;
+    /**
+     * 清除持久化会话
+     * @returns {void}
+     */
+    clear(): void;
+}

package/dist/main/store/types/app-store.d.ts

@@ -0,0 +1,46 @@
+declare global {
+
+    // Store
+    namespace XoStore {
+
+        // 窗口设置
+        interface WindowSetting {
+            // 窗口是否置顶
+            onTop: boolean
+            // 侧边栏是否折叠
+            sidebarFolded: boolean
+            // 窗口位置和大小
+            rectangle: Electron.Rectangle
+        }
+
+        // App 设置
+        interface AppSetting {
+            // 当前应用安装实例的设备标识
+            deviceId?: string
+            // 主题 system | light | dark
+            themeSource: XoTheme.Source
+            // APP 透明度 0-1
+            opacity: number
+            // 快捷窗口材质
+            windowMaterial?: XoApp.WindowMaterial
+            // 应用启动模式
+            appLaunchMode: XoApp.AppLaunchMode
+            // 是否开机启动
+            launchOnStartup: boolean
+            // 关闭窗口行为
+            windowCloseBehavior: XoApp.WindowCloseBehavior
+            // 日志等级
+            logLevel: XoLogger.Level
+            // 快捷键配置
+            shortcuts?: XoShortcut.KeyMap
+            // 更新器用户设置
+            updater?: XoUpdater.UserSettings
+            // 远程服务用户设置
+            remoteService?: XoRemoteService.UserSettings
+            // 窗口设置
+            windowSettings?: Record<XoWindow.TypeName, WindowSetting>
+        }
+    }
+}
+
+export {}

package/dist/main/store/types/jwt-auth-store.d.ts

@@ -0,0 +1,14 @@
+declare global {
+
+    // Store
+    namespace XoStore {
+
+        /** JWT 认证存储结构 */
+        interface JwtAuth {
+            /** safeStorage 加密后的会话数据 */
+            session?: string
+        }
+    }
+}
+
+export {}

package/dist/main/theme/consts/theme-sources.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 主题
+ */
+export declare const ThemeSources: readonly ["system", "light", "dark"];
+/**
+ * 标准化主题来源
+ * @param {unknown} source 来源
+ * @returns {XoTheme.Source} 标准化来源
+ */
+export declare const NormalizeSource: (source: unknown) => XoTheme.Source;

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

@@ -0,0 +1,7 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './consts/theme-sources';
+export * from './theme-manager-abstract';
+export * from './theme-manager';
+export type * from './types/theme';

package/dist/main/theme/index.js

@@ -0,0 +1,16 @@
+import {
+  ThemeManager,
+  ThemeManagerAbstract
+} from "../../chunk-files/chunk-3XB4IEWO.js";
+import {
+  NormalizeSource,
+  ThemeSources
+} from "../../chunk-files/chunk-SVTZ4T6S.js";
+import "../../chunk-files/chunk-UIJUY7QZ.js";
+import "../../chunk-files/chunk-ID3YDA2K.js";
+export {
+  NormalizeSource,
+  ThemeManager,
+  ThemeManagerAbstract,
+  ThemeSources
+};