nexfep 0.4.3 → 0.5.0

package/cli/help.mjs

@@ -0,0 +1,57 @@
+const helpTexts = {
+  help: `
+Nexfep - A desktop application framework for Node.js
+
+This is a command-line tool for building desktop applications with Node.js.
+
+For application development, please refer to the README.md:
+  https://github.com/nexfteam/Nexfep#readme
+
+Usage: nexfep <command> [options]
+
+Commands:
+  help            Show this help message
+  build           Build the application into a standalone executable
+
+See 'nexfep help <command>'
+to read about a specific subcommand.
+`,
+  build: `
+nexfep build - Build the application into a standalone executable
+
+Usage:
+  nexfep build [options]
+
+Options:
+  -n, --name <name>             Application name (default: from package.json)
+  -e, --entry <file>            Entry file path (default: from package.json main)
+  -o, --output <dir>            Output directory (default: dist)
+  -i, --ignore <pattern>        Files or directories to ignore (can be used multiple times)
+  -c, --console                 Show console window on Windows (default: false)
+  -r, --reinstall               Reinstall production dependencies only before building (default: false)
+  -s, --skip-clean              Skip cleaning old build files before building (default: false)
+  -u, --upx <level>             Use UPX to compress the executable, level in range 0-9, 0 means no UPX compression.
+                                Ensure UPX is installed before using (default: 0)
+  -m, --meta, --metadata <file> Metadata JSON file path.
+                                For more details, see README.md and https://github.com/nexfteam/Nexfpack#Metadata.
+
+Examples:
+  nexfep build                          # Build using defaults from package.json
+  nexfep build -n my-app                # Set custom application name
+  nexfep build -e ./src/index.js        # Set custom entry file
+  nexfep build -o ./build               # Set custom output directory
+  nexfep build -i node_modules          # Ignore node_modules
+  nexfep build -i test -i temp          # Ignore multiple patterns
+
+This command uses nexfpack (github.com/nexfteam/Nexfpack) to package
+your application into a standalone executable. For more details, see:
+  https://github.com/nexfteam/Nexfpack
+`,
+};
+export default function help(command = "help") {
+  if (command in helpTexts) {
+    console.log(helpTexts[command]);
+  } else {
+    console.log("Invalid command.");
+  }
+}

package/cli/index.mjs

@@ -1,20 +1,18 @@
 #!/usr/bin/env node
-import fs from 'fs';
-import path from 'path';
-import build from './build.mjs';
-import help from './help.mjs';
+import build from "./build.mjs";
+import help from "./help.mjs";
 const args = process.argv.slice(2);
