@e-xi/xion 0.0.6

package/README.md

@@ -0,0 +1 @@
+# Xion

package/dist/bin/icon-generator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 图标生成分组
+ */
+export interface GenerateIconsGroup {
+    sourceDir: string;
+    targetDir: string;
+    names: string[];
+}
+/**
+ * 图标生成选项
+ */
+export interface GenerateIconsOptions {
+    rootDir: string;
+    groups: GenerateIconsGroup[];
+    sizes?: number[];
+}
+/**
+ * 根据 png 文件生成 ico 图标
+ * @param {GenerateIconsOptions} options 图标生成选项
+ * @returns {Promise<void>}
+ */
+export declare function generateIcons(options: GenerateIconsOptions): Promise<void>;

package/dist/bin/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './icon-generator';
+export * from './logo-generator';

package/dist/bin/index.js

@@ -0,0 +1,92 @@
+// src/bin/icon-generator.ts
+import { IconIco } from "@shockpkg/icon-encoder";
+import fs from "node:fs";
+import path from "node:path";
+import sharp from "sharp";
+var defaultSizes = [16, 24, 32, 48, 256];
+function cleanIcoFiles(dir) {
+  if (!fs.existsSync(dir)) {
+    return;
+  }
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isFile() && entry.name.endsWith(".ico")) {
+      fs.unlinkSync(path.join(dir, entry.name));
+    }
+  }
+}
+function findPngFile(sourceDir, name) {
+  const exactFile = path.join(sourceDir, `${name}.png`);
+  if (fs.existsSync(exactFile)) {
+    return exactFile;
+  }
+  const matchedFile = fs.readdirSync(sourceDir, { withFileTypes: true }).filter((entry) => entry.isFile() && path.extname(entry.name).toLowerCase() === ".png" && path.parse(entry.name).name.includes(name)).map((entry) => entry.name).sort()[0];
+  return matchedFile ? path.join(sourceDir, matchedFile) : void 0;
+}
+async function createPngIco(input, sizes) {
+  const ico = new IconIco();
+  for (const size of sizes) {
+    const png = await sharp(input).resize(size, size, {
+      fit: "contain",
+      background: { r: 0, g: 0, b: 0, alpha: 0 },
+      kernel: sharp.kernel.lanczos3
+    }).png({
+      compressionLevel: 9,
+      adaptiveFiltering: true
+    }).toBuffer();
+    await ico.addFromPng(png, true, true);
+  }
+  return Buffer.from(ico.encode());
+}
+async function generateIcons(options) {
+  const rootDir = path.resolve(options.rootDir);
+  const sizes = options.sizes ?? defaultSizes;
+  for (const group of options.groups) {
+    const sourceDir = path.resolve(rootDir, group.sourceDir);
+    const targetDir = path.resolve(rootDir, group.targetDir);
+    if (!fs.existsSync(sourceDir)) {
+      console.log(`[gen-icon] source directory not found: ${sourceDir}`);
+      continue;
+    }
+    fs.mkdirSync(targetDir, { recursive: true });
+    cleanIcoFiles(targetDir);
+    for (const name of group.names) {
+      const input = findPngFile(sourceDir, name);
+      const output = path.join(targetDir, `${name}.ico`);
+      if (!input) {
+        console.log(`[gen-icon] skipped missing source containing "${name}": ${sourceDir}`);
+        continue;
+      }
+      fs.writeFileSync(output, await createPngIco(input, sizes));
+      console.log(`[gen-icon] generated ${output}`);
+    }
+  }
+}
+
+// src/bin/logo-generator.ts
+import fs2 from "node:fs";
+import path2 from "node:path";
+import sharp2 from "sharp";
+function createTargetFile(targetFile, width, height) {
+  const parsed = path2.parse(targetFile);
+  return path2.join(parsed.dir, `${parsed.name}-${width}x${height}.png`);
+}
+async function generateLogo(options) {
+  const rootDir = path2.resolve(options.rootDir);
+  const sourceFile = path2.resolve(rootDir, options.sourceFile);
+  const targetFile = path2.resolve(rootDir, options.targetFile);
+  fs2.mkdirSync(path2.dirname(targetFile), { recursive: true });
+  for (const size of options.sizes) {
+    const { data, info } = await sharp2(sourceFile).resize({
+      width: size.width,
+      height: size.height,
+      fit: size.height === void 0 ? "inside" : "fill"
+    }).png().toBuffer({ resolveWithObject: true });
+    const file = createTargetFile(targetFile, info.width, info.height);
+    fs2.writeFileSync(file, data);
+    console.log(`[gen-logo] generated ${file}`);
+  }
+}
+export {
+  generateIcons,
+  generateLogo
+};

