napi 0.17.0

Generate Dart bindings for Node-API addons and WebAssembly modules.

0.17.0

• Support resource objects inside const container defaults, with operation leases and disposal behavior matching explicit inputs.
• Extend JsArray and JsMap elements with references, resources, binary values, nested handles, copied structures, value classes and typed function values. Preserve the original JavaScript container and validate elements on access.
• Export Dart function values through fields, copied containers and higher-order signatures, including Future and Stream results. Preserve function identity when the input and output conversions agree.
• Support optional and named callback parameters, binary and structured payloads, and selected class references. Keep asynchronous resource leases tied to actual callback payloads.
• Infer value-class input constructors from Dart declarations; select a different constructor or factory with @NAPI(). Remove the valueConstructor option; existing declarations using it must migrate to constructor selection.
• Fix nullable and non-nullable function values sharing a generated adapter, and describe asymmetric value-class function conversions accurately in TypeScript.

0.16.1

• Fix const-default type-cast failures for package lib/ files and relative reexports. Preserve Dart library identities and diagnose conflicting file/package imports before generation. Rebuild generated npm packages after upgrading.

0.16.0

• Support const reference and value objects as Dart defaults, directly and inside supported List, Map, Dictionary and record defaults. Preserve canonical Dart identity, generic types and public factory constructors.
• Use public const variables and static constants for object defaults with private constructors or auxiliary Dart values, including private aliases.
• Support direct const resource defaults with the same operation leases and disposal behavior as explicit inputs, including Futures, Streams and reentry.
• Refresh usage guides for annotations, external selections, shared JavaScript containers and native runtime distribution.

0.15.0

• Rebuild binding generation around one @NAPI() export model and the separate package:napi/build.dart API. See migration notes for changes from the earlier builder and runtime APIs.
• Add experimental native Node-API addons on macOS arm64 alongside Dart Wasm. Native builds automatically download and cache the matching precompiled runtime; application builds need only the ordinary Dart 3.13.5 SDK.
• Preserve JavaScript constructors, class inheritance and object identity, Dart defaults and argument presence, exact UTF-16 strings, and integer precision.
• Convert Lists, Maps, dictionaries, records and configured value classes; support structural constant defaults and explicit binary snapshots or shared byte views.
• Support opaque generic payloads, generic methods and concrete generic aliases with shared TypeScript declarations across both targets.
• Add Futures and Promises, retained synchronous and asynchronous callbacks, bounded async iteration, cooperative cancellation, and resource disposal.
• Share JavaScript Arrays and Maps through explicit JsArray/JsMap handles, including handles nested in copied structures and callback signatures.
• Build complete native, Wasm or dual-target npm packages with automatic loaders, matching type declarations and licenses. Rebuild managed packages atomically on local macOS APFS.

0.14.0

• Support binary Lists with Uint8Array elements and independent snapshots.
• Include Dart documentation in generated TypeScript declarations.
• Generate distinct TypeScript names for Dart wildcard parameters.
• Allow source packages with older language versions to use the Dart 3.13.5 build SDK.

Earlier release notes are available in Git history.