node-api-dotnet 0.3.1 → 0.4.4

package/README.md

@@ -48,6 +48,7 @@ For more examples, see the [examples](./examples/) directory.
  - [Stream across .NET and JS](#stream-across-net-and-js)
  - [Optional .NET native AOT compilation](#optional-net-native-aot-compilation)
  - [High performance](#high-performance)
+ - [Work with .NET generic APIs in JS](#generics)
 
 ### Load and call .NET assemblies from JS
 The `node-api-dotnet` package manages hosting the .NET runtime in the JS process
@@ -257,6 +258,17 @@ Thanks to these design choices, JS to .NET calls are [more than twice as fast](
     https://github.com/jasongin/napi-dotnet/pull/23) when compared to `edge-js` using
     [that project's benchmark](https://github.com/tjanczuk/edge/wiki/Performance).
 
+### Generics
+Even though the JavaScript runtime type system lacks generics, it is possible to work with .NET
+generic types and methods from JavaScript:
+
+```JavaScript
+// JavaScript
+System.Enum.Parse$(System.DayOfWeek)('Tuesday');
+```
+
+For details, see [Using .NET Generics in JavaScript](./docs/generics.md).
+
 ## Getting Started
 #### Requirements
  - .NET 6 or later

package/index.d.ts

@@ -6,18 +6,6 @@
 // This explicit module declaration enables module members to be merged with imported namespaces.
 declare module 'node-api-dotnet' {
 
-/**
- * A .NET assembly that was loaded dynamically by the .NET host. Types within the assembly
- * can be accessed via properties on the assembly object.
- */
-export interface Assembly {
-  /**
-   * Gets a type within the assembly.
-   * @param typeName Either a type full name or (if unambiguous) simple type name.
-   */
-  [typeName: string]: any;
-}
-
 /**
  * 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.
@@ -25,33 +13,32 @@ export interface Assembly {
  * @returns The JavaScript module exported by the assembly. (Type information for the module
  * may be available in a separate generated type-definitions file.)
  */
-export declare function require(dotnetAssemblyFilePath: string): any;
+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.
- * @param dotnetAssemblyFilePath Path to the .NET assembly DLL file to load.
- * @returns A JS object that represents the loaded assembly; each property of the object
- * is a public type in the assembly.
+ * 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.
  */
-export declare function load(dotnetAssemblyFilePath: string): Assembly | undefined;
+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 must call `load()`
  * to load the requested assembly file.
  */
-export declare function addListener(
+export function addListener(
   event: 'resolving',
   listener: (assemblyName: string, assemblyVersion: string) => void,
-): this;
+): void;
 
 /**
  * Removes a listener for the `resolving` event.
  */
-export declare function removeListener(
+export function removeListener(
   event: 'resolving',
   listener: (assemblyName: string, assemblyVersion: string) => void,
-): this;
+): void;
 
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-api-dotnet",
-  "version": "0.3.1",
+  "version": "0.4.4",
   "description": "Node-API bindings for .Net",
   "main": "index.js",
   "license": "MIT",