package/dist/bin/logo-generator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PNG Logo 尺寸
+ */
+export interface GeneratePngLogoSize {
+    width: number;
+    height?: number;
+}
+/**
+ * PNG Logo 生成选项
+ */
+export interface GeneratePngLogoOptions {
+    rootDir: string;
+    sourceFile: string;
+    targetFile: string;
+    sizes: GeneratePngLogoSize[];
+}
+/**
+ * 根据 PNG 图片生成指定尺寸的 PNG Logo
+ * @param {GeneratePngLogoOptions} options PNG Logo 生成选项
+ * @returns {Promise<void>}
+ */
+export declare function generateLogo(options: GeneratePngLogoOptions): Promise<void>;

package/dist/chunk-files/chunk-34OODP7M.js

@@ -0,0 +1,147 @@
+import {
+  defaultElectronAppConfig
+} from "./chunk-DEODEAKM.js";
+import {
+  FileAssociationUtil
+} from "./chunk-VGDNICVG.js";
+import {
+  ProtocolUtil
+} from "./chunk-KFK47PDH.js";
+import {
+  ObjectUtil
+} from "./chunk-RODB64YF.js";
+
+// src/main/config/app-config.ts
+var defaultConfig = () => {
+  return {
+    // electron 应用构建选项
+    eletronAppConfig: defaultElectronAppConfig(),
+    // 是否单例模式
+    singleInstance: true,
+    // 是否在渲染进程使用上下文菜单
+    useContextMenuInRenderer: true,
+    // 是否接管链接跳转
+    takeOverLinkNavigation: true,
+    // 链接跳转白名单正则
+    linkNavigationWhiteList: [],
+    // 快捷窗口材质（会强制设置 browserOptions 中的选项）
+    // - transparent 窗口透明无边框 {backgroundMaterial: 'none'， transparent: true, backgroundColor: '#00000000', frame: false, thickFrame: false}
+    // - none        不使用材质 {backgroundMaterial: 'none', transparent: false}
+    // - mica        Windows 11 云母材质（带系统色调的柔和背景） {transparent: false, backgroundColor: '#00000000'}
+    // - acrylic     Windows 10 亚克力材质（毛玻璃，有半透明、模糊、透出背后内容的效果） {transparent: false, backgroundColor: '#00000000'}
+    // - tabbed      窗口背景使用 tabbed 风格的系统材质 {transparent: false, backgroundColor: '#00000000'}
+    windowMaterial: void 0,
+    // 标题栏覆盖配置
+    titleBarOverlayConfig: {
+      light: {
+        color: "#F5F7FA",
+        symbolColor: "#000000",
+        height: 40
+      },
+      dark: {
+        color: "#121212",
+        symbolColor: "#ffffff",
+        height: 40
+      }
+    },
+    // 托盘"检查更新"点击后跳转的设置路由（如版本更新页面），未配置时不跳转
+    updaterSettingsRoute: void 0
+  };
+};
+var defineAppConfig = (config) => {
+  const result = ObjectUtil.merge(defaultConfig(), config ?? {});
+  result.eletronAppConfig.protocols = formatProtocols(result.eletronAppConfig?.protocols);
+  result.eletronAppConfig.rendererProtocol = formatRendererProtocol(result.eletronAppConfig?.rendererProtocol);
+  result.eletronAppConfig.fileAssociationExtensions = formatFileAssociationExtensions(result.eletronAppConfig?.fileAssociationExtensions);
+  return result;
+};
+function formatRendererProtocol(protocol) {
+  const normalizedProtocol = protocol?.trim().toLowerCase();
+  if (!normalizedProtocol) {
+    return void 0;
+  }
+  if (!ProtocolUtil.isValidProtocol(normalizedProtocol)) {
+    throw new Error(`\u65E0\u6548\u7684\u6E32\u67D3\u8FDB\u7A0B\u5165\u53E3\u534F\u8BAE: ${normalizedProtocol}`);
+  }
+  if (["about", "blob", "chrome", "data", "devtools", "file", "http", "https", "javascript"].includes(normalizedProtocol)) {
+    throw new Error(`\u6E32\u67D3\u8FDB\u7A0B\u5165\u53E3\u534F\u8BAE\u4E0D\u80FD\u4F7F\u7528\u5185\u7F6E\u534F\u8BAE: ${normalizedProtocol}`);
+  }
+  return normalizedProtocol;
+}
+function formatProtocols(protocols) {
+  const normalizedProtocols = [...new Set(protocols?.map((protocol) => protocol.trim().toLowerCase()) ?? [])];
+  for (const protocol of normalizedProtocols) {
+    if (!ProtocolUtil.isValidProtocol(protocol)) {
+      throw new Error(`\u65E0\u6548\u7684\u8F6F\u4EF6\u534F\u8BAE: ${protocol}`);
+    }
+  }
+  return normalizedProtocols;
+}
+function formatFileAssociationExtensions(extensions) {
+  const normalizedExtensions = [...new Set(extensions?.map(FileAssociationUtil.normalizeExtension) ?? [])];
+  for (const extension of normalizedExtensions) {
+    if (!FileAssociationUtil.isValidExtension(extension)) {
+      throw new Error(`\u65E0\u6548\u7684\u6587\u4EF6\u5173\u8054\u6269\u5C55\u540D: ${extension}`);
+    }
+  }
+  return normalizedExtensions;
+}
+
+// src/main/config/remote-service-config.ts
+var defaultConfig2 = () => {
+  return {
+    // 是否启用远程服务（默认关闭，不发起连接和心跳）
+    enabled: false,
+    // 服务地址，如 https://api.example.com（http/https 均可）
+    serviceUrl: "",
+    // 连接超时时间（毫秒）
+    connectionTimeout: 1e4,
+    // 连接失败后的最大重试次数
+    retryCount: 3,
+    // 重试间隔（毫秒）
+    retryDelay: 3e3,
+    // 快速重试耗尽后的低频探测间隔（毫秒）
+    lowFrequencyProbeInterval: 3e4,
+    // 心跳发送间隔（毫秒）
+    heartbeatInterval: 5e3,
+    // 心跳探测路径，相对服务地址，如 /health
+    // 如 heartbeatPath: '/health' 探测 https://api.example.com/health
+    heartbeatPath: "/health",
+    // 远程请求携带当前 Session 中的凭据
+    requestCredentials: "include",
+    // 远程请求遇到重定向时直接失败
+    requestRedirect: "error"
+  };
+};
+var defineRemoteServiceConfig = (config) => {
+  return ObjectUtil.merge(defaultConfig2(), config ?? {});
+};
+
+// src/main/config/updater-config.ts
+var defaultConfig3 = () => {
+  return {
+    // 是否启用更新模块，'checkOnStart' 启动时检查更新
+    enable: false,
+    // 自动检查更新延迟时间（毫秒）
+    autoCheckDelay: 5e3,
+    // 是否在发现新版本后自动下载
+    autoDownload: false,
+    // 是否在应用退出时自动安装已下载的更新
+    autoInstallOnAppQuit: false,
+    // 是否允许检查预发布版本
+    allowPrerelease: false,
+    // 是否允许降级安装
+    allowDowngrade: false,
+    // 是否允许用户自定义更新地址
+    allowUserFeedUrl: true
+  };
+};
+var defineUpdaterConfig = (config) => {
+  return ObjectUtil.merge(defaultConfig3(), config ?? {});
+};
+
+export {
+  defineAppConfig,
+  defineRemoteServiceConfig,
+  defineUpdaterConfig
+};

