koffi 0.9.2 → 0.9.5

package/vendor/node-addon-api/doc/callback_scope.md

@@ -1,54 +1,54 @@
-# CallbackScope
-
-There are cases (for example, resolving promises) where it is necessary to have
-the equivalent of the scope associated with a callback in place when making
-certain Node-API calls.
-
-## Methods
-
-### Constructor
-
-Creates a new callback scope on the stack.
-
-```cpp
-Napi::CallbackScope::CallbackScope(napi_env env, napi_callback_scope scope);
-```
-
-- `[in] env`: The environment in which to create the `Napi::CallbackScope`.
-- `[in] scope`: The pre-existing `napi_callback_scope` or `Napi::CallbackScope`.
-
-### Constructor
-
-Creates a new callback scope on the stack.
-
-```cpp
-Napi::CallbackScope::CallbackScope(napi_env env, napi_async_context context);
-```
-
-- `[in] env`: The environment in which to create the `Napi::CallbackScope`.
-- `[in] async_context`: The pre-existing `napi_async_context` or `Napi::AsyncContext`.
-
-### Destructor
-
-Deletes the instance of `Napi::CallbackScope` object.
-
-```cpp
-virtual Napi::CallbackScope::~CallbackScope();
-```
-
-### Env
-
-```cpp
-Napi::Env Napi::CallbackScope::Env() const;
-```
-
-Returns the `Napi::Env` associated with the `Napi::CallbackScope`.
-
-## Operator
-
-```cpp
-Napi::CallbackScope::operator napi_callback_scope() const;
-```
-
-Returns the Node-API `napi_callback_scope` wrapped by the `Napi::CallbackScope`
-object. This can be used to mix usage of the C Node-API and node-addon-api.
+# CallbackScope
+
+There are cases (for example, resolving promises) where it is necessary to have
+the equivalent of the scope associated with a callback in place when making
+certain Node-API calls.
+
+## Methods
+
+### Constructor
+
+Creates a new callback scope on the stack.
+
+```cpp
+Napi::CallbackScope::CallbackScope(napi_env env, napi_callback_scope scope);
+```
+
+- `[in] env`: The environment in which to create the `Napi::CallbackScope`.
+- `[in] scope`: The pre-existing `napi_callback_scope` or `Napi::CallbackScope`.
+
+### Constructor
+
+Creates a new callback scope on the stack.
+
+```cpp
+Napi::CallbackScope::CallbackScope(napi_env env, napi_async_context context);
+```
+
+- `[in] env`: The environment in which to create the `Napi::CallbackScope`.
+- `[in] async_context`: The pre-existing `napi_async_context` or `Napi::AsyncContext`.
+
+### Destructor
+
+Deletes the instance of `Napi::CallbackScope` object.
+
+```cpp
+virtual Napi::CallbackScope::~CallbackScope();
+```
+
+### Env
+
+```cpp
+Napi::Env Napi::CallbackScope::Env() const;
+```
+
+Returns the `Napi::Env` associated with the `Napi::CallbackScope`.
+
+## Operator
+
+```cpp
+Napi::CallbackScope::operator napi_callback_scope() const;
+```
+
+Returns the Node-API `napi_callback_scope` wrapped by the `Napi::CallbackScope`
+object. This can be used to mix usage of the C Node-API and node-addon-api.

package/vendor/node-addon-api/doc/callbackinfo.md

