@diia-inhouse/genproto 1.15.0 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@diia-inhouse/genproto",
-    "version": "1.15.0",
+    "version": "2.0.0",
     "description": "JS codegen from proto with imports from @diia-inhouse/types",
     "bin": {
         "genproto": "./dist/genproto.js"
@@ -24,9 +24,11 @@
     "dependencies": {
         "glob": "11.0.0",
         "lookpath": "1.2.2",
-        "ts-proto": "1.181.0",
         "yargs": "17.7.2"
     },
+    "peerDependencies": {
+        "ts-proto": ">=1.181.0"
+    },
     "devDependencies": {
         "@diia-inhouse/configs": "2.0.0",
         "@diia-inhouse/eslint-config": "5.1.0",
@@ -35,7 +37,7 @@
         "lockfile-lint": "4.14.0",
         "madge": "7.0.0",
         "prettier": "3.3.2",
-        "rimraf": "6.0.0",
+        "rimraf": "6.0.1",
         "semantic-release": "24.0.0"
     },
     "eslintConfig": {
@@ -66,8 +68,5 @@
     "prettier": "@diia-inhouse/eslint-config/prettier",
     "madge": {
         "tsConfig": "./tsconfig.json"
-    },
-    "bundleDependencies": [
-        "ts-proto"
-    ]
+    }
 }

package/node_modules/@protobufjs/aspromise/LICENSE

@@ -1,26 +0,0 @@
-Copyright (c) 2016, Daniel Wirtz  All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-* Redistributions of source code must retain the above copyright
-  notice, this list of conditions and the following disclaimer.
-* Redistributions in binary form must reproduce the above copyright
-  notice, this list of conditions and the following disclaimer in the
-  documentation and/or other materials provided with the distribution.
-* Neither the name of its author, nor the names of its contributors
-  may be used to endorse or promote products derived from this software
-  without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/node_modules/@protobufjs/aspromise/README.md