package/dist/chunk-files/chunk-3KBZWBNP.js

@@ -0,0 +1,51 @@
+import {
+  ObjectUtil
+} from "./chunk-RODB64YF.js";
+
+// src/main/config/logger-config.ts
+var defaultConfig = () => {
+  return {
+    // 控制台选项
+    console: {
+      // 日志等级
+      level: "info",
+      // 日志格式
+      format: "{y}-{m}-{d} {h}:{i}:{s}.{ms} [{initialUpper}] {scopeLabel}{message}",
+      // 是否使用样式
+      useStyles: true,
+      // 日志等级颜色
+      colors: {
+        error: "red",
+        warn: "yellow",
+        info: "green",
+        debug: "cyan",
+        verbose: "gray",
+        silly: "gray"
+      }
+    },
+    // 文件选项
+    file: {
+      // 日志等级
+      level: "info",
+      // 日志格式
+      format: "{y}-{m}-{d} {h}:{i}:{s}.{ms} [{initialUpper}] {scopeLabel}{message}",
+      // 日志目录
+      fileName: "app",
+      // 文件主名称
+      dir: "logs",
+      // 文件后缀
+      extension: "log",
+      // 保留文件天数
+      retentionDays: 180,
+      // 日志清理频率：daily=按天
+      cleanupFrequency: "daily"
+    }
+  };
+};
+var defineLoggerConfig = (config) => {
+  return ObjectUtil.merge(defaultConfig(), config ?? {});
+};
+
+export {
+  defineLoggerConfig
+};