-if(args.length === 0) {
+if (args.length === 0) {
+  help();
+  process.exit(1);
+}
+if (args[0] === "help") {
+  if (args.length > 1) {
+    help(args[1]);
+  } else {
     help();
-    process.exit(1);
+  }
 }
-if(args[0] === 'help') {
-    if(args.length > 1) {
-        help(args[1]);
-    } else {
-        help();
-    }
+if (args[0] === "build") {
+  build(args.slice(1));
 }
-if(args[0] === 'build') {
-    build(args.slice(1));
-}

package/cli/timeTyper.mjs

@@ -0,0 +1,32 @@
+export default class TimeTyper {
+  typerKilled;
+  msg;
+  constructor(msg) {
+    this.typerKilled = false;
+    this.msg = msg;
+    this.typeTime(0);
+  }
+  typeTime(seconds) {
+    if (this.typerKilled) {
+      this.typerKilled = false;
+      return;
+    }
+    console.log(`\x1b[1A\x1b[2K(${seconds}s) ${this.msg}`);
+    setTimeout(() => {
+      this.typeTime(seconds + 1);
+    }, 1000);
+  }
+  async waitForReset(resolve) {
+    if (!this.typerKilled) {
+      resolve();
+    } else {
+      setTimeout(() => {
+        this.waitForReset(resolve);
+      }, 10);
+    }
+  }
+  async kill() {
+    this.typerKilled = true;
+    await new Promise(this.waitForReset.bind(this));
+  }
+}

package/index.d.ts

@@ -1 +1 @@
-export * from './src/Application.js';
+export * from "./src/Application.js";

package/index.js

@@ -1 +1 @@
-export * from './src/Application.js';
+export * from "./src/Application.js";

package/package.json

@@ -1,32 +1,24 @@
 {
   "name": "nexfep",
+  "version": "0.5.0",
   "description": "A desktop application framework based on @webviewjs/webview",
-  "repository": "https://github.com/nexfteam/Nexfep",
-  "homepage": "https://github.com/nexfteam/Nexfep#readme",
-  "bugs": {
-    "url": "https://github.com/nexfteam/Nexfep/issues"
-  },
-  "bin": {
-    "nexfep": "cli/index.mjs"
-  },
   "keywords": [
-    "desktop",
+    "@webviewjs/webview",
     "application",
+    "desktop",
     "framework",
-    "@webviewjs/webview",
-    "webview",
-    "typescript"
+    "typescript",
+    "webview"
   ],
-  "version": "0.4.3",
-  "type": "module",
-  "main": "./index.js",
-  "scripts": {
-    "compile": "tsc"
+  "homepage": "https://github.com/nexfteam/Nexfep#readme",
+  "bugs": {
+    "url": "https://github.com/nexfteam/Nexfep/issues"
   },
-  "author": "nexfteam",
   "license": "MIT",
-  "engines": {
-    "node": ">=20.11.0"
+  "author": "nexfteam",
+  "repository": "https://github.com/nexfteam/Nexfep",
+  "bin": {
+    "nexfep": "cli/index.mjs"
   },
   "files": [
     "index.js",
@@ -35,6 +27,10 @@
     "README-CN.md",
     "LICENSE",
     "package.json",
+    "cli/index.mjs",
+    "cli/help.mjs",
+    "cli/build.mjs",
+    "cli/timeTyper.mjs",
     "src/WindowManager.js",
     "src/WindowManager.d.ts",
     "src/Application.js",
@@ -42,14 +38,31 @@
     "src/Tray.js",
     "src/Tray.d.ts",
     "src/Logger.js",
-    "src/Logger.d.ts"
+    "src/Logger.d.ts",
+    "src/SingleInstance.js",
+    "src/SingleInstance.d.ts"
   ],
+  "type": "module",
+  "main": "./index.js",
+  "scripts": {
+    "compile": "tsc",
+    "fmt": "oxfmt --check",
+    "lint": "oxlint",
+    "fmt:fix": "oxfmt",
+    "lint:fix": "oxlint --fix"
+  },
   "dependencies": {
+    "@nexfteam/single-instance": "^0.0.7",
     "@webviewjs/webview": "0.4.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "oxfmt": "^0.60.0",
+    "oxlint": "^1.75.0",
     "tsx": "^4.0.0",
     "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=20.11.0"
   }
-}
+}

package/src/Application.d.ts

@@ -1,7 +1,8 @@
-import { Application as WebviewApplication, TrayIconImage, Notification } from '@webviewjs/webview';
-import { WindowPool } from './WindowManager.js';
-import { Tray } from './Tray.js';
-import { Logger } from './Logger.js';
+import { Application as WebviewApplication, TrayIconImage, Notification } from "@webviewjs/webview";
+import { WindowPool } from "./WindowManager.js";
+import { Tray } from "./Tray.js";
+import { Logger } from "./Logger.js";
+import { Locker } from "./SingleInstance.js";
 declare class __Utils {
     app: WebviewApplication;
     constructor(app: WebviewApplication);
@@ -25,6 +26,7 @@ declare class Application {
             label: string;
         }>;
     }): Tray;
+    createLocker(appName: string): Locker;
     exit(): void;
 }
 export { Application };

package/src/Application.js

@@ -1,7 +1,8 @@
-import { Application as WebviewApplication, Notification } from '@webviewjs/webview';
-import { WindowPool } from './WindowManager.js';
-import { Tray } from './Tray.js';
-import { Logger } from './Logger.js';
+import { Application as WebviewApplication, Notification } from "@webviewjs/webview";
+import { WindowPool } from "./WindowManager.js";
+import { Tray } from "./Tray.js";
+import { Logger } from "./Logger.js";
+import { Locker } from "./SingleInstance.js";
 class __Utils {
     app;
     constructor(app) {
@@ -21,13 +22,19 @@ class Application {
         this.app = new WebviewApplication();
         this.utils = new __Utils(this.app);
         this.logger = new Logger(options.LogFilePath);
-        const poolOptions = { WindowsWebview2UserDataFolder: options.WindowsWebview2UserDataFolder, logger: this.logger };
+        const poolOptions = {
+            WindowsWebview2UserDataFolder: options.WindowsWebview2UserDataFolder,
+            logger: this.logger,
+        };
         this.windows = new WindowPool(this.app, poolOptions);
         this.app.whenReady();
     }
     createTray(options) {
         return new Tray(this.app, options);
     }
+    createLocker(appName) {
+        return new Locker(appName);
+    }
     exit() {
         this.app.exit();
     }

package/src/Logger.js

@@ -1,4 +1,4 @@
-import fs from 'fs';
+import fs from "fs";
 class Logger {
     logFilePath;
     constructor(logFilePath) {
@@ -6,56 +6,56 @@ class Logger {
     }
     __formatConsoleArgs(args) {
         if (!Array.isArray(args) || args.length === 0)
-            return '';
+            return "";
         const template = args[0];
-        if (typeof template !== 'string' || !template.includes('%c')) {
-            return args.map(String).join(' ');
+        if (typeof template !== "string" || !template.includes("%c")) {
+            return args.map(String).join(" ");
         }
-        const RESET = '\x1b[0m';
+        const RESET = "\x1b[0m";
         const parts = template.split(/(%c)/);
         let styleArgIndex = 1;
-        let result = '';
-        let currentAnsiStyle = '';
+        let result = "";
+        let currentAnsiStyle = "";
         // 命名前景色映射
         const fgColors = {
-            black: '\x1b[30m',
-            red: '\x1b[31m',
-            green: '\x1b[32m',
-            yellow: '\x1b[33m',
-            blue: '\x1b[34m',
-            magenta: '\x1b[35m',
-            cyan: '\x1b[36m',
-            white: '\x1b[37m',
-            gray: '\x1b[90m',
-            grey: '\x1b[90m',
-            lightred: '\x1b[91m',
-            lightgreen: '\x1b[92m',
-            lightyellow: '\x1b[93m',
-            lightblue: '\x1b[94m',
-            lightmagenta: '\x1b[95m',
-            lightcyan: '\x1b[96m',
-            lightwhite: '\x1b[97m',
+            black: "\x1b[30m",
+            red: "\x1b[31m",
+            green: "\x1b[32m",
+            yellow: "\x1b[33m",
+            blue: "\x1b[34m",
+            magenta: "\x1b[35m",
+            cyan: "\x1b[36m",
+            white: "\x1b[37m",
+            gray: "\x1b[90m",
+            grey: "\x1b[90m",
+            lightred: "\x1b[91m",
+            lightgreen: "\x1b[92m",
+            lightyellow: "\x1b[93m",
+            lightblue: "\x1b[94m",
+            lightmagenta: "\x1b[95m",
+            lightcyan: "\x1b[96m",
+            lightwhite: "\x1b[97m",
         };
         // 命名背景色映射
         const bgColors = {
-            black: '\x1b[40m',
-            red: '\x1b[41m',
-            green: '\x1b[42m',
-            yellow: '\x1b[43m',
-            blue: '\x1b[44m',
-            magenta: '\x1b[45m',
-            cyan: '\x1b[46m',
-            white: '\x1b[47m',
+            black: "\x1b[40m",
+            red: "\x1b[41m",
+            green: "\x1b[42m",
+            yellow: "\x1b[43m",
+            blue: "\x1b[44m",
+            magenta: "\x1b[45m",
+            cyan: "\x1b[46m",
+            white: "\x1b[47m",
         };
         // 文字样式：加粗、斜体、下划线
         const textStyles = {
-            'bold': '\x1b[1m',
-            'font-weight:bold': '\x1b[1m',
-            'italic': '\x1b[3m',
-            'font-style:italic': '\x1b[3m',
-            'underline': '\x1b[4m',
-            'text-decoration:underline': '\x1b[4m',
-            'none': RESET,
+            bold: "\x1b[1m",
+            "font-weight:bold": "\x1b[1m",
+            italic: "\x1b[3m",
+            "font-style:italic": "\x1b[3m",
+            underline: "\x1b[4m",
+            "text-decoration:underline": "\x1b[4m",
+            none: RESET,
         };
         /** hex/rgb 转 ANSI 24位真彩色 */
         function colorToAnsi(colorVal, isBg = false) {
@@ -67,9 +67,12 @@ class Logger {
             // hex #fff #ffffff
             const hexReg = /^#([0-9a-f]{3}|[0-9a-f]{6})$/;
             if (hexReg.test(val)) {
-                let hex = val.replace('#', '');
+                let hex = val.replace("#", "");
                 if (hex.length === 3)
-                    hex = hex.split('').map(c => c + c).join('');
+                    hex = hex
+                        .split("")
+                        .map((c) => c + c)
+                        .join("");
                 const r = parseInt(hex.slice(0, 2), 16);
                 const g = parseInt(hex.slice(2, 4), 16);
                 const b = parseInt(hex.slice(4, 6), 16);
@@ -82,30 +85,33 @@ class Logger {
                 const [, r, g, b] = rgbMatch;
                 return isBg ? `\x1b[48;2;${r};${g};${b}m` : `\x1b[38;2;${r};${g};${b}m`;
             }
-            return '';
+            return "";
         }
         /** 解析CSS样式字符串为ANSI序列 */
         function parseColorStyle(styleStr) {
             if (!styleStr)
                 return RESET;
-            let ansi = '';
-            const rules = styleStr.split(';').map(s => s.trim()).filter(Boolean);
+            let ansi = "";
+            const rules = styleStr
+                .split(";")
+                .map((s) => s.trim())
+                .filter(Boolean);
             for (const rule of rules) {
-                const [prop, ...rest] = rule.split(':');
+                const [prop, ...rest] = rule.split(":");
                 const propKey = prop.trim().toLowerCase();
-                const value = rest.join(':').trim().toLowerCase();
+                const value = rest.join(":").trim().toLowerCase();
                 // 文字样式
                 if (textStyles[`${propKey}:${value}`] || textStyles[value]) {
                     ansi += textStyles[`${propKey}:${value}`] ?? textStyles[value];
                     continue;
                 }
                 // 前景色
-                if (propKey === 'color') {
+                if (propKey === "color") {
                     ansi += colorToAnsi(value, false);
                     continue;
                 }
                 // 背景色
-                if (propKey === 'background' || propKey === 'background-color') {
+                if (propKey === "background" || propKey === "background-color") {
                     ansi += colorToAnsi(value, true);
                     continue;
                 }
@@ -113,14 +119,14 @@ class Logger {
             return ansi;
         }
         for (const segment of parts) {
-            if (segment === '%c') {
+            if (segment === "%c") {
                 // 取出下一个样式参数，参数不足则重置样式
                 const styleStr = args[styleArgIndex];
                 styleArgIndex++;
-                currentAnsiStyle = parseColorStyle(String(styleStr ?? ''));
+                currentAnsiStyle = parseColorStyle(String(styleStr ?? ""));
             }
             else {
-                if (segment === '')
+                if (segment === "")
                     continue;
                 if (currentAnsiStyle) {
                     result += currentAnsiStyle + segment;
@@ -136,54 +142,54 @@ class Logger {
         // 剩余非样式参数直接拼接
         const extraArgs = args.slice(styleArgIndex);
         if (extraArgs.length) {
-            result += ' ' + extraArgs.map(String).join(' ');
+            result += " " + extraArgs.map(String).join(" ");
         }
         return result;
     }
     __printLog(winid, type, args, colorANSI, colorRESET) {
         if (this.logFilePath) {
-            fs.appendFileSync(this.logFilePath, `${new Date().toISOString()} [${winid}] ${type}: ${args.join(' ')}\n`);
+            fs.appendFileSync(this.logFilePath, `${new Date().toISOString()} [${winid}] ${type}: ${args.join(" ")}\n`);
         }
-        console.log(`${colorANSI || ''}[${winid}] ${type}:${colorRESET || ''}`, this.__formatConsoleArgs(args));
+        console.log(`${colorANSI || ""}[${winid}] ${type}:${colorRESET || ""}`, this.__formatConsoleArgs(args));
     }
     log(args) {
         if (Array.isArray(args)) {
-            this.__printLog(0, 'Log', args);
+            this.__printLog(0, "Log", args);
         }
         else {
-            this.__printLog(0, 'Log', [args]);
+            this.__printLog(0, "Log", [args]);
         }
     }
     error(args) {
         if (Array.isArray(args)) {
-            this.__printLog(0, 'Error', args, '\x1b[31m', '\x1b[0m');
+            this.__printLog(0, "Error", args, "\x1b[31m", "\x1b[0m");
         }
         else {
-            this.__printLog(0, 'Error', [args], '\x1b[31m', '\x1b[0m');
+            this.__printLog(0, "Error", [args], "\x1b[31m", "\x1b[0m");
         }
     }
     warn(args) {
         if (Array.isArray(args)) {
-            this.__printLog(0, 'Warn', args, '\x1b[33m', '\x1b[0m');
+            this.__printLog(0, "Warn", args, "\x1b[33m", "\x1b[0m");
         }
         else {
-            this.__printLog(0, 'Warn', [args], '\x1b[33m', '\x1b[0m');
+            this.__printLog(0, "Warn", [args], "\x1b[33m", "\x1b[0m");
         }
     }
     info(args) {
         if (Array.isArray(args)) {
-            this.__printLog(0, 'Info', args, '\x1b[34m', '\x1b[0m');
+            this.__printLog(0, "Info", args, "\x1b[34m", "\x1b[0m");
         }
         else {
-            this.__printLog(0, 'Info', [args], '\x1b[34m', '\x1b[0m');
+            this.__printLog(0, "Info", [args], "\x1b[34m", "\x1b[0m");
         }
     }
     debug(args) {
         if (Array.isArray(args)) {
-            this.__printLog(0, 'Debug', args, '\x1b[90m', '\x1b[0m');
+            this.__printLog(0, "Debug", args, "\x1b[90m", "\x1b[0m");
         }
         else {
-            this.__printLog(0, 'Debug', [args], '\x1b[90m', '\x1b[0m');
+            this.__printLog(0, "Debug", [args], "\x1b[90m", "\x1b[0m");
         }
     }
 }

package/src/SingleInstance.d.ts

@@ -0,0 +1,9 @@
+import { SingleInstance } from "@nexfteam/single-instance";
+declare class Locker {
+    locker: SingleInstance;
+    constructor(appName: string);
+    lock(): Promise<void>;
+    unlock(): Promise<void>;
+    whenLost(callback: () => void): void;
+}
+export { Locker };

package/src/SingleInstance.js

@@ -0,0 +1,17 @@
+import { SingleInstance } from "@nexfteam/single-instance";
+class Locker {
+    locker;
+    constructor(appName) {
+        this.locker = new SingleInstance(appName);
+    }
+    lock() {
+        return this.locker.lock();
+    }
+    unlock() {
+        return this.locker.unlock();
+    }
+    whenLost(callback) {
+        this.locker.on("connection-attempt", callback);
+    }
+}
+export { Locker };

package/src/Tray.d.ts

@@ -1,4 +1,4 @@
-import { Application, TrayIcon, TrayIconImage } from '@webviewjs/webview';
+import { Application, TrayIcon, TrayIconImage } from "@webviewjs/webview";
 declare class Tray {
     app: Application;
     tray: TrayIcon;

package/src/Tray.js

@@ -12,13 +12,13 @@ class Tray {
             tooltip: options.tooltip,
             icon: options.icon,
             menu: {
-                items: this.menuItems
-            }
+                items: this.menuItems,
+            },
         });
     }
     __ErrorWhenDestroyed() {
         if (this.destroyed) {
-            throw new Error('Tray has been destroyed');
+            throw new Error("Tray has been destroyed");
         }
     }
     addMenuItem(item) {
@@ -28,7 +28,7 @@ class Tray {
     }
     removeMenuItem(id) {
         this.__ErrorWhenDestroyed();
-        this.menuItems = this.menuItems.filter(item => item.id !== id);
+        this.menuItems = this.menuItems.filter((item) => item.id !== id);
         this.tray.setMenu({ items: this.menuItems });
     }
     setMenuItems(items) {

package/src/WindowManager.d.ts

@@ -16,9 +16,18 @@ declare class Window {
     minimize(): void;
     unMaximize(): void;
     unMinimize(): void;
+    isMaximized(): boolean;
+    isMinimized(): boolean;
+    toggleMaximize(): void;
+    toggleMinimize(): void;
     openDevTools(): void;
     closeDevTools(): void;
     setSize(width: number, height: number): void;
+    getSize(): import("@webviewjs/webview").Dimensions;
+    setPosition(x: number, y: number): void;
+    getPosition(): import("@webviewjs/webview").Position;
+    isFocused(): boolean;
+    focus(): void;
     hide(): void;
     show(): void;
     close(): void;