ewvjs 1.0.7 → 1.0.9

package/package.json

@@ -1,55 +1,54 @@
-{
-  "name": "ewvjs",
-  "version": "1.0.7",
-  "description": "Embedded WebView for JavaScript - Edge WebView2 bindings for Node.js",
-  "workspaces": [
-    "packages/*"
-  ],
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist/**/*",
-    "native/**/*",
-    "src/csharp/bin/Release/**/*",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "prebuild": "node scripts/copy-native.js",
-    "build": "npm run prebuild && tsc",
-    "build:webview": "dotnet build src/csharp/WebView.csproj -c Release"
-  },
-  "keywords": [
-    "webview",
-    "webview2",
-    "windows",
-    "electron-alternative",
-    "gui",
-    "native",
-    "packaging",
-    "cli"
-  ],
-  "author": "miukyo",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/miukyo/ewvjs"
-  },
-  "type": "commonjs",
-  "os": [
-    "win32"
-  ],
-  "devDependencies": {
-    "@types/node": "^25.2.0",
-    "typescript": "^5.9.3"
-  },
-  "dependencies": {
-    "node-api-dotnet": "^0.9.19"
-  }
-}
+{
+  "name": "ewvjs",
+  "version": "1.0.9",
+  "description": "Embedded WebView for JavaScript - Edge WebView2 bindings for Node.js",
+  "workspaces": [
+    "packages/*"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*",
+    "native/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "prebuild": "node scripts/copy-native.js",
+    "build": "npm run prebuild && tsc",
+    "build:webview": "dotnet build src/csharp/WebView.csproj -c Release"
+  },
+  "keywords": [
+    "webview",
+    "webview2",
+    "windows",
+    "electron-alternative",
+    "gui",
+    "native",
+    "packaging",
+    "cli"
+  ],
+  "author": "miukyo",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/miukyo/ewvjs"
+  },
+  "type": "commonjs",
+  "os": [
+    "win32"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "node-api-dotnet": "^0.9.19"
+  }
+}

package/native/node_modules/node-api-dotnet/README.md