package/dist/chunk-files/chunk-3R6EJDYR.js

@@ -0,0 +1,10 @@
+// src/main/tray/consts/tray-animation-name.ts
+var TrayAnimationNamePrefix = "TrayAnimation_";
+
+// src/main/tray/consts/tray-icon-name.ts
+var TrayIconNamePrefix = "TrayIcon_";
+
+export {
+  TrayAnimationNamePrefix,
+  TrayIconNamePrefix
+};

package/dist/chunk-files/chunk-3RVKOFMP.js

@@ -0,0 +1,68 @@
+// src/vite/utils/runtime-config-vite-util.ts
+var RuntimeConfigViteUtil = class _RuntimeConfigViteUtil {
+  /**
+   * 运行时配置文件路径
+   * @type {string}
+   */
+  static filePath = ".xion/runtime-config.gen.json";
+  /**
+   * 将运行时配置写入主进程输出目录
+   * @param {UserConfig}       userConfig 主进程入口
+   * @param {XoRuntime.Config} config     运行时配置
+   */
+  static writeFile(userConfig, config) {
+    this.useBuildPlugin(userConfig, config);
+  }
+  /**
+   * 通过插件写入主进程输出目录
+   * @param {UserConfig}       userConfig 主进程入口
+   * @param {XoRuntime.Config} config     运行时配置
+   * @private
+   */
+  static useBuildPlugin(userConfig, config) {
+    userConfig.main = {
+      ...userConfig.main,
+      plugins: [
+        ...userConfig.main?.plugins ?? [],
+        this.buildPlugin(config)
+      ]
+    };
+  }
+  /**
+   * 运行时配置构建插件
+   * @param {XoRuntime.Config} config 运行时配置
+   * @returns {Plugin}
+   * @private
+   */
+  static buildPlugin(config) {
+    return {
+      name: "xion-runtime-config",
+      generateBundle: function() {
+        this.emitFile({
+          type: "asset",
+          fileName: _RuntimeConfigViteUtil.filePath,
+          source: _RuntimeConfigViteUtil.jsonContent(config)
+        });
+      }
+    };
+  }
+  /**
+   * 配置文件内容
+   * @param {XoRuntime.Config} config 运行时配置
+   * @returns {string}
+   * @private
+   */
+  static jsonContent(config) {
+    return JSON.stringify({
+      "/* DO NOT EDIT */": "/* Automatically generated by @e-xi/xion/src/vite/config/electron-vite-config.ts */",
+      appMode: config.appMode,
+      mainOutDir: config.mainOutDir,
+      preloadOutDir: config.preloadOutDir,
+      rendererOutDir: config.rendererOutDir
+    }, null, 4);
+  }
+};
+
+export {
+  RuntimeConfigViteUtil
+};