@@ -1,97 +1,97 @@
-# CallbackInfo
-
-The object representing the components of the JavaScript request being made.
-
-The `Napi::CallbackInfo` object is usually created and passed by the Node.js runtime or node-addon-api infrastructure.
-
-The `Napi::CallbackInfo` object contains the arguments passed by the caller. The number of arguments is returned by the `Length` method. Each individual argument can be accessed using the `operator[]` method.
-
-The `SetData` and `Data` methods are used to set and retrieve the data pointer contained in the `Napi::CallbackInfo` object.
-
-## Methods
-
-### Constructor
-
-```cpp
-Napi::CallbackInfo::CallbackInfo(napi_env env, napi_callback_info info);
-```
-
-- `[in] env`: The `napi_env` environment in which to construct the `Napi::CallbackInfo` object.
-- `[in] info`: The `napi_callback_info` data structure from which to construct the `Napi::CallbackInfo` object.
-
-### Env
-
-```cpp
-Napi::Env Napi::CallbackInfo::Env() const;
-```
-
-Returns the `Env` object in which the request is being made.
-
-### NewTarget
-
-```cpp
-Napi::Value Napi::CallbackInfo::NewTarget() const;
-```
-
-Returns the `new.target` value of the constructor call. If the function that was invoked (and for which the `Napi::NCallbackInfo` was passed) is not a constructor call, a call to `IsEmpty()` on the returned value returns true.
-
-### IsConstructCall
-
-```cpp
-bool Napi::CallbackInfo::IsConstructCall() const;
-```
-
-Returns a `bool` indicating if the function that was invoked (and for which the `Napi::CallbackInfo` was passed) is a constructor call.
-
-### Length
-
-```cpp
-size_t Napi::CallbackInfo::Length() const;
-```
-
-Returns the number of arguments passed in the `Napi::CallbackInfo` object.
-
-### operator []
-
-```cpp
-const Napi::Value operator [](size_t index) const;
-```
-
-- `[in] index`: The zero-based index of the requested argument.
-
-Returns a `Napi::Value` object containing the requested argument.
-
-### This
-
-```cpp
-Napi::Value Napi::CallbackInfo::This() const;
-```
-
-Returns the JavaScript `this` value for the call
-
-### Data
-
-```cpp
-void* Napi::CallbackInfo::Data() const;
-```
-
-Returns the data pointer for the callback.
-
-### SetData
-
-```cpp
-void Napi::CallbackInfo::SetData(void* data);
-```
-
-- `[in] data`: The new data pointer to associate with this `Napi::CallbackInfo` object.
-
-Returns `void`.
-
-### Not documented here
-
-```cpp
-Napi::CallbackInfo::~CallbackInfo();
-// Disallow copying to prevent multiple free of _dynamicArgs
-Napi::CallbackInfo::CallbackInfo(CallbackInfo const &) = delete;
-void Napi::CallbackInfo::operator=(CallbackInfo const &) = delete;
-```
+# CallbackInfo
+
+The object representing the components of the JavaScript request being made.
+
+The `Napi::CallbackInfo` object is usually created and passed by the Node.js runtime or node-addon-api infrastructure.
+
+The `Napi::CallbackInfo` object contains the arguments passed by the caller. The number of arguments is returned by the `Length` method. Each individual argument can be accessed using the `operator[]` method.
+
+The `SetData` and `Data` methods are used to set and retrieve the data pointer contained in the `Napi::CallbackInfo` object.
+
+## Methods
+
+### Constructor
+
+```cpp
+Napi::CallbackInfo::CallbackInfo(napi_env env, napi_callback_info info);
+```
+
+- `[in] env`: The `napi_env` environment in which to construct the `Napi::CallbackInfo` object.
+- `[in] info`: The `napi_callback_info` data structure from which to construct the `Napi::CallbackInfo` object.
+
+### Env
+
+```cpp
+Napi::Env Napi::CallbackInfo::Env() const;
+```
+
+Returns the `Env` object in which the request is being made.
+
+### NewTarget
+
+```cpp
+Napi::Value Napi::CallbackInfo::NewTarget() const;
+```
+
+Returns the `new.target` value of the constructor call. If the function that was invoked (and for which the `Napi::NCallbackInfo` was passed) is not a constructor call, a call to `IsEmpty()` on the returned value returns true.
+
+### IsConstructCall
+
+```cpp
+bool Napi::CallbackInfo::IsConstructCall() const;
+```
+
+Returns a `bool` indicating if the function that was invoked (and for which the `Napi::CallbackInfo` was passed) is a constructor call.
+
+### Length
+
+```cpp
+size_t Napi::CallbackInfo::Length() const;
+```
+
+Returns the number of arguments passed in the `Napi::CallbackInfo` object.
+
+### operator []
+
+```cpp
+const Napi::Value operator [](size_t index) const;
+```
+
+- `[in] index`: The zero-based index of the requested argument.
+
+Returns a `Napi::Value` object containing the requested argument.
+
+### This
+
+```cpp
+Napi::Value Napi::CallbackInfo::This() const;
+```
+
+Returns the JavaScript `this` value for the call
+
+### Data
+
+```cpp
+void* Napi::CallbackInfo::Data() const;
+```
+
+Returns the data pointer for the callback.
+
+### SetData
+
+```cpp
+void Napi::CallbackInfo::SetData(void* data);
+```
+
+- `[in] data`: The new data pointer to associate with this `Napi::CallbackInfo` object.
+
+Returns `void`.
+
+### Not documented here
+
+```cpp
+Napi::CallbackInfo::~CallbackInfo();
+// Disallow copying to prevent multiple free of _dynamicArgs
+Napi::CallbackInfo::CallbackInfo(CallbackInfo const &) = delete;
+void Napi::CallbackInfo::operator=(CallbackInfo const &) = delete;
+```

package/vendor/node-addon-api/doc/checker-tool.md

@@ -1,32 +1,32 @@
-# Checker Tool
-
-**node-addon-api** provides a [checker tool][] that will inspect a given
-directory tree, identifying all Node.js native addons therein, and further
-indicating for each addon whether it is an Node-API addon.
-
-## To use the checker tool:
-
-  1. Install the application with `npm install`.
-
-  2. If the application does not depend on **node-addon-api**, copy the
-     checker tool into the application's directory.
-
-  3. If the application does not depend on **node-addon-api**, run the checker
-     tool from the application's directory:
-
-     ```sh
-     node ./check-napi.js
-     ```
-
-     Otherwise, the checker tool can be run from the application's
-     `node_modules/` subdirectory:
-
-     ```sh
-     node ./node_modules/node-addon-api/tools/check-napi.js
-     ```
-
-The tool accepts the root directory from which to start checking for Node.js
-native addons as a single optional command line parameter. If omitted it will
-start checking from the current directory (`.`).
-
-[checker tool]: ../tools/check-napi.js
+# Checker Tool
+
+**node-addon-api** provides a [checker tool][] that will inspect a given
+directory tree, identifying all Node.js native addons therein, and further
+indicating for each addon whether it is an Node-API addon.
+
+## To use the checker tool:
+
+  1. Install the application with `npm install`.
+
+  2. If the application does not depend on **node-addon-api**, copy the
+     checker tool into the application's directory.
+
+  3. If the application does not depend on **node-addon-api**, run the checker
+     tool from the application's directory:
+
+     ```sh
+     node ./check-napi.js
+     ```
+
+     Otherwise, the checker tool can be run from the application's
+     `node_modules/` subdirectory:
+
+     ```sh
+     node ./node_modules/node-addon-api/tools/check-napi.js
+     ```
+
+The tool accepts the root directory from which to start checking for Node.js
+native addons as a single optional command line parameter. If omitted it will
+start checking from the current directory (`.`).
+
+[checker tool]: ../tools/check-napi.js

package/vendor/node-addon-api/doc/class_property_descriptor.md

@@ -1,115 +1,115 @@
-# Class property and descriptor
-
-Property descriptor for use with `Napi::ObjectWrap::DefineClass()`.
-This is different from the standalone `Napi::PropertyDescriptor` because it is
-specific to each `Napi::ObjectWrap<T>` subclass.
-This prevents using descriptors from a different class when defining a new class
-(preventing the callbacks from having incorrect `this` pointers).
-
-## Example
-
-```cpp
-#include <napi.h>
-
-class Example : public Napi::ObjectWrap<Example> {
-  public:
-    static Napi::Object Init(Napi::Env env, Napi::Object exports);
-    Example(const Napi::CallbackInfo &info);
-
-  private:
-    double _value;
-    Napi::Value GetValue(const Napi::CallbackInfo &info);
-    void SetValue(const Napi::CallbackInfo &info, const Napi::Value &value);
-};
-
-Napi::Object Example::Init(Napi::Env env, Napi::Object exports) {
-    Napi::Function func = DefineClass(env, "Example", {
-        // Register a class instance accessor with getter and setter functions.
-        InstanceAccessor<&Example::GetValue, &Example::SetValue>("value"),
-        // We can also register a readonly accessor by omitting the setter.
-        InstanceAccessor<&Example::GetValue>("readOnlyProp")
-    });
-
-    Napi::FunctionReference *constructor = new Napi::FunctionReference();
-    *constructor = Napi::Persistent(func);
-    env.SetInstanceData(constructor);
-    exports.Set("Example", func);
-
-    return exports;
-}
-
-Example::Example(const Napi::CallbackInfo &info) : Napi::ObjectWrap<Example>(info) {
-    Napi::Env env = info.Env();
-    // ...
-    Napi::Number value = info[0].As<Napi::Number>();
-    this->_value = value.DoubleValue();
-}
-
-Napi::Value Example::GetValue(const Napi::CallbackInfo &info) {
-    Napi::Env env = info.Env();
-    return Napi::Number::New(env, this->_value);
-}
-
-void Example::SetValue(const Napi::CallbackInfo &info, const Napi::Value &value) {
-    Napi::Env env = info.Env();
-    // ...
-    Napi::Number arg = value.As<Napi::Number>();
-    this->_value = arg.DoubleValue();
-}
-
-// Initialize native add-on
-Napi::Object Init (Napi::Env env, Napi::Object exports) {
-    Example::Init(env, exports);
-    return exports;
-}
-
-// Register and initialize native add-on
-NODE_API_MODULE(NODE_GYP_MODULE_NAME, Init)
-```
-
-The above code can be used from JavaScript as follows:
-
-```js
-'use strict';
-
-const { Example } = require('bindings')('addon');
-
-const example = new Example(11);
-console.log(example.value);
-// It prints 11
-example.value = 19;
-console.log(example.value);
-// It prints 19
-example.readOnlyProp = 500;
-console.log(example.readOnlyProp);
-// Unchanged. It prints 19
-```
-
-## Methods
-
-### Constructor
-
-Creates new instance of `Napi::ClassPropertyDescriptor` descriptor object.
-
-```cpp
-Napi::ClassPropertyDescriptor(napi_property_descriptor desc) : _desc(desc) {}
-```
-
-- `[in] desc`: The `napi_property_descriptor`
-
-Returns new instance of `Napi::ClassPropertyDescriptor` that is used as property descriptor
-inside the `Napi::ObjectWrap<T>` class.
-
-### Operator
-
-```cpp
-operator napi_property_descriptor&() { return _desc; }
-```
-
-Returns the original Node-API `napi_property_descriptor` wrapped inside the `Napi::ClassPropertyDescriptor`
-
-```cpp
-operator const napi_property_descriptor&() const { return _desc; }
-```
-
-Returns the original Node-API `napi_property_descriptor` wrapped inside the `Napi::ClassPropertyDescriptor`
+# Class property and descriptor
+
+Property descriptor for use with `Napi::ObjectWrap::DefineClass()`.
+This is different from the standalone `Napi::PropertyDescriptor` because it is
+specific to each `Napi::ObjectWrap<T>` subclass.
+This prevents using descriptors from a different class when defining a new class
+(preventing the callbacks from having incorrect `this` pointers).
+
+## Example
+
+```cpp
+#include <napi.h>
+
+class Example : public Napi::ObjectWrap<Example> {
+  public:
+    static Napi::Object Init(Napi::Env env, Napi::Object exports);
+    Example(const Napi::CallbackInfo &info);
+
+  private:
+    double _value;
+    Napi::Value GetValue(const Napi::CallbackInfo &info);
+    void SetValue(const Napi::CallbackInfo &info, const Napi::Value &value);
+};
+
+Napi::Object Example::Init(Napi::Env env, Napi::Object exports) {
+    Napi::Function func = DefineClass(env, "Example", {
+        // Register a class instance accessor with getter and setter functions.
+        InstanceAccessor<&Example::GetValue, &Example::SetValue>("value"),
+        // We can also register a readonly accessor by omitting the setter.
+        InstanceAccessor<&Example::GetValue>("readOnlyProp")
+    });
+
+    Napi::FunctionReference *constructor = new Napi::FunctionReference();
+    *constructor = Napi::Persistent(func);
+    env.SetInstanceData(constructor);
+    exports.Set("Example", func);
+
+    return exports;
+}
+
+Example::Example(const Napi::CallbackInfo &info) : Napi::ObjectWrap<Example>(info) {
+    Napi::Env env = info.Env();
+    // ...
+    Napi::Number value = info[0].As<Napi::Number>();
+    this->_value = value.DoubleValue();
+}
+
+Napi::Value Example::GetValue(const Napi::CallbackInfo &info) {
+    Napi::Env env = info.Env();
+    return Napi::Number::New(env, this->_value);
+}
+
+void Example::SetValue(const Napi::CallbackInfo &info, const Napi::Value &value) {
+    Napi::Env env = info.Env();
+    // ...
+    Napi::Number arg = value.As<Napi::Number>();
+    this->_value = arg.DoubleValue();
+}
+
+// Initialize native add-on
+Napi::Object Init (Napi::Env env, Napi::Object exports) {
+    Example::Init(env, exports);
+    return exports;
+}
+
+// Register and initialize native add-on
+NODE_API_MODULE(NODE_GYP_MODULE_NAME, Init)
+```
+
+The above code can be used from JavaScript as follows:
+
+```js
+'use strict';
+
+const { Example } = require('bindings')('addon');
+
+const example = new Example(11);
+console.log(example.value);
+// It prints 11
+example.value = 19;
+console.log(example.value);
+// It prints 19
+example.readOnlyProp = 500;
+console.log(example.readOnlyProp);
+// Unchanged. It prints 19
+```
+
+## Methods
+
+### Constructor
+
+Creates new instance of `Napi::ClassPropertyDescriptor` descriptor object.
+
+```cpp
+Napi::ClassPropertyDescriptor(napi_property_descriptor desc) : _desc(desc) {}
+```
+
+- `[in] desc`: The `napi_property_descriptor`
+
+Returns new instance of `Napi::ClassPropertyDescriptor` that is used as property descriptor
+inside the `Napi::ObjectWrap<T>` class.
+
+### Operator
+
+```cpp
+operator napi_property_descriptor&() { return _desc; }
+```
+
+Returns the original Node-API `napi_property_descriptor` wrapped inside the `Napi::ClassPropertyDescriptor`
+
+```cpp
+operator const napi_property_descriptor&() const { return _desc; }
+```
+
+Returns the original Node-API `napi_property_descriptor` wrapped inside the `Napi::ClassPropertyDescriptor`