@@ -1,80 +0,0 @@
-# Node API for .NET: JavaScript + .NET Interop
-
-This project enables advanced interoperability between .NET and JavaScript in the same process.
-
- - Load .NET assemblies and call .NET APIs in-proc from a JavaScript application.
- - Load JavaScript packages and call JS APIs in-proc from a .NET application.
-
-Interop is high-performance and supports TypeScript type-definitions generation, async
-(tasks/promises), streams, and more. It uses [Node API](https://nodejs.org/api/n-api.html) so
-it is compatible with any Node.js version (without recompiling) or other JavaScript runtime that
-supports Node API.
-
-:warning: _**Status: Public Preview** - Most functionality works well, though there are some known
-limitations around the edges, and there may still be minor breaking API changes._
-
-### Documentation
-
-Getting-started guidance, feature details, and API reference documentation are published at
-https://microsoft.github.io/node-api-dotnet
-
-### Minimal example - JS calling .NET
-```JavaScript
-// JavaScript
-const Console = require('node-api-dotnet').System.Console;
-Console.WriteLine('Hello from .NET!'); // JS writes to the .NET console API
-```
-
-### Minimal example - .NET calling JS
-```C#
-// C#
-interface IConsole { void Log(string message); }
-
-var nodejs = new NodejsPlatform(libnodePath).CreateEnvironment();
-nodejs.Run(() =>
-{
-    var console = nodejs.Import<IConsole>("global", "console");
-    console.Log("Hello from JS!"); // C# writes to the JS console API
-});
-```
-
-## Packages
-
-Depending on the [scenario](https://microsoft.github.io/node-api-dotnet/scenarios/),
-either NPM or NuGet packages may be used:
- - NPM: [`node-api-dotnet`](https://www.npmjs.com/package/node-api-dotnet)
- - NuGet: [`Microsoft.JavaScript.NodeApi`](https://www.nuget.org/packages/Microsoft.JavaScript.NodeApi/)
-
-See [Packages & Releases](https://microsoft.github.io/node-api-dotnet/reference/packages-releases.html)
-for details.
-
-## Development
-
-For information about building, testing, and debugging this project, see
-[README-DEV.md](./README-DEV.md).
-
-Contributions require agreement to the
-[Contributor License Agreement](https://microsoft.github.io/node-api-dotnet/contributing.html#contributor-license-agreement).
-
-## Code of Conduct
-
-This project has adopted the
-[Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
-For more information see the
-[Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
-contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or
-comments.
-
-## Trademarks
-
-This project may contain trademarks or logos for projects, products, or services. Authorized use of
-Microsoft trademarks or logos is subject to and must follow
-[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
-Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion
-or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those
-third-party's policies.
-
-<br/>
-<br/>
-
-![.NET + JS scene](./docs/images/dotnet-bot_scene_coffee-shop.png)

package/native/node_modules/node-api-dotnet/index.d.ts

@@ -1,98 +0,0 @@
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT License.
-
-/**
- * Use the `node-api-dotnet` package to load .NET assemblies into a Node.js application and
- * call public APIs defined in the assemblies.
- * ::: code-group
- * ```JavaScript [ES (TS or JS)]
- * import dotnet from 'node-api-dotnet';
- * ```
- * ```TypeScript [CommonJS (TS)]
- * import * as dotnet from 'node-api-dotnet';
- * ```
- * ```JavaScript [CommonJS (JS)]
- * const dotnet = require('node-api-dotnet');
- * ```
- * :::
- * To load a specific version of .NET, append the target framework moniker to the package name:
- * ::: code-group
- * ```JavaScript [ES (TS or JS)]
- * import dotnet from 'node-api-dotnet/net8.0';
- * ```
- * ```TypeScript [CommonJS (TS)]
- * import * as dotnet from 'node-api-dotnet/net8.0';
- * ```
- * ```JavaScript [CommonJS (JS)]
- * const dotnet = require('node-api-dotnet/net8.0');
- * ```
- * :::
- * Currently the supported target frameworks are `net472`, `net8.0`, and `net9.0`.
- * @module node-api-dotnet
- */
-declare module 'node-api-dotnet' {
-// APIs defined here are implemented by Microsoft.JavaScript.NodeApi.DotNetHost.
-// The explicit module declaration enables module members to be merged with imported namespaces.
-
-/**
- * Gets the current .NET runtime version, for example "8.0.1".
- */
-export const runtimeVersion: string;
-
-/**
- * Gets the framework monikier corresponding to the current .NET runtime version,
- * for example "net8.0" or "net472".
- */
-export const frameworkMoniker: string;
-
-/**
- * Loads a .NET assembly that was built to be a Node API module, using static binding to
- * the APIs the module specifically exports to JS.
- * @param dotnetAssemblyFilePath Path to the .NET assembly DLL file.
- * @returns The JavaScript module exported by the assembly. (Type information for the module
- * may be available in a separate generated type-definitions file.)
- * @description The .NET assembly must use `[JSExport]` attributes to export selected types
- * and/or members to JavaScript. These exports _do not_ use .NET namespaces.
- */
-export function require(dotnetAssemblyFilePath: string): any;
-
-/**
- * Loads an arbitrary .NET assembly that isn't necessarily designed as a JS module, enabling
- * dynamic invocation of any APIs in the assembly. After loading, types from the assembly are
- * available via namespaces on the main dotnet module.
- * @param assemblyNameOrFilePath Path to the .NET assembly DLL file, or name of a system assembly.
- * @description After loading an assembly, types in the assembly are merged into the .NET
- * namespace hierarchy, with top-level namespaces available as properties on the .NET module.
- * For example, if the assembly defines a type `Contoso.Business.Component`, it can be accessed as
- * `dotnet.Contoso.Business.Component`. (.NET core library types can be accessed the same way, for
- * example `dotnet.System.Console`.)
- */
-export function load(assemblyNameOrFilePath: string): void;
-
-/**
- * Adds a listener for the `resolving` event, which is raised when a .NET assembly requires
- * an additional dependent assembly to be resolved and loaded. The listener may call `resolve()`
- * to load the requested assembly from a resolved file path. If the listener does not call
- * `resolve()`, the runtime will then attempt to resolve the assembly by searching in the same
- * application directory as other already-loaded assemblies, if there were any.
- */
-export function addListener(
-  event: 'resolving',
-  /**
-   * Resolving event listener funciton to be invokved when a .NET assembly is being resolved.
-   * @param assemblyName Name of the assembly to be resolved.
-   * @param assemblyVersion Version of the assembly to be resolved.
-   * @param resolve Callback to invoke with the full path to the resolved assembly file.
-   */
-  listener: (assemblyName: string, assemblyVersion: string, resolve: (string) => void) => void,
-): void;
-
-/**
- * Removes a listener for the `resolving` event.
- */
-export function removeListener(
-  event: 'resolving',
-  listener: (assemblyName: string, assemblyVersion: string) => void,
-): void;
-
-}

package/native/node_modules/node-api-dotnet/net472/Microsoft.JavaScript.NodeApi.runtimeconfig.json

@@ -1,9 +0,0 @@
-{
-  "runtimeOptions": {
-    "tfm": "net472",
-    "configProperties": {
-      "System.Reflection.Metadata.MetadataUpdater.IsSupported": false,
-      "System.Runtime.InteropServices.EnableConsumingManagedCodeFromNativeHosting": true
-    }
-  }
-}

package/native/node_modules/node-api-dotnet/net472.d.ts

@@ -1,2 +0,0 @@
-import './index';
-export * from 'node-api-dotnet';

package/native/node_modules/node-api-dotnet/net472.js

@@ -1,2 +0,0 @@
-const initialize = require('./init');
-module.exports = initialize('net472');

package/native/node_modules/node-api-dotnet/net8.0/Microsoft.JavaScript.NodeApi.runtimeconfig.json

@@ -1,14 +0,0 @@
-{
-  "runtimeOptions": {
-    "tfm": "net8.0",
-    "framework": {
-      "name": "Microsoft.NETCore.App",
-      "version": "8.0.0"
-    },
-    "configProperties": {
-      "System.Reflection.Metadata.MetadataUpdater.IsSupported": false,
-      "System.Runtime.Serialization.EnableUnsafeBinaryFormatterSerialization": false,
-      "System.Runtime.InteropServices.EnableConsumingManagedCodeFromNativeHosting": true
-    }
-  }
-}

package/native/node_modules/node-api-dotnet/net8.0.d.ts

@@ -1,2 +0,0 @@
-import './index';
-export * from 'node-api-dotnet';

package/native/node_modules/node-api-dotnet/net8.0.js

@@ -1,2 +0,0 @@
-const initialize = require('./init');
-module.exports = initialize('net8.0');

package/native/node_modules/node-api-dotnet/net9.0.d.ts

@@ -1,2 +0,0 @@
-import './index';
-export * from 'node-api-dotnet';

package/native/node_modules/node-api-dotnet/package.json

@@ -1,27 +0,0 @@
-{
-  "name": "node-api-dotnet",
-  "version": "0.9.19",
-  "description": "Node-API bindings for .Net",
-  "license": "MIT",
-  "author": "Microsoft",
-  "type": "commonjs",
-  "exports": {
-    ".": "./index.js",
-    "./net10.0": "./net10.0.js",
-    "./net9.0": "./net9.0.js",
-    "./net8.0": "./net8.0.js",
-    "./net472": "./net472.js"
-  },
-  "types": "./index.d.ts",
-  "keywords": [
-    "Node-API",
-    "NAPI",
-    ".Net",
-    "dotnet"
-  ],
-  "repository": "github:microsoft/node-api-dotnet",
-  "homepage": "https://github.com/microsoft/node-api-dotnet#readme",
-  "bugs": {
-    "url": "https://github.com/microsoft/node-api-dotnet/issues"
-  }
-}

package/src/README.md

@@ -1,125 +0,0 @@
-# Source Code Structure
-
-The TypeScript source code is organized into logical modules for better readability and maintainability.
-
-## Module Overview
-
-### `index.ts`
-Main entry point that exports the public API. This is what users import when using ewvjs.
-
-**Exports:**
-- `WebView` class
-- `Window` class
-- All type definitions
-- Convenience functions: `create_window()`, `start()`, `expose()`
-- Default singleton instance
-
-### `webview.ts`
-Contains the `WebView` class which manages the application lifecycle.
-
-**Responsibilities:**
-- Platform detection and initialization
-- Window creation and lifecycle management
-- Exposed function registry
-- Event loop management
-
-**Key Methods:**
-- `create_window()` - Creates a new window instance
-- `start()` - Starts the application event loop
-- `expose()` - Registers Node.js functions to be callable from WebView
-
-### `window.ts`
-Contains the `Window` class which represents individual window instances.
-
-**Responsibilities:**
-- Window state management
-- Message routing between WebView and Node.js
-- Context menu handling
-- Exposed function call/response handling
-- API method delegation to platform
-
-**Method Categories:**
-- **Core**: `run()`, `close()`, `evaluate_js()`
-- **State**: `maximize()`, `minimize()`, `restore()`, `show()`, `hide()`, `focus()`
-- **Size/Position**: `getSize()`, `setSize()`, `getPosition()`, `setPosition()`, `move()`, `resize()`
-- **Title**: `setTitle()`, `set_title()`
-- **Title Bar**: `show_titlebar()`, `hide_titlebar()`
-- **Cookies**: `get_cookies()`, `set_cookie()`, `clear_cookies()`
-
-**Message Handling:**
-- `_on_message()` - Routes messages from C# to appropriate handlers
-- `_handleExposedFunction()` - Executes exposed Node.js functions
-- `_handleContextMenu()` - Processes context menu requests
-- `_handleMenuClick()` - Triggers menu item callbacks
-
-### `types.ts`
-Type definitions and interfaces.
-
-**Types:**
-- `ContextMenuItem` - Context menu item definition
-- `WindowOptions` - Window configuration options
-
-### `utils.ts`
-Utility functions used across modules.
-
-**Functions:**
-- `getParamNames()` - Extracts parameter names from a function
-- `generateId()` - Generates random IDs for menu items
-
-## Data Flow
-
-```
-User Code
-    ↓
-index.ts (exports)
-    ↓
-webview.ts (creates Window instances)
-    ↓
-window.ts (manages window lifecycle)
-    ↓
-platforms/windows.ts (platform-specific implementation)
-    ↓
-csharp/WebViewWindow.cs (native WebView2 integration)
-```
-
-## Message Flow (Exposed Functions)
-
-```
-WebView JavaScript
-    ↓ postMessage([funcName, params, id])
-C# WebViewWindow.CoreWebView2_WebMessageReceived
-    ↓ SendMessageAsync()
-window.ts _on_message()
-    ↓ _handleExposedFunction()
-Node.js Function Execution
-    ↓ _sendSuccessResponse()
-window.evaluate_js()
-    ↓ resolves promise in WebView
-WebView JavaScript receives result
-```
-
-## Best Practices
-
-1. **Window Creation**: Always call `window.run()` after creating a window
-2. **Exposed Functions**: Register with `expose()` before creating windows
-3. **Cleanup**: Windows automatically clean up on close
-4. **Error Handling**: All async methods can throw - use try/catch
-5. **Threading**: All window operations are automatically marshaled to the correct thread
-
-## Example Usage
-
-```typescript
-import ewvjs from 'ewvjs';
-
-// Expose a Node.js function
-ewvjs.expose('greet', (name: string) => {
-    return `Hello, ${name}!`;
-});
-
-// Create and run a window
-const win = ewvjs.create_window('My App', '<h1>Test</h1>');
-await win.run();
-
-// Start the event loop
-await ewvjs.start();
-```