package/dist/chunk-files/chunk-3S5OTD47.js

@@ -0,0 +1,35 @@
+// src/main/utils/xo-util.ts
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+var XoUtil = class {
+  /**
+   * 解析框架包根目录
+   * @returns {string}
+   */
+  static rootDir() {
+    let currentDir = path.dirname(fileURLToPath(import.meta.url));
+    while (true) {
+      if (fs.existsSync(path.join(currentDir, "package.json"))) {
+        return currentDir;
+      }
+      const parentDir = path.dirname(currentDir);
+      if (parentDir === currentDir) {
+        throw new Error("Cannot resolve Xion package root");
+      }
+      currentDir = parentDir;
+    }
+  }
+  /**
+   * 解析框架包内文件路径
+   * @param {string} file 文件路径
+   * @returns {string}
+   */
+  static resolveFile(file) {
+    return path.resolve(this.rootDir(), file);
+  }
+};
+
+export {
+  XoUtil
+};

package/dist/chunk-files/chunk-3XB4IEWO.js

@@ -0,0 +1,195 @@
+import {
+  NormalizeSource
+} from "./chunk-SVTZ4T6S.js";
+import {
+  ThemeChannels
+} from "./chunk-UIJUY7QZ.js";
+
+// src/main/theme/theme-manager-abstract.ts
+import { BrowserWindow, nativeTheme } from "electron";
+var ThemeManagerAbstract = class {
+  /**
+   * Xion 应用
+   * @type {XoAppAbstract}
+   * @protected
+   */
+  xoApp;
+  /**
+   * 是否已初始化
+   * @private
+   */
+  initialized = false;
+  /**
+   * 构造函数
+   * @param {XoAppAbstract} xoApp Xion 应用
+   */
+  constructor(xoApp) {
+    this.xoApp = xoApp;
+  }
+  /**
+   * 获取 App 设置存储
+   * @returns {AppStore}
+   */
+  getAppStore() {
+    return this.xoApp.getAppStore();
+  }
+  /**
+   * 初始化主题
+   * @returns {boolean}
+   */
+  initialize() {
+    if (this.initialized) {
+      return false;
+    }
+    this.initialized = true;
+    nativeTheme.on("updated", () => {
+      this.syncToAllWindows();
+    });
+    const themeSource = this.getAppStore().getThemeSource();
+    this.setSource(themeSource);
+    return true;
+  }
+  /**
+   * 设置APP主题和主题缓存
+   * @param {XoTheme.Source} themeSource 主题来源
+   */
+  setSource(themeSource) {
+    const source = NormalizeSource(themeSource);
+    nativeTheme.themeSource = source;
+    this.getAppStore().setThemeSource(source);
+    this.syncToAllWindows();
+  }
+  /**
+   * 获取主题状态
+   * @returns {XoTheme.State}
+   */
+  getState(window) {
+    return {
+      themeSource: nativeTheme.themeSource,
+      shouldUseDarkColors: nativeTheme.shouldUseDarkColors,
+      titleBarOverlayEnabled: this.titleBarOverlayEnabled(window),
+      titleBarOverlay: this.titleBarOverlay(window),
+      titleBarOverlayBackground: this.configuredTitleBarOverlay(window).color
+    };
+  }
+  /**
+   * 是否启用标题栏覆盖
+   * @param {Electron.BrowserWindow} window 窗口
+   * @returns {boolean}
+   * @protected
+   */
+  titleBarOverlayEnabled(window) {
+    const record = window ? this.xoApp.getWindowManager().getRecordByBrowserWindowId(window.id) : void 0;
+    return record?.type?.windowConfig?.browserOptions?.titleBarOverlay !== false;
+  }
+  /**
+   * 标题栏覆盖配置
+   * @param {Electron.BrowserWindow} window 窗口
+   * @returns {Electron.TitleBarOverlayOptions}
+   * @protected
+   */
+  titleBarOverlay(window) {
+    const titleBarOverlayOptions = this.configuredTitleBarOverlay(window);
+    if (window && this.needsTransparentBackground(window)) {
+      titleBarOverlayOptions.color = "#00000000";
+    }
+    return titleBarOverlayOptions;
+  }
+  /**
+   * 配置中的标题栏覆盖配置
+   * @param {Electron.BrowserWindow} window 窗口
+   * @returns {Electron.TitleBarOverlayOptions}
+   * @protected
+   */
+  configuredTitleBarOverlay(window) {
+    const overlay = this.xoApp.getAppConfig()?.titleBarOverlayConfig;
+    const titleBarOverlay = nativeTheme.shouldUseDarkColors ? overlay?.dark ?? {} : overlay?.light ?? {};
+    const record = window ? this.xoApp.getWindowManager().getRecordByBrowserWindowId(window.id) : void 0;
+    const titleBarHeight = record?.type?.windowConfig?.titleBarHeight;
+    const titleBarOverlayOptions = {
+      ...titleBarOverlay
+    };
+    if (titleBarHeight !== void 0) {
+      titleBarOverlayOptions.height = titleBarHeight;
+    }
+    return titleBarOverlayOptions;
+  }
+  /**
+   * 同步主题到窗口和渲染进程
+   */
+  syncToAllWindows() {
+    BrowserWindow.getAllWindows().forEach((window) => {
+      this.syncToWindow(window);
+    });
+  }
+  /**
+   * 同步主题到指定窗口和渲染进程
+   * @param {Electron.BrowserWindow} window 窗口
+   */
+  syncToWindow(window) {
+    this.notifyWindow(window);
+    this.updateWindowTheme(window);
+  }
+  /**
+   * 更新窗口主题
+   * @param {Electron.BrowserWindow} window 窗口
+   * @protected
+   */
+  updateWindowTheme(window) {
+    if (window.isDestroyed()) {
+      return;
+    }
+    const titleBarOverlay = this.titleBarOverlay(window);
+    if (this.needsTransparentBackground(window)) {
+      window.setBackgroundColor("#00000000");
+    } else {
+      titleBarOverlay?.color && window.setBackgroundColor(titleBarOverlay.color);
+    }
+    if (!this.titleBarOverlayEnabled(window)) {
+      return;
+    }
+    window.setTitleBarOverlay({
+      ...titleBarOverlay,
+      color: "#00000000"
+      // 标题栏透明
+    });
+  }
+  /**
+   * 是否需要透明窗口背景
+   * @param {Electron.BrowserWindow} window 窗口
+   * @returns {boolean}
+   * @protected
+   */
+  needsTransparentBackground(window) {
+    const record = this.xoApp.getWindowManager().getRecordByBrowserWindowId(window.id);
+    const options = record?.type?.windowConfig?.browserOptions;
+    if (options?.backgroundMaterial !== void 0) {
+      return options.transparent === true || options.backgroundMaterial !== "none";
+    }
+    const windowMaterial = record?.type?.windowConfig?.windowMaterial ?? this.getAppStore().getWindowMaterial() ?? this.xoApp.getAppConfig()?.windowMaterial;
+    if (windowMaterial !== void 0) {
+      return windowMaterial !== "none";
+    }
+    return options?.transparent === true;
+  }
+  /**
+   * 通知渲染进程主题已更新
+   * @param {Electron.BrowserWindow} window 窗口
+   * @protected
+   */
+  notifyWindow(window) {
+    if (window.isDestroyed() || window.webContents.isDestroyed()) {
+      return;
+    }
+    window.webContents.send(ThemeChannels.onUpdate, this.getState(window));
+  }
+};
+
+// src/main/theme/theme-manager.ts
+var ThemeManager = class extends ThemeManagerAbstract {
+};
+
+export {
+  ThemeManagerAbstract,
+  ThemeManager
+};

package/dist/chunk-files/chunk-3XOVD6UX.js

@@ -0,0 +1,8 @@
+// src/shared/mode/consts/command.ts
+var CommandServe = "serve";
+var CommandBuild = "build";
+
+export {
+  CommandServe,
+  CommandBuild
+};