ewvjs 1.0.0 → 1.0.1

package/README.md

@@ -12,7 +12,7 @@
 - 🖱️ **Context Menus**: Customizable native right-click context menus.
 - 📦 **Packaging**: Built-in CLI tool to package your app into a standalone executable.
 - 🔧 **Native Bindings**: High-performance C# bindings via `node-api-dotnet`.
-- 🖼️ **Customization**: Support for frameless windows, transparency, dark mode, and more.
+- 🖼️ **Customization**: Support for frameless windows, transparency, vibrancy, and more.
 
 ## Installation
 
@@ -83,6 +83,17 @@ Creates a new WebView window.
 *   `url` (string): The URL to load (http/https) or path to a local HTML file or HTML string.
 *   `options` (object): Configuration options.
 
+### `start()`
+
+Starts the application event loop. This keeps the Node.js process alive until all windows are closed.
+
+### `expose(name, callback)`
+
+Exposes a Node.js function to the frontend.
+
+*   `name` (string): The name of the function as it will appear in `window.ewvjs.api`.
+*   `callback` (function): The Node.js function to execute. Can be async.
+
 ### Window Options
 
 ```typescript
@@ -137,7 +148,22 @@ Once a window is created, you can control it using the returned `Window` instanc
 
 ### Custom Context Menus
 
-Define native context menus using `on_context_menu`:
+Define native context menus using `on_context_menu`. It should return an array of `ContextMenuItem` objects.
+
+#### ContextMenuItem Interface
+
+```typescript
+interface ContextMenuItem {
+    label?: string;
+    type?: 'normal' | 'separator' | 'checkbox' | 'submenu';
+    checked?: boolean;
+    enabled?: boolean;
+    submenu?: ContextMenuItem[];
+    click?: () => void;
+}
+```
+
+Example:
 
 ```javascript
 win.on_context_menu = (params) => {
@@ -149,19 +175,122 @@ win.on_context_menu = (params) => {
 };
 ```
 
-## CLI & Packaging
+## CLI Reference
+
+`ewvjs` provides a command-line interface for creating and packaging applications.
+
+### Installation
+
+The CLI is included with the `ewvjs` package and can be run using `npx`:
+
+```bash
+npx ewvjs <command> [options]
+```
+
+### Commands
+
+#### `init` - Initialize a New Project
+
+Create a new ewvjs project with a sample application structure.
+
+**Usage:**
+```bash
+npx ewvjs init [name]
+```
+
+**Arguments:**
+*   `name` - Project name (default: `my-ewvjs-app`)
+
+**Example:**
+```bash
+npx ewvjs init my-awesome-app
+cd my-awesome-app
+npm install
+npm start
+```
+
+This creates:
+*   `package.json` - Project configuration with scripts
+*   `app.js` - Sample application with Node.js integration
+*   `assets/` - Directory for static assets
+*   `README.md` - Project documentation
+
+---
+
+#### `package` - Package Application
 
-`ewvjs` comes with a CLI tool to package your application into a standalone executable.
+Package your ewvjs application into a standalone executable.
 
+**Usage:**
 ```bash
-npx ewvjs package app.js --output myapp.exe --icon icon.ico
+npx ewvjs package <entry> [options]
 ```
 
+**Arguments:**
+*   `entry` - Entry point JavaScript file (required, e.g., `app.js`)
+
 **Options:**
-*   `--output, -o`: Output filename.
-*   `--icon, -i`: Path to application icon (.ico).
-*   `--assets, -a`: Directory of assets to copy.
-*   `--target, -t`: Target platform (default: node18-win-x64).
+
+| Option | Alias | Description | Default |
+|--------|-------|-------------|---------|
+| `--output <name>` | `-o` | Output executable name (without .exe) | `app` |
+| `--name <name>` | `-n` | Application name | `My App` |
+| `--icon <file>` | `-i` | Path to application icon (.ico file) | None |
+| `--assets <dir>` | `-a` | Assets directory to include in package | `./assets` |
+| `--target <target>` | `-t` | Target platform | `node18-win-x64` |
+| `--modules <modules>` | `-m` | Additional node modules to bundle (comma-separated) | None |
+| `--compress` | | Compress executable with UPX | `false` |
+| `--no-native` | | Skip bundling native DLLs (if already included) | Includes by default |
+
+**Examples:**
+
+Basic packaging:
+```bash
+npx ewvjs package app.js
+```
+
+Full customization:
+```bash
+npx ewvjs package app.js \
+  --output myapp \
+  --name "My Application" \
+  --icon icon.ico \
+  --assets ./public \
+  --modules axios,lodash \
+  --compress
+```
+
+Package with custom target:
+```bash
+npx ewvjs package app.js -o myapp -t node20-win-x64
+```
+
+**Output:**
+
+The packaged application will be created in the `dist/` directory with:
+*   `<output>.exe` - Standalone executable
+*   Native WebView2 dependencies (unless `--no-native` is used)
+*   Bundled assets from the specified directory
+
+**Notes:**
+*   Icon file must be in `.ico` format
+*   Additional modules should be listed without spaces: `axios,lodash,express`
+*   The `--compress` option requires UPX to be installed and available in PATH
+*   Default target `node18-win-x64` works with Node.js 18+ on 64-bit Windows
+
+### Getting Help
+
+Display available commands and options:
+```bash
+npx ewvjs --help
+npx ewvjs package --help
+npx ewvjs init --help
+```
+
+Display version:
+```bash
+npx ewvjs --version
+```
 
 ## License
 

package/dist/webview.d.ts

@@ -9,6 +9,7 @@ export declare class WebView {
     private _startPromise;
     private _resolveStart;
     private _heartbeat;
+    private _resolveOnce;
     constructor();
     create_window(title: string, url_or_html?: string, options?: Partial<WindowOptions>): Window;
     start(): Promise<void>;

package/dist/webview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webview.d.ts","sourceRoot":"","sources":["../src/webview.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,qBAAa,OAAO;IAChB,QAAQ,EAAE,GAAG,CAAC;IACd,iBAAiB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,CAAM;IACpD,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,UAAU,CAA+B;;IAUjD,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,GAAE,MAAW,EAAE,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,MAAM;IAgB9F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B,OAAO,CAAC,QAAQ;IAgBhB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IAIpC,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,OAAO,CAAC,mBAAmB;CA2B9B"}
+{"version":3,"file":"webview.d.ts","sourceRoot":"","sources":["../src/webview.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,qBAAa,OAAO;IAChB,QAAQ,EAAE,GAAG,CAAC;IACd,iBAAiB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,CAAM;IACpD,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,YAAY,CAAkB;;IAUtC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,GAAE,MAAW,EAAE,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,MAAM;IAgB9F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B,OAAO,CAAC,QAAQ;IAkBhB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IAIpC,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,OAAO,CAAC,mBAAmB;CA2B9B"}

package/dist/webview.js

@@ -19,6 +19,7 @@ class WebView {
         this._startPromise = null;
         this._resolveStart = null;
         this._heartbeat = null;
+        this._resolveOnce = false;
         if (process.platform === 'win32') {
             this.platform = new windows_1.WindowsPlatform();
         }
@@ -57,12 +58,15 @@ class WebView {
         }
         if (this._resolveStart) {
             this._resolveStart();
+            this._resolveOnce = true;
             this._resolveStart = null;
         }
         // Force exit after a short delay to ensure cleanup completes
-        setTimeout(() => {
-            process.exit(0);
-        }, 100);
+        if (this._resolveOnce) {
+            setTimeout(() => {
+                process.exit(0);
+            }, 100);
+        }
     }
     expose(name, func) {
         this.exposed_functions[name] = func;

package/dist/window.d.ts

@@ -7,11 +7,13 @@ export declare class Window {
     private _resolveClosed;
     private _menuCallbacks;
     private _exposedFunctions;
+    private _isClosed;
     on_context_menu: (items: any[]) => ContextMenuItem[] | null | Promise<ContextMenuItem[] | null>;
     constructor(platform: any, options: WindowOptions, exposedFunctions: {
         [key: string]: Function;
     });
     get closed(): Promise<void>;
+    get is_closed(): boolean;
     run(): Promise<any>;
     private _call;
     evaluate_js(script: string): Promise<any>;

package/dist/window.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../src/window.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGzD,qBAAa,MAAM;IACf,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,EAAE,aAAa,CAAC;IAEvB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,iBAAiB,CAA8B;IAEvD,eAAe,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,eAAe,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAAc;gBAEjG,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE;IAiBhG,IAAI,MAAM,kBAET;IAEK,GAAG;YAkBK,KAAK;IAgBb,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAIzC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAItC,KAAK;IAIL,OAAO;IAKP,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IAGJ,OAAO;IACP,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAGrC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAIpC,WAAW;IACX,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAGhC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAIzB,YAAY;IACZ,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAIjC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAK5B,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAM7B,QAAQ,CAAC,KAAK,EAAE,MAAM;IAGtB,SAAS,CAAC,KAAK,EAAE,MAAM;IAKvB,aAAa;IACb,aAAa;IAGb,OAAO,CAAC,QAAQ,EAAE,MAAM;IAKxB,WAAW;IACX,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAW,EAAE,IAAI,GAAE,MAAY;IAG/E,aAAa;YAEL,WAAW;IAqCzB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,gBAAgB;YAOV,kBAAkB;YAUlB,sBAAsB;YAmBtB,oBAAoB;YAMpB,kBAAkB;IAMhC,OAAO,CAAC,YAAY;CAkBvB"}
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../src/window.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGzD,qBAAa,MAAM;IACf,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,EAAE,aAAa,CAAC;IAEvB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,SAAS,CAAkB;IAEnC,eAAe,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,eAAe,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,CAAc;gBAEjG,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE;IAiBhG,IAAI,MAAM,kBAET;IAED,IAAI,SAAS,YAEZ;IAEK,GAAG;YAkBK,KAAK;IA+Bb,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAIzC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAItC,KAAK;IAQL,OAAO;IAKP,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IAGJ,OAAO;IACP,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAGrC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAIpC,WAAW;IACX,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAGhC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAIzB,YAAY;IACZ,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAIjC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAK5B,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAM7B,QAAQ,CAAC,KAAK,EAAE,MAAM;IAGtB,SAAS,CAAC,KAAK,EAAE,MAAM;IAKvB,aAAa;IACb,aAAa;IAGb,OAAO,CAAC,QAAQ,EAAE,MAAM;IAKxB,WAAW;IACX,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAW,EAAE,IAAI,GAAE,MAAY;IAG/E,aAAa;YAEL,WAAW;IAsCzB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,gBAAgB;YAOV,kBAAkB;YAUlB,sBAAsB;YAmBtB,oBAAoB;YAMpB,kBAAkB;IAMhC,OAAO,CAAC,YAAY;CAkBvB"}

package/dist/window.js

@@ -14,6 +14,7 @@ const utils_1 = require("./utils");
 class Window {
     constructor(platform, options, exposedFunctions) {
         this._menuCallbacks = new Map();
+        this._isClosed = false;
         this.on_context_menu = () => null;
         this.platform = platform;
         this.options = Object.assign({}, options);
@@ -32,6 +33,9 @@ class Window {
     get closed() {
         return this._closedPromise;
     }
+    get is_closed() {
+        return this._isClosed;
+    }
     run() {
         return __awaiter(this, void 0, void 0, function* () {
             this.controller = yield this.platform.createWindow(this.options);
@@ -50,16 +54,31 @@ class Window {
     }
     _call(method_1) {
         return __awaiter(this, arguments, void 0, function* (method, payload = null) {
+            if (this._isClosed) {
+                console.warn(`Cannot call ${method}: Window is closed`);
+                return null;
+            }
             if (!this.controller || !this.controller[method]) {
                 throw new Error(`Window not running or ${method} not supported`);
             }
-            const result = this.controller[method](payload);
-            // Check if method returns a Promise (node-api-dotnet JSCallback style)
-            if (result && typeof result.then === 'function') {
-                return result;
+            try {
+                const result = this.controller[method](payload);
+                // Check if method returns a Promise (node-api-dotnet JSCallback style)
+                if (result && typeof result.then === 'function') {
+                    return result;
+                }
+                else {
+                    return result;
+                }
             }
-            else {
-                return result;
+            catch (err) {
+                // If window was closed mid-operation, mark as closed and return null
+                if (err && err.message && err.message.includes('Window not initialized')) {
+                    this._isClosed = true;
+                    console.warn(`Window was closed during ${method} call`);
+                    return null;
+                }
+                throw err;
             }
         });
     }
@@ -76,7 +95,12 @@ class Window {
     }
     close() {
         return __awaiter(this, void 0, void 0, function* () {
-            return this._call('close');
+            if (this._isClosed)
+                return;
+            this._isClosed = true;
+            const result = yield this._call('close');
+            this._resolveClosed();
+            return result;
         });
     }
     destroy() {
@@ -201,6 +225,7 @@ class Window {
                 const params = this._parseParams(rawParams);
                 // Handle special messages
                 if (funcName === 'closed') {
+                    this._isClosed = true;
                     this._resolveClosed();
                     return null;
                 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ewvjs",
-  "version": "1.0.0",
-  "description": "Embedded WebView for JavaScript - Windows WebView2 bindings for Node.js",
+  "version": "1.0.1",
+  "description": "Embedded WebView for JavaScript - Edge WebView2 bindings for Node.js",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
@@ -39,19 +39,23 @@
   ],
   "author": "miukyo",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/miukyo/ewvjs"
+  },
   "type": "commonjs",
   "os": [
     "win32"
   ],
   "devDependencies": {
     "@types/node": "^25.2.0",
-    "@yao-pkg/pkg": "^6.12.0",
     "typescript": "^5.9.3"
   },
   "dependencies": {
+    "@yao-pkg/pkg": "^6.12.0",
     "archiver": "^7.0.1",
     "commander": "^12.1.0",
     "node-api-dotnet": "^0.9.19",
     "resedit": "^2.0.2"
   }
-}
+}