@@ -1,13 +0,0 @@
-@protobufjs/aspromise
-=====================
-[![npm](https://img.shields.io/npm/v/@protobufjs/aspromise.svg)](https://www.npmjs.com/package/@protobufjs/aspromise)
-
-Returns a promise from a node-style callback function.
-
-API
----
-
-* **asPromise(fn: `function`, ctx: `Object`, ...params: `*`): `Promise<*>`**<br />
-  Returns a promise from a node-style callback function.
-
-**License:** [BSD 3-Clause License](https://opensource.org/licenses/BSD-3-Clause)

package/node_modules/@protobufjs/aspromise/index.d.ts

@@ -1,13 +0,0 @@
-export = asPromise;
-
-type asPromiseCallback = (error: Error | null, ...params: any[]) => {};
-
-/**
- * Returns a promise from a node-style callback function.
- * @memberof util
- * @param {asPromiseCallback} fn Function to call
- * @param {*} ctx Function context
- * @param {...*} params Function arguments
- * @returns {Promise<*>} Promisified function
- */
-declare function asPromise(fn: asPromiseCallback, ctx: any, ...params: any[]): Promise<any>;

package/node_modules/@protobufjs/aspromise/index.js

@@ -1,52 +0,0 @@
-"use strict";
-module.exports = asPromise;
-
-/**
- * Callback as used by {@link util.asPromise}.
- * @typedef asPromiseCallback
- * @type {function}
- * @param {Error|null} error Error, if any
- * @param {...*} params Additional arguments
- * @returns {undefined}
- */
-
-/**
- * Returns a promise from a node-style callback function.
- * @memberof util
- * @param {asPromiseCallback} fn Function to call
- * @param {*} ctx Function context
- * @param {...*} params Function arguments
- * @returns {Promise<*>} Promisified function
- */
-function asPromise(fn, ctx/*, varargs */) {
-    var params  = new Array(arguments.length - 1),
-        offset  = 0,
-        index   = 2,
-        pending = true;
-    while (index < arguments.length)
-        params[offset++] = arguments[index++];
-    return new Promise(function executor(resolve, reject) {
-        params[offset] = function callback(err/*, varargs */) {
-            if (pending) {
-                pending = false;
-                if (err)
-                    reject(err);
-                else {
-                    var params = new Array(arguments.length - 1),
-                        offset = 0;
-                    while (offset < params.length)
-                        params[offset++] = arguments[offset];
-                    resolve.apply(null, params);
-                }
-            }
-        };
-        try {
-            fn.apply(ctx || null, params);
-        } catch (err) {
-            if (pending) {
-                pending = false;
-                reject(err);
-            }
-        }
-    });
-}

package/node_modules/@protobufjs/aspromise/package.json

@@ -1,21 +0,0 @@
-{
-  "name": "@protobufjs/aspromise",
-  "description": "Returns a promise from a node-style callback function.",
-  "version": "1.1.2",
-  "author": "Daniel Wirtz <dcode+protobufjs@dcode.io>",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/dcodeIO/protobuf.js.git"
-  },
-  "license": "BSD-3-Clause",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "devDependencies": {
-    "istanbul": "^0.4.5",
-    "tape": "^4.6.3"
-  },
-  "scripts": {
-    "test": "tape tests/*.js",
-    "coverage": "istanbul cover node_modules/tape/bin/tape tests/*.js"
-  }
-}

package/node_modules/@protobufjs/aspromise/tests/index.js

@@ -1,130 +0,0 @@
-var tape = require("tape");
-
-var asPromise = require("..");
-
-tape.test("aspromise", function(test) {
-
-    test.test(this.name + " - resolve", function(test) {
-
-        function fn(arg1, arg2, callback) {
-            test.equal(this, ctx, "function should be called with this = ctx");
-            test.equal(arg1, 1, "function should be called with arg1 = 1");
-            test.equal(arg2, 2, "function should be called with arg2 = 2");
-            callback(null, arg2);
-        }
-
-        var ctx = {};
-
-        var promise = asPromise(fn, ctx, 1, 2);
-        promise.then(function(arg2) {
-            test.equal(arg2, 2, "promise should be resolved with arg2 = 2");
-            test.end();
-        }).catch(function(err) {
-            test.fail("promise should not be rejected (" + err + ")");
-        });
-    });
-
-    test.test(this.name + " - reject", function(test) {
-
-        function fn(arg1, arg2, callback) {
-            test.equal(this, ctx, "function should be called with this = ctx");
-            test.equal(arg1, 1, "function should be called with arg1 = 1");
-            test.equal(arg2, 2, "function should be called with arg2 = 2");
-            callback(arg1);
-        }
-
-        var ctx = {};
-
-        var promise = asPromise(fn, ctx, 1, 2);
-        promise.then(function() {
-            test.fail("promise should not be resolved");
-        }).catch(function(err) {
-            test.equal(err, 1, "promise should be rejected with err = 1");
-            test.end();
-        });
-    });
-
-    test.test(this.name + " - resolve twice", function(test) {
-
-        function fn(arg1, arg2, callback) {
-            test.equal(this, ctx, "function should be called with this = ctx");
-            test.equal(arg1, 1, "function should be called with arg1 = 1");
-            test.equal(arg2, 2, "function should be called with arg2 = 2");
-            callback(null, arg2);
-            callback(null, arg1);
-        }
-
-        var ctx = {};
-        var count = 0;
-
-        var promise = asPromise(fn, ctx, 1, 2);
-        promise.then(function(arg2) {
-            test.equal(arg2, 2, "promise should be resolved with arg2 = 2");
-            if (++count > 1)
-                test.fail("promise should not be resolved twice");
-            test.end();
-        }).catch(function(err) {
-            test.fail("promise should not be rejected (" + err + ")");
-        });
-    });
-
-    test.test(this.name + " - reject twice", function(test) {
-
-        function fn(arg1, arg2, callback) {
-            test.equal(this, ctx, "function should be called with this = ctx");
-            test.equal(arg1, 1, "function should be called with arg1 = 1");
-            test.equal(arg2, 2, "function should be called with arg2 = 2");
-            callback(arg1);
-            callback(arg2);
-        }
-
-        var ctx = {};
-        var count = 0;
-
-        var promise = asPromise(fn, ctx, 1, 2);
-        promise.then(function() {
-            test.fail("promise should not be resolved");
-        }).catch(function(err) {
-            test.equal(err, 1, "promise should be rejected with err = 1");
-            if (++count > 1)
-                test.fail("promise should not be rejected twice");
-            test.end();
-        });
-    });
-
-    test.test(this.name + " - reject error", function(test) {
-
-        function fn(callback) {
-            test.ok(arguments.length === 1 && typeof callback === "function", "function should be called with just a callback");
-            throw 3;
-        }
-
-        var promise = asPromise(fn, null);
-        promise.then(function() {
-            test.fail("promise should not be resolved");
-        }).catch(function(err) {
-            test.equal(err, 3, "promise should be rejected with err = 3");
-            test.end();
-        });
-    });
-
-    test.test(this.name + " - reject and error", function(test) {
-
-        function fn(callback) {
-            callback(3);
-            throw 4;
-        }
-
-        var count = 0;
-
-        var promise = asPromise(fn, null);
-        promise.then(function() {
-            test.fail("promise should not be resolved");
-        }).catch(function(err) {
-            test.equal(err, 3, "promise should be rejected with err = 3");
-            if (++count > 1)
-                test.fail("promise should not be rejected twice");
-            test.end();
-        });
-    });
-});

package/node_modules/@protobufjs/base64/LICENSE

@@ -1,26 +0,0 @@
-Copyright (c) 2016, Daniel Wirtz  All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-* Redistributions of source code must retain the above copyright
-  notice, this list of conditions and the following disclaimer.
-* Redistributions in binary form must reproduce the above copyright
-  notice, this list of conditions and the following disclaimer in the
-  documentation and/or other materials provided with the distribution.
-* Neither the name of its author, nor the names of its contributors
-  may be used to endorse or promote products derived from this software
-  without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/node_modules/@protobufjs/base64/README.md

@@ -1,19 +0,0 @@
-@protobufjs/base64
-==================
-[![npm](https://img.shields.io/npm/v/@protobufjs/base64.svg)](https://www.npmjs.com/package/@protobufjs/base64)
-
-A minimal base64 implementation for number arrays.
-
-API
----
-
-* **base64.length(string: `string`): `number`**<br />
-  Calculates the byte length of a base64 encoded string.
-
-* **base64.encode(buffer: `Uint8Array`, start: `number`, end: `number`): `string`**<br />
-  Encodes a buffer to a base64 encoded string.
-
-* **base64.decode(string: `string`, buffer: `Uint8Array`, offset: `number`): `number`**<br />
-  Decodes a base64 encoded string to a buffer.
-
-**License:** [BSD 3-Clause License](https://opensource.org/licenses/BSD-3-Clause)

package/node_modules/@protobufjs/base64/index.d.ts

@@ -1,32 +0,0 @@
-/**
- * Calculates the byte length of a base64 encoded string.
- * @param {string} string Base64 encoded string
- * @returns {number} Byte length
- */
-export function length(string: string): number;
-
-/**
- * Encodes a buffer to a base64 encoded string.
- * @param {Uint8Array} buffer Source buffer
- * @param {number} start Source start
- * @param {number} end Source end
- * @returns {string} Base64 encoded string
- */
-export function encode(buffer: Uint8Array, start: number, end: number): string;
-
-/**
- * Decodes a base64 encoded string to a buffer.
- * @param {string} string Source string
- * @param {Uint8Array} buffer Destination buffer
- * @param {number} offset Destination offset
- * @returns {number} Number of bytes written
- * @throws {Error} If encoding is invalid
- */
-export function decode(string: string, buffer: Uint8Array, offset: number): number;
-
-/**
- * Tests if the specified string appears to be base64 encoded.
- * @param {string} string String to test
- * @returns {boolean} `true` if it appears to be base64 encoded, otherwise false
- */
-export function test(string: string): boolean;

package/node_modules/@protobufjs/base64/index.js

@@ -1,139 +0,0 @@
-"use strict";
-
-/**
- * A minimal base64 implementation for number arrays.
- * @memberof util
- * @namespace
- */
-var base64 = exports;
-
-/**
- * Calculates the byte length of a base64 encoded string.
- * @param {string} string Base64 encoded string
- * @returns {number} Byte length
- */
-base64.length = function length(string) {
-    var p = string.length;
-    if (!p)
-        return 0;
-    var n = 0;
-    while (--p % 4 > 1 && string.charAt(p) === "=")
-        ++n;
-    return Math.ceil(string.length * 3) / 4 - n;
-};
-
-// Base64 encoding table
-var b64 = new Array(64);
-
-// Base64 decoding table
-var s64 = new Array(123);
-
-// 65..90, 97..122, 48..57, 43, 47
-for (var i = 0; i < 64;)
-    s64[b64[i] = i < 26 ? i + 65 : i < 52 ? i + 71 : i < 62 ? i - 4 : i - 59 | 43] = i++;
-
-/**
- * Encodes a buffer to a base64 encoded string.
- * @param {Uint8Array} buffer Source buffer
- * @param {number} start Source start
- * @param {number} end Source end
- * @returns {string} Base64 encoded string
- */
-base64.encode = function encode(buffer, start, end) {
-    var parts = null,
-        chunk = [];
-    var i = 0, // output index
-        j = 0, // goto index
-        t;     // temporary
-    while (start < end) {
-        var b = buffer[start++];
-        switch (j) {
-            case 0:
-                chunk[i++] = b64[b >> 2];
-                t = (b & 3) << 4;
-                j = 1;
-                break;
-            case 1:
-                chunk[i++] = b64[t | b >> 4];
-                t = (b & 15) << 2;
-                j = 2;
-                break;
-            case 2:
-                chunk[i++] = b64[t | b >> 6];
-                chunk[i++] = b64[b & 63];
-                j = 0;
-                break;
-        }
-        if (i > 8191) {
-            (parts || (parts = [])).push(String.fromCharCode.apply(String, chunk));
-            i = 0;
-        }
-    }
-    if (j) {
-        chunk[i++] = b64[t];
-        chunk[i++] = 61;
-        if (j === 1)
-            chunk[i++] = 61;
-    }
-    if (parts) {
-        if (i)
-            parts.push(String.fromCharCode.apply(String, chunk.slice(0, i)));
-        return parts.join("");
-    }
-    return String.fromCharCode.apply(String, chunk.slice(0, i));
-};
-
-var invalidEncoding = "invalid encoding";
-
-/**
- * Decodes a base64 encoded string to a buffer.
- * @param {string} string Source string
- * @param {Uint8Array} buffer Destination buffer
- * @param {number} offset Destination offset
- * @returns {number} Number of bytes written
- * @throws {Error} If encoding is invalid
- */
-base64.decode = function decode(string, buffer, offset) {
-    var start = offset;
-    var j = 0, // goto index
-        t;     // temporary
-    for (var i = 0; i < string.length;) {
-        var c = string.charCodeAt(i++);
-        if (c === 61 && j > 1)
-            break;
-        if ((c = s64[c]) === undefined)
-            throw Error(invalidEncoding);
-        switch (j) {
-            case 0:
-                t = c;
-                j = 1;
-                break;
-            case 1:
-                buffer[offset++] = t << 2 | (c & 48) >> 4;
-                t = c;
-                j = 2;
-                break;
-            case 2:
-                buffer[offset++] = (t & 15) << 4 | (c & 60) >> 2;
-                t = c;
-                j = 3;
-                break;
-            case 3:
-                buffer[offset++] = (t & 3) << 6 | c;
-                j = 0;
-                break;
-        }
-    }
-    if (j === 1)
-        throw Error(invalidEncoding);
-    return offset - start;
-};
-
-/**
- * Tests if the specified string appears to be base64 encoded.
- * @param {string} string String to test
- * @returns {boolean} `true` if probably base64 encoded, otherwise false
- */
-base64.test = function test(string) {
-    return /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(string);
-};

package/node_modules/@protobufjs/base64/package.json

@@ -1,21 +0,0 @@
-{
-  "name": "@protobufjs/base64",
-  "description": "A minimal base64 implementation for number arrays.",
-  "version": "1.1.2",
-  "author": "Daniel Wirtz <dcode+protobufjs@dcode.io>",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/dcodeIO/protobuf.js.git"
-  },
-  "license": "BSD-3-Clause",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "devDependencies": {
-    "istanbul": "^0.4.5",
-    "tape": "^4.6.3"
-  },
-  "scripts": {
-    "test": "tape tests/*.js",
-    "coverage": "istanbul cover node_modules/tape/bin/tape tests/*.js"
-  }
-}

package/node_modules/@protobufjs/base64/tests/index.js

@@ -1,46 +0,0 @@
-var tape = require("tape");
-
-var base64 = require("..");
-
-var strings = {
-    "": "",
-    "a": "YQ==",
-    "ab": "YWI=",
-    "abcdefg": "YWJjZGVmZw==",
-    "abcdefgh": "YWJjZGVmZ2g=",
-    "abcdefghi": "YWJjZGVmZ2hp"
-};
-
-tape.test("base64", function(test) {
-
-    Object.keys(strings).forEach(function(str) {
-        var enc = strings[str];
-
-        test.equal(base64.test(enc), true, "should detect '" + enc + "' to be base64 encoded");
-
-        var len = base64.length(enc);
-        test.equal(len, str.length, "should calculate '" + enc + "' as " + str.length + " bytes");
-
-        var buf = new Array(len);
-        var len2 = base64.decode(enc, buf, 0);
-        test.equal(len2, len, "should decode '" + enc + "' to " + len + " bytes");
-
-        test.equal(String.fromCharCode.apply(String, buf), str, "should decode '" + enc + "' to '" + str + "'");
-
-        var enc2 = base64.encode(buf, 0, buf.length);
-        test.equal(enc2, enc, "should encode '" + str + "' to '" + enc + "'");
-
-    });
-
-    test.throws(function() {
-        var buf = new Array(10);
-        base64.decode("YQ!", buf, 0);
-    }, Error, "should throw if encoding is invalid");
-
-    test.throws(function() {
-        var buf = new Array(10);
-        base64.decode("Y", buf, 0);
-    }, Error, "should throw if string is truncated");
-
-    test.end();
-});

package/node_modules/@protobufjs/codegen/LICENSE

@@ -1,26 +0,0 @@
-Copyright (c) 2016, Daniel Wirtz  All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-* Redistributions of source code must retain the above copyright
-  notice, this list of conditions and the following disclaimer.
-* Redistributions in binary form must reproduce the above copyright
-  notice, this list of conditions and the following disclaimer in the
-  documentation and/or other materials provided with the distribution.
-* Neither the name of its author, nor the names of its contributors
-  may be used to endorse or promote products derived from this software
-  without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/node_modules/@protobufjs/codegen/README.md

@@ -1,49 +0,0 @@
-@protobufjs/codegen
-===================
-[![npm](https://img.shields.io/npm/v/@protobufjs/codegen.svg)](https://www.npmjs.com/package/@protobufjs/codegen)
-
-A minimalistic code generation utility.
-
-API
----
-
-* **codegen([functionParams: `string[]`], [functionName: string]): `Codegen`**<br />
-  Begins generating a function.
-
-* **codegen.verbose = `false`**<br />
-  When set to true, codegen will log generated code to console. Useful for debugging.
-
-Invoking **codegen** returns an appender function that appends code to the function's body and returns itself:
-
-* **Codegen(formatString: `string`, [...formatParams: `any`]): Codegen**<br />
-  Appends code to the function's body. The format string can contain placeholders specifying the types of inserted format parameters:
-
-  * `%d`: Number (integer or floating point value)
-  * `%f`: Floating point value
-  * `%i`: Integer value
-  * `%j`: JSON.stringify'ed value
-  * `%s`: String value
-  * `%%`: Percent sign<br />
-
-* **Codegen([scope: `Object.<string,*>`]): `Function`**<br />
-  Finishes the function and returns it.
-
-* **Codegen.toString([functionNameOverride: `string`]): `string`**<br />
-  Returns the function as a string.
-
-Example
--------
-
-```js
-var codegen = require("@protobufjs/codegen");
-
-var add = codegen(["a", "b"], "add") // A function with parameters "a" and "b" named "add"
-  ("// awesome comment")             // adds the line to the function's body
-  ("return a + b - c + %d", 1)       // replaces %d with 1 and adds the line to the body
-  ({ c: 1 });                        // adds "c" with a value of 1 to the function's scope
-
-console.log(add.toString()); // function add(a, b) { return a + b - c + 1 }
-console.log(add(1, 2));      // calculates 1 + 2 - 1 + 1 = 3
-```
-
-**License:** [BSD 3-Clause License](https://opensource.org/licenses/BSD-3-Clause)