+
+Simple functions shared among the sinon end user libraries
+
+## Rules
+
+* Follows the [Sinon.JS compatibility](https://github.com/sinonjs/sinon/blob/master/CONTRIBUTING.md#compatibility)
+* 100% test coverage
+* Code formatted using [Prettier](https://prettier.io)
+* No side effects welcome! (only pure functions)
+* No platform specific functions
+* One export per file (any bundler can do tree shaking)
diff --git a/node_modules/@sinonjs/commons/lib/called-in-order.js b/node_modules/@sinonjs/commons/lib/called-in-order.js
new file mode 100644
index 0000000..4edb67f
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/called-in-order.js
@@ -0,0 +1,57 @@
+"use strict";
+
+var every = require("./prototypes/array").every;
+
+/**
+ * @private
+ */
+function hasCallsLeft(callMap, spy) {
+ if (callMap[spy.id] === undefined) {
+ callMap[spy.id] = 0;
+ }
+
+ return callMap[spy.id] < spy.callCount;
+}
+
+/**
+ * @private
+ */
+function checkAdjacentCalls(callMap, spy, index, spies) {
+ var calledBeforeNext = true;
+
+ if (index !== spies.length - 1) {
+ calledBeforeNext = spy.calledBefore(spies[index + 1]);
+ }
+
+ if (hasCallsLeft(callMap, spy) && calledBeforeNext) {
+ callMap[spy.id] += 1;
+ return true;
+ }
+
+ return false;
+}
+
+/**
+ * A Sinon proxy object (fake, spy, stub)
+ *
+ * @typedef {object} SinonProxy
+ * @property {Function} calledBefore - A method that determines if this proxy was called before another one
+ * @property {string} id - Some id
+ * @property {number} callCount - Number of times this proxy has been called
+ */
+
+/**
+ * Returns true when the spies have been called in the order they were supplied in
+ *
+ * @param {SinonProxy[] | SinonProxy} spies An array of proxies, or several proxies as arguments
+ * @returns {boolean} true when spies are called in order, false otherwise
+ */
+function calledInOrder(spies) {
+ var callMap = {};
+ // eslint-disable-next-line no-underscore-dangle
+ var _spies = arguments.length > 1 ? arguments : spies;
+
+ return every(_spies, checkAdjacentCalls.bind(null, callMap));
+}
+
+module.exports = calledInOrder;
diff --git a/node_modules/@sinonjs/commons/lib/called-in-order.test.js b/node_modules/@sinonjs/commons/lib/called-in-order.test.js
new file mode 100644
index 0000000..00d8b8b
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/called-in-order.test.js
@@ -0,0 +1,121 @@
+"use strict";
+
+var assert = require("@sinonjs/referee-sinon").assert;
+var calledInOrder = require("./called-in-order");
+var sinon = require("@sinonjs/referee-sinon").sinon;
+
+var testObject1 = {
+ someFunction: function() {
+ return;
+ }
+};
+var testObject2 = {
+ otherFunction: function() {
+ return;
+ }
+};
+var testObject3 = {
+ thirdFunction: function() {
+ return;
+ }
+};
+
+function testMethod() {
+ testObject1.someFunction();
+ testObject2.otherFunction();
+ testObject2.otherFunction();
+ testObject2.otherFunction();
+ testObject3.thirdFunction();
+}
+
+describe("calledInOrder", function() {
+ beforeEach(function() {
+ sinon.stub(testObject1, "someFunction");
+ sinon.stub(testObject2, "otherFunction");
+ sinon.stub(testObject3, "thirdFunction");
+ testMethod();
+ });
+ afterEach(function() {
+ testObject1.someFunction.restore();
+ testObject2.otherFunction.restore();
+ testObject3.thirdFunction.restore();
+ });
+
+ describe("given single array argument", function() {
+ describe("when stubs were called in expected order", function() {
+ it("returns true", function() {
+ assert.isTrue(
+ calledInOrder([
+ testObject1.someFunction,
+ testObject2.otherFunction
+ ])
+ );
+ assert.isTrue(
+ calledInOrder([
+ testObject1.someFunction,
+ testObject2.otherFunction,
+ testObject2.otherFunction,
+ testObject3.thirdFunction
+ ])
+ );
+ });
+ });
+
+ describe("when stubs were called in unexpected order", function() {
+ it("returns false", function() {
+ assert.isFalse(
+ calledInOrder([
+ testObject2.otherFunction,
+ testObject1.someFunction
+ ])
+ );
+ assert.isFalse(
+ calledInOrder([
+ testObject2.otherFunction,
+ testObject1.someFunction,
+ testObject1.someFunction,
+ testObject3.thirdFunction
+ ])
+ );
+ });
+ });
+ });
+
+ describe("given multiple arguments", function() {
+ describe("when stubs were called in expected order", function() {
+ it("returns true", function() {
+ assert.isTrue(
+ calledInOrder(
+ testObject1.someFunction,
+ testObject2.otherFunction
+ )
+ );
+ assert.isTrue(
+ calledInOrder(
+ testObject1.someFunction,
+ testObject2.otherFunction,
+ testObject3.thirdFunction
+ )
+ );
+ });
+ });
+
+ describe("when stubs were called in unexpected order", function() {
+ it("returns false", function() {
+ assert.isFalse(
+ calledInOrder(
+ testObject2.otherFunction,
+ testObject1.someFunction
+ )
+ );
+ assert.isFalse(
+ calledInOrder(
+ testObject2.otherFunction,
+ testObject1.someFunction,
+ testObject3.thirdFunction
+ )
+ );
+ });
+ });
+ });
+});
diff --git a/node_modules/@sinonjs/commons/lib/class-name.js b/node_modules/@sinonjs/commons/lib/class-name.js
new file mode 100644
index 0000000..bcd26ba
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/class-name.js
@@ -0,0 +1,27 @@
+"use strict";
+
+var functionName = require("./function-name");
+
+/**
+ * Returns a display name for a value from a constructor
+ *
+ * @param {object} value A value to examine
+ * @returns {(string|null)} A string or null
+ */
+function className(value) {
+ return (
+ (value.constructor && value.constructor.name) ||
+ // The next branch is for IE11 support only:
+ // Because the name property is not set on the prototype
+ // of the Function object, we finally try to grab the
+ // name from its definition. This will never be reached
+ // in node, so we are not able to test this properly.
+ // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/name
+ (typeof value.constructor === "function" &&
+ /* istanbul ignore next */
+ functionName(value.constructor)) ||
+ null
+ );
+}
+
+module.exports = className;
diff --git a/node_modules/@sinonjs/commons/lib/class-name.test.js b/node_modules/@sinonjs/commons/lib/class-name.test.js
new file mode 100644
index 0000000..d091506
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/class-name.test.js
@@ -0,0 +1,37 @@
+"use strict";
+/* eslint-disable no-empty-function */
+
+var assert = require("@sinonjs/referee").assert;
+var className = require("./class-name");
+
+describe("className", function() {
+ it("returns the class name of an instance", function() {
+ // Because eslint-config-sinon disables es6, we can't
+ // use a class definition here
+ // https://github.com/sinonjs/eslint-config-sinon/blob/master/index.js
+ // var instance = new (class TestClass {})();
+ var instance = new (function TestClass() {})();
+ var name = className(instance);
+ assert.equals(name, "TestClass");
+ });
+
+ it("returns 'Object' for {}", function() {
+ var name = className({});
+ assert.equals(name, "Object");
+ });
+
+ it("returns null for an object that has no prototype", function() {
+ var obj = Object.create(null);
+ var name = className(obj);
+ assert.equals(name, null);
+ });
+
+ it("returns null for an object whose prototype was mangled", function() {
+ // This is what Node v6 and v7 do for objects returned by querystring.parse()
+ function MangledObject() {}
+ MangledObject.prototype = Object.create(null);
+ var obj = new MangledObject();
+ var name = className(obj);
+ assert.equals(name, null);
+ });
+});
diff --git a/node_modules/@sinonjs/commons/lib/deprecated.js b/node_modules/@sinonjs/commons/lib/deprecated.js
new file mode 100644
index 0000000..ad68cc9
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/deprecated.js
@@ -0,0 +1,58 @@
+/* eslint-disable no-console */
+"use strict";
+
+/**
+ * Returns a function that will invoke the supplied function and print a
+ * deprecation warning to the console each time it is called.
+ *
+ * @param {Function} func
+ * @param {string} msg
+ * @returns {Function}
+ */
+exports.wrap = function(func, msg) {
+ var wrapped = function() {
+ exports.printWarning(msg);
+ return func.apply(this, arguments);
+ };
+ if (func.prototype) {
+ wrapped.prototype = func.prototype;
+ }
+ return wrapped;
+};
+
+/**
+ * Returns a string which can be supplied to `wrap()` to notify the user that a
+ * particular part of the sinon API has been deprecated.
+ *
+ * @param {string} packageName
+ * @param {string} funcName
+ * @returns {string}
+ */
+exports.defaultMsg = function(packageName, funcName) {
+ return (
+ packageName +
+ "." +
+ funcName +
+ " is deprecated and will be removed from the public API in a future version of " +
+ packageName +
+ "."
+ );
+};
+
+/**
+ * Prints a warning on the console, when it exists
+ *
+ * @param {string} msg
+ * @returns {undefined}
+ */
+exports.printWarning = function(msg) {
+ /* istanbul ignore next */
+ if (typeof process === "object" && process.emitWarning) {
+ // Emit Warnings in Node
+ process.emitWarning(msg);
+ } else if (console.info) {
+ console.info(msg);
+ } else {
+ console.log(msg);
+ }
+};
diff --git a/node_modules/@sinonjs/commons/lib/deprecated.test.js b/node_modules/@sinonjs/commons/lib/deprecated.test.js
new file mode 100644
index 0000000..9034345
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/deprecated.test.js
@@ -0,0 +1,100 @@
+/* eslint-disable no-console */
+"use strict";
+
+var assert = require("@sinonjs/referee-sinon").assert;
+var sinon = require("@sinonjs/referee-sinon").sinon;
+
+var deprecated = require("./deprecated");
+
+var msg = "test";
+
+describe("deprecated", function() {
+ describe("defaultMsg", function() {
+ it("should return a string", function() {
+ assert.equals(
+ deprecated.defaultMsg("sinon", "someFunc"),
+ "sinon.someFunc is deprecated and will be removed from the public API in a future version of sinon."
+ );
+ });
+ });
+
+ describe("printWarning", function() {
+ beforeEach(function() {
+ sinon.replace(process, "emitWarning", sinon.fake());
+ });
+
+ afterEach(sinon.restore);
+
+ describe("when `process.emitWarning` is defined", function() {
+ it("should call process.emitWarning with a msg", function() {
+ deprecated.printWarning(msg);
+ assert.calledOnceWith(process.emitWarning, msg);
+ });
+ });
+
+ describe("when `process.emitWarning` is undefined", function() {
+ beforeEach(function() {
+ sinon.replace(console, "info", sinon.fake());
+ sinon.replace(console, "log", sinon.fake());
+ process.emitWarning = undefined;
+ });
+
+ afterEach(sinon.restore);
+
+ describe("when `console.info` is defined", function() {
+ it("should call `console.info` with a message", function() {
+ deprecated.printWarning(msg);
+ assert.calledOnceWith(console.info, msg);
+ });
+ });
+
+ describe("when `console.info` is undefined", function() {
+ it("should call `console.log` with a message", function() {
+ console.info = undefined;
+ deprecated.printWarning(msg);
+ assert.calledOnceWith(console.log, msg);
+ });
+ });
+ });
+ });
+
+ describe("wrap", function() {
+ var method = sinon.fake();
+ var wrapped;
+
+ beforeEach(function() {
+ wrapped = deprecated.wrap(method, msg);
+ });
+
+ it("should return a wrapper function", function() {
+ assert.match(wrapped, sinon.match.func);
+ });
+
+ it("should assign the prototype of the passed method", function() {
+ assert.equals(method.prototype, wrapped.prototype);
+ });
+
+ context("when the passed method has falsy prototype", function() {
+ it("should not be assigned to the wrapped method", function() {
+ method.prototype = null;
+ wrapped = deprecated.wrap(method, msg);
+ assert.match(wrapped.prototype, sinon.match.object);
+ });
+ });
+
+ context("when invoking the wrapped function", function() {
+ before(function() {
+ sinon.replace(deprecated, "printWarning", sinon.fake());
+ wrapped({});
+ });
+
+ it("should call `printWarning` before invoking", function() {
+ assert.calledOnceWith(deprecated.printWarning, msg);
+ });
+
+ it("should invoke the passed method with the given arguments", function() {
+ assert.calledOnceWith(method, {});
+ });
+ });
+ });
+});
diff --git a/node_modules/@sinonjs/commons/lib/every.js b/node_modules/@sinonjs/commons/lib/every.js
new file mode 100644
index 0000000..c390397
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/every.js
@@ -0,0 +1,27 @@
+"use strict";
+
+/**
+ * Returns true when fn returns true for all members of obj.
+ * This is an every implementation that works for all iterables
+ *
+ * @param {object} obj
+ * @param {Function} fn
+ * @returns {boolean}
+ */
+module.exports = function every(obj, fn) {
+ var pass = true;
+
+ try {
+ /* eslint-disable-next-line local-rules/no-prototype-methods */
+ obj.forEach(function() {
+ if (!fn.apply(this, arguments)) {
+ // Throwing an error is the only way to break `forEach`
+ throw new Error();
+ }
+ });
+ } catch (e) {
+ pass = false;
+ }
+
+ return pass;
+};
diff --git a/node_modules/@sinonjs/commons/lib/every.test.js b/node_modules/@sinonjs/commons/lib/every.test.js
new file mode 100644
index 0000000..f893d43
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/every.test.js
@@ -0,0 +1,41 @@
+"use strict";
+
+var assert = require("@sinonjs/referee-sinon").assert;
+var sinon = require("@sinonjs/referee-sinon").sinon;
+var every = require("./every");
+
+describe("util/core/every", function() {
+ it("returns true when the callback function returns true for every element in an iterable", function() {
+ var obj = [true, true, true, true];
+ var allTrue = every(obj, function(val) {
+ return val;
+ });
+
+ assert(allTrue);
+ });
+
+ it("returns false when the callback function returns false for any element in an iterable", function() {
+ var obj = [true, true, true, false];
+ var result = every(obj, function(val) {
+ return val;
+ });
+
+ assert.isFalse(result);
+ });
+
+ it("calls the given callback once for each item in an iterable until it returns false", function() {
+ var iterableOne = [true, true, true, true];
+ var iterableTwo = [true, true, false, true];
+ var callback = sinon.spy(function(val) {
+ return val;
+ });
+
+ every(iterableOne, callback);
+ assert.equals(callback.callCount, 4);
+
+ callback.resetHistory();
+
+ every(iterableTwo, callback);
+ assert.equals(callback.callCount, 3);
+ });
+});
diff --git a/node_modules/@sinonjs/commons/lib/function-name.js b/node_modules/@sinonjs/commons/lib/function-name.js
new file mode 100644
index 0000000..199b04e
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/function-name.js
@@ -0,0 +1,29 @@
+"use strict";
+
+/**
+ * Returns a display name for a function
+ *
+ * @param {Function} func
+ * @returns {string}
+ */
+module.exports = function functionName(func) {
+ if (!func) {
+ return "";
+ }
+
+ try {
+ return (
+ func.displayName ||
+ func.name ||
+ // Use function decomposition as a last resort to get function
+ // name. Does not rely on function decomposition to work - if it
+ // doesn't debugging will be slightly less informative
+ // (i.e. toString will say 'spy' rather than 'myFunc').
+ (String(func).match(/function ([^\s(]+)/) || [])[1]
+ );
+ } catch (e) {
+ // Stringify may fail and we might get an exception, as a last-last
+ // resort fall back to empty string.
+ return "";
+ }
+};
diff --git a/node_modules/@sinonjs/commons/lib/function-name.test.js b/node_modules/@sinonjs/commons/lib/function-name.test.js
new file mode 100644
index 0000000..6dda3a4
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/function-name.test.js
@@ -0,0 +1,76 @@
+"use strict";
+
+var jsc = require("jsverify");
+var refute = require("@sinonjs/referee-sinon").refute;
+
+var functionName = require("./function-name");
+
+describe("function-name", function() {
+ it("should return empty string if func is falsy", function() {
+ jsc.assertForall("falsy", function(fn) {
+ return functionName(fn) === "";
+ });
+ });
+
+ it("should use displayName by default", function() {
+ jsc.assertForall("nestring", function(displayName) {
+ var fn = { displayName: displayName };
+
+ return functionName(fn) === fn.displayName;
+ });
+ });
+
+ it("should use name if displayName is not available", function() {
+ jsc.assertForall("nestring", function(name) {
+ var fn = { name: name };
+
+ return functionName(fn) === fn.name;
+ });
+ });
+
+ it("should fallback to string parsing", function() {
+ jsc.assertForall("nat", function(naturalNumber) {
+ var name = "fn" + naturalNumber;
+ var fn = {
+ toString: function() {
+ return "\nfunction " + name;
+ }
+ };
+
+ return functionName(fn) === name;
+ });
+ });
+
+ it("should not fail when a name cannot be found", function() {
+ refute.exception(function() {
+ var fn = {
+ toString: function() {
+ return "\nfunction (";
+ }
+ };
+
+ functionName(fn);
+ });
+ });
+
+ it("should not fail when toString is undefined", function() {
+ refute.exception(function() {
+ functionName(Object.create(null));
+ });
+ });
+
+ it("should not fail when toString throws", function() {
+ refute.exception(function() {
+ var fn;
+ try {
+ // eslint-disable-next-line no-eval
+ fn = eval("(function*() {})")().constructor;
+ } catch (e) {
+ // env doesn't support generators
+ return;
+ }
+
+ functionName(fn);
+ });
+ });
+});
diff --git a/node_modules/@sinonjs/commons/lib/global.js b/node_modules/@sinonjs/commons/lib/global.js
new file mode 100644
index 0000000..51715a2
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/global.js
@@ -0,0 +1,22 @@
+"use strict";
+
+/**
+ * A reference to the global object
+ *
+ * @type {object} globalObject
+ */
+var globalObject;
+
+/* istanbul ignore else */
+if (typeof global !== "undefined") {
+ // Node
+ globalObject = global;
+} else if (typeof window !== "undefined") {
+ // Browser
+ globalObject = window;
+} else {
+ // WebWorker
+ globalObject = self;
+}
+
+module.exports = globalObject;
diff --git a/node_modules/@sinonjs/commons/lib/global.test.js b/node_modules/@sinonjs/commons/lib/global.test.js
new file mode 100644
index 0000000..e49b3da
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/global.test.js
@@ -0,0 +1,16 @@
+"use strict";
+
+var assert = require("@sinonjs/referee-sinon").assert;
+var globalObject = require("./global");
+
+describe("global", function() {
+ before(function() {
+ if (typeof global === "undefined") {
+ this.skip();
+ }
+ });
+
+ it("is same as global", function() {
+ assert.same(globalObject, global);
+ });
+});
diff --git a/node_modules/@sinonjs/commons/lib/index.js b/node_modules/@sinonjs/commons/lib/index.js
new file mode 100644
index 0000000..5404857
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/index.js
@@ -0,0 +1,14 @@
+"use strict";
+
+module.exports = {
+ global: require("./global"),
+ calledInOrder: require("./called-in-order"),
+ className: require("./class-name"),
+ deprecated: require("./deprecated"),
+ every: require("./every"),
+ functionName: require("./function-name"),
+ orderByFirstCall: require("./order-by-first-call"),
+ prototypes: require("./prototypes"),
+ typeOf: require("./type-of"),
+ valueToString: require("./value-to-string")
+};
diff --git a/node_modules/@sinonjs/commons/lib/index.test.js b/node_modules/@sinonjs/commons/lib/index.test.js
new file mode 100644
index 0000000..cac58a0
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/index.test.js
@@ -0,0 +1,29 @@
+"use strict";
+
+var assert = require("@sinonjs/referee-sinon").assert;
+var index = require("./index");
+
+var expectedMethods = [
+ "calledInOrder",
+ "className",
+ "every",
+ "functionName",
+ "orderByFirstCall",
+ "typeOf",
+ "valueToString"
+];
+var expectedObjectProperties = ["deprecated", "prototypes"];
+
+describe("package", function() {
+ expectedMethods.forEach(function(name) {
+ it("should export a method named " + name, function() {
+ assert.isFunction(index[name]);
+ });
+ });
+
+ expectedObjectProperties.forEach(function(name) {
+ it("should export an object property named " + name, function() {
+ assert.isObject(index[name]);
+ });
+ });
+});
diff --git a/node_modules/@sinonjs/commons/lib/order-by-first-call.js b/node_modules/@sinonjs/commons/lib/order-by-first-call.js
new file mode 100644
index 0000000..c3d47ed
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/order-by-first-call.js
@@ -0,0 +1,36 @@
+"use strict";
+
+var sort = require("./prototypes/array").sort;
+var slice = require("./prototypes/array").slice;
+
+/**
+ * @private
+ */
+function comparator(a, b) {
+ // uuid, won't ever be equal
+ var aCall = a.getCall(0);
+ var bCall = b.getCall(0);
+ var aId = (aCall && aCall.callId) || -1;
+ var bId = (bCall && bCall.callId) || -1;
+
+ return aId < bId ? -1 : 1;
+}
+
+/**
+ * A Sinon proxy object (fake, spy, stub)
+ *
+ * @typedef {object} SinonProxy
+ * @property {Function} getCall - A method that can return the first call
+ */
+
+/**
+ * Sorts an array of SinonProxy instances (fake, spy, stub) by their first call
+ *
+ * @param {SinonProxy[] | SinonProxy} spies
+ * @returns {SinonProxy[]}
+ */
+function orderByFirstCall(spies) {
+ return sort(slice(spies), comparator);
+}
+
+module.exports = orderByFirstCall;
diff --git a/node_modules/@sinonjs/commons/lib/order-by-first-call.test.js b/node_modules/@sinonjs/commons/lib/order-by-first-call.test.js
new file mode 100644
index 0000000..485ad43
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/order-by-first-call.test.js
@@ -0,0 +1,52 @@
+"use strict";
+
+var assert = require("@sinonjs/referee-sinon").assert;
+var knuthShuffle = require("knuth-shuffle").knuthShuffle;
+var sinon = require("@sinonjs/referee-sinon").sinon;
+var orderByFirstCall = require("./order-by-first-call");
+
+describe("orderByFirstCall", function() {
+ it("should order an Array of spies by the callId of the first call, ascending", function() {
+ // create an array of spies
+ var spies = [
+ sinon.spy(),
+ sinon.spy(),
+ sinon.spy(),
+ sinon.spy(),
+ sinon.spy(),
+ sinon.spy()
+ ];
+
+ // call all the spies
+ spies.forEach(function(spy) {
+ spy();
+ });
+
+ // add a few uncalled spies
+ spies.push(sinon.spy());
+ spies.push(sinon.spy());
+
+ // randomise the order of the spies
+ knuthShuffle(spies);
+
+ var sortedSpies = orderByFirstCall(spies);
+
+ assert.equals(sortedSpies.length, spies.length);
+
+ var orderedByFirstCall = sortedSpies.every(function(spy, index) {
+ if (index + 1 === sortedSpies.length) {
+ return true;
+ }
+ var nextSpy = sortedSpies[index + 1];
+
+ // uncalled spies should be ordered first
+ if (!spy.called) {
+ return true;
+ }
+
+ return spy.calledImmediatelyBefore(nextSpy);
+ });
+
+ assert.isTrue(orderedByFirstCall);
+ });
+});
diff --git a/node_modules/@sinonjs/commons/lib/prototypes/README.md b/node_modules/@sinonjs/commons/lib/prototypes/README.md
new file mode 100644
index 0000000..16d60c8
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/prototypes/README.md
@@ -0,0 +1,44 @@
+# Prototypes
+
+The functions in this folder are to be use for keeping cached references to the built-in prototypes, so that people can't inadvertently break the library by making mistakes in userland.
+
+See https://github.com/sinonjs/sinon/pull/1523
+
+## Without cached references
+
+```js
+// in userland, the library user needs to replace the filter method on
+// Array.prototype
+var array = [1, 2, 3];
+sinon.replace(array, "filter", sinon.fake.returns(2));
+
+// in a sinon module, the library author needs to use the filter method
+var someArray = ["a", "b", 42, "c"];
+var answer = filter(someArray, function(v) {
+ return v === 42;
+});
+
+console.log(answer);
+// => 2
+```
+
+
+## With cached references
+
+```js
+// in userland, the library user needs to replace the filter method on
+// Array.prototype
+var array = [1, 2, 3];
+sinon.replace(array, "filter", sinon.fake.returns(2));
+
+// in a sinon module, the library author needs to use the filter method
+// get a reference to the original Array.prototype.filter
+var filter = require("@sinonjs/commons").prototypes.array.filter;
+var someArray = ["a", "b", 42, "c"];
+var answer = filter(someArray, function(v) {
+ return v === 42;
+});
+
+console.log(answer);
+// => 42
+```
diff --git a/node_modules/@sinonjs/commons/lib/prototypes/array.js b/node_modules/@sinonjs/commons/lib/prototypes/array.js
new file mode 100644
index 0000000..0e332b5
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/prototypes/array.js
@@ -0,0 +1,5 @@
+"use strict";
+
+var copyPrototype = require("./copy-prototype");
+
+module.exports = copyPrototype(Array.prototype);
diff --git a/node_modules/@sinonjs/commons/lib/prototypes/copy-prototype.js b/node_modules/@sinonjs/commons/lib/prototypes/copy-prototype.js
new file mode 100644
index 0000000..fd1e6d6
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/prototypes/copy-prototype.js
@@ -0,0 +1,21 @@
+"use strict";
+
+var call = Function.call;
+
+module.exports = function copyPrototypeMethods(prototype) {
+ /* eslint-disable local-rules/no-prototype-methods */
+ return Object.getOwnPropertyNames(prototype).reduce(function(result, name) {
+ // ignore size because it throws from Map
+ if (
+ name !== "size" &&
+ name !== "caller" &&
+ name !== "callee" &&
+ name !== "arguments" &&
+ typeof prototype[name] === "function"
+ ) {
+ result[name] = call.bind(prototype[name]);
+ }
+
+ return result;
+ }, Object.create(null));
+};
diff --git a/node_modules/@sinonjs/commons/lib/prototypes/function.js b/node_modules/@sinonjs/commons/lib/prototypes/function.js
new file mode 100644
index 0000000..28d0cb3
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/prototypes/function.js
@@ -0,0 +1,5 @@
+"use strict";
+
+var copyPrototype = require("./copy-prototype");
+
+module.exports = copyPrototype(Function.prototype);
diff --git a/node_modules/@sinonjs/commons/lib/prototypes/index.js b/node_modules/@sinonjs/commons/lib/prototypes/index.js
new file mode 100644
index 0000000..6ca7f84
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/prototypes/index.js
@@ -0,0 +1,10 @@
+"use strict";
+
+module.exports = {
+ array: require("./array"),
+ function: require("./function"),
+ map: require("./map"),
+ object: require("./object"),
+ set: require("./set"),
+ string: require("./string")
+};
diff --git a/node_modules/@sinonjs/commons/lib/prototypes/index.test.js b/node_modules/@sinonjs/commons/lib/prototypes/index.test.js
new file mode 100644
index 0000000..926f4f1
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/prototypes/index.test.js
@@ -0,0 +1,51 @@
+"use strict";
+
+var assert = require("@sinonjs/referee-sinon").assert;
+
+var arrayProto = require("./index").array;
+var functionProto = require("./index").function;
+var mapProto = require("./index").map;
+var objectProto = require("./index").object;
+var setProto = require("./index").set;
+var stringProto = require("./index").string;
+
+describe("prototypes", function() {
+ describe(".array", function() {
+ verifyProperties(arrayProto, Array);
+ });
+ describe(".function", function() {
+ verifyProperties(functionProto, Function);
+ });
+ describe(".map", function() {
+ verifyProperties(mapProto, Map);
+ });
+ describe(".object", function() {
+ verifyProperties(objectProto, Object);
+ });
+ describe(".set", function() {
+ verifyProperties(setProto, Set);
+ });
+ describe(".string", function() {
+ verifyProperties(stringProto, String);
+ });
+});
+
+function verifyProperties(p, origin) {
+ it("should have all the methods of the origin prototype", function() {
+ var methodNames = Object.getOwnPropertyNames(origin.prototype).filter(
+ function(name) {
+ return (
+ name !== "size" &&
+ name !== "caller" &&
+ name !== "callee" &&
+ name !== "arguments" &&
+ typeof origin.prototype[name] === "function"
+ );
+ }
+ );
+
+ methodNames.forEach(function(name) {
+ assert.isTrue(Object.prototype.hasOwnProperty.call(p, name), name);
+ });
+ });
+}
diff --git a/node_modules/@sinonjs/commons/lib/prototypes/map.js b/node_modules/@sinonjs/commons/lib/prototypes/map.js
new file mode 100644
index 0000000..793d08b
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/prototypes/map.js
@@ -0,0 +1,5 @@
+"use strict";
+
+var copyPrototype = require("./copy-prototype");
+
+module.exports = copyPrototype(Map.prototype);
diff --git a/node_modules/@sinonjs/commons/lib/prototypes/object.js b/node_modules/@sinonjs/commons/lib/prototypes/object.js
new file mode 100644
index 0000000..5b18b56
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/prototypes/object.js
@@ -0,0 +1,5 @@
+"use strict";
+
+var copyPrototype = require("./copy-prototype");
+
+module.exports = copyPrototype(Object.prototype);
diff --git a/node_modules/@sinonjs/commons/lib/prototypes/set.js b/node_modules/@sinonjs/commons/lib/prototypes/set.js
new file mode 100644
index 0000000..b5ade92
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/prototypes/set.js
@@ -0,0 +1,5 @@
+"use strict";
+
+var copyPrototype = require("./copy-prototype");
+
+module.exports = copyPrototype(Set.prototype);
diff --git a/node_modules/@sinonjs/commons/lib/prototypes/string.js b/node_modules/@sinonjs/commons/lib/prototypes/string.js
new file mode 100644
index 0000000..edc905e
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/prototypes/string.js
@@ -0,0 +1,5 @@
+"use strict";
+
+var copyPrototype = require("./copy-prototype");
+
+module.exports = copyPrototype(String.prototype);
diff --git a/node_modules/@sinonjs/commons/lib/type-of.js b/node_modules/@sinonjs/commons/lib/type-of.js
new file mode 100644
index 0000000..97a0bb9
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/type-of.js
@@ -0,0 +1,13 @@
+"use strict";
+
+var type = require("type-detect");
+
+/**
+ * Returns the lower-case result of running type from type-detect on the value
+ *
+ * @param {*} value
+ * @returns {string}
+ */
+module.exports = function typeOf(value) {
+ return type(value).toLowerCase();
+};
diff --git a/node_modules/@sinonjs/commons/lib/type-of.test.js b/node_modules/@sinonjs/commons/lib/type-of.test.js
new file mode 100644
index 0000000..5fcfc74
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/type-of.test.js
@@ -0,0 +1,51 @@
+"use strict";
+
+var assert = require("@sinonjs/referee-sinon").assert;
+var typeOf = require("./type-of");
+
+describe("typeOf", function() {
+ it("returns boolean", function() {
+ assert.equals(typeOf(false), "boolean");
+ });
+
+ it("returns string", function() {
+ assert.equals(typeOf("Sinon.JS"), "string");
+ });
+
+ it("returns number", function() {
+ assert.equals(typeOf(123), "number");
+ });
+
+ it("returns object", function() {
+ assert.equals(typeOf({}), "object");
+ });
+
+ it("returns function", function() {
+ assert.equals(
+ typeOf(function() {
+ return undefined;
+ }),
+ "function"
+ );
+ });
+
+ it("returns undefined", function() {
+ assert.equals(typeOf(undefined), "undefined");
+ });
+
+ it("returns null", function() {
+ assert.equals(typeOf(null), "null");
+ });
+
+ it("returns array", function() {
+ assert.equals(typeOf([]), "array");
+ });
+
+ it("returns regexp", function() {
+ assert.equals(typeOf(/.*/), "regexp");
+ });
+
+ it("returns date", function() {
+ assert.equals(typeOf(new Date()), "date");
+ });
+});
diff --git a/node_modules/@sinonjs/commons/lib/value-to-string.js b/node_modules/@sinonjs/commons/lib/value-to-string.js
new file mode 100644
index 0000000..cbe7aea
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/value-to-string.js
@@ -0,0 +1,17 @@
+"use strict";
+
+/**
+ * Returns a string representation of the value
+ *
+ * @param {*} value
+ * @returns {string}
+ */
+function valueToString(value) {
+ if (value && value.toString) {
+ /* eslint-disable-next-line local-rules/no-prototype-methods */
+ return value.toString();
+ }
+ return String(value);
+}
+
+module.exports = valueToString;
diff --git a/node_modules/@sinonjs/commons/lib/value-to-string.test.js b/node_modules/@sinonjs/commons/lib/value-to-string.test.js
new file mode 100644
index 0000000..5cae501
--- /dev/null
+++ b/node_modules/@sinonjs/commons/lib/value-to-string.test.js
@@ -0,0 +1,20 @@
+"use strict";
+
+var assert = require("@sinonjs/referee-sinon").assert;
+var valueToString = require("./value-to-string");
+
+describe("util/core/valueToString", function() {
+ it("returns string representation of an object", function() {
+ var obj = {};
+
+ assert.equals(valueToString(obj), obj.toString());
+ });
+
+ it("returns 'null' for literal null'", function() {
+ assert.equals(valueToString(null), "null");
+ });
+
+ it("returns 'undefined' for literal undefined", function() {
+ assert.equals(valueToString(undefined), "undefined");
+ });
+});
diff --git a/node_modules/@sinonjs/commons/package.json b/node_modules/@sinonjs/commons/package.json
new file mode 100644
index 0000000..613f045
--- /dev/null
+++ b/node_modules/@sinonjs/commons/package.json
@@ -0,0 +1,85 @@
+{
+ "_from": "@sinonjs/commons@^1.0.2",
+ "_id": "@sinonjs/commons@1.8.1",
+ "_inBundle": false,
+ "_integrity": "sha512-892K+kWUUi3cl+LlqEWIDrhvLgdL79tECi8JZUyq6IviKy/DNhuzCRlbHUjxK89f4ypPMMaFnFuR9Ie6DoIMsw==",
+ "_location": "/@sinonjs/commons",
+ "_phantomChildren": {},
+ "_requested": {
+ "type": "range",
+ "registry": true,
+ "raw": "@sinonjs/commons@^1.0.2",
+ "name": "@sinonjs/commons",
+ "escapedName": "@sinonjs%2fcommons",
+ "scope": "@sinonjs",
+ "rawSpec": "^1.0.2",
+ "saveSpec": null,
+ "fetchSpec": "^1.0.2"
+ },
+ "_requiredBy": [
+ "/@sinonjs/formatio",
+ "/@sinonjs/formatio/@sinonjs/samsam",
+ "/nise/lolex",
+ "/sinon"
+ ],
+ "_resolved": "https://registry.npmjs.org/@sinonjs/commons/-/commons-1.8.1.tgz",
+ "_shasum": "e7df00f98a203324f6dc7cc606cad9d4a8ab2217",
+ "_spec": "@sinonjs/commons@^1.0.2",
+ "_where": "/Users/ayman/Documents/GitHub/javascript-challenges/node_modules/sinon",
+ "author": "",
+ "bugs": {
+ "url": "https://github.com/sinonjs/commons/issues"
+ },
+ "bundleDependencies": false,
+ "dependencies": {
+ "type-detect": "4.0.8"
+ },
+ "deprecated": false,
+ "description": "Simple functions shared among the sinon end user libraries",
+ "devDependencies": {
+ "@sinonjs/referee-sinon": "7.0.2",
+ "@studio/changes": "^2.0.0",
+ "eslint": "^6.1.0",
+ "eslint-config-prettier": "^6.3.0",
+ "eslint-config-sinon": "^4.0.0",
+ "eslint-plugin-ie11": "^1.0.0",
+ "eslint-plugin-jsdoc": "^22.1.0",
+ "eslint-plugin-local-rules": "^0.1.0",
+ "eslint-plugin-mocha": "^6.1.1",
+ "eslint-plugin-prettier": "^3.0.0",
+ "husky": "4.2.3",
+ "jsverify": "0.8.4",
+ "knuth-shuffle": "^1.0.8",
+ "lint-staged": "10.1.1",
+ "mocha": "7.1.0",
+ "nyc": "15.0.0",
+ "prettier": "^1.14.3"
+ },
+ "files": [
+ "lib"
+ ],
+ "homepage": "https://github.com/sinonjs/commons#readme",
+ "license": "BSD-3-Clause",
+ "lint-staged": {
+ "*.js": [
+ "eslint"
+ ]
+ },
+ "main": "lib/index.js",
+ "name": "@sinonjs/commons",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/sinonjs/commons.git"
+ },
+ "scripts": {
+ "lint": "eslint .",
+ "postversion": "git push --follow-tags && npm publish",
+ "precommit": "lint-staged",
+ "preversion": "npm run test-check-coverage",
+ "test": "mocha --recursive -R dot \"lib/**/*.test.js\"",
+ "test-check-coverage": "npm run test-coverage && nyc check-coverage --branches 100 --functions 100 --lines 100",
+ "test-coverage": "nyc --reporter text --reporter html --reporter lcovonly npm run test",
+ "version": "changes --commits --footer"
+ },
+ "version": "1.8.1"
+}
diff --git a/node_modules/@sinonjs/formatio/LICENSE b/node_modules/@sinonjs/formatio/LICENSE
new file mode 100644
index 0000000..d5908f3
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/LICENSE
@@ -0,0 +1,27 @@
+(The BSD License)
+
+Copyright (c) 2010-2012, Christian Johansen (christian@cjohansen.no) and
+August Lilleaas (august.lilleaas@gmail.com). 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 Christian Johansen nor the names of his 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 HOLDER 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.
diff --git a/node_modules/@sinonjs/formatio/README.md b/node_modules/@sinonjs/formatio/README.md
new file mode 100644
index 0000000..9ab2c57
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/README.md
@@ -0,0 +1,101 @@
+# formatio
+
+[](http://travis-ci.org/sinonjs/formatio)
+[](https://codecov.io/gh/sinonjs/formatio)
+
+> The cheesy object formatter
+
+Pretty formatting of arbitrary JavaScript values. Currently only supports ascii
+formatting, suitable for command-line utilities. Like `JSON.stringify`, it
+formats objects recursively, but unlike `JSON.stringify`, it can handle
+regular expressions, functions, circular objects and more.
+
+`formatio` is a general-purpose library. It works in browsers (including old
+and rowdy ones, like IE6) and Node. It will define itself as an AMD module if
+you want it to (i.e. if there's a `define` function available).
+
+## Installation
+
+```shell
+npm install @sinonjs/formatio
+```
+
+## Documentation
+
+https://sinonjs.github.io/formatio/
+
+
+## Backers
+
+Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/sinon#backer)]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## Sponsors
+
+Become a sponsor and get your logo on our README on GitHub with a link to your site. [[Become a sponsor](https://opencollective.com/sinon#sponsor)]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## Licence
+
+formatio was released under [BSD-3](LICENSE)
diff --git a/node_modules/@sinonjs/formatio/lib/formatio.js b/node_modules/@sinonjs/formatio/lib/formatio.js
new file mode 100644
index 0000000..5491b23
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/lib/formatio.js
@@ -0,0 +1,247 @@
+"use strict";
+
+var samsam = require("@sinonjs/samsam");
+var functionName = require("@sinonjs/commons").functionName;
+var typeOf = require("@sinonjs/commons").typeOf;
+
+var formatio = {
+ excludeConstructors: ["Object", /^.$/],
+ quoteStrings: true,
+ limitChildrenCount: 0
+};
+
+var specialObjects = [];
+if (typeof global !== "undefined") {
+ specialObjects.push({ object: global, value: "[object global]" });
+}
+if (typeof document !== "undefined") {
+ specialObjects.push({
+ object: document,
+ value: "[object HTMLDocument]"
+ });
+}
+if (typeof window !== "undefined") {
+ specialObjects.push({ object: window, value: "[object Window]" });
+}
+
+function constructorName(f, object) {
+ var name = functionName(object && object.constructor);
+ var excludes = f.excludeConstructors ||
+ formatio.excludeConstructors || [];
+
+ var i, l;
+ for (i = 0, l = excludes.length; i < l; ++i) {
+ if (typeof excludes[i] === "string" && excludes[i] === name) {
+ return "";
+ } else if (excludes[i].test && excludes[i].test(name)) {
+ return "";
+ }
+ }
+
+ return name;
+}
+
+function isCircular(object, objects) {
+ if (typeof object !== "object") { return false; }
+ var i, l;
+ for (i = 0, l = objects.length; i < l; ++i) {
+ if (objects[i] === object) { return true; }
+ }
+ return false;
+}
+
+function ascii(f, object, processed, indent) {
+ if (typeof object === "string") {
+ if (object.length === 0) { return "(empty string)"; }
+ var qs = f.quoteStrings;
+ var quote = typeof qs !== "boolean" || qs;
+ return processed || quote ? "\"" + object + "\"" : object;
+ }
+
+ if (typeof object === "symbol") {
+ return object.toString();
+ }
+
+ if (typeof object === "function" && !(object instanceof RegExp)) {
+ return ascii.func(object);
+ }
+
+ // eslint supports bigint as of version 6.0.0
+ // https://github.com/eslint/eslint/commit/e4ab0531c4e44c23494c6a802aa2329d15ac90e5
+ // eslint-disable-next-line
+ if (typeOf(object) === "bigint") {
+ return object.toString();
+ }
+
+ processed = processed || [];
+
+ if (isCircular(object, processed)) { return "[Circular]"; }
+
+ if (typeOf(object) === "array") {
+ return ascii.array.call(f, object, processed);
+ }
+
+ if (!object) { return String((1 / object) === -Infinity ? "-0" : object); }
+ if (samsam.isElement(object)) { return ascii.element(object); }
+
+ if (typeof object.toString === "function" &&
+ object.toString !== Object.prototype.toString) {
+ return object.toString();
+ }
+
+ var i, l;
+ for (i = 0, l = specialObjects.length; i < l; i++) {
+ if (object === specialObjects[i].object) {
+ return specialObjects[i].value;
+ }
+ }
+
+ if (samsam.isSet(object)) {
+ return ascii.set.call(f, object, processed);
+ }
+
+ return ascii.object.call(f, object, processed, indent);
+}
+
+ascii.func = function (func) {
+ var funcName = functionName(func) || "";
+ return "function " + funcName + "() {}";
+};
+
+function delimit(str, delimiters) {
+ delimiters = delimiters || ["[", "]"];
+ return delimiters[0] + str + delimiters[1];
+}
+
+ascii.array = function (array, processed, delimiters) {
+ processed = processed || [];
+ processed.push(array);
+ var pieces = [];
+ var i, l;
+ l = (this.limitChildrenCount > 0) ?
+ Math.min(this.limitChildrenCount, array.length) : array.length;
+
+ for (i = 0; i < l; ++i) {
+ pieces.push(ascii(this, array[i], processed));
+ }
+
+ if (l < array.length) {
+ pieces.push("[... " + (array.length - l) + " more elements]");
+ }
+
+ return delimit(pieces.join(", "), delimiters);
+};
+
+ascii.set = function (set, processed) {
+ return ascii.array.call(this, Array.from(set), processed, ["Set {", "}"]);
+};
+
+function getSymbols(object) {
+ if (samsam.isArguments(object)) {
+ return [];
+ }
+
+ if (typeof Object.getOwnPropertySymbols === "function") {
+ return Object.getOwnPropertySymbols(object);
+ }
+
+ return [];
+}
+
+ascii.object = function (object, processed, indent) {
+ processed = processed || [];
+ processed.push(object);
+ indent = indent || 0;
+ var pieces = [];
+ var properties = Object.keys(object).sort().concat(getSymbols(object));
+ var length = 3;
+ var prop, str, obj, i, k, l;
+ l = (this.limitChildrenCount > 0) ?
+ Math.min(this.limitChildrenCount, properties.length) : properties.length;
+
+ for (i = 0; i < l; ++i) {
+ prop = properties[i];
+ obj = object[prop];
+
+ if (isCircular(obj, processed)) {
+ str = "[Circular]";
+ } else {
+ str = ascii(this, obj, processed, indent + 2);
+ }
+
+ str = (
+ typeof prop === "string" && /\s/.test(prop) ?
+ "\"" + prop + "\"" : prop.toString()
+ ) + ": " + str;
+ length += str.length;
+ pieces.push(str);
+ }
+
+ var cons = constructorName(this, object);
+ var prefix = cons ? "[" + cons + "] " : "";
+ var is = "";
+ for (i = 0, k = indent; i < k; ++i) { is += " "; }
+
+ if (l < properties.length)
+ {pieces.push("[... " + (properties.length - l) + " more elements]");}
+
+ if (length + indent > 80) {
+ return prefix + "{\n " + is + pieces.join(",\n " + is) + "\n" +
+ is + "}";
+ }
+ return prefix + "{ " + pieces.join(", ") + " }";
+};
+
+ascii.element = function (element) {
+ var tagName = element.tagName.toLowerCase();
+ var attrs = element.attributes;
+ var pairs = [];
+ var attr, attrName, i, l, val;
+
+ for (i = 0, l = attrs.length; i < l; ++i) {
+ attr = attrs.item(i);
+ attrName = attr.nodeName.toLowerCase().replace("html:", "");
+ val = attr.nodeValue;
+ if (attrName !== "contenteditable" || val !== "inherit") {
+ if (val) { pairs.push(attrName + "=\"" + val + "\""); }
+ }
+ }
+
+ var formatted = "<" + tagName + (pairs.length > 0 ? " " : "");
+ // SVG elements have undefined innerHTML
+ var content = element.innerHTML || "";
+
+ if (content.length > 20) {
+ content = content.substr(0, 20) + "[...]";
+ }
+
+ var res = formatted + pairs.join(" ") + ">" + content +
+ "";
+
+ return res.replace(/ contentEditable="inherit"/, "");
+};
+
+function Formatio(options) {
+ // eslint-disable-next-line guard-for-in
+ for (var opt in options) {
+ this[opt] = options[opt];
+ }
+}
+
+Formatio.prototype = {
+ functionName: functionName,
+
+ configure: function (options) {
+ return new Formatio(options);
+ },
+
+ constructorName: function (object) {
+ return constructorName(this, object);
+ },
+
+ ascii: function (object, processed, indent) {
+ return ascii(this, object, processed, indent);
+ }
+};
+
+module.exports = Formatio.prototype;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/LICENSE b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/LICENSE
new file mode 100644
index 0000000..f00310b
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/LICENSE
@@ -0,0 +1,27 @@
+(The BSD License)
+
+Copyright (c) 2010-2012, Christian Johansen, christian@cjohansen.no and
+August Lilleaas, august.lilleaas@gmail.com. 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 Christian Johansen nor the names of his 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 HOLDER 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.
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/README.md b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/README.md
new file mode 100644
index 0000000..99a2943
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/README.md
@@ -0,0 +1,83 @@
+# samsam
+
+[](http://travis-ci.org/sinonjs/samsam)
+[](https://coveralls.io/github/sinonjs/samsam?branch=master)
+
+Value identification and comparison functions
+
+Documentation: http://sinonjs.github.io/samsam/
+
+## Backers
+
+Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/sinon#backer)]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## Sponsors
+
+Become a sponsor and get your logo on our README on GitHub with a link to your site. [[Become a sponsor](https://opencollective.com/sinon#sponsor)]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## Licence
+
+samsam was released under [BSD-3](LICENSE)
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/dist/samsam.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/dist/samsam.js
new file mode 100644
index 0000000..d2d5497
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/dist/samsam.js
@@ -0,0 +1,1110 @@
+(function (global, factory) {
+ typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@sinonjs/commons'), require('lodash')) :
+ typeof define === 'function' && define.amd ? define(['exports', '@sinonjs/commons', 'lodash'], factory) :
+ (factory((global.samsam = {}),global.require$$0,global.lodash));
+}(this, (function (exports,require$$0,lodash) { 'use strict';
+
+ require$$0 = require$$0 && require$$0.hasOwnProperty('default') ? require$$0['default'] : require$$0;
+ lodash = lodash && lodash.hasOwnProperty('default') ? lodash['default'] : lodash;
+
+ function isNaN(value) {
+ // Unlike global isNaN, this avoids type coercion
+ // typeof check avoids IE host object issues, hat tip to
+ // lodash
+ var val = value; // JsLint thinks value !== value is "weird"
+ return typeof value === "number" && value !== val;
+ }
+
+ var isNan = isNaN;
+
+ /**
+ * @name samsam.isNegZero
+ * @param Object value
+ *
+ * Returns ``true`` if ``value`` is ``-0``.
+ */
+ function isNegZero(value) {
+ return value === 0 && 1 / value === -Infinity;
+ }
+
+ var isNegZero_1 = isNegZero;
+
+ /**
+ * @name samsam.equal
+ * @param Object obj1
+ * @param Object obj2
+ *
+ * Returns ``true`` if two objects are strictly equal. Compared to
+ * ``===`` there are two exceptions:
+ *
+ * - NaN is considered equal to NaN
+ * - -0 and +0 are not considered equal
+ */
+ function identical(obj1, obj2) {
+ if (obj1 === obj2 || (isNan(obj1) && isNan(obj2))) {
+ return obj1 !== 0 || isNegZero_1(obj1) === isNegZero_1(obj2);
+ }
+
+ return false;
+ }
+
+ var identical_1 = identical;
+
+ var toString = require$$0.prototypes.object.toString;
+
+ function getClass(value) {
+ // Returns the internal [[Class]] by calling Object.prototype.toString
+ // with the provided value as this. Return value is a string, naming the
+ // internal class, e.g. "Array"
+ return toString(value).split(/[ \]]/)[1];
+ }
+
+ var getClass_1 = getClass;
+
+ /**
+ * @name samsam.isArguments
+ * @param Object object
+ *
+ * Returns ``true`` if ``object`` is an ``arguments`` object,
+ * ``false`` otherwise.
+ */
+ function isArguments(object) {
+ if (getClass_1(object) === "Arguments") {
+ return true;
+ }
+ if (
+ typeof object !== "object" ||
+ typeof object.length !== "number" ||
+ getClass_1(object) === "Array"
+ ) {
+ return false;
+ }
+ if (typeof object.callee === "function") {
+ return true;
+ }
+ try {
+ object[object.length] = 6;
+ delete object[object.length];
+ } catch (e) {
+ return true;
+ }
+ return false;
+ }
+
+ var isArguments_1 = isArguments;
+
+ var div = typeof document !== "undefined" && document.createElement("div");
+
+ /**
+ * @name samsam.isElement
+ * @param Object object
+ *
+ * Returns ``true`` if ``object`` is a DOM element node. Unlike
+ * Underscore.js/lodash, this function will return ``false`` if ``object``
+ * is an *element-like* object, i.e. a regular object with a ``nodeType``
+ * property that holds the value ``1``.
+ */
+ function isElement(object) {
+ if (!object || object.nodeType !== 1 || !div) {
+ return false;
+ }
+ try {
+ object.appendChild(div);
+ object.removeChild(div);
+ } catch (e) {
+ return false;
+ }
+ return true;
+ }
+
+ var isElement_1 = isElement;
+
+ function isSet(val) {
+ return (typeof Set !== "undefined" && val instanceof Set) || false;
+ }
+
+ var isSet_1 = isSet;
+
+ function isDate(value) {
+ return value instanceof Date;
+ }
+
+ var isDate_1 = isDate;
+
+ function isMap(value) {
+ return typeof Map !== "undefined" && value instanceof Map;
+ }
+
+ var isMap_1 = isMap;
+
+ // Returns true when the value is a regular Object and not a specialized Object
+ //
+ // This helps speeding up deepEqual cyclic checks
+ // The premise is that only Objects are stored in the visited array.
+ // So if this function returns false, we don't have to do the
+ // expensive operation of searching for the value in the the array of already
+ // visited objects
+ function isObject(value) {
+ return (
+ typeof value === "object" &&
+ value !== null &&
+ // none of these are collection objects, so we can return false
+ !(value instanceof Boolean) &&
+ !(value instanceof Date) &&
+ !(value instanceof Error) &&
+ !(value instanceof Number) &&
+ !(value instanceof RegExp) &&
+ !(value instanceof String)
+ );
+ }
+
+ var isObject_1 = isObject;
+
+ function isSubset(s1, s2, compare) {
+ var allContained = true;
+ s1.forEach(function(v1) {
+ var includes = false;
+ s2.forEach(function(v2) {
+ if (compare(v2, v1)) {
+ includes = true;
+ }
+ });
+ allContained = allContained && includes;
+ });
+
+ return allContained;
+ }
+
+ var isSubset_1 = isSubset;
+
+ var valueToString = require$$0.valueToString;
+ var className = require$$0.className;
+ var arrayProto = require$$0.prototypes.array;
+ var objectProto = require$$0.prototypes.object;
+
+
+
+
+
+
+
+
+
+
+
+
+ var every = arrayProto.every;
+ var getTime = Date.prototype.getTime;
+ var hasOwnProperty = objectProto.hasOwnProperty;
+ var indexOf = arrayProto.indexOf;
+ var keys = Object.keys;
+ var getOwnPropertySymbols = Object.getOwnPropertySymbols;
+
+ /**
+ * @name samsam.deepEqual
+ * @param Object actual
+ * @param Object expectation
+ *
+ * Deep equal comparison. Two values are "deep equal" if:
+ *
+ * - They are equal, according to samsam.identical
+ * - They are both date objects representing the same time
+ * - They are both arrays containing elements that are all deepEqual
+ * - They are objects with the same set of properties, and each property
+ * in ``actual`` is deepEqual to the corresponding property in ``expectation``
+ *
+ * Supports cyclic objects.
+ */
+ function deepEqualCyclic(actual, expectation, match) {
+ // used for cyclic comparison
+ // contain already visited objects
+ var actualObjects = [];
+ var expectationObjects = [];
+ // contain pathes (position in the object structure)
+ // of the already visited objects
+ // indexes same as in objects arrays
+ var actualPaths = [];
+ var expectationPaths = [];
+ // contains combinations of already compared objects
+ // in the manner: { "$1['ref']$2['ref']": true }
+ var compared = {};
+
+ // does the recursion for the deep equal check
+ return (function deepEqual(
+ actualObj,
+ expectationObj,
+ actualPath,
+ expectationPath
+ ) {
+ // If both are matchers they must be the same instance in order to be
+ // considered equal If we didn't do that we would end up running one
+ // matcher against the other
+ if (match && match.isMatcher(expectationObj)) {
+ if (match.isMatcher(actualObj)) {
+ return actualObj === expectationObj;
+ }
+ return expectationObj.test(actualObj);
+ }
+
+ var actualType = typeof actualObj;
+ var expectationType = typeof expectationObj;
+
+ // == null also matches undefined
+ if (
+ actualObj === expectationObj ||
+ isNan(actualObj) ||
+ isNan(expectationObj) ||
+ actualObj == null ||
+ expectationObj == null ||
+ actualType !== "object" ||
+ expectationType !== "object"
+ ) {
+ return identical_1(actualObj, expectationObj);
+ }
+
+ // Elements are only equal if identical(expected, actual)
+ if (isElement_1(actualObj) || isElement_1(expectationObj)) {
+ return false;
+ }
+
+ var isActualDate = isDate_1(actualObj);
+ var isExpectationDate = isDate_1(expectationObj);
+ if (isActualDate || isExpectationDate) {
+ if (
+ !isActualDate ||
+ !isExpectationDate ||
+ getTime.call(actualObj) !== getTime.call(expectationObj)
+ ) {
+ return false;
+ }
+ }
+
+ if (actualObj instanceof RegExp && expectationObj instanceof RegExp) {
+ if (valueToString(actualObj) !== valueToString(expectationObj)) {
+ return false;
+ }
+ }
+
+ if (actualObj instanceof Error && expectationObj instanceof Error) {
+ return actualObj === expectationObj;
+ }
+
+ var actualClass = getClass_1(actualObj);
+ var expectationClass = getClass_1(expectationObj);
+ var actualKeys = keys(actualObj);
+ var expectationKeys = keys(expectationObj);
+ var actualName = className(actualObj);
+ var expectationName = className(expectationObj);
+ var expectationSymbols =
+ typeof getOwnPropertySymbols === "function"
+ ? getOwnPropertySymbols(expectationObj)
+ : [];
+ var expectationKeysAndSymbols = expectationKeys.concat(
+ expectationSymbols
+ );
+
+ if (isArguments_1(actualObj) || isArguments_1(expectationObj)) {
+ if (actualObj.length !== expectationObj.length) {
+ return false;
+ }
+ } else {
+ if (
+ actualType !== expectationType ||
+ actualClass !== expectationClass ||
+ actualKeys.length !== expectationKeys.length ||
+ (actualName &&
+ expectationName &&
+ actualName !== expectationName)
+ ) {
+ return false;
+ }
+ }
+
+ if (isSet_1(actualObj) || isSet_1(expectationObj)) {
+ if (
+ !isSet_1(actualObj) ||
+ !isSet_1(expectationObj) ||
+ actualObj.size !== expectationObj.size
+ ) {
+ return false;
+ }
+
+ return isSubset_1(actualObj, expectationObj, deepEqual);
+ }
+
+ if (isMap_1(actualObj) || isMap_1(expectationObj)) {
+ if (
+ !isMap_1(actualObj) ||
+ !isMap_1(expectationObj) ||
+ actualObj.size !== expectationObj.size
+ ) {
+ return false;
+ }
+
+ var mapsDeeplyEqual = true;
+ actualObj.forEach(function(value, key) {
+ mapsDeeplyEqual =
+ mapsDeeplyEqual &&
+ deepEqualCyclic(value, expectationObj.get(key));
+ });
+
+ return mapsDeeplyEqual;
+ }
+
+ return every(expectationKeysAndSymbols, function(key) {
+ if (!hasOwnProperty(actualObj, key)) {
+ return false;
+ }
+
+ var actualValue = actualObj[key];
+ var expectationValue = expectationObj[key];
+ var actualObject = isObject_1(actualValue);
+ var expectationObject = isObject_1(expectationValue);
+ // determines, if the objects were already visited
+ // (it's faster to check for isObject first, than to
+ // get -1 from getIndex for non objects)
+ var actualIndex = actualObject
+ ? indexOf(actualObjects, actualValue)
+ : -1;
+ var expectationIndex = expectationObject
+ ? indexOf(expectationObjects, expectationValue)
+ : -1;
+ // determines the new paths of the objects
+ // - for non cyclic objects the current path will be extended
+ // by current property name
+ // - for cyclic objects the stored path is taken
+ var newActualPath =
+ actualIndex !== -1
+ ? actualPaths[actualIndex]
+ : actualPath + "[" + JSON.stringify(key) + "]";
+ var newExpectationPath =
+ expectationIndex !== -1
+ ? expectationPaths[expectationIndex]
+ : expectationPath + "[" + JSON.stringify(key) + "]";
+ var combinedPath = newActualPath + newExpectationPath;
+
+ // stop recursion if current objects are already compared
+ if (compared[combinedPath]) {
+ return true;
+ }
+
+ // remember the current objects and their paths
+ if (actualIndex === -1 && actualObject) {
+ actualObjects.push(actualValue);
+ actualPaths.push(newActualPath);
+ }
+ if (expectationIndex === -1 && expectationObject) {
+ expectationObjects.push(expectationValue);
+ expectationPaths.push(newExpectationPath);
+ }
+
+ // remember that the current objects are already compared
+ if (actualObject && expectationObject) {
+ compared[combinedPath] = true;
+ }
+
+ // End of cyclic logic
+
+ // neither actualValue nor expectationValue is a cycle
+ // continue with next level
+ return deepEqual(
+ actualValue,
+ expectationValue,
+ newActualPath,
+ newExpectationPath
+ );
+ });
+ })(actual, expectation, "$1", "$2");
+ }
+
+ deepEqualCyclic.use = function(match) {
+ return function(a, b) {
+ return deepEqualCyclic(a, b, match);
+ };
+ };
+
+ var deepEqual = deepEqualCyclic;
+
+ var slice = require$$0.prototypes.string.slice;
+ var typeOf = require$$0.typeOf;
+ var valueToString$1 = require$$0.valueToString;
+
+ var iterableToString = function iterableToString(obj) {
+ var representation = "";
+
+ function stringify(item) {
+ return typeof item === "string"
+ ? "'" + item + "'"
+ : valueToString$1(item);
+ }
+
+ function mapToString(map) {
+ /* eslint-disable-next-line local-rules/no-prototype-methods */
+ map.forEach(function(value, key) {
+ representation +=
+ "[" + stringify(key) + "," + stringify(value) + "],";
+ });
+
+ representation = slice(representation, 0, -1);
+ return representation;
+ }
+
+ function genericIterableToString(iterable) {
+ /* eslint-disable-next-line local-rules/no-prototype-methods */
+ iterable.forEach(function(value) {
+ representation += stringify(value) + ",";
+ });
+
+ representation = slice(representation, 0, -1);
+ return representation;
+ }
+
+ if (typeOf(obj) === "map") {
+ return mapToString(obj);
+ }
+
+ return genericIterableToString(obj);
+ };
+
+ var arrayProto$1 = require$$0.prototypes.array;
+ var deepEqual$1 = deepEqual.use(match); // eslint-disable-line no-use-before-define
+ var every$1 = require$$0.every;
+ var functionName = require$$0.functionName;
+ var get = lodash.get;
+
+ var objectProto$1 = require$$0.prototypes.object;
+ var stringProto = require$$0.prototypes.string;
+ var typeOf$1 = require$$0.typeOf;
+ var valueToString$2 = require$$0.valueToString;
+
+ var arrayIndexOf = arrayProto$1.indexOf;
+ var arrayEvery = arrayProto$1.every;
+ var join = arrayProto$1.join;
+ var map = arrayProto$1.map;
+ var some = arrayProto$1.some;
+
+ var hasOwnProperty$1 = objectProto$1.hasOwnProperty;
+ var isPrototypeOf = objectProto$1.isPrototypeOf;
+ var objectToString = objectProto$1.toString;
+
+ var stringIndexOf = stringProto.indexOf;
+
+ var matcher = {
+ toString: function() {
+ return this.message;
+ }
+ };
+
+ function isMatcher(object) {
+ return isPrototypeOf(matcher, object);
+ }
+
+ function assertType(value, type, name) {
+ var actual = typeOf$1(value);
+ if (actual !== type) {
+ throw new TypeError(
+ "Expected type of " +
+ name +
+ " to be " +
+ type +
+ ", but was " +
+ actual
+ );
+ }
+ }
+
+ function assertMethodExists(value, method, name, methodPath) {
+ if (value[method] == null) {
+ throw new TypeError(
+ "Expected " + name + " to have method " + methodPath
+ );
+ }
+ }
+
+ function assertMatcher(value) {
+ if (!isMatcher(value)) {
+ throw new TypeError("Matcher expected");
+ }
+ }
+
+ function isIterable(value) {
+ return !!value && typeOf$1(value.forEach) === "function";
+ }
+
+ function matchObject(actual, expectation) {
+ if (actual === null || actual === undefined) {
+ return false;
+ }
+
+ return arrayEvery(Object.keys(expectation), function(key) {
+ var exp = expectation[key];
+ var act = actual[key];
+
+ if (isMatcher(exp)) {
+ if (!exp.test(act)) {
+ return false;
+ }
+ } else if (typeOf$1(exp) === "object") {
+ if (!matchObject(act, exp)) {
+ return false;
+ }
+ } else if (!deepEqual$1(act, exp)) {
+ return false;
+ }
+
+ return true;
+ });
+ }
+
+ var TYPE_MAP = {
+ function: function(m, expectation, message) {
+ m.test = expectation;
+ m.message = message || "match(" + functionName(expectation) + ")";
+ },
+ number: function(m, expectation) {
+ m.test = function(actual) {
+ // we need type coercion here
+ return expectation == actual; // eslint-disable-line eqeqeq
+ };
+ },
+ object: function(m, expectation) {
+ var array = [];
+
+ if (typeof expectation.test === "function") {
+ m.test = function(actual) {
+ return expectation.test(actual) === true;
+ };
+ m.message = "match(" + functionName(expectation.test) + ")";
+ return m;
+ }
+
+ array = map(Object.keys(expectation), function(key) {
+ return key + ": " + valueToString$2(expectation[key]);
+ });
+
+ m.test = function(actual) {
+ return matchObject(actual, expectation);
+ };
+ m.message = "match(" + join(array, ", ") + ")";
+
+ return m;
+ },
+ regexp: function(m, expectation) {
+ m.test = function(actual) {
+ return typeof actual === "string" && expectation.test(actual);
+ };
+ },
+ string: function(m, expectation) {
+ m.test = function(actual) {
+ return (
+ typeof actual === "string" &&
+ stringIndexOf(actual, expectation) !== -1
+ );
+ };
+ m.message = 'match("' + expectation + '")';
+ }
+ };
+
+ function match(expectation, message) {
+ var m = Object.create(matcher);
+ var type = typeOf$1(expectation);
+
+ if (message !== undefined && typeof message !== "string") {
+ throw new TypeError("Message should be a string");
+ }
+
+ if (arguments.length > 2) {
+ throw new TypeError(
+ "Expected 1 or 2 arguments, received " + arguments.length
+ );
+ }
+
+ if (type in TYPE_MAP) {
+ TYPE_MAP[type](m, expectation, message);
+ } else {
+ m.test = function(actual) {
+ return deepEqual$1(actual, expectation);
+ };
+ }
+
+ if (!m.message) {
+ m.message = "match(" + valueToString$2(expectation) + ")";
+ }
+
+ return m;
+ }
+
+ matcher.or = function(m2) {
+ if (!arguments.length) {
+ throw new TypeError("Matcher expected");
+ } else if (!isMatcher(m2)) {
+ m2 = match(m2);
+ }
+ var m1 = this;
+ var or = Object.create(matcher);
+ or.test = function(actual) {
+ return m1.test(actual) || m2.test(actual);
+ };
+ or.message = m1.message + ".or(" + m2.message + ")";
+ return or;
+ };
+
+ matcher.and = function(m2) {
+ if (!arguments.length) {
+ throw new TypeError("Matcher expected");
+ } else if (!isMatcher(m2)) {
+ m2 = match(m2);
+ }
+ var m1 = this;
+ var and = Object.create(matcher);
+ and.test = function(actual) {
+ return m1.test(actual) && m2.test(actual);
+ };
+ and.message = m1.message + ".and(" + m2.message + ")";
+ return and;
+ };
+
+ match.isMatcher = isMatcher;
+
+ match.any = match(function() {
+ return true;
+ }, "any");
+
+ match.defined = match(function(actual) {
+ return actual !== null && actual !== undefined;
+ }, "defined");
+
+ match.truthy = match(function(actual) {
+ return !!actual;
+ }, "truthy");
+
+ match.falsy = match(function(actual) {
+ return !actual;
+ }, "falsy");
+
+ match.same = function(expectation) {
+ return match(function(actual) {
+ return expectation === actual;
+ }, "same(" + valueToString$2(expectation) + ")");
+ };
+
+ match.in = function(arrayOfExpectations) {
+ if (typeOf$1(arrayOfExpectations) !== "array") {
+ throw new TypeError("array expected");
+ }
+
+ return match(function(actual) {
+ return some(arrayOfExpectations, function(expectation) {
+ return expectation === actual;
+ });
+ }, "in(" + valueToString$2(arrayOfExpectations) + ")");
+ };
+
+ match.typeOf = function(type) {
+ assertType(type, "string", "type");
+ return match(function(actual) {
+ return typeOf$1(actual) === type;
+ }, 'typeOf("' + type + '")');
+ };
+
+ match.instanceOf = function(type) {
+ if (
+ typeof Symbol === "undefined" ||
+ typeof Symbol.hasInstance === "undefined"
+ ) {
+ assertType(type, "function", "type");
+ } else {
+ assertMethodExists(
+ type,
+ Symbol.hasInstance,
+ "type",
+ "[Symbol.hasInstance]"
+ );
+ }
+ return match(function(actual) {
+ return actual instanceof type;
+ }, "instanceOf(" + (functionName(type) || objectToString(type)) + ")");
+ };
+
+ function createPropertyMatcher(propertyTest, messagePrefix) {
+ return function(property, value) {
+ assertType(property, "string", "property");
+ var onlyProperty = arguments.length === 1;
+ var message = messagePrefix + '("' + property + '"';
+ if (!onlyProperty) {
+ message += ", " + valueToString$2(value);
+ }
+ message += ")";
+ return match(function(actual) {
+ if (
+ actual === undefined ||
+ actual === null ||
+ !propertyTest(actual, property)
+ ) {
+ return false;
+ }
+ return onlyProperty || deepEqual$1(actual[property], value);
+ }, message);
+ };
+ }
+
+ match.has = createPropertyMatcher(function(actual, property) {
+ if (typeof actual === "object") {
+ return property in actual;
+ }
+ return actual[property] !== undefined;
+ }, "has");
+
+ match.hasOwn = createPropertyMatcher(function(actual, property) {
+ return hasOwnProperty$1(actual, property);
+ }, "hasOwn");
+
+ match.hasNested = function(property, value) {
+ assertType(property, "string", "property");
+ var onlyProperty = arguments.length === 1;
+ var message = 'hasNested("' + property + '"';
+ if (!onlyProperty) {
+ message += ", " + valueToString$2(value);
+ }
+ message += ")";
+ return match(function(actual) {
+ if (
+ actual === undefined ||
+ actual === null ||
+ get(actual, property) === undefined
+ ) {
+ return false;
+ }
+ return onlyProperty || deepEqual$1(get(actual, property), value);
+ }, message);
+ };
+
+ match.every = function(predicate) {
+ assertMatcher(predicate);
+
+ return match(function(actual) {
+ if (typeOf$1(actual) === "object") {
+ return every$1(Object.keys(actual), function(key) {
+ return predicate.test(actual[key]);
+ });
+ }
+
+ return (
+ isIterable(actual) &&
+ every$1(actual, function(element) {
+ return predicate.test(element);
+ })
+ );
+ }, "every(" + predicate.message + ")");
+ };
+
+ match.some = function(predicate) {
+ assertMatcher(predicate);
+
+ return match(function(actual) {
+ if (typeOf$1(actual) === "object") {
+ return !every$1(Object.keys(actual), function(key) {
+ return !predicate.test(actual[key]);
+ });
+ }
+
+ return (
+ isIterable(actual) &&
+ !every$1(actual, function(element) {
+ return !predicate.test(element);
+ })
+ );
+ }, "some(" + predicate.message + ")");
+ };
+
+ match.array = match.typeOf("array");
+
+ match.array.deepEquals = function(expectation) {
+ return match(function(actual) {
+ // Comparing lengths is the fastest way to spot a difference before iterating through every item
+ var sameLength = actual.length === expectation.length;
+ return (
+ typeOf$1(actual) === "array" &&
+ sameLength &&
+ every$1(actual, function(element, index) {
+ var expected = expectation[index];
+ return typeOf$1(expected) === "array" &&
+ typeOf$1(element) === "array"
+ ? match.array.deepEquals(expected).test(element)
+ : deepEqual$1(expected, element);
+ })
+ );
+ }, "deepEquals([" + iterableToString(expectation) + "])");
+ };
+
+ match.array.startsWith = function(expectation) {
+ return match(function(actual) {
+ return (
+ typeOf$1(actual) === "array" &&
+ every$1(expectation, function(expectedElement, index) {
+ return actual[index] === expectedElement;
+ })
+ );
+ }, "startsWith([" + iterableToString(expectation) + "])");
+ };
+
+ match.array.endsWith = function(expectation) {
+ return match(function(actual) {
+ // This indicates the index in which we should start matching
+ var offset = actual.length - expectation.length;
+
+ return (
+ typeOf$1(actual) === "array" &&
+ every$1(expectation, function(expectedElement, index) {
+ return actual[offset + index] === expectedElement;
+ })
+ );
+ }, "endsWith([" + iterableToString(expectation) + "])");
+ };
+
+ match.array.contains = function(expectation) {
+ return match(function(actual) {
+ return (
+ typeOf$1(actual) === "array" &&
+ every$1(expectation, function(expectedElement) {
+ return arrayIndexOf(actual, expectedElement) !== -1;
+ })
+ );
+ }, "contains([" + iterableToString(expectation) + "])");
+ };
+
+ match.map = match.typeOf("map");
+
+ match.map.deepEquals = function mapDeepEquals(expectation) {
+ return match(function(actual) {
+ // Comparing lengths is the fastest way to spot a difference before iterating through every item
+ var sameLength = actual.size === expectation.size;
+ return (
+ typeOf$1(actual) === "map" &&
+ sameLength &&
+ every$1(actual, function(element, key) {
+ return expectation.has(key) && expectation.get(key) === element;
+ })
+ );
+ }, "deepEquals(Map[" + iterableToString(expectation) + "])");
+ };
+
+ match.map.contains = function mapContains(expectation) {
+ return match(function(actual) {
+ return (
+ typeOf$1(actual) === "map" &&
+ every$1(expectation, function(element, key) {
+ return actual.has(key) && actual.get(key) === element;
+ })
+ );
+ }, "contains(Map[" + iterableToString(expectation) + "])");
+ };
+
+ match.set = match.typeOf("set");
+
+ match.set.deepEquals = function setDeepEquals(expectation) {
+ return match(function(actual) {
+ // Comparing lengths is the fastest way to spot a difference before iterating through every item
+ var sameLength = actual.size === expectation.size;
+ return (
+ typeOf$1(actual) === "set" &&
+ sameLength &&
+ every$1(actual, function(element) {
+ return expectation.has(element);
+ })
+ );
+ }, "deepEquals(Set[" + iterableToString(expectation) + "])");
+ };
+
+ match.set.contains = function setContains(expectation) {
+ return match(function(actual) {
+ return (
+ typeOf$1(actual) === "set" &&
+ every$1(expectation, function(element) {
+ return actual.has(element);
+ })
+ );
+ }, "contains(Set[" + iterableToString(expectation) + "])");
+ };
+
+ match.bool = match.typeOf("boolean");
+ match.number = match.typeOf("number");
+ match.string = match.typeOf("string");
+ match.object = match.typeOf("object");
+ match.func = match.typeOf("function");
+ match.regexp = match.typeOf("regexp");
+ match.date = match.typeOf("date");
+ match.symbol = match.typeOf("symbol");
+
+ var matcher_1 = match;
+
+ var valueToString$3 = require$$0.valueToString;
+
+ var deepEqual$2 = deepEqual.use(match$1); // eslint-disable-line no-use-before-define
+
+
+
+
+
+
+ function arrayContains(array, subset, compare) {
+ if (subset.length === 0) {
+ return true;
+ }
+ var i, l, j, k;
+ for (i = 0, l = array.length; i < l; ++i) {
+ if (compare(array[i], subset[0])) {
+ for (j = 0, k = subset.length; j < k; ++j) {
+ if (i + j >= l) {
+ return false;
+ }
+ if (!compare(array[i + j], subset[j])) {
+ return false;
+ }
+ }
+ return true;
+ }
+ }
+ return false;
+ }
+
+ /**
+ * @name samsam.match
+ * @param Object object
+ * @param Object matcher
+ *
+ * Compare arbitrary value ``object`` with matcher.
+ */
+ function match$1(object, matcher) {
+ if (matcher && typeof matcher.test === "function") {
+ return matcher.test(object);
+ }
+
+ if (typeof matcher === "function") {
+ return matcher(object) === true;
+ }
+
+ if (typeof matcher === "string") {
+ matcher = matcher.toLowerCase();
+ var notNull = typeof object === "string" || !!object;
+ return (
+ notNull &&
+ valueToString$3(object)
+ .toLowerCase()
+ .indexOf(matcher) >= 0
+ );
+ }
+
+ if (typeof matcher === "number") {
+ return matcher === object;
+ }
+
+ if (typeof matcher === "boolean") {
+ return matcher === object;
+ }
+
+ if (typeof matcher === "undefined") {
+ return typeof object === "undefined";
+ }
+
+ if (matcher === null) {
+ return object === null;
+ }
+
+ if (object === null) {
+ return false;
+ }
+
+ if (isSet_1(object)) {
+ return isSubset_1(matcher, object, match$1);
+ }
+
+ if (getClass_1(object) === "Array" && getClass_1(matcher) === "Array") {
+ return arrayContains(object, matcher, match$1);
+ }
+
+ if (isDate_1(matcher)) {
+ return isDate_1(object) && object.getTime() === matcher.getTime();
+ }
+
+ if (matcher && typeof matcher === "object") {
+ if (matcher === object) {
+ return true;
+ }
+ if (typeof object !== "object") {
+ return false;
+ }
+ var prop;
+ // eslint-disable-next-line guard-for-in
+ for (prop in matcher) {
+ var value = object[prop];
+ if (
+ typeof value === "undefined" &&
+ typeof object.getAttribute === "function"
+ ) {
+ value = object.getAttribute(prop);
+ }
+ if (
+ matcher[prop] === null ||
+ typeof matcher[prop] === "undefined"
+ ) {
+ if (value !== matcher[prop]) {
+ return false;
+ }
+ } else if (
+ typeof value === "undefined" ||
+ !deepEqual$2(value, matcher[prop])
+ ) {
+ return false;
+ }
+ }
+ return true;
+ }
+
+ throw new Error(
+ "Matcher was not a string, a number, a " +
+ "function, a boolean or an object"
+ );
+ }
+
+ Object.keys(matcher_1).forEach(function(key) {
+ match$1[key] = matcher_1[key];
+ });
+
+ var match_1 = match$1;
+
+ var deepEqualCyclic$1 = deepEqual.use(match_1);
+
+
+ var samsam = {
+ createMatcher: matcher_1,
+ deepEqual: deepEqualCyclic$1,
+ identical: identical_1,
+ isArguments: isArguments_1,
+ isElement: isElement_1,
+ isNegZero: isNegZero_1,
+ isSet: isSet_1,
+ match: match_1
+ };
+ var samsam_1 = samsam.createMatcher;
+ var samsam_2 = samsam.deepEqual;
+ var samsam_3 = samsam.identical;
+ var samsam_4 = samsam.isArguments;
+ var samsam_5 = samsam.isElement;
+ var samsam_6 = samsam.isNegZero;
+ var samsam_7 = samsam.isSet;
+ var samsam_8 = samsam.match;
+
+ exports.default = samsam;
+ exports.createMatcher = samsam_1;
+ exports.deepEqual = samsam_2;
+ exports.identical = samsam_3;
+ exports.isArguments = samsam_4;
+ exports.isElement = samsam_5;
+ exports.isNegZero = samsam_6;
+ exports.isSet = samsam_7;
+ exports.match = samsam_8;
+
+ Object.defineProperty(exports, '__esModule', { value: true });
+
+})));
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/docs/index.md b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/docs/index.md
new file mode 100644
index 0000000..a054883
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/docs/index.md
@@ -0,0 +1,203 @@
+# samsam
+
+> Same same, but different
+
+`samsam` is a collection of predicate and comparison functions useful for
+identifiying the type of values and to compare values with varying degrees of
+strictness.
+
+`samsam` is a general-purpose library with no dependencies. It works in browsers
+(including old and rowdy ones, like IE6) and Node. It will define itself as an
+AMD module if you want it to (i.e. if there's a `define` function available).
+
+## Predicate functions
+
+
+### `isArguments(value)`
+
+Returns `true` if `value` is an `arguments` object, `false` otherwise.
+
+
+### `isNegZero(value)`
+
+Returns `true` if `value` is `-0`.
+
+
+### `isElement(value)`
+
+Returns `true` if `value` is a DOM element node. Unlike
+Underscore.js/lodash, this function will return `false` if `value` is an
+*element-like* object, i.e. a regular object with a `nodeType` property that
+holds the value `1`.
+
+### `isSet(value)`
+
+Returns `true` if `value` is a [Set](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set).
+
+
+## Comparison functions
+
+
+### `identical(x, y)`
+
+Strict equality check according to EcmaScript Harmony's `egal`.
+
+**From the Harmony wiki:**
+
+> An egal function simply makes available the internal `SameValue` function
+from section 9.12 of the ES5 spec. If two values are egal, then they are not
+observably distinguishable.
+
+`identical` returns `true` when `===` is `true`, except for `-0` and
+`+0`, where it returns `false`. Additionally, it returns `true` when
+`NaN` is compared to itself.
+
+
+### `deepEqual(actual, expectation)`
+
+Deep equal comparison. Two values are "deep equal" if:
+
+* They are identical
+* They are both date objects representing the same time
+* They are both arrays containing elements that are all deepEqual
+* They are objects with the same set of properties, and each property
+ in `actual` is deepEqual to the corresponding property in `expectation`
+
+ * `actual` can have [symbolic properties](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol) that are missing from `expectation`
+
+
+### `match(object, matcher)`
+
+Partial equality check. Compares `object` with matcher according a wide set of
+rules:
+
+#### String matcher
+
+In its simplest form, `match` performs a case insensitive substring match.
+When the matcher is a string, `object` is converted to a string, and the
+function returns `true` if the matcher is a case-insensitive substring of
+`object` as a string.
+
+```javascript
+samsam.match("Give me something", "Give"); //true
+samsam.match("Give me something", "sumptn"); // false
+samsam.match({ toString: function () { return "yeah"; } }, "Yeah!"); // true
+```
+
+The last example is not symmetric. When the matcher is a string, the `object`
+is coerced to a string - in this case using `toString`. Changing the order of
+the arguments would cause the matcher to be an object, in which case different
+rules apply (see below).
+
+
+#### Boolean matcher
+
+Performs a strict (i.e. `===`) match with the object. So, only `true`
+matches `true`, and only `false` matches `false`.
+
+
+#### Regular expression matcher
+
+When the matcher is a regular expression, the function will pass if
+`object.test(matcher)` is `true`. `match` is written in a generic way, so
+any object with a `test` method will be used as a matcher this way.
+
+```javascript
+samsam.match("Give me something", /^[a-z\s]$/i); // true
+samsam.match("Give me something", /[0-9]/); // false
+samsam.match({ toString: function () { return "yeah!"; } }, /yeah/); // true
+samsam.match(234, /[a-z]/); // false
+```
+
+
+#### Number matcher
+
+When the matcher is a number, the assertion will pass if `object == matcher`.
+
+```javascript
+samsam.match("123", 123); // true
+samsam.match("Give me something", 425); // false
+samsam.match({ toString: function () { return "42"; } }, 42); // true
+samsam.match(234, 1234); // false
+```
+
+
+#### Function matcher
+
+When the matcher is a function, it is called with `object` as its only
+argument. `match` returns `true` if the function returns `true`. A strict
+match is performed against the return value, so a boolean `true` is required,
+truthy is not enough.
+
+```javascript
+// true
+samsam.match("123", function (exp) {
+ return exp == "123";
+});
+
+// false
+samsam.match("Give me something", function () {
+ return "ok";
+});
+
+// true
+samsam.match({
+ toString: function () {
+ return "42";
+ }
+}, function () { return true; });
+
+// false
+samsam.match(234, function () {});
+```
+
+
+#### Object matcher
+
+As mentioned above, if an object matcher defines a `test` method, `match`
+will return `true` if `matcher.test(object)` returns truthy.
+
+If the matcher does not have a test method, a recursive match is performed. If
+all properties of `matcher` matches corresponding properties in `object`,
+`match` returns `true`. Note that the object matcher does not care if the
+number of properties in the two objects are the same - only if all properties in
+the matcher recursively matches ones in `object`.
+
+```javascript
+// true
+samsam.match("123", {
+ test: function (arg) {
+ return arg == 123;
+ }
+});
+
+// false
+samsam.match({}, { prop: 42 });
+
+// true
+samsam.match({
+ name: "Chris",
+ profession: "Programmer"
+}, {
+ name: "Chris"
+});
+
+// false
+samsam.match(234, { name: "Chris" });
+```
+
+
+#### DOM elements
+
+`match` can be very helpful when comparing DOM elements, because it allows
+you to compare several properties with one call:
+
+```javascript
+var el = document.getElementById("myEl");
+
+samsam.match(el, {
+ tagName: "h2",
+ className: "item",
+ innerHTML: "Howdy"
+});
+```
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/create-set.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/create-set.js
new file mode 100644
index 0000000..37ad6d5
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/create-set.js
@@ -0,0 +1,27 @@
+"use strict";
+
+var typeOf = require("@sinonjs/commons").typeOf;
+
+// This helper makes it convenient to create Set instances from a
+// collection, an overcomes the shortcoming that IE11 doesn't support
+// collection arguments
+//
+// See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
+function createSet(array) {
+ if (arguments.length > 0 && !Array.isArray(array)) {
+ throw new TypeError(
+ "createSet can be called with either no arguments or an Array"
+ );
+ }
+
+ var items = typeOf(array) === "array" ? array : [];
+ var set = new Set();
+
+ items.forEach(function(item) {
+ set.add(item);
+ });
+
+ return set;
+}
+
+module.exports = createSet;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/deep-equal-benchmark.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/deep-equal-benchmark.js
new file mode 100644
index 0000000..6193bb0
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/deep-equal-benchmark.js
@@ -0,0 +1,74 @@
+"use strict";
+
+var Benchmark = require("benchmark");
+var deepEqual = require("./deep-equal");
+
+var suite = new Benchmark.Suite();
+var complex1 = {
+ "1e116061-59bf-433a-8ab0-017b67a51d26":
+ "a7fd22ab-e809-414f-ad55-9c97598395d8",
+ "3824e8b7-22f5-489c-9919-43b432e3af6b":
+ "548baefd-f43c-4dc9-9df5-f7c9c96223b0",
+ "123e5750-eb66-45e5-a770-310879203b33":
+ "89ff817d-65a2-4598-b190-21c128096e6a",
+ "1d66be95-8aaa-4167-9a47-e7ee19bb0735":
+ "64349492-56e8-4100-9552-a89fb4a9aef4",
+ "f5538565-dc92-4ee4-a762-1ba5fe0528f6": {
+ "53631f78-2f2a-448f-89c7-ed3585e8e6f0":
+ "2cce00ee-f5ee-43ef-878f-958597b23225",
+ "73e8298b-72fd-4969-afc1-d891b61e744f":
+ "4e57aa30-af51-4d78-887c-019755e5d117",
+ "85439907-5b0e-4a08-8cfa-902a68dc3cc0":
+ "9639add9-6897-4cf0-b3d3-2ebf9c214f01",
+ "d4ae9d87-bd6c-47e0-95a1-6f4eb4211549":
+ "41fd3dd2-43ce-47f2-b92e-462474d07a6f",
+ "f70345a2-0ea3-45a6-bafa-8c7a72379277": {
+ "1bce714b-cd0a-417d-9a0c-bf4b7d35c0c4":
+ "3b8b0dde-e2ed-4b34-ac8d-729ba3c9667e",
+ "13e05c60-97d1-43f0-a6ef-d5247f4dd11f":
+ "60f685a4-6558-4ade-9d4b-28281c3989db",
+ "925b2609-e7b7-42f5-82cf-2d995697cec5":
+ "79115261-8161-4a6c-9487-47847276a717",
+ "52d644ac-7b33-4b79-b5b3-5afe7fd4ec2c": [
+ "3c2ae716-92f1-4a3d-b98f-50ea49f51c45",
+ "de76b822-71b3-4b5a-a041-4140378b70e2",
+ "0302a405-1d58-44fa-a0c6-dd07bb0ca26e",
+ new Date(),
+ new Error(),
+ new RegExp(),
+ // eslint-disable-next-line no-undef
+ new Map(),
+ new Set(),
+ // eslint-disable-next-line no-undef, ie11/no-weak-collections
+ new WeakMap(),
+ // eslint-disable-next-line no-undef, ie11/no-weak-collections
+ new WeakSet()
+ ]
+ }
+ }
+};
+var complex2 = Object.create(complex1);
+
+var cyclic1 = {
+ "4a092cd1-225e-4739-8331-d6564aafb702":
+ "d0cebbe0-23fb-4cc4-8fa0-ef11ceedf12e"
+};
+cyclic1.cyclicRef = cyclic1;
+
+var cyclic2 = Object.create(cyclic1);
+
+// add tests
+suite
+ .add("complex objects", function() {
+ return deepEqual(complex1, complex2);
+ })
+ .add("cyclic references", function() {
+ return deepEqual(cyclic1, cyclic2);
+ })
+ // add listeners
+ .on("cycle", function(event) {
+ // eslint-disable-next-line no-console
+ console.log(String(event.target));
+ })
+ // run async
+ .run({ async: true });
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/deep-equal.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/deep-equal.js
new file mode 100644
index 0000000..64f2f19
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/deep-equal.js
@@ -0,0 +1,249 @@
+"use strict";
+
+var valueToString = require("@sinonjs/commons").valueToString;
+var className = require("@sinonjs/commons").className;
+var arrayProto = require("@sinonjs/commons").prototypes.array;
+var objectProto = require("@sinonjs/commons").prototypes.object;
+
+var getClass = require("./get-class");
+var identical = require("./identical");
+var isArguments = require("./is-arguments");
+var isDate = require("./is-date");
+var isElement = require("./is-element");
+var isMap = require("./is-map");
+var isNaN = require("./is-nan");
+var isObject = require("./is-object");
+var isSet = require("./is-set");
+var isSubset = require("./is-subset");
+
+var every = arrayProto.every;
+var getTime = Date.prototype.getTime;
+var hasOwnProperty = objectProto.hasOwnProperty;
+var indexOf = arrayProto.indexOf;
+var keys = Object.keys;
+var getOwnPropertySymbols = Object.getOwnPropertySymbols;
+
+/**
+ * @name samsam.deepEqual
+ * @param Object actual
+ * @param Object expectation
+ *
+ * Deep equal comparison. Two values are "deep equal" if:
+ *
+ * - They are equal, according to samsam.identical
+ * - They are both date objects representing the same time
+ * - They are both arrays containing elements that are all deepEqual
+ * - They are objects with the same set of properties, and each property
+ * in ``actual`` is deepEqual to the corresponding property in ``expectation``
+ *
+ * Supports cyclic objects.
+ */
+function deepEqualCyclic(actual, expectation, match) {
+ // used for cyclic comparison
+ // contain already visited objects
+ var actualObjects = [];
+ var expectationObjects = [];
+ // contain pathes (position in the object structure)
+ // of the already visited objects
+ // indexes same as in objects arrays
+ var actualPaths = [];
+ var expectationPaths = [];
+ // contains combinations of already compared objects
+ // in the manner: { "$1['ref']$2['ref']": true }
+ var compared = {};
+
+ // does the recursion for the deep equal check
+ return (function deepEqual(
+ actualObj,
+ expectationObj,
+ actualPath,
+ expectationPath
+ ) {
+ // If both are matchers they must be the same instance in order to be
+ // considered equal If we didn't do that we would end up running one
+ // matcher against the other
+ if (match && match.isMatcher(expectationObj)) {
+ if (match.isMatcher(actualObj)) {
+ return actualObj === expectationObj;
+ }
+ return expectationObj.test(actualObj);
+ }
+
+ var actualType = typeof actualObj;
+ var expectationType = typeof expectationObj;
+
+ // == null also matches undefined
+ if (
+ actualObj === expectationObj ||
+ isNaN(actualObj) ||
+ isNaN(expectationObj) ||
+ actualObj == null ||
+ expectationObj == null ||
+ actualType !== "object" ||
+ expectationType !== "object"
+ ) {
+ return identical(actualObj, expectationObj);
+ }
+
+ // Elements are only equal if identical(expected, actual)
+ if (isElement(actualObj) || isElement(expectationObj)) {
+ return false;
+ }
+
+ var isActualDate = isDate(actualObj);
+ var isExpectationDate = isDate(expectationObj);
+ if (isActualDate || isExpectationDate) {
+ if (
+ !isActualDate ||
+ !isExpectationDate ||
+ getTime.call(actualObj) !== getTime.call(expectationObj)
+ ) {
+ return false;
+ }
+ }
+
+ if (actualObj instanceof RegExp && expectationObj instanceof RegExp) {
+ if (valueToString(actualObj) !== valueToString(expectationObj)) {
+ return false;
+ }
+ }
+
+ if (actualObj instanceof Error && expectationObj instanceof Error) {
+ return actualObj === expectationObj;
+ }
+
+ var actualClass = getClass(actualObj);
+ var expectationClass = getClass(expectationObj);
+ var actualKeys = keys(actualObj);
+ var expectationKeys = keys(expectationObj);
+ var actualName = className(actualObj);
+ var expectationName = className(expectationObj);
+ var expectationSymbols =
+ typeof getOwnPropertySymbols === "function"
+ ? getOwnPropertySymbols(expectationObj)
+ : [];
+ var expectationKeysAndSymbols = expectationKeys.concat(
+ expectationSymbols
+ );
+
+ if (isArguments(actualObj) || isArguments(expectationObj)) {
+ if (actualObj.length !== expectationObj.length) {
+ return false;
+ }
+ } else {
+ if (
+ actualType !== expectationType ||
+ actualClass !== expectationClass ||
+ actualKeys.length !== expectationKeys.length ||
+ (actualName &&
+ expectationName &&
+ actualName !== expectationName)
+ ) {
+ return false;
+ }
+ }
+
+ if (isSet(actualObj) || isSet(expectationObj)) {
+ if (
+ !isSet(actualObj) ||
+ !isSet(expectationObj) ||
+ actualObj.size !== expectationObj.size
+ ) {
+ return false;
+ }
+
+ return isSubset(actualObj, expectationObj, deepEqual);
+ }
+
+ if (isMap(actualObj) || isMap(expectationObj)) {
+ if (
+ !isMap(actualObj) ||
+ !isMap(expectationObj) ||
+ actualObj.size !== expectationObj.size
+ ) {
+ return false;
+ }
+
+ var mapsDeeplyEqual = true;
+ actualObj.forEach(function(value, key) {
+ mapsDeeplyEqual =
+ mapsDeeplyEqual &&
+ deepEqualCyclic(value, expectationObj.get(key));
+ });
+
+ return mapsDeeplyEqual;
+ }
+
+ return every(expectationKeysAndSymbols, function(key) {
+ if (!hasOwnProperty(actualObj, key)) {
+ return false;
+ }
+
+ var actualValue = actualObj[key];
+ var expectationValue = expectationObj[key];
+ var actualObject = isObject(actualValue);
+ var expectationObject = isObject(expectationValue);
+ // determines, if the objects were already visited
+ // (it's faster to check for isObject first, than to
+ // get -1 from getIndex for non objects)
+ var actualIndex = actualObject
+ ? indexOf(actualObjects, actualValue)
+ : -1;
+ var expectationIndex = expectationObject
+ ? indexOf(expectationObjects, expectationValue)
+ : -1;
+ // determines the new paths of the objects
+ // - for non cyclic objects the current path will be extended
+ // by current property name
+ // - for cyclic objects the stored path is taken
+ var newActualPath =
+ actualIndex !== -1
+ ? actualPaths[actualIndex]
+ : actualPath + "[" + JSON.stringify(key) + "]";
+ var newExpectationPath =
+ expectationIndex !== -1
+ ? expectationPaths[expectationIndex]
+ : expectationPath + "[" + JSON.stringify(key) + "]";
+ var combinedPath = newActualPath + newExpectationPath;
+
+ // stop recursion if current objects are already compared
+ if (compared[combinedPath]) {
+ return true;
+ }
+
+ // remember the current objects and their paths
+ if (actualIndex === -1 && actualObject) {
+ actualObjects.push(actualValue);
+ actualPaths.push(newActualPath);
+ }
+ if (expectationIndex === -1 && expectationObject) {
+ expectationObjects.push(expectationValue);
+ expectationPaths.push(newExpectationPath);
+ }
+
+ // remember that the current objects are already compared
+ if (actualObject && expectationObject) {
+ compared[combinedPath] = true;
+ }
+
+ // End of cyclic logic
+
+ // neither actualValue nor expectationValue is a cycle
+ // continue with next level
+ return deepEqual(
+ actualValue,
+ expectationValue,
+ newActualPath,
+ newExpectationPath
+ );
+ });
+ })(actual, expectation, "$1", "$2");
+}
+
+deepEqualCyclic.use = function(match) {
+ return function(a, b) {
+ return deepEqualCyclic(a, b, match);
+ };
+};
+
+module.exports = deepEqualCyclic;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/get-class.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/get-class.js
new file mode 100644
index 0000000..24b4317
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/get-class.js
@@ -0,0 +1,12 @@
+"use strict";
+
+var toString = require("@sinonjs/commons").prototypes.object.toString;
+
+function getClass(value) {
+ // Returns the internal [[Class]] by calling Object.prototype.toString
+ // with the provided value as this. Return value is a string, naming the
+ // internal class, e.g. "Array"
+ return toString(value).split(/[ \]]/)[1];
+}
+
+module.exports = getClass;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/identical.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/identical.js
new file mode 100644
index 0000000..a673670
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/identical.js
@@ -0,0 +1,25 @@
+"use strict";
+
+var isNaN = require("./is-nan");
+var isNegZero = require("./is-neg-zero");
+
+/**
+ * @name samsam.equal
+ * @param Object obj1
+ * @param Object obj2
+ *
+ * Returns ``true`` if two objects are strictly equal. Compared to
+ * ``===`` there are two exceptions:
+ *
+ * - NaN is considered equal to NaN
+ * - -0 and +0 are not considered equal
+ */
+function identical(obj1, obj2) {
+ if (obj1 === obj2 || (isNaN(obj1) && isNaN(obj2))) {
+ return obj1 !== 0 || isNegZero(obj1) === isNegZero(obj2);
+ }
+
+ return false;
+}
+
+module.exports = identical;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-arguments.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-arguments.js
new file mode 100644
index 0000000..c24beec
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-arguments.js
@@ -0,0 +1,35 @@
+"use strict";
+
+var getClass = require("./get-class");
+
+/**
+ * @name samsam.isArguments
+ * @param Object object
+ *
+ * Returns ``true`` if ``object`` is an ``arguments`` object,
+ * ``false`` otherwise.
+ */
+function isArguments(object) {
+ if (getClass(object) === "Arguments") {
+ return true;
+ }
+ if (
+ typeof object !== "object" ||
+ typeof object.length !== "number" ||
+ getClass(object) === "Array"
+ ) {
+ return false;
+ }
+ if (typeof object.callee === "function") {
+ return true;
+ }
+ try {
+ object[object.length] = 6;
+ delete object[object.length];
+ } catch (e) {
+ return true;
+ }
+ return false;
+}
+
+module.exports = isArguments;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-date.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-date.js
new file mode 100644
index 0000000..23537a0
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-date.js
@@ -0,0 +1,7 @@
+"use strict";
+
+function isDate(value) {
+ return value instanceof Date;
+}
+
+module.exports = isDate;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-element.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-element.js
new file mode 100644
index 0000000..55feae9
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-element.js
@@ -0,0 +1,27 @@
+"use strict";
+
+var div = typeof document !== "undefined" && document.createElement("div");
+
+/**
+ * @name samsam.isElement
+ * @param Object object
+ *
+ * Returns ``true`` if ``object`` is a DOM element node. Unlike
+ * Underscore.js/lodash, this function will return ``false`` if ``object``
+ * is an *element-like* object, i.e. a regular object with a ``nodeType``
+ * property that holds the value ``1``.
+ */
+function isElement(object) {
+ if (!object || object.nodeType !== 1 || !div) {
+ return false;
+ }
+ try {
+ object.appendChild(div);
+ object.removeChild(div);
+ } catch (e) {
+ return false;
+ }
+ return true;
+}
+
+module.exports = isElement;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-map.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-map.js
new file mode 100644
index 0000000..c392d8e
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-map.js
@@ -0,0 +1,7 @@
+"use strict";
+
+function isMap(value) {
+ return typeof Map !== "undefined" && value instanceof Map;
+}
+
+module.exports = isMap;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-nan.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-nan.js
new file mode 100644
index 0000000..9dd2355
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-nan.js
@@ -0,0 +1,11 @@
+"use strict";
+
+function isNaN(value) {
+ // Unlike global isNaN, this avoids type coercion
+ // typeof check avoids IE host object issues, hat tip to
+ // lodash
+ var val = value; // JsLint thinks value !== value is "weird"
+ return typeof value === "number" && value !== val;
+}
+
+module.exports = isNaN;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-neg-zero.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-neg-zero.js
new file mode 100644
index 0000000..ca10524
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-neg-zero.js
@@ -0,0 +1,13 @@
+"use strict";
+
+/**
+ * @name samsam.isNegZero
+ * @param Object value
+ *
+ * Returns ``true`` if ``value`` is ``-0``.
+ */
+function isNegZero(value) {
+ return value === 0 && 1 / value === -Infinity;
+}
+
+module.exports = isNegZero;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-object.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-object.js
new file mode 100644
index 0000000..01eea47
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-object.js
@@ -0,0 +1,24 @@
+"use strict";
+
+// Returns true when the value is a regular Object and not a specialized Object
+//
+// This helps speeding up deepEqual cyclic checks
+// The premise is that only Objects are stored in the visited array.
+// So if this function returns false, we don't have to do the
+// expensive operation of searching for the value in the the array of already
+// visited objects
+function isObject(value) {
+ return (
+ typeof value === "object" &&
+ value !== null &&
+ // none of these are collection objects, so we can return false
+ !(value instanceof Boolean) &&
+ !(value instanceof Date) &&
+ !(value instanceof Error) &&
+ !(value instanceof Number) &&
+ !(value instanceof RegExp) &&
+ !(value instanceof String)
+ );
+}
+
+module.exports = isObject;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-set.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-set.js
new file mode 100644
index 0000000..8607b26
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-set.js
@@ -0,0 +1,7 @@
+"use strict";
+
+function isSet(val) {
+ return (typeof Set !== "undefined" && val instanceof Set) || false;
+}
+
+module.exports = isSet;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-subset.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-subset.js
new file mode 100644
index 0000000..c894974
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/is-subset.js
@@ -0,0 +1,18 @@
+"use strict";
+
+function isSubset(s1, s2, compare) {
+ var allContained = true;
+ s1.forEach(function(v1) {
+ var includes = false;
+ s2.forEach(function(v2) {
+ if (compare(v2, v1)) {
+ includes = true;
+ }
+ });
+ allContained = allContained && includes;
+ });
+
+ return allContained;
+}
+
+module.exports = isSubset;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/iterable-to-string.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/iterable-to-string.js
new file mode 100644
index 0000000..1709976
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/iterable-to-string.js
@@ -0,0 +1,42 @@
+"use strict";
+
+var slice = require("@sinonjs/commons").prototypes.string.slice;
+var typeOf = require("@sinonjs/commons").typeOf;
+var valueToString = require("@sinonjs/commons").valueToString;
+
+module.exports = function iterableToString(obj) {
+ var representation = "";
+
+ function stringify(item) {
+ return typeof item === "string"
+ ? "'" + item + "'"
+ : valueToString(item);
+ }
+
+ function mapToString(map) {
+ /* eslint-disable-next-line local-rules/no-prototype-methods */
+ map.forEach(function(value, key) {
+ representation +=
+ "[" + stringify(key) + "," + stringify(value) + "],";
+ });
+
+ representation = slice(representation, 0, -1);
+ return representation;
+ }
+
+ function genericIterableToString(iterable) {
+ /* eslint-disable-next-line local-rules/no-prototype-methods */
+ iterable.forEach(function(value) {
+ representation += stringify(value) + ",";
+ });
+
+ representation = slice(representation, 0, -1);
+ return representation;
+ }
+
+ if (typeOf(obj) === "map") {
+ return mapToString(obj);
+ }
+
+ return genericIterableToString(obj);
+};
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/match.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/match.js
new file mode 100644
index 0000000..bc80fc0
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/match.js
@@ -0,0 +1,136 @@
+"use strict";
+
+var valueToString = require("@sinonjs/commons").valueToString;
+
+var deepEqual = require("./deep-equal").use(match); // eslint-disable-line no-use-before-define
+var getClass = require("./get-class");
+var isDate = require("./is-date");
+var isSet = require("./is-set");
+var isSubset = require("./is-subset");
+var createMatcher = require("./matcher");
+
+function arrayContains(array, subset, compare) {
+ if (subset.length === 0) {
+ return true;
+ }
+ var i, l, j, k;
+ for (i = 0, l = array.length; i < l; ++i) {
+ if (compare(array[i], subset[0])) {
+ for (j = 0, k = subset.length; j < k; ++j) {
+ if (i + j >= l) {
+ return false;
+ }
+ if (!compare(array[i + j], subset[j])) {
+ return false;
+ }
+ }
+ return true;
+ }
+ }
+ return false;
+}
+
+/**
+ * @name samsam.match
+ * @param Object object
+ * @param Object matcher
+ *
+ * Compare arbitrary value ``object`` with matcher.
+ */
+function match(object, matcher) {
+ if (matcher && typeof matcher.test === "function") {
+ return matcher.test(object);
+ }
+
+ if (typeof matcher === "function") {
+ return matcher(object) === true;
+ }
+
+ if (typeof matcher === "string") {
+ matcher = matcher.toLowerCase();
+ var notNull = typeof object === "string" || !!object;
+ return (
+ notNull &&
+ valueToString(object)
+ .toLowerCase()
+ .indexOf(matcher) >= 0
+ );
+ }
+
+ if (typeof matcher === "number") {
+ return matcher === object;
+ }
+
+ if (typeof matcher === "boolean") {
+ return matcher === object;
+ }
+
+ if (typeof matcher === "undefined") {
+ return typeof object === "undefined";
+ }
+
+ if (matcher === null) {
+ return object === null;
+ }
+
+ if (object === null) {
+ return false;
+ }
+
+ if (isSet(object)) {
+ return isSubset(matcher, object, match);
+ }
+
+ if (getClass(object) === "Array" && getClass(matcher) === "Array") {
+ return arrayContains(object, matcher, match);
+ }
+
+ if (isDate(matcher)) {
+ return isDate(object) && object.getTime() === matcher.getTime();
+ }
+
+ if (matcher && typeof matcher === "object") {
+ if (matcher === object) {
+ return true;
+ }
+ if (typeof object !== "object") {
+ return false;
+ }
+ var prop;
+ // eslint-disable-next-line guard-for-in
+ for (prop in matcher) {
+ var value = object[prop];
+ if (
+ typeof value === "undefined" &&
+ typeof object.getAttribute === "function"
+ ) {
+ value = object.getAttribute(prop);
+ }
+ if (
+ matcher[prop] === null ||
+ typeof matcher[prop] === "undefined"
+ ) {
+ if (value !== matcher[prop]) {
+ return false;
+ }
+ } else if (
+ typeof value === "undefined" ||
+ !deepEqual(value, matcher[prop])
+ ) {
+ return false;
+ }
+ }
+ return true;
+ }
+
+ throw new Error(
+ "Matcher was not a string, a number, a " +
+ "function, a boolean or an object"
+ );
+}
+
+Object.keys(createMatcher).forEach(function(key) {
+ match[key] = createMatcher[key];
+});
+
+module.exports = match;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/matcher.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/matcher.js
new file mode 100644
index 0000000..732850b
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/matcher.js
@@ -0,0 +1,473 @@
+"use strict";
+
+var arrayProto = require("@sinonjs/commons").prototypes.array;
+var deepEqual = require("./deep-equal").use(match); // eslint-disable-line no-use-before-define
+var every = require("@sinonjs/commons").every;
+var functionName = require("@sinonjs/commons").functionName;
+var get = require("lodash").get;
+var iterableToString = require("./iterable-to-string");
+var objectProto = require("@sinonjs/commons").prototypes.object;
+var stringProto = require("@sinonjs/commons").prototypes.string;
+var typeOf = require("@sinonjs/commons").typeOf;
+var valueToString = require("@sinonjs/commons").valueToString;
+
+var arrayIndexOf = arrayProto.indexOf;
+var arrayEvery = arrayProto.every;
+var join = arrayProto.join;
+var map = arrayProto.map;
+var some = arrayProto.some;
+
+var hasOwnProperty = objectProto.hasOwnProperty;
+var isPrototypeOf = objectProto.isPrototypeOf;
+var objectToString = objectProto.toString;
+
+var stringIndexOf = stringProto.indexOf;
+
+var matcher = {
+ toString: function() {
+ return this.message;
+ }
+};
+
+function isMatcher(object) {
+ return isPrototypeOf(matcher, object);
+}
+
+function assertType(value, type, name) {
+ var actual = typeOf(value);
+ if (actual !== type) {
+ throw new TypeError(
+ "Expected type of " +
+ name +
+ " to be " +
+ type +
+ ", but was " +
+ actual
+ );
+ }
+}
+
+function assertMethodExists(value, method, name, methodPath) {
+ if (value[method] == null) {
+ throw new TypeError(
+ "Expected " + name + " to have method " + methodPath
+ );
+ }
+}
+
+function assertMatcher(value) {
+ if (!isMatcher(value)) {
+ throw new TypeError("Matcher expected");
+ }
+}
+
+function isIterable(value) {
+ return !!value && typeOf(value.forEach) === "function";
+}
+
+function matchObject(actual, expectation) {
+ if (actual === null || actual === undefined) {
+ return false;
+ }
+
+ return arrayEvery(Object.keys(expectation), function(key) {
+ var exp = expectation[key];
+ var act = actual[key];
+
+ if (isMatcher(exp)) {
+ if (!exp.test(act)) {
+ return false;
+ }
+ } else if (typeOf(exp) === "object") {
+ if (!matchObject(act, exp)) {
+ return false;
+ }
+ } else if (!deepEqual(act, exp)) {
+ return false;
+ }
+
+ return true;
+ });
+}
+
+var TYPE_MAP = {
+ function: function(m, expectation, message) {
+ m.test = expectation;
+ m.message = message || "match(" + functionName(expectation) + ")";
+ },
+ number: function(m, expectation) {
+ m.test = function(actual) {
+ // we need type coercion here
+ return expectation == actual; // eslint-disable-line eqeqeq
+ };
+ },
+ object: function(m, expectation) {
+ var array = [];
+
+ if (typeof expectation.test === "function") {
+ m.test = function(actual) {
+ return expectation.test(actual) === true;
+ };
+ m.message = "match(" + functionName(expectation.test) + ")";
+ return m;
+ }
+
+ array = map(Object.keys(expectation), function(key) {
+ return key + ": " + valueToString(expectation[key]);
+ });
+
+ m.test = function(actual) {
+ return matchObject(actual, expectation);
+ };
+ m.message = "match(" + join(array, ", ") + ")";
+
+ return m;
+ },
+ regexp: function(m, expectation) {
+ m.test = function(actual) {
+ return typeof actual === "string" && expectation.test(actual);
+ };
+ },
+ string: function(m, expectation) {
+ m.test = function(actual) {
+ return (
+ typeof actual === "string" &&
+ stringIndexOf(actual, expectation) !== -1
+ );
+ };
+ m.message = 'match("' + expectation + '")';
+ }
+};
+
+function match(expectation, message) {
+ var m = Object.create(matcher);
+ var type = typeOf(expectation);
+
+ if (message !== undefined && typeof message !== "string") {
+ throw new TypeError("Message should be a string");
+ }
+
+ if (arguments.length > 2) {
+ throw new TypeError(
+ "Expected 1 or 2 arguments, received " + arguments.length
+ );
+ }
+
+ if (type in TYPE_MAP) {
+ TYPE_MAP[type](m, expectation, message);
+ } else {
+ m.test = function(actual) {
+ return deepEqual(actual, expectation);
+ };
+ }
+
+ if (!m.message) {
+ m.message = "match(" + valueToString(expectation) + ")";
+ }
+
+ return m;
+}
+
+matcher.or = function(m2) {
+ if (!arguments.length) {
+ throw new TypeError("Matcher expected");
+ } else if (!isMatcher(m2)) {
+ m2 = match(m2);
+ }
+ var m1 = this;
+ var or = Object.create(matcher);
+ or.test = function(actual) {
+ return m1.test(actual) || m2.test(actual);
+ };
+ or.message = m1.message + ".or(" + m2.message + ")";
+ return or;
+};
+
+matcher.and = function(m2) {
+ if (!arguments.length) {
+ throw new TypeError("Matcher expected");
+ } else if (!isMatcher(m2)) {
+ m2 = match(m2);
+ }
+ var m1 = this;
+ var and = Object.create(matcher);
+ and.test = function(actual) {
+ return m1.test(actual) && m2.test(actual);
+ };
+ and.message = m1.message + ".and(" + m2.message + ")";
+ return and;
+};
+
+match.isMatcher = isMatcher;
+
+match.any = match(function() {
+ return true;
+}, "any");
+
+match.defined = match(function(actual) {
+ return actual !== null && actual !== undefined;
+}, "defined");
+
+match.truthy = match(function(actual) {
+ return !!actual;
+}, "truthy");
+
+match.falsy = match(function(actual) {
+ return !actual;
+}, "falsy");
+
+match.same = function(expectation) {
+ return match(function(actual) {
+ return expectation === actual;
+ }, "same(" + valueToString(expectation) + ")");
+};
+
+match.in = function(arrayOfExpectations) {
+ if (typeOf(arrayOfExpectations) !== "array") {
+ throw new TypeError("array expected");
+ }
+
+ return match(function(actual) {
+ return some(arrayOfExpectations, function(expectation) {
+ return expectation === actual;
+ });
+ }, "in(" + valueToString(arrayOfExpectations) + ")");
+};
+
+match.typeOf = function(type) {
+ assertType(type, "string", "type");
+ return match(function(actual) {
+ return typeOf(actual) === type;
+ }, 'typeOf("' + type + '")');
+};
+
+match.instanceOf = function(type) {
+ if (
+ typeof Symbol === "undefined" ||
+ typeof Symbol.hasInstance === "undefined"
+ ) {
+ assertType(type, "function", "type");
+ } else {
+ assertMethodExists(
+ type,
+ Symbol.hasInstance,
+ "type",
+ "[Symbol.hasInstance]"
+ );
+ }
+ return match(function(actual) {
+ return actual instanceof type;
+ }, "instanceOf(" + (functionName(type) || objectToString(type)) + ")");
+};
+
+function createPropertyMatcher(propertyTest, messagePrefix) {
+ return function(property, value) {
+ assertType(property, "string", "property");
+ var onlyProperty = arguments.length === 1;
+ var message = messagePrefix + '("' + property + '"';
+ if (!onlyProperty) {
+ message += ", " + valueToString(value);
+ }
+ message += ")";
+ return match(function(actual) {
+ if (
+ actual === undefined ||
+ actual === null ||
+ !propertyTest(actual, property)
+ ) {
+ return false;
+ }
+ return onlyProperty || deepEqual(actual[property], value);
+ }, message);
+ };
+}
+
+match.has = createPropertyMatcher(function(actual, property) {
+ if (typeof actual === "object") {
+ return property in actual;
+ }
+ return actual[property] !== undefined;
+}, "has");
+
+match.hasOwn = createPropertyMatcher(function(actual, property) {
+ return hasOwnProperty(actual, property);
+}, "hasOwn");
+
+match.hasNested = function(property, value) {
+ assertType(property, "string", "property");
+ var onlyProperty = arguments.length === 1;
+ var message = 'hasNested("' + property + '"';
+ if (!onlyProperty) {
+ message += ", " + valueToString(value);
+ }
+ message += ")";
+ return match(function(actual) {
+ if (
+ actual === undefined ||
+ actual === null ||
+ get(actual, property) === undefined
+ ) {
+ return false;
+ }
+ return onlyProperty || deepEqual(get(actual, property), value);
+ }, message);
+};
+
+match.every = function(predicate) {
+ assertMatcher(predicate);
+
+ return match(function(actual) {
+ if (typeOf(actual) === "object") {
+ return every(Object.keys(actual), function(key) {
+ return predicate.test(actual[key]);
+ });
+ }
+
+ return (
+ isIterable(actual) &&
+ every(actual, function(element) {
+ return predicate.test(element);
+ })
+ );
+ }, "every(" + predicate.message + ")");
+};
+
+match.some = function(predicate) {
+ assertMatcher(predicate);
+
+ return match(function(actual) {
+ if (typeOf(actual) === "object") {
+ return !every(Object.keys(actual), function(key) {
+ return !predicate.test(actual[key]);
+ });
+ }
+
+ return (
+ isIterable(actual) &&
+ !every(actual, function(element) {
+ return !predicate.test(element);
+ })
+ );
+ }, "some(" + predicate.message + ")");
+};
+
+match.array = match.typeOf("array");
+
+match.array.deepEquals = function(expectation) {
+ return match(function(actual) {
+ // Comparing lengths is the fastest way to spot a difference before iterating through every item
+ var sameLength = actual.length === expectation.length;
+ return (
+ typeOf(actual) === "array" &&
+ sameLength &&
+ every(actual, function(element, index) {
+ var expected = expectation[index];
+ return typeOf(expected) === "array" &&
+ typeOf(element) === "array"
+ ? match.array.deepEquals(expected).test(element)
+ : deepEqual(expected, element);
+ })
+ );
+ }, "deepEquals([" + iterableToString(expectation) + "])");
+};
+
+match.array.startsWith = function(expectation) {
+ return match(function(actual) {
+ return (
+ typeOf(actual) === "array" &&
+ every(expectation, function(expectedElement, index) {
+ return actual[index] === expectedElement;
+ })
+ );
+ }, "startsWith([" + iterableToString(expectation) + "])");
+};
+
+match.array.endsWith = function(expectation) {
+ return match(function(actual) {
+ // This indicates the index in which we should start matching
+ var offset = actual.length - expectation.length;
+
+ return (
+ typeOf(actual) === "array" &&
+ every(expectation, function(expectedElement, index) {
+ return actual[offset + index] === expectedElement;
+ })
+ );
+ }, "endsWith([" + iterableToString(expectation) + "])");
+};
+
+match.array.contains = function(expectation) {
+ return match(function(actual) {
+ return (
+ typeOf(actual) === "array" &&
+ every(expectation, function(expectedElement) {
+ return arrayIndexOf(actual, expectedElement) !== -1;
+ })
+ );
+ }, "contains([" + iterableToString(expectation) + "])");
+};
+
+match.map = match.typeOf("map");
+
+match.map.deepEquals = function mapDeepEquals(expectation) {
+ return match(function(actual) {
+ // Comparing lengths is the fastest way to spot a difference before iterating through every item
+ var sameLength = actual.size === expectation.size;
+ return (
+ typeOf(actual) === "map" &&
+ sameLength &&
+ every(actual, function(element, key) {
+ return expectation.has(key) && expectation.get(key) === element;
+ })
+ );
+ }, "deepEquals(Map[" + iterableToString(expectation) + "])");
+};
+
+match.map.contains = function mapContains(expectation) {
+ return match(function(actual) {
+ return (
+ typeOf(actual) === "map" &&
+ every(expectation, function(element, key) {
+ return actual.has(key) && actual.get(key) === element;
+ })
+ );
+ }, "contains(Map[" + iterableToString(expectation) + "])");
+};
+
+match.set = match.typeOf("set");
+
+match.set.deepEquals = function setDeepEquals(expectation) {
+ return match(function(actual) {
+ // Comparing lengths is the fastest way to spot a difference before iterating through every item
+ var sameLength = actual.size === expectation.size;
+ return (
+ typeOf(actual) === "set" &&
+ sameLength &&
+ every(actual, function(element) {
+ return expectation.has(element);
+ })
+ );
+ }, "deepEquals(Set[" + iterableToString(expectation) + "])");
+};
+
+match.set.contains = function setContains(expectation) {
+ return match(function(actual) {
+ return (
+ typeOf(actual) === "set" &&
+ every(expectation, function(element) {
+ return actual.has(element);
+ })
+ );
+ }, "contains(Set[" + iterableToString(expectation) + "])");
+};
+
+match.bool = match.typeOf("boolean");
+match.number = match.typeOf("number");
+match.string = match.typeOf("string");
+match.object = match.typeOf("object");
+match.func = match.typeOf("function");
+match.regexp = match.typeOf("regexp");
+match.date = match.typeOf("date");
+match.symbol = match.typeOf("symbol");
+
+module.exports = match;
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/samsam.js b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/samsam.js
new file mode 100644
index 0000000..6f4fa14
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/lib/samsam.js
@@ -0,0 +1,21 @@
+"use strict";
+
+var identical = require("./identical");
+var isArguments = require("./is-arguments");
+var isElement = require("./is-element");
+var isNegZero = require("./is-neg-zero");
+var isSet = require("./is-set");
+var match = require("./match");
+var deepEqualCyclic = require("./deep-equal").use(match);
+var createMatcher = require("./matcher");
+
+module.exports = {
+ createMatcher: createMatcher,
+ deepEqual: deepEqualCyclic,
+ identical: identical,
+ isArguments: isArguments,
+ isElement: isElement,
+ isNegZero: isNegZero,
+ isSet: isSet,
+ match: match
+};
diff --git a/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/package.json b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/package.json
new file mode 100644
index 0000000..225f7d9
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/node_modules/@sinonjs/samsam/package.json
@@ -0,0 +1,93 @@
+{
+ "_from": "@sinonjs/samsam@^3.1.0",
+ "_id": "@sinonjs/samsam@3.3.3",
+ "_inBundle": false,
+ "_integrity": "sha512-bKCMKZvWIjYD0BLGnNrxVuw4dkWCYsLqFOUWw8VgKF/+5Y+mE7LfHWPIYoDXowH+3a9LsWDMo0uAP8YDosPvHQ==",
+ "_location": "/@sinonjs/formatio/@sinonjs/samsam",
+ "_phantomChildren": {},
+ "_requested": {
+ "type": "range",
+ "registry": true,
+ "raw": "@sinonjs/samsam@^3.1.0",
+ "name": "@sinonjs/samsam",
+ "escapedName": "@sinonjs%2fsamsam",
+ "scope": "@sinonjs",
+ "rawSpec": "^3.1.0",
+ "saveSpec": null,
+ "fetchSpec": "^3.1.0"
+ },
+ "_requiredBy": [
+ "/@sinonjs/formatio"
+ ],
+ "_resolved": "https://registry.npmjs.org/@sinonjs/samsam/-/samsam-3.3.3.tgz",
+ "_shasum": "46682efd9967b259b81136b9f120fd54585feb4a",
+ "_spec": "@sinonjs/samsam@^3.1.0",
+ "_where": "/Users/ayman/Documents/GitHub/javascript-challenges/node_modules/@sinonjs/formatio",
+ "author": {
+ "name": "Christian Johansen"
+ },
+ "bugs": {
+ "url": "https://github.com/sinonjs/samsam/issues"
+ },
+ "bundleDependencies": false,
+ "dependencies": {
+ "@sinonjs/commons": "^1.3.0",
+ "array-from": "^2.1.1",
+ "lodash": "^4.17.15"
+ },
+ "deprecated": false,
+ "description": "Value identification and comparison functions",
+ "devDependencies": {
+ "@sinonjs/referee": "^2.0.0",
+ "benchmark": "2.1.4",
+ "eslint": "^4.19.1",
+ "eslint-config-prettier": "2.9.0",
+ "eslint-config-sinon": "^1.0.3",
+ "eslint-plugin-ie11": "^1.0.0",
+ "eslint-plugin-mocha": "^4.11.0",
+ "eslint-plugin-prettier": "2.6.2",
+ "husky": "^0.14.3",
+ "jsdom": "^13.0.0",
+ "jsdom-global": "^3.0.2",
+ "lint-staged": "^6.1.0",
+ "microtime": "2.1.8",
+ "mkdirp": "^0.5.1",
+ "mocha": "^6.2.0",
+ "mochify": "^6.4.1",
+ "npm-run-all": "^4.1.2",
+ "nyc": "^14.1.1",
+ "prettier": "1.13.7",
+ "rollup": "^0.57.1",
+ "rollup-plugin-commonjs": "^9.1.0"
+ },
+ "files": [
+ "dist/",
+ "docs/",
+ "lib/",
+ "!lib/**/*.test.js"
+ ],
+ "homepage": "http://sinonjs.github.io/samsam/",
+ "license": "BSD-3-Clause",
+ "lint-staged": {
+ "*.js": "eslint"
+ },
+ "main": "./lib/samsam",
+ "name": "@sinonjs/samsam",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/sinonjs/samsam.git"
+ },
+ "scripts": {
+ "benchmark": "node lib/deep-equal-benchmark.js",
+ "build": "run-s build:dist-folder build:bundle",
+ "build:bundle": "rollup -c > dist/samsam.js",
+ "build:dist-folder": "mkdirp dist",
+ "lint": "eslint .",
+ "prepublishOnly": "npm run build && mkdocs gh-deploy -r upstream || mkdocs gh-deploy -r origin",
+ "test": "mocha ./lib/*.test.js",
+ "test-cloud": "npm run test-headless -- --wd",
+ "test-coverage": "nyc --reporter text --reporter html --reporter lcovonly npm run test",
+ "test-headless": "mochify lib/*.test.js"
+ },
+ "version": "3.3.3"
+}
diff --git a/node_modules/@sinonjs/formatio/package.json b/node_modules/@sinonjs/formatio/package.json
new file mode 100644
index 0000000..d1b6484
--- /dev/null
+++ b/node_modules/@sinonjs/formatio/package.json
@@ -0,0 +1,76 @@
+{
+ "_from": "@sinonjs/formatio@^3.0.0",
+ "_id": "@sinonjs/formatio@3.2.2",
+ "_inBundle": false,
+ "_integrity": "sha512-B8SEsgd8gArBLMD6zpRw3juQ2FVSsmdd7qlevyDqzS9WTCtvF55/gAL+h6gue8ZvPYcdiPdvueM/qm//9XzyTQ==",
+ "_location": "/@sinonjs/formatio",
+ "_phantomChildren": {
+ "@sinonjs/commons": "1.8.1",
+ "array-from": "2.1.1",
+ "lodash": "4.17.20"
+ },
+ "_requested": {
+ "type": "range",
+ "registry": true,
+ "raw": "@sinonjs/formatio@^3.0.0",
+ "name": "@sinonjs/formatio",
+ "escapedName": "@sinonjs%2fformatio",
+ "scope": "@sinonjs",
+ "rawSpec": "^3.0.0",
+ "saveSpec": null,
+ "fetchSpec": "^3.0.0"
+ },
+ "_requiredBy": [
+ "/nise",
+ "/sinon"
+ ],
+ "_resolved": "https://registry.npmjs.org/@sinonjs/formatio/-/formatio-3.2.2.tgz",
+ "_shasum": "771c60dfa75ea7f2d68e3b94c7e888a78781372c",
+ "_spec": "@sinonjs/formatio@^3.0.0",
+ "_where": "/Users/ayman/Documents/GitHub/javascript-challenges/node_modules/sinon",
+ "author": {
+ "name": "Christian Johansen"
+ },
+ "bugs": {
+ "url": "https://github.com/sinonjs/formatio/issues"
+ },
+ "bundleDependencies": false,
+ "dependencies": {
+ "@sinonjs/commons": "^1",
+ "@sinonjs/samsam": "^3.1.0"
+ },
+ "deprecated": false,
+ "description": "Human-readable object formatting",
+ "devDependencies": {
+ "@sinonjs/referee": "^3.2.0",
+ "eslint": "^4.19.1",
+ "eslint-config-sinon": "^1.0.3",
+ "eslint-plugin-ie11": "^1.0.0",
+ "eslint-plugin-mocha": "^6.1.1",
+ "mocha": "^6.2.1",
+ "nyc": "^14.1.1",
+ "rollup": "0.65.2",
+ "rollup-plugin-commonjs": "9.1.6"
+ },
+ "files": [
+ "lib/**/*[^test].js"
+ ],
+ "homepage": "https://sinonjs.github.io/formatio/",
+ "license": "BSD-3-Clause",
+ "main": "./lib/formatio",
+ "name": "@sinonjs/formatio",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/sinonjs/formatio.git"
+ },
+ "scripts": {
+ "build": "npm run build:dist-folder && npm run build:bundle",
+ "build:bundle": "rollup -c > dist/formatio.js",
+ "build:dist-folder": "mkdirp dist",
+ "lint": "eslint .",
+ "prepublishOnly": "npm run build && mkdocs gh-deploy -r upstream || mkdocs gh-deploy -r origin",
+ "test": "mocha 'lib/**/*.test.js'",
+ "test-coverage": "nyc --reporter text --reporter html --reporter lcovonly npm run test"
+ },
+ "version": "3.2.2"
+}
diff --git a/node_modules/@sinonjs/samsam/LICENSE b/node_modules/@sinonjs/samsam/LICENSE
new file mode 100644
index 0000000..f00310b
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/LICENSE
@@ -0,0 +1,27 @@
+(The BSD License)
+
+Copyright (c) 2010-2012, Christian Johansen, christian@cjohansen.no and
+August Lilleaas, august.lilleaas@gmail.com. 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 Christian Johansen nor the names of his 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 HOLDER 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.
diff --git a/node_modules/@sinonjs/samsam/README.md b/node_modules/@sinonjs/samsam/README.md
new file mode 100644
index 0000000..99a2943
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/README.md
@@ -0,0 +1,83 @@
+# samsam
+
+[](http://travis-ci.org/sinonjs/samsam)
+[](https://coveralls.io/github/sinonjs/samsam?branch=master)
+
+Value identification and comparison functions
+
+Documentation: http://sinonjs.github.io/samsam/
+
+## Backers
+
+Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/sinon#backer)]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## Sponsors
+
+Become a sponsor and get your logo on our README on GitHub with a link to your site. [[Become a sponsor](https://opencollective.com/sinon#sponsor)]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## Licence
+
+samsam was released under [BSD-3](LICENSE)
diff --git a/node_modules/@sinonjs/samsam/dist/samsam.js b/node_modules/@sinonjs/samsam/dist/samsam.js
new file mode 100644
index 0000000..4b065b8
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/dist/samsam.js
@@ -0,0 +1,512 @@
+(function (global, factory) {
+ typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+ typeof define === 'function' && define.amd ? define(['exports'], factory) :
+ (factory((global.samsam = {})));
+}(this, (function (exports) { 'use strict';
+
+ var o = Object.prototype;
+
+ function getClass(value) {
+ // Returns the internal [[Class]] by calling Object.prototype.toString
+ // with the provided value as this. Return value is a string, naming the
+ // internal class, e.g. "Array"
+ return o.toString.call(value).split(/[ \]]/)[1];
+ }
+
+ var getClass_1 = getClass;
+
+ function isNaN(value) {
+ // Unlike global isNaN, this avoids type coercion
+ // typeof check avoids IE host object issues, hat tip to
+ // lodash
+ var val = value; // JsLint thinks value !== value is "weird"
+ return typeof value === "number" && value !== val;
+ }
+
+ var isNan = isNaN;
+
+ /**
+ * @name samsam.isNegZero
+ * @param Object value
+ *
+ * Returns ``true`` if ``value`` is ``-0``.
+ */
+ function isNegZero(value) {
+ return value === 0 && 1 / value === -Infinity;
+ }
+
+ var isNegZero_1 = isNegZero;
+
+ /**
+ * @name samsam.equal
+ * @param Object obj1
+ * @param Object obj2
+ *
+ * Returns ``true`` if two objects are strictly equal. Compared to
+ * ``===`` there are two exceptions:
+ *
+ * - NaN is considered equal to NaN
+ * - -0 and +0 are not considered equal
+ */
+ function identical(obj1, obj2) {
+ if (obj1 === obj2 || (isNan(obj1) && isNan(obj2))) {
+ return obj1 !== 0 || isNegZero_1(obj1) === isNegZero_1(obj2);
+ }
+
+ return false;
+ }
+
+ var identical_1 = identical;
+
+ /**
+ * @name samsam.isArguments
+ * @param Object object
+ *
+ * Returns ``true`` if ``object`` is an ``arguments`` object,
+ * ``false`` otherwise.
+ */
+ function isArguments(object) {
+ if (getClass_1(object) === "Arguments") {
+ return true;
+ }
+ if (
+ typeof object !== "object" ||
+ typeof object.length !== "number" ||
+ getClass_1(object) === "Array"
+ ) {
+ return false;
+ }
+ if (typeof object.callee === "function") {
+ return true;
+ }
+ try {
+ object[object.length] = 6;
+ delete object[object.length];
+ } catch (e) {
+ return true;
+ }
+ return false;
+ }
+
+ var isArguments_1 = isArguments;
+
+ function isDate(value) {
+ return value instanceof Date;
+ }
+
+ var isDate_1 = isDate;
+
+ var div = typeof document !== "undefined" && document.createElement("div");
+
+ /**
+ * @name samsam.isElement
+ * @param Object object
+ *
+ * Returns ``true`` if ``object`` is a DOM element node. Unlike
+ * Underscore.js/lodash, this function will return ``false`` if ``object``
+ * is an *element-like* object, i.e. a regular object with a ``nodeType``
+ * property that holds the value ``1``.
+ */
+ function isElement(object) {
+ if (!object || object.nodeType !== 1 || !div) {
+ return false;
+ }
+ try {
+ object.appendChild(div);
+ object.removeChild(div);
+ } catch (e) {
+ return false;
+ }
+ return true;
+ }
+
+ var isElement_1 = isElement;
+
+ // Returns true when the value is a regular Object and not a specialized Object
+ //
+ // This helps speeding up deepEqual cyclic checks
+ // The premise is that only Objects are stored in the visited array.
+ // So if this function returns false, we don't have to do the
+ // expensive operation of searching for the value in the the array of already
+ // visited objects
+ function isObject(value) {
+ return (
+ typeof value === "object" &&
+ value !== null &&
+ // none of these are collection objects, so we can return false
+ !(value instanceof Boolean) &&
+ !(value instanceof Date) &&
+ !(value instanceof Error) &&
+ !(value instanceof Number) &&
+ !(value instanceof RegExp) &&
+ !(value instanceof String)
+ );
+ }
+
+ var isObject_1 = isObject;
+
+ function isSet(val) {
+ return (typeof Set !== "undefined" && val instanceof Set) || false;
+ }
+
+ var isSet_1 = isSet;
+
+ function isSubset(s1, s2, compare) {
+ var allContained = true;
+ s1.forEach(function(v1) {
+ var includes = false;
+ s2.forEach(function(v2) {
+ if (compare(v2, v1)) {
+ includes = true;
+ }
+ });
+ allContained = allContained && includes;
+ });
+
+ return allContained;
+ }
+
+ var isSubset_1 = isSubset;
+
+ var re = /function (\w+)\s*\(/;
+
+ function getClassName(value) {
+ if (value.constructor && "name" in value.constructor) {
+ return value.constructor.name;
+ }
+
+ if (typeof value.constructor === "function") {
+ var match = value.constructor.toString().match(re);
+ if (match.length > 1) {
+ return match[1];
+ }
+ }
+
+ return null;
+ }
+
+ var getClassName_1 = getClassName;
+
+ var every = Array.prototype.every;
+ var getTime = Date.prototype.getTime;
+ var hasOwnProperty = Object.prototype.hasOwnProperty;
+ var indexOf = Array.prototype.indexOf;
+ var keys = Object.keys;
+
+ /**
+ * @name samsam.deepEqual
+ * @param Object first
+ * @param Object second
+ *
+ * Deep equal comparison. Two values are "deep equal" if:
+ *
+ * - They are equal, according to samsam.identical
+ * - They are both date objects representing the same time
+ * - They are both arrays containing elements that are all deepEqual
+ * - They are objects with the same set of properties, and each property
+ * in ``first`` is deepEqual to the corresponding property in ``second``
+ *
+ * Supports cyclic objects.
+ */
+ function deepEqualCyclic(first, second) {
+ // used for cyclic comparison
+ // contain already visited objects
+ var objects1 = [];
+ var objects2 = [];
+ // contain pathes (position in the object structure)
+ // of the already visited objects
+ // indexes same as in objects arrays
+ var paths1 = [];
+ var paths2 = [];
+ // contains combinations of already compared objects
+ // in the manner: { "$1['ref']$2['ref']": true }
+ var compared = {};
+
+ // does the recursion for the deep equal check
+ return (function deepEqual(obj1, obj2, path1, path2) {
+ var type1 = typeof obj1;
+ var type2 = typeof obj2;
+
+ // == null also matches undefined
+ if (
+ obj1 === obj2 ||
+ isNan(obj1) ||
+ isNan(obj2) ||
+ obj1 == null ||
+ obj2 == null ||
+ type1 !== "object" ||
+ type2 !== "object"
+ ) {
+ return identical_1(obj1, obj2);
+ }
+
+ // Elements are only equal if identical(expected, actual)
+ if (isElement_1(obj1) || isElement_1(obj2)) {
+ return false;
+ }
+
+ var isDate1 = isDate_1(obj1);
+ var isDate2 = isDate_1(obj2);
+ if (isDate1 || isDate2) {
+ if (
+ !isDate1 ||
+ !isDate2 ||
+ getTime.call(obj1) !== getTime.call(obj2)
+ ) {
+ return false;
+ }
+ }
+
+ if (obj1 instanceof RegExp && obj2 instanceof RegExp) {
+ if (obj1.toString() !== obj2.toString()) {
+ return false;
+ }
+ }
+
+ if (obj1 instanceof Error && obj2 instanceof Error) {
+ if (
+ obj1.constructor !== obj2.constructor ||
+ obj1.message !== obj2.message ||
+ obj1.stack !== obj2.stack
+ ) {
+ return false;
+ }
+ }
+
+ var class1 = getClass_1(obj1);
+ var class2 = getClass_1(obj2);
+ var keys1 = keys(obj1);
+ var keys2 = keys(obj2);
+ var name1 = getClassName_1(obj1);
+ var name2 = getClassName_1(obj2);
+
+ if (isArguments_1(obj1) || isArguments_1(obj2)) {
+ if (obj1.length !== obj2.length) {
+ return false;
+ }
+ } else {
+ if (
+ type1 !== type2 ||
+ class1 !== class2 ||
+ keys1.length !== keys2.length ||
+ (name1 && name2 && name1 !== name2)
+ ) {
+ return false;
+ }
+ }
+
+ if (isSet_1(obj1) || isSet_1(obj2)) {
+ if (!isSet_1(obj1) || !isSet_1(obj2) || obj1.size !== obj2.size) {
+ return false;
+ }
+
+ return isSubset_1(obj1, obj2, deepEqual);
+ }
+
+ return every.call(keys1, function(key) {
+ if (!hasOwnProperty.call(obj2, key)) {
+ return false;
+ }
+
+ var value1 = obj1[key];
+ var value2 = obj2[key];
+ var isObject1 = isObject_1(value1);
+ var isObject2 = isObject_1(value2);
+ // determines, if the objects were already visited
+ // (it's faster to check for isObject first, than to
+ // get -1 from getIndex for non objects)
+ var index1 = isObject1 ? indexOf.call(objects1, value1) : -1;
+ var index2 = isObject2 ? indexOf.call(objects2, value2) : -1;
+ // determines the new paths of the objects
+ // - for non cyclic objects the current path will be extended
+ // by current property name
+ // - for cyclic objects the stored path is taken
+ var newPath1 =
+ index1 !== -1
+ ? paths1[index1]
+ : path1 + "[" + JSON.stringify(key) + "]";
+ var newPath2 =
+ index2 !== -1
+ ? paths2[index2]
+ : path2 + "[" + JSON.stringify(key) + "]";
+ var combinedPath = newPath1 + newPath2;
+
+ // stop recursion if current objects are already compared
+ if (compared[combinedPath]) {
+ return true;
+ }
+
+ // remember the current objects and their paths
+ if (index1 === -1 && isObject1) {
+ objects1.push(value1);
+ paths1.push(newPath1);
+ }
+ if (index2 === -1 && isObject2) {
+ objects2.push(value2);
+ paths2.push(newPath2);
+ }
+
+ // remember that the current objects are already compared
+ if (isObject1 && isObject2) {
+ compared[combinedPath] = true;
+ }
+
+ // End of cyclic logic
+
+ // neither value1 nor value2 is a cycle
+ // continue with next level
+ return deepEqual(value1, value2, newPath1, newPath2);
+ });
+ })(first, second, "$1", "$2");
+ }
+
+ var deepEqual = deepEqualCyclic;
+
+ function arrayContains(array, subset, compare) {
+ if (subset.length === 0) {
+ return true;
+ }
+ var i, l, j, k;
+ for (i = 0, l = array.length; i < l; ++i) {
+ if (compare(array[i], subset[0])) {
+ for (j = 0, k = subset.length; j < k; ++j) {
+ if (i + j >= l) {
+ return false;
+ }
+ if (!compare(array[i + j], subset[j])) {
+ return false;
+ }
+ }
+ return true;
+ }
+ }
+ return false;
+ }
+
+ /**
+ * @name samsam.match
+ * @param Object object
+ * @param Object matcher
+ *
+ * Compare arbitrary value ``object`` with matcher.
+ */
+ function match(object, matcher) {
+ if (matcher && typeof matcher.test === "function") {
+ return matcher.test(object);
+ }
+
+ if (typeof matcher === "function") {
+ return matcher(object) === true;
+ }
+
+ if (typeof matcher === "string") {
+ matcher = matcher.toLowerCase();
+ var notNull = typeof object === "string" || !!object;
+ return (
+ notNull &&
+ String(object)
+ .toLowerCase()
+ .indexOf(matcher) >= 0
+ );
+ }
+
+ if (typeof matcher === "number") {
+ return matcher === object;
+ }
+
+ if (typeof matcher === "boolean") {
+ return matcher === object;
+ }
+
+ if (typeof matcher === "undefined") {
+ return typeof object === "undefined";
+ }
+
+ if (matcher === null) {
+ return object === null;
+ }
+
+ if (object === null) {
+ return false;
+ }
+
+ if (isSet_1(object)) {
+ return isSubset_1(matcher, object, match);
+ }
+
+ if (getClass_1(object) === "Array" && getClass_1(matcher) === "Array") {
+ return arrayContains(object, matcher, match);
+ }
+
+ if (isDate_1(matcher)) {
+ return isDate_1(object) && object.getTime() === matcher.getTime();
+ }
+
+ if (matcher && typeof matcher === "object") {
+ if (matcher === object) {
+ return true;
+ }
+ if (typeof object !== "object") {
+ return false;
+ }
+ var prop;
+ // eslint-disable-next-line guard-for-in
+ for (prop in matcher) {
+ var value = object[prop];
+ if (
+ typeof value === "undefined" &&
+ typeof object.getAttribute === "function"
+ ) {
+ value = object.getAttribute(prop);
+ }
+ if (
+ matcher[prop] === null ||
+ typeof matcher[prop] === "undefined"
+ ) {
+ if (value !== matcher[prop]) {
+ return false;
+ }
+ } else if (
+ typeof value === "undefined" ||
+ !match(value, matcher[prop])
+ ) {
+ return false;
+ }
+ }
+ return true;
+ }
+
+ throw new Error(
+ "Matcher was not a string, a number, a " +
+ "function, a boolean or an object"
+ );
+ }
+
+ var match_1 = match;
+
+ var samsam = {
+ isArguments: isArguments_1,
+ isElement: isElement_1,
+ isNegZero: isNegZero_1,
+ identical: identical_1,
+ deepEqual: deepEqual,
+ match: match_1
+ };
+ var samsam_1 = samsam.isArguments;
+ var samsam_2 = samsam.isElement;
+ var samsam_3 = samsam.isNegZero;
+ var samsam_4 = samsam.identical;
+ var samsam_5 = samsam.deepEqual;
+ var samsam_6 = samsam.match;
+
+ exports.default = samsam;
+ exports.isArguments = samsam_1;
+ exports.isElement = samsam_2;
+ exports.isNegZero = samsam_3;
+ exports.identical = samsam_4;
+ exports.deepEqual = samsam_5;
+ exports.match = samsam_6;
+
+ Object.defineProperty(exports, '__esModule', { value: true });
+
+})));
diff --git a/node_modules/@sinonjs/samsam/docs/index.md b/node_modules/@sinonjs/samsam/docs/index.md
new file mode 100644
index 0000000..eff7aca
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/docs/index.md
@@ -0,0 +1,197 @@
+# samsam
+
+> Same same, but different
+
+`samsam` is a collection of predicate and comparison functions useful for
+identifiying the type of values and to compare values with varying degrees of
+strictness.
+
+`samsam` is a general-purpose library with no dependencies. It works in browsers
+(including old and rowdy ones, like IE6) and Node. It will define itself as an
+AMD module if you want it to (i.e. if there's a `define` function available).
+
+## Predicate functions
+
+
+### `isArguments(object)`
+
+Returns `true` if `object` is an `arguments` object, `false` otherwise.
+
+
+### `isNegZero(value)`
+
+Returns `true` if `value` is `-0`.
+
+
+### `isElement(object)`
+
+Returns `true` if `object` is a DOM element node. Unlike
+Underscore.js/lodash, this function will return `false` if `object` is an
+*element-like* object, i.e. a regular object with a `nodeType` property that
+holds the value `1`.
+
+
+## Comparison functions
+
+
+### `identical(x, y)`
+
+Strict equality check according to EcmaScript Harmony's `egal`.
+
+**From the Harmony wiki:**
+
+> An egal function simply makes available the internal `SameValue` function
+from section 9.12 of the ES5 spec. If two values are egal, then they are not
+observably distinguishable.
+
+`identical` returns `true` when `===` is `true`, except for `-0` and
+`+0`, where it returns `false`. Additionally, it returns `true` when
+`NaN` is compared to itself.
+
+
+### `deepEqual(obj1, obj2)`
+
+Deep equal comparison. Two values are "deep equal" if:
+
+* They are identical
+* They are both date objects representing the same time
+* They are both arrays containing elements that are all deepEqual
+* They are objects with the same set of properties, and each property
+ in `obj1` is deepEqual to the corresponding property in `obj2`
+
+
+### `match(object, matcher)`
+
+Partial equality check. Compares `object` with matcher according a wide set of
+rules:
+
+#### String matcher
+
+In its simplest form, `match` performs a case insensitive substring match.
+When the matcher is a string, `object` is converted to a string, and the
+function returns `true` if the matcher is a case-insensitive substring of
+`object` as a string.
+
+```javascript
+samsam.match("Give me something", "Give"); //true
+samsam.match("Give me something", "sumptn"); // false
+samsam.match({ toString: function () { return "yeah"; } }, "Yeah!"); // true
+```
+
+The last example is not symmetric. When the matcher is a string, the `object`
+is coerced to a string - in this case using `toString`. Changing the order of
+the arguments would cause the matcher to be an object, in which case different
+rules apply (see below).
+
+
+#### Boolean matcher
+
+Performs a strict (i.e. `===`) match with the object. So, only `true`
+matches `true`, and only `false` matches `false`.
+
+
+#### Regular expression matcher
+
+When the matcher is a regular expression, the function will pass if
+`object.test(matcher)` is `true`. `match` is written in a generic way, so
+any object with a `test` method will be used as a matcher this way.
+
+```javascript
+samsam.match("Give me something", /^[a-z\s]$/i); // true
+samsam.match("Give me something", /[0-9]/); // false
+samsam.match({ toString: function () { return "yeah!"; } }, /yeah/); // true
+samsam.match(234, /[a-z]/); // false
+```
+
+
+#### Number matcher
+
+When the matcher is a number, the assertion will pass if `object == matcher`.
+
+```javascript
+samsam.match("123", 123); // true
+samsam.match("Give me something", 425); // false
+samsam.match({ toString: function () { return "42"; } }, 42); // true
+samsam.match(234, 1234); // false
+```
+
+
+#### Function matcher
+
+When the matcher is a function, it is called with `object` as its only
+argument. `match` returns `true` if the function returns `true`. A strict
+match is performed against the return value, so a boolean `true` is required,
+truthy is not enough.
+
+```javascript
+// true
+samsam.match("123", function (exp) {
+ return exp == "123";
+});
+
+// false
+samsam.match("Give me something", function () {
+ return "ok";
+});
+
+// true
+samsam.match({
+ toString: function () {
+ return "42";
+ }
+}, function () { return true; });
+
+// false
+samsam.match(234, function () {});
+```
+
+
+#### Object matcher
+
+As mentioned above, if an object matcher defines a `test` method, `match`
+will return `true` if `matcher.test(object)` returns truthy.
+
+If the matcher does not have a test method, a recursive match is performed. If
+all properties of `matcher` matches corresponding properties in `object`,
+`match` returns `true`. Note that the object matcher does not care if the
+number of properties in the two objects are the same - only if all properties in
+the matcher recursively matches ones in `object`.
+
+```javascript
+// true
+samsam.match("123", {
+ test: function (arg) {
+ return arg == 123;
+ }
+});
+
+// false
+samsam.match({}, { prop: 42 });
+
+// true
+samsam.match({
+ name: "Chris",
+ profession: "Programmer"
+}, {
+ name: "Chris"
+});
+
+// false
+samsam.match(234, { name: "Chris" });
+```
+
+
+#### DOM elements
+
+`match` can be very helpful when comparing DOM elements, because it allows
+you to compare several properties with one call:
+
+```javascript
+var el = document.getElementById("myEl");
+
+samsam.match(el, {
+ tagName: "h2",
+ className: "item",
+ innerHTML: "Howdy"
+});
+```
diff --git a/node_modules/@sinonjs/samsam/lib/create-set.js b/node_modules/@sinonjs/samsam/lib/create-set.js
new file mode 100644
index 0000000..0a10845
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/create-set.js
@@ -0,0 +1,25 @@
+"use strict";
+
+// This helper makes it convenient to create Set instances from a
+// collection, an overcomes the shortcoming that IE11 doesn't support
+// collection arguments
+//
+// See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
+function createSet(array) {
+ if (arguments.length > 0 && !Array.isArray(array)) {
+ throw new TypeError(
+ "createSet can be called with either no arguments or an Array"
+ );
+ }
+
+ var items = Array.isArray(array) ? array : [];
+ var set = new Set();
+
+ items.forEach(function(item) {
+ set.add(item);
+ });
+
+ return set;
+}
+
+module.exports = createSet;
diff --git a/node_modules/@sinonjs/samsam/lib/deep-equal-benchmark.js b/node_modules/@sinonjs/samsam/lib/deep-equal-benchmark.js
new file mode 100644
index 0000000..6193bb0
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/deep-equal-benchmark.js
@@ -0,0 +1,74 @@
+"use strict";
+
+var Benchmark = require("benchmark");
+var deepEqual = require("./deep-equal");
+
+var suite = new Benchmark.Suite();
+var complex1 = {
+ "1e116061-59bf-433a-8ab0-017b67a51d26":
+ "a7fd22ab-e809-414f-ad55-9c97598395d8",
+ "3824e8b7-22f5-489c-9919-43b432e3af6b":
+ "548baefd-f43c-4dc9-9df5-f7c9c96223b0",
+ "123e5750-eb66-45e5-a770-310879203b33":
+ "89ff817d-65a2-4598-b190-21c128096e6a",
+ "1d66be95-8aaa-4167-9a47-e7ee19bb0735":
+ "64349492-56e8-4100-9552-a89fb4a9aef4",
+ "f5538565-dc92-4ee4-a762-1ba5fe0528f6": {
+ "53631f78-2f2a-448f-89c7-ed3585e8e6f0":
+ "2cce00ee-f5ee-43ef-878f-958597b23225",
+ "73e8298b-72fd-4969-afc1-d891b61e744f":
+ "4e57aa30-af51-4d78-887c-019755e5d117",
+ "85439907-5b0e-4a08-8cfa-902a68dc3cc0":
+ "9639add9-6897-4cf0-b3d3-2ebf9c214f01",
+ "d4ae9d87-bd6c-47e0-95a1-6f4eb4211549":
+ "41fd3dd2-43ce-47f2-b92e-462474d07a6f",
+ "f70345a2-0ea3-45a6-bafa-8c7a72379277": {
+ "1bce714b-cd0a-417d-9a0c-bf4b7d35c0c4":
+ "3b8b0dde-e2ed-4b34-ac8d-729ba3c9667e",
+ "13e05c60-97d1-43f0-a6ef-d5247f4dd11f":
+ "60f685a4-6558-4ade-9d4b-28281c3989db",
+ "925b2609-e7b7-42f5-82cf-2d995697cec5":
+ "79115261-8161-4a6c-9487-47847276a717",
+ "52d644ac-7b33-4b79-b5b3-5afe7fd4ec2c": [
+ "3c2ae716-92f1-4a3d-b98f-50ea49f51c45",
+ "de76b822-71b3-4b5a-a041-4140378b70e2",
+ "0302a405-1d58-44fa-a0c6-dd07bb0ca26e",
+ new Date(),
+ new Error(),
+ new RegExp(),
+ // eslint-disable-next-line no-undef
+ new Map(),
+ new Set(),
+ // eslint-disable-next-line no-undef, ie11/no-weak-collections
+ new WeakMap(),
+ // eslint-disable-next-line no-undef, ie11/no-weak-collections
+ new WeakSet()
+ ]
+ }
+ }
+};
+var complex2 = Object.create(complex1);
+
+var cyclic1 = {
+ "4a092cd1-225e-4739-8331-d6564aafb702":
+ "d0cebbe0-23fb-4cc4-8fa0-ef11ceedf12e"
+};
+cyclic1.cyclicRef = cyclic1;
+
+var cyclic2 = Object.create(cyclic1);
+
+// add tests
+suite
+ .add("complex objects", function() {
+ return deepEqual(complex1, complex2);
+ })
+ .add("cyclic references", function() {
+ return deepEqual(cyclic1, cyclic2);
+ })
+ // add listeners
+ .on("cycle", function(event) {
+ // eslint-disable-next-line no-console
+ console.log(String(event.target));
+ })
+ // run async
+ .run({ async: true });
diff --git a/node_modules/@sinonjs/samsam/lib/deep-equal.js b/node_modules/@sinonjs/samsam/lib/deep-equal.js
new file mode 100644
index 0000000..05ee8c6
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/deep-equal.js
@@ -0,0 +1,187 @@
+"use strict";
+
+var getClass = require("./get-class");
+var identical = require("./identical");
+var isArguments = require("./is-arguments");
+var isDate = require("./is-date");
+var isElement = require("./is-element");
+var isNaN = require("./is-nan");
+var isObject = require("./is-object");
+var isSet = require("./is-set");
+var isSubset = require("./is-subset");
+var getClassName = require("./get-class-name");
+
+var every = Array.prototype.every;
+var getTime = Date.prototype.getTime;
+var hasOwnProperty = Object.prototype.hasOwnProperty;
+var indexOf = Array.prototype.indexOf;
+var keys = Object.keys;
+
+/**
+ * @name samsam.deepEqual
+ * @param Object first
+ * @param Object second
+ *
+ * Deep equal comparison. Two values are "deep equal" if:
+ *
+ * - They are equal, according to samsam.identical
+ * - They are both date objects representing the same time
+ * - They are both arrays containing elements that are all deepEqual
+ * - They are objects with the same set of properties, and each property
+ * in ``first`` is deepEqual to the corresponding property in ``second``
+ *
+ * Supports cyclic objects.
+ */
+function deepEqualCyclic(first, second) {
+ // used for cyclic comparison
+ // contain already visited objects
+ var objects1 = [];
+ var objects2 = [];
+ // contain pathes (position in the object structure)
+ // of the already visited objects
+ // indexes same as in objects arrays
+ var paths1 = [];
+ var paths2 = [];
+ // contains combinations of already compared objects
+ // in the manner: { "$1['ref']$2['ref']": true }
+ var compared = {};
+
+ // does the recursion for the deep equal check
+ return (function deepEqual(obj1, obj2, path1, path2) {
+ var type1 = typeof obj1;
+ var type2 = typeof obj2;
+
+ // == null also matches undefined
+ if (
+ obj1 === obj2 ||
+ isNaN(obj1) ||
+ isNaN(obj2) ||
+ obj1 == null ||
+ obj2 == null ||
+ type1 !== "object" ||
+ type2 !== "object"
+ ) {
+ return identical(obj1, obj2);
+ }
+
+ // Elements are only equal if identical(expected, actual)
+ if (isElement(obj1) || isElement(obj2)) {
+ return false;
+ }
+
+ var isDate1 = isDate(obj1);
+ var isDate2 = isDate(obj2);
+ if (isDate1 || isDate2) {
+ if (
+ !isDate1 ||
+ !isDate2 ||
+ getTime.call(obj1) !== getTime.call(obj2)
+ ) {
+ return false;
+ }
+ }
+
+ if (obj1 instanceof RegExp && obj2 instanceof RegExp) {
+ if (obj1.toString() !== obj2.toString()) {
+ return false;
+ }
+ }
+
+ if (obj1 instanceof Error && obj2 instanceof Error) {
+ if (
+ obj1.constructor !== obj2.constructor ||
+ obj1.message !== obj2.message ||
+ obj1.stack !== obj2.stack
+ ) {
+ return false;
+ }
+ }
+
+ var class1 = getClass(obj1);
+ var class2 = getClass(obj2);
+ var keys1 = keys(obj1);
+ var keys2 = keys(obj2);
+ var name1 = getClassName(obj1);
+ var name2 = getClassName(obj2);
+
+ if (isArguments(obj1) || isArguments(obj2)) {
+ if (obj1.length !== obj2.length) {
+ return false;
+ }
+ } else {
+ if (
+ type1 !== type2 ||
+ class1 !== class2 ||
+ keys1.length !== keys2.length ||
+ (name1 && name2 && name1 !== name2)
+ ) {
+ return false;
+ }
+ }
+
+ if (isSet(obj1) || isSet(obj2)) {
+ if (!isSet(obj1) || !isSet(obj2) || obj1.size !== obj2.size) {
+ return false;
+ }
+
+ return isSubset(obj1, obj2, deepEqual);
+ }
+
+ return every.call(keys1, function(key) {
+ if (!hasOwnProperty.call(obj2, key)) {
+ return false;
+ }
+
+ var value1 = obj1[key];
+ var value2 = obj2[key];
+ var isObject1 = isObject(value1);
+ var isObject2 = isObject(value2);
+ // determines, if the objects were already visited
+ // (it's faster to check for isObject first, than to
+ // get -1 from getIndex for non objects)
+ var index1 = isObject1 ? indexOf.call(objects1, value1) : -1;
+ var index2 = isObject2 ? indexOf.call(objects2, value2) : -1;
+ // determines the new paths of the objects
+ // - for non cyclic objects the current path will be extended
+ // by current property name
+ // - for cyclic objects the stored path is taken
+ var newPath1 =
+ index1 !== -1
+ ? paths1[index1]
+ : path1 + "[" + JSON.stringify(key) + "]";
+ var newPath2 =
+ index2 !== -1
+ ? paths2[index2]
+ : path2 + "[" + JSON.stringify(key) + "]";
+ var combinedPath = newPath1 + newPath2;
+
+ // stop recursion if current objects are already compared
+ if (compared[combinedPath]) {
+ return true;
+ }
+
+ // remember the current objects and their paths
+ if (index1 === -1 && isObject1) {
+ objects1.push(value1);
+ paths1.push(newPath1);
+ }
+ if (index2 === -1 && isObject2) {
+ objects2.push(value2);
+ paths2.push(newPath2);
+ }
+
+ // remember that the current objects are already compared
+ if (isObject1 && isObject2) {
+ compared[combinedPath] = true;
+ }
+
+ // End of cyclic logic
+
+ // neither value1 nor value2 is a cycle
+ // continue with next level
+ return deepEqual(value1, value2, newPath1, newPath2);
+ });
+ })(first, second, "$1", "$2");
+}
+
+module.exports = deepEqualCyclic;
diff --git a/node_modules/@sinonjs/samsam/lib/get-class-name.js b/node_modules/@sinonjs/samsam/lib/get-class-name.js
new file mode 100644
index 0000000..5e94aa5
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/get-class-name.js
@@ -0,0 +1,20 @@
+"use strict";
+
+var re = /function (\w+)\s*\(/;
+
+function getClassName(value) {
+ if (value.constructor && "name" in value.constructor) {
+ return value.constructor.name;
+ }
+
+ if (typeof value.constructor === "function") {
+ var match = value.constructor.toString().match(re);
+ if (match.length > 1) {
+ return match[1];
+ }
+ }
+
+ return null;
+}
+
+module.exports = getClassName;
diff --git a/node_modules/@sinonjs/samsam/lib/get-class.js b/node_modules/@sinonjs/samsam/lib/get-class.js
new file mode 100644
index 0000000..d95e386
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/get-class.js
@@ -0,0 +1,12 @@
+"use strict";
+
+var o = Object.prototype;
+
+function getClass(value) {
+ // Returns the internal [[Class]] by calling Object.prototype.toString
+ // with the provided value as this. Return value is a string, naming the
+ // internal class, e.g. "Array"
+ return o.toString.call(value).split(/[ \]]/)[1];
+}
+
+module.exports = getClass;
diff --git a/node_modules/@sinonjs/samsam/lib/identical.js b/node_modules/@sinonjs/samsam/lib/identical.js
new file mode 100644
index 0000000..a673670
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/identical.js
@@ -0,0 +1,25 @@
+"use strict";
+
+var isNaN = require("./is-nan");
+var isNegZero = require("./is-neg-zero");
+
+/**
+ * @name samsam.equal
+ * @param Object obj1
+ * @param Object obj2
+ *
+ * Returns ``true`` if two objects are strictly equal. Compared to
+ * ``===`` there are two exceptions:
+ *
+ * - NaN is considered equal to NaN
+ * - -0 and +0 are not considered equal
+ */
+function identical(obj1, obj2) {
+ if (obj1 === obj2 || (isNaN(obj1) && isNaN(obj2))) {
+ return obj1 !== 0 || isNegZero(obj1) === isNegZero(obj2);
+ }
+
+ return false;
+}
+
+module.exports = identical;
diff --git a/node_modules/@sinonjs/samsam/lib/is-arguments.js b/node_modules/@sinonjs/samsam/lib/is-arguments.js
new file mode 100644
index 0000000..c24beec
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/is-arguments.js
@@ -0,0 +1,35 @@
+"use strict";
+
+var getClass = require("./get-class");
+
+/**
+ * @name samsam.isArguments
+ * @param Object object
+ *
+ * Returns ``true`` if ``object`` is an ``arguments`` object,
+ * ``false`` otherwise.
+ */
+function isArguments(object) {
+ if (getClass(object) === "Arguments") {
+ return true;
+ }
+ if (
+ typeof object !== "object" ||
+ typeof object.length !== "number" ||
+ getClass(object) === "Array"
+ ) {
+ return false;
+ }
+ if (typeof object.callee === "function") {
+ return true;
+ }
+ try {
+ object[object.length] = 6;
+ delete object[object.length];
+ } catch (e) {
+ return true;
+ }
+ return false;
+}
+
+module.exports = isArguments;
diff --git a/node_modules/@sinonjs/samsam/lib/is-date.js b/node_modules/@sinonjs/samsam/lib/is-date.js
new file mode 100644
index 0000000..23537a0
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/is-date.js
@@ -0,0 +1,7 @@
+"use strict";
+
+function isDate(value) {
+ return value instanceof Date;
+}
+
+module.exports = isDate;
diff --git a/node_modules/@sinonjs/samsam/lib/is-element.js b/node_modules/@sinonjs/samsam/lib/is-element.js
new file mode 100644
index 0000000..55feae9
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/is-element.js
@@ -0,0 +1,27 @@
+"use strict";
+
+var div = typeof document !== "undefined" && document.createElement("div");
+
+/**
+ * @name samsam.isElement
+ * @param Object object
+ *
+ * Returns ``true`` if ``object`` is a DOM element node. Unlike
+ * Underscore.js/lodash, this function will return ``false`` if ``object``
+ * is an *element-like* object, i.e. a regular object with a ``nodeType``
+ * property that holds the value ``1``.
+ */
+function isElement(object) {
+ if (!object || object.nodeType !== 1 || !div) {
+ return false;
+ }
+ try {
+ object.appendChild(div);
+ object.removeChild(div);
+ } catch (e) {
+ return false;
+ }
+ return true;
+}
+
+module.exports = isElement;
diff --git a/node_modules/@sinonjs/samsam/lib/is-nan.js b/node_modules/@sinonjs/samsam/lib/is-nan.js
new file mode 100644
index 0000000..9dd2355
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/is-nan.js
@@ -0,0 +1,11 @@
+"use strict";
+
+function isNaN(value) {
+ // Unlike global isNaN, this avoids type coercion
+ // typeof check avoids IE host object issues, hat tip to
+ // lodash
+ var val = value; // JsLint thinks value !== value is "weird"
+ return typeof value === "number" && value !== val;
+}
+
+module.exports = isNaN;
diff --git a/node_modules/@sinonjs/samsam/lib/is-neg-zero.js b/node_modules/@sinonjs/samsam/lib/is-neg-zero.js
new file mode 100644
index 0000000..ca10524
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/is-neg-zero.js
@@ -0,0 +1,13 @@
+"use strict";
+
+/**
+ * @name samsam.isNegZero
+ * @param Object value
+ *
+ * Returns ``true`` if ``value`` is ``-0``.
+ */
+function isNegZero(value) {
+ return value === 0 && 1 / value === -Infinity;
+}
+
+module.exports = isNegZero;
diff --git a/node_modules/@sinonjs/samsam/lib/is-object.js b/node_modules/@sinonjs/samsam/lib/is-object.js
new file mode 100644
index 0000000..01eea47
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/is-object.js
@@ -0,0 +1,24 @@
+"use strict";
+
+// Returns true when the value is a regular Object and not a specialized Object
+//
+// This helps speeding up deepEqual cyclic checks
+// The premise is that only Objects are stored in the visited array.
+// So if this function returns false, we don't have to do the
+// expensive operation of searching for the value in the the array of already
+// visited objects
+function isObject(value) {
+ return (
+ typeof value === "object" &&
+ value !== null &&
+ // none of these are collection objects, so we can return false
+ !(value instanceof Boolean) &&
+ !(value instanceof Date) &&
+ !(value instanceof Error) &&
+ !(value instanceof Number) &&
+ !(value instanceof RegExp) &&
+ !(value instanceof String)
+ );
+}
+
+module.exports = isObject;
diff --git a/node_modules/@sinonjs/samsam/lib/is-set.js b/node_modules/@sinonjs/samsam/lib/is-set.js
new file mode 100644
index 0000000..8607b26
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/is-set.js
@@ -0,0 +1,7 @@
+"use strict";
+
+function isSet(val) {
+ return (typeof Set !== "undefined" && val instanceof Set) || false;
+}
+
+module.exports = isSet;
diff --git a/node_modules/@sinonjs/samsam/lib/is-subset.js b/node_modules/@sinonjs/samsam/lib/is-subset.js
new file mode 100644
index 0000000..c894974
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/is-subset.js
@@ -0,0 +1,18 @@
+"use strict";
+
+function isSubset(s1, s2, compare) {
+ var allContained = true;
+ s1.forEach(function(v1) {
+ var includes = false;
+ s2.forEach(function(v2) {
+ if (compare(v2, v1)) {
+ includes = true;
+ }
+ });
+ allContained = allContained && includes;
+ });
+
+ return allContained;
+}
+
+module.exports = isSubset;
diff --git a/node_modules/@sinonjs/samsam/lib/match.js b/node_modules/@sinonjs/samsam/lib/match.js
new file mode 100644
index 0000000..0d96f38
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/match.js
@@ -0,0 +1,128 @@
+"use strict";
+
+var getClass = require("./get-class");
+var isDate = require("./is-date");
+var isSet = require("./is-set");
+var isSubset = require("./is-subset");
+
+function arrayContains(array, subset, compare) {
+ if (subset.length === 0) {
+ return true;
+ }
+ var i, l, j, k;
+ for (i = 0, l = array.length; i < l; ++i) {
+ if (compare(array[i], subset[0])) {
+ for (j = 0, k = subset.length; j < k; ++j) {
+ if (i + j >= l) {
+ return false;
+ }
+ if (!compare(array[i + j], subset[j])) {
+ return false;
+ }
+ }
+ return true;
+ }
+ }
+ return false;
+}
+
+/**
+ * @name samsam.match
+ * @param Object object
+ * @param Object matcher
+ *
+ * Compare arbitrary value ``object`` with matcher.
+ */
+function match(object, matcher) {
+ if (matcher && typeof matcher.test === "function") {
+ return matcher.test(object);
+ }
+
+ if (typeof matcher === "function") {
+ return matcher(object) === true;
+ }
+
+ if (typeof matcher === "string") {
+ matcher = matcher.toLowerCase();
+ var notNull = typeof object === "string" || !!object;
+ return (
+ notNull &&
+ String(object)
+ .toLowerCase()
+ .indexOf(matcher) >= 0
+ );
+ }
+
+ if (typeof matcher === "number") {
+ return matcher === object;
+ }
+
+ if (typeof matcher === "boolean") {
+ return matcher === object;
+ }
+
+ if (typeof matcher === "undefined") {
+ return typeof object === "undefined";
+ }
+
+ if (matcher === null) {
+ return object === null;
+ }
+
+ if (object === null) {
+ return false;
+ }
+
+ if (isSet(object)) {
+ return isSubset(matcher, object, match);
+ }
+
+ if (getClass(object) === "Array" && getClass(matcher) === "Array") {
+ return arrayContains(object, matcher, match);
+ }
+
+ if (isDate(matcher)) {
+ return isDate(object) && object.getTime() === matcher.getTime();
+ }
+
+ if (matcher && typeof matcher === "object") {
+ if (matcher === object) {
+ return true;
+ }
+ if (typeof object !== "object") {
+ return false;
+ }
+ var prop;
+ // eslint-disable-next-line guard-for-in
+ for (prop in matcher) {
+ var value = object[prop];
+ if (
+ typeof value === "undefined" &&
+ typeof object.getAttribute === "function"
+ ) {
+ value = object.getAttribute(prop);
+ }
+ if (
+ matcher[prop] === null ||
+ typeof matcher[prop] === "undefined"
+ ) {
+ if (value !== matcher[prop]) {
+ return false;
+ }
+ } else if (
+ typeof value === "undefined" ||
+ !match(value, matcher[prop])
+ ) {
+ return false;
+ }
+ }
+ return true;
+ }
+
+ throw new Error(
+ "Matcher was not a string, a number, a " +
+ "function, a boolean or an object"
+ );
+}
+
+module.exports = match;
diff --git a/node_modules/@sinonjs/samsam/lib/samsam.js b/node_modules/@sinonjs/samsam/lib/samsam.js
new file mode 100644
index 0000000..ac6c5f3
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/lib/samsam.js
@@ -0,0 +1,17 @@
+"use strict";
+
+var deepEqualCyclic = require("./deep-equal");
+var identical = require("./identical");
+var isArguments = require("./is-arguments");
+var isElement = require("./is-element");
+var isNegZero = require("./is-neg-zero");
+var match = require("./match");
+
+module.exports = {
+ isArguments: isArguments,
+ isElement: isElement,
+ isNegZero: isNegZero,
+ identical: identical,
+ deepEqual: deepEqualCyclic,
+ match: match
+};
diff --git a/node_modules/@sinonjs/samsam/package.json b/node_modules/@sinonjs/samsam/package.json
new file mode 100644
index 0000000..75a3ec1
--- /dev/null
+++ b/node_modules/@sinonjs/samsam/package.json
@@ -0,0 +1,89 @@
+{
+ "_from": "@sinonjs/samsam@^2.1.2",
+ "_id": "@sinonjs/samsam@2.1.3",
+ "_inBundle": false,
+ "_integrity": "sha512-8zNeBkSKhU9a5cRNbpCKau2WWPfan+Q2zDlcXvXyhn9EsMqgYs4qzo0XHNVlXC6ABQL8fT6nV+zzo5RTHJzyXw==",
+ "_location": "/@sinonjs/samsam",
+ "_phantomChildren": {},
+ "_requested": {
+ "type": "range",
+ "registry": true,
+ "raw": "@sinonjs/samsam@^2.1.2",
+ "name": "@sinonjs/samsam",
+ "escapedName": "@sinonjs%2fsamsam",
+ "scope": "@sinonjs",
+ "rawSpec": "^2.1.2",
+ "saveSpec": null,
+ "fetchSpec": "^2.1.2"
+ },
+ "_requiredBy": [
+ "/sinon"
+ ],
+ "_resolved": "https://registry.npmjs.org/@sinonjs/samsam/-/samsam-2.1.3.tgz",
+ "_shasum": "62cf2a9b624edc795134135fe37fc2ae8ea36be3",
+ "_spec": "@sinonjs/samsam@^2.1.2",
+ "_where": "/Users/ayman/Documents/GitHub/javascript-challenges/node_modules/sinon",
+ "author": {
+ "name": "Christian Johansen"
+ },
+ "bugs": {
+ "url": "https://github.com/sinonjs/samsam/issues"
+ },
+ "bundleDependencies": false,
+ "dependencies": {},
+ "deprecated": false,
+ "description": "Value identification and comparison functions",
+ "devDependencies": {
+ "@sinonjs/referee": "^2.0.0",
+ "benchmark": "2.1.4",
+ "eslint": "^4.19.1",
+ "eslint-config-prettier": "2.9.0",
+ "eslint-config-sinon": "^1.0.3",
+ "eslint-plugin-ie11": "^1.0.0",
+ "eslint-plugin-mocha": "^4.11.0",
+ "eslint-plugin-prettier": "2.6.2",
+ "husky": "^0.14.3",
+ "jsdom": "^13.0.0",
+ "jsdom-global": "^3.0.2",
+ "lint-staged": "^6.1.0",
+ "microtime": "2.1.8",
+ "mkdirp": "^0.5.1",
+ "mocha": "^5.0.0",
+ "mochify": "^5.8.1",
+ "npm-run-all": "^4.1.2",
+ "nyc": "^11.7.3",
+ "prettier": "1.13.7",
+ "rollup": "^0.57.1",
+ "rollup-plugin-commonjs": "^9.1.0"
+ },
+ "files": [
+ "dist/",
+ "docs/",
+ "lib/",
+ "!lib/**/*.test.js"
+ ],
+ "homepage": "http://sinonjs.github.io/samsam/",
+ "license": "BSD-3-Clause",
+ "lint-staged": {
+ "*.js": "eslint"
+ },
+ "main": "./lib/samsam",
+ "name": "@sinonjs/samsam",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/sinonjs/samsam.git"
+ },
+ "scripts": {
+ "benchmark": "node lib/deep-equal-benchmark.js",
+ "build": "run-s build:dist-folder build:bundle",
+ "build:bundle": "rollup -c > dist/samsam.js",
+ "build:dist-folder": "mkdirp dist",
+ "lint": "eslint .",
+ "prepublishOnly": "npm run build && mkdocs gh-deploy -r upstream || mkdocs gh-deploy -r origin",
+ "test": "mocha ./lib/*.test.js",
+ "test-cloud": "npm run test-headless -- --wd",
+ "test-coverage": "nyc --reporter text --reporter html --reporter lcovonly npm run test",
+ "test-headless": "mochify lib/*.test.js"
+ },
+ "version": "2.1.3"
+}
diff --git a/node_modules/@sinonjs/text-encoding/LICENSE.md b/node_modules/@sinonjs/text-encoding/LICENSE.md
new file mode 100644
index 0000000..5ab1046
--- /dev/null
+++ b/node_modules/@sinonjs/text-encoding/LICENSE.md
@@ -0,0 +1,237 @@
+The encoding indexes, algorithms, and many comments in the code
+derive from the Encoding Standard https://encoding.spec.whatwg.org/
+
+Otherwise, the code of this repository is released under the Unlicense
+license and is also dual-licensed under an Apache 2.0 license. Both
+are included below.
+
+# Unlicense
+
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to 
+
+Basic example in a web page
+
+```html
+
+
+
+```
+
+Open the above .html file in a browser and you should see
+
+
+
+**[Full online demo](http://kpdecker.github.com/jsdiff)**
+
+## Compatibility
+
+[](https://saucelabs.com/u/jsdiff)
+
+jsdiff supports all ES3 environments with some known issues on IE8 and below. Under these browsers some diff algorithms such as word diff and others may fail due to lack of support for capturing groups in the `split` operation.
+
+## License
+
+See [LICENSE](https://github.com/kpdecker/jsdiff/blob/master/LICENSE).
diff --git a/node_modules/diff/dist/diff.js b/node_modules/diff/dist/diff.js
new file mode 100644
index 0000000..0b824f1
--- /dev/null
+++ b/node_modules/diff/dist/diff.js
@@ -0,0 +1,1843 @@
+/*!
+
+ diff v3.5.0
+
+Software License Agreement (BSD License)
+
+Copyright (c) 2009-2015, Kevin Decker ' + func(text) + '
'; + * }); + * + * p('fred, barney, & pebbles'); + * // => 'fred, barney, & pebbles
' + */ + function wrap(value, wrapper) { + return partial(castFunction(wrapper), value); + } + + /*------------------------------------------------------------------------*/ + + /** + * Casts `value` as an array if it's not one. + * + * @static + * @memberOf _ + * @since 4.4.0 + * @category Lang + * @param {*} value The value to inspect. + * @returns {Array} Returns the cast array. + * @example + * + * _.castArray(1); + * // => [1] + * + * _.castArray({ 'a': 1 }); + * // => [{ 'a': 1 }] + * + * _.castArray('abc'); + * // => ['abc'] + * + * _.castArray(null); + * // => [null] + * + * _.castArray(undefined); + * // => [undefined] + * + * _.castArray(); + * // => [] + * + * var array = [1, 2, 3]; + * console.log(_.castArray(array) === array); + * // => true + */ + function castArray() { + if (!arguments.length) { + return []; + } + var value = arguments[0]; + return isArray(value) ? value : [value]; + } + + /** + * Creates a shallow clone of `value`. + * + * **Note:** This method is loosely based on the + * [structured clone algorithm](https://mdn.io/Structured_clone_algorithm) + * and supports cloning arrays, array buffers, booleans, date objects, maps, + * numbers, `Object` objects, regexes, sets, strings, symbols, and typed + * arrays. The own enumerable properties of `arguments` objects are cloned + * as plain objects. An empty object is returned for uncloneable values such + * as error objects, functions, DOM nodes, and WeakMaps. + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to clone. + * @returns {*} Returns the cloned value. + * @see _.cloneDeep + * @example + * + * var objects = [{ 'a': 1 }, { 'b': 2 }]; + * + * var shallow = _.clone(objects); + * console.log(shallow[0] === objects[0]); + * // => true + */ + function clone(value) { + return baseClone(value, CLONE_SYMBOLS_FLAG); + } + + /** + * This method is like `_.clone` except that it accepts `customizer` which + * is invoked to produce the cloned value. If `customizer` returns `undefined`, + * cloning is handled by the method instead. The `customizer` is invoked with + * up to four arguments; (value [, index|key, object, stack]). + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to clone. + * @param {Function} [customizer] The function to customize cloning. + * @returns {*} Returns the cloned value. + * @see _.cloneDeepWith + * @example + * + * function customizer(value) { + * if (_.isElement(value)) { + * return value.cloneNode(false); + * } + * } + * + * var el = _.cloneWith(document.body, customizer); + * + * console.log(el === document.body); + * // => false + * console.log(el.nodeName); + * // => 'BODY' + * console.log(el.childNodes.length); + * // => 0 + */ + function cloneWith(value, customizer) { + customizer = typeof customizer == 'function' ? customizer : undefined; + return baseClone(value, CLONE_SYMBOLS_FLAG, customizer); + } + + /** + * This method is like `_.clone` except that it recursively clones `value`. + * + * @static + * @memberOf _ + * @since 1.0.0 + * @category Lang + * @param {*} value The value to recursively clone. + * @returns {*} Returns the deep cloned value. + * @see _.clone + * @example + * + * var objects = [{ 'a': 1 }, { 'b': 2 }]; + * + * var deep = _.cloneDeep(objects); + * console.log(deep[0] === objects[0]); + * // => false + */ + function cloneDeep(value) { + return baseClone(value, CLONE_DEEP_FLAG | CLONE_SYMBOLS_FLAG); + } + + /** + * This method is like `_.cloneWith` except that it recursively clones `value`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to recursively clone. + * @param {Function} [customizer] The function to customize cloning. + * @returns {*} Returns the deep cloned value. + * @see _.cloneWith + * @example + * + * function customizer(value) { + * if (_.isElement(value)) { + * return value.cloneNode(true); + * } + * } + * + * var el = _.cloneDeepWith(document.body, customizer); + * + * console.log(el === document.body); + * // => false + * console.log(el.nodeName); + * // => 'BODY' + * console.log(el.childNodes.length); + * // => 20 + */ + function cloneDeepWith(value, customizer) { + customizer = typeof customizer == 'function' ? customizer : undefined; + return baseClone(value, CLONE_DEEP_FLAG | CLONE_SYMBOLS_FLAG, customizer); + } + + /** + * Checks if `object` conforms to `source` by invoking the predicate + * properties of `source` with the corresponding property values of `object`. + * + * **Note:** This method is equivalent to `_.conforms` when `source` is + * partially applied. + * + * @static + * @memberOf _ + * @since 4.14.0 + * @category Lang + * @param {Object} object The object to inspect. + * @param {Object} source The object of property predicates to conform to. + * @returns {boolean} Returns `true` if `object` conforms, else `false`. + * @example + * + * var object = { 'a': 1, 'b': 2 }; + * + * _.conformsTo(object, { 'b': function(n) { return n > 1; } }); + * // => true + * + * _.conformsTo(object, { 'b': function(n) { return n > 2; } }); + * // => false + */ + function conformsTo(object, source) { + return source == null || baseConformsTo(object, source, keys(source)); + } + + /** + * Performs a + * [`SameValueZero`](http://ecma-international.org/ecma-262/7.0/#sec-samevaluezero) + * comparison between two values to determine if they are equivalent. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to compare. + * @param {*} other The other value to compare. + * @returns {boolean} Returns `true` if the values are equivalent, else `false`. + * @example + * + * var object = { 'a': 1 }; + * var other = { 'a': 1 }; + * + * _.eq(object, object); + * // => true + * + * _.eq(object, other); + * // => false + * + * _.eq('a', 'a'); + * // => true + * + * _.eq('a', Object('a')); + * // => false + * + * _.eq(NaN, NaN); + * // => true + */ + function eq(value, other) { + return value === other || (value !== value && other !== other); + } + + /** + * Checks if `value` is greater than `other`. + * + * @static + * @memberOf _ + * @since 3.9.0 + * @category Lang + * @param {*} value The value to compare. + * @param {*} other The other value to compare. + * @returns {boolean} Returns `true` if `value` is greater than `other`, + * else `false`. + * @see _.lt + * @example + * + * _.gt(3, 1); + * // => true + * + * _.gt(3, 3); + * // => false + * + * _.gt(1, 3); + * // => false + */ + var gt = createRelationalOperation(baseGt); + + /** + * Checks if `value` is greater than or equal to `other`. + * + * @static + * @memberOf _ + * @since 3.9.0 + * @category Lang + * @param {*} value The value to compare. + * @param {*} other The other value to compare. + * @returns {boolean} Returns `true` if `value` is greater than or equal to + * `other`, else `false`. + * @see _.lte + * @example + * + * _.gte(3, 1); + * // => true + * + * _.gte(3, 3); + * // => true + * + * _.gte(1, 3); + * // => false + */ + var gte = createRelationalOperation(function(value, other) { + return value >= other; + }); + + /** + * Checks if `value` is likely an `arguments` object. + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is an `arguments` object, + * else `false`. + * @example + * + * _.isArguments(function() { return arguments; }()); + * // => true + * + * _.isArguments([1, 2, 3]); + * // => false + */ + var isArguments = baseIsArguments(function() { return arguments; }()) ? baseIsArguments : function(value) { + return isObjectLike(value) && hasOwnProperty.call(value, 'callee') && + !propertyIsEnumerable.call(value, 'callee'); + }; + + /** + * Checks if `value` is classified as an `Array` object. + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is an array, else `false`. + * @example + * + * _.isArray([1, 2, 3]); + * // => true + * + * _.isArray(document.body.children); + * // => false + * + * _.isArray('abc'); + * // => false + * + * _.isArray(_.noop); + * // => false + */ + var isArray = Array.isArray; + + /** + * Checks if `value` is classified as an `ArrayBuffer` object. + * + * @static + * @memberOf _ + * @since 4.3.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is an array buffer, else `false`. + * @example + * + * _.isArrayBuffer(new ArrayBuffer(2)); + * // => true + * + * _.isArrayBuffer(new Array(2)); + * // => false + */ + var isArrayBuffer = nodeIsArrayBuffer ? baseUnary(nodeIsArrayBuffer) : baseIsArrayBuffer; + + /** + * Checks if `value` is array-like. A value is considered array-like if it's + * not a function and has a `value.length` that's an integer greater than or + * equal to `0` and less than or equal to `Number.MAX_SAFE_INTEGER`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is array-like, else `false`. + * @example + * + * _.isArrayLike([1, 2, 3]); + * // => true + * + * _.isArrayLike(document.body.children); + * // => true + * + * _.isArrayLike('abc'); + * // => true + * + * _.isArrayLike(_.noop); + * // => false + */ + function isArrayLike(value) { + return value != null && isLength(value.length) && !isFunction(value); + } + + /** + * This method is like `_.isArrayLike` except that it also checks if `value` + * is an object. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is an array-like object, + * else `false`. + * @example + * + * _.isArrayLikeObject([1, 2, 3]); + * // => true + * + * _.isArrayLikeObject(document.body.children); + * // => true + * + * _.isArrayLikeObject('abc'); + * // => false + * + * _.isArrayLikeObject(_.noop); + * // => false + */ + function isArrayLikeObject(value) { + return isObjectLike(value) && isArrayLike(value); + } + + /** + * Checks if `value` is classified as a boolean primitive or object. + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a boolean, else `false`. + * @example + * + * _.isBoolean(false); + * // => true + * + * _.isBoolean(null); + * // => false + */ + function isBoolean(value) { + return value === true || value === false || + (isObjectLike(value) && baseGetTag(value) == boolTag); + } + + /** + * Checks if `value` is a buffer. + * + * @static + * @memberOf _ + * @since 4.3.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a buffer, else `false`. + * @example + * + * _.isBuffer(new Buffer(2)); + * // => true + * + * _.isBuffer(new Uint8Array(2)); + * // => false + */ + var isBuffer = nativeIsBuffer || stubFalse; + + /** + * Checks if `value` is classified as a `Date` object. + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a date object, else `false`. + * @example + * + * _.isDate(new Date); + * // => true + * + * _.isDate('Mon April 23 2012'); + * // => false + */ + var isDate = nodeIsDate ? baseUnary(nodeIsDate) : baseIsDate; + + /** + * Checks if `value` is likely a DOM element. + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a DOM element, else `false`. + * @example + * + * _.isElement(document.body); + * // => true + * + * _.isElement(''); + * // => false + */ + function isElement(value) { + return isObjectLike(value) && value.nodeType === 1 && !isPlainObject(value); + } + + /** + * Checks if `value` is an empty object, collection, map, or set. + * + * Objects are considered empty if they have no own enumerable string keyed + * properties. + * + * Array-like values such as `arguments` objects, arrays, buffers, strings, or + * jQuery-like collections are considered empty if they have a `length` of `0`. + * Similarly, maps and sets are considered empty if they have a `size` of `0`. + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is empty, else `false`. + * @example + * + * _.isEmpty(null); + * // => true + * + * _.isEmpty(true); + * // => true + * + * _.isEmpty(1); + * // => true + * + * _.isEmpty([1, 2, 3]); + * // => false + * + * _.isEmpty({ 'a': 1 }); + * // => false + */ + function isEmpty(value) { + if (value == null) { + return true; + } + if (isArrayLike(value) && + (isArray(value) || typeof value == 'string' || typeof value.splice == 'function' || + isBuffer(value) || isTypedArray(value) || isArguments(value))) { + return !value.length; + } + var tag = getTag(value); + if (tag == mapTag || tag == setTag) { + return !value.size; + } + if (isPrototype(value)) { + return !baseKeys(value).length; + } + for (var key in value) { + if (hasOwnProperty.call(value, key)) { + return false; + } + } + return true; + } + + /** + * Performs a deep comparison between two values to determine if they are + * equivalent. + * + * **Note:** This method supports comparing arrays, array buffers, booleans, + * date objects, error objects, maps, numbers, `Object` objects, regexes, + * sets, strings, symbols, and typed arrays. `Object` objects are compared + * by their own, not inherited, enumerable properties. Functions and DOM + * nodes are compared by strict equality, i.e. `===`. + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to compare. + * @param {*} other The other value to compare. + * @returns {boolean} Returns `true` if the values are equivalent, else `false`. + * @example + * + * var object = { 'a': 1 }; + * var other = { 'a': 1 }; + * + * _.isEqual(object, other); + * // => true + * + * object === other; + * // => false + */ + function isEqual(value, other) { + return baseIsEqual(value, other); + } + + /** + * This method is like `_.isEqual` except that it accepts `customizer` which + * is invoked to compare values. If `customizer` returns `undefined`, comparisons + * are handled by the method instead. The `customizer` is invoked with up to + * six arguments: (objValue, othValue [, index|key, object, other, stack]). + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to compare. + * @param {*} other The other value to compare. + * @param {Function} [customizer] The function to customize comparisons. + * @returns {boolean} Returns `true` if the values are equivalent, else `false`. + * @example + * + * function isGreeting(value) { + * return /^h(?:i|ello)$/.test(value); + * } + * + * function customizer(objValue, othValue) { + * if (isGreeting(objValue) && isGreeting(othValue)) { + * return true; + * } + * } + * + * var array = ['hello', 'goodbye']; + * var other = ['hi', 'goodbye']; + * + * _.isEqualWith(array, other, customizer); + * // => true + */ + function isEqualWith(value, other, customizer) { + customizer = typeof customizer == 'function' ? customizer : undefined; + var result = customizer ? customizer(value, other) : undefined; + return result === undefined ? baseIsEqual(value, other, undefined, customizer) : !!result; + } + + /** + * Checks if `value` is an `Error`, `EvalError`, `RangeError`, `ReferenceError`, + * `SyntaxError`, `TypeError`, or `URIError` object. + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is an error object, else `false`. + * @example + * + * _.isError(new Error); + * // => true + * + * _.isError(Error); + * // => false + */ + function isError(value) { + if (!isObjectLike(value)) { + return false; + } + var tag = baseGetTag(value); + return tag == errorTag || tag == domExcTag || + (typeof value.message == 'string' && typeof value.name == 'string' && !isPlainObject(value)); + } + + /** + * Checks if `value` is a finite primitive number. + * + * **Note:** This method is based on + * [`Number.isFinite`](https://mdn.io/Number/isFinite). + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a finite number, else `false`. + * @example + * + * _.isFinite(3); + * // => true + * + * _.isFinite(Number.MIN_VALUE); + * // => true + * + * _.isFinite(Infinity); + * // => false + * + * _.isFinite('3'); + * // => false + */ + function isFinite(value) { + return typeof value == 'number' && nativeIsFinite(value); + } + + /** + * Checks if `value` is classified as a `Function` object. + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a function, else `false`. + * @example + * + * _.isFunction(_); + * // => true + * + * _.isFunction(/abc/); + * // => false + */ + function isFunction(value) { + if (!isObject(value)) { + return false; + } + // The use of `Object#toString` avoids issues with the `typeof` operator + // in Safari 9 which returns 'object' for typed arrays and other constructors. + var tag = baseGetTag(value); + return tag == funcTag || tag == genTag || tag == asyncTag || tag == proxyTag; + } + + /** + * Checks if `value` is an integer. + * + * **Note:** This method is based on + * [`Number.isInteger`](https://mdn.io/Number/isInteger). + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is an integer, else `false`. + * @example + * + * _.isInteger(3); + * // => true + * + * _.isInteger(Number.MIN_VALUE); + * // => false + * + * _.isInteger(Infinity); + * // => false + * + * _.isInteger('3'); + * // => false + */ + function isInteger(value) { + return typeof value == 'number' && value == toInteger(value); + } + + /** + * Checks if `value` is a valid array-like length. + * + * **Note:** This method is loosely based on + * [`ToLength`](http://ecma-international.org/ecma-262/7.0/#sec-tolength). + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a valid length, else `false`. + * @example + * + * _.isLength(3); + * // => true + * + * _.isLength(Number.MIN_VALUE); + * // => false + * + * _.isLength(Infinity); + * // => false + * + * _.isLength('3'); + * // => false + */ + function isLength(value) { + return typeof value == 'number' && + value > -1 && value % 1 == 0 && value <= MAX_SAFE_INTEGER; + } + + /** + * Checks if `value` is the + * [language type](http://www.ecma-international.org/ecma-262/7.0/#sec-ecmascript-language-types) + * of `Object`. (e.g. arrays, functions, objects, regexes, `new Number(0)`, and `new String('')`) + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is an object, else `false`. + * @example + * + * _.isObject({}); + * // => true + * + * _.isObject([1, 2, 3]); + * // => true + * + * _.isObject(_.noop); + * // => true + * + * _.isObject(null); + * // => false + */ + function isObject(value) { + var type = typeof value; + return value != null && (type == 'object' || type == 'function'); + } + + /** + * Checks if `value` is object-like. A value is object-like if it's not `null` + * and has a `typeof` result of "object". + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is object-like, else `false`. + * @example + * + * _.isObjectLike({}); + * // => true + * + * _.isObjectLike([1, 2, 3]); + * // => true + * + * _.isObjectLike(_.noop); + * // => false + * + * _.isObjectLike(null); + * // => false + */ + function isObjectLike(value) { + return value != null && typeof value == 'object'; + } + + /** + * Checks if `value` is classified as a `Map` object. + * + * @static + * @memberOf _ + * @since 4.3.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a map, else `false`. + * @example + * + * _.isMap(new Map); + * // => true + * + * _.isMap(new WeakMap); + * // => false + */ + var isMap = nodeIsMap ? baseUnary(nodeIsMap) : baseIsMap; + + /** + * Performs a partial deep comparison between `object` and `source` to + * determine if `object` contains equivalent property values. + * + * **Note:** This method is equivalent to `_.matches` when `source` is + * partially applied. + * + * Partial comparisons will match empty array and empty object `source` + * values against any array or object value, respectively. See `_.isEqual` + * for a list of supported value comparisons. + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category Lang + * @param {Object} object The object to inspect. + * @param {Object} source The object of property values to match. + * @returns {boolean} Returns `true` if `object` is a match, else `false`. + * @example + * + * var object = { 'a': 1, 'b': 2 }; + * + * _.isMatch(object, { 'b': 2 }); + * // => true + * + * _.isMatch(object, { 'b': 1 }); + * // => false + */ + function isMatch(object, source) { + return object === source || baseIsMatch(object, source, getMatchData(source)); + } + + /** + * This method is like `_.isMatch` except that it accepts `customizer` which + * is invoked to compare values. If `customizer` returns `undefined`, comparisons + * are handled by the method instead. The `customizer` is invoked with five + * arguments: (objValue, srcValue, index|key, object, source). + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {Object} object The object to inspect. + * @param {Object} source The object of property values to match. + * @param {Function} [customizer] The function to customize comparisons. + * @returns {boolean} Returns `true` if `object` is a match, else `false`. + * @example + * + * function isGreeting(value) { + * return /^h(?:i|ello)$/.test(value); + * } + * + * function customizer(objValue, srcValue) { + * if (isGreeting(objValue) && isGreeting(srcValue)) { + * return true; + * } + * } + * + * var object = { 'greeting': 'hello' }; + * var source = { 'greeting': 'hi' }; + * + * _.isMatchWith(object, source, customizer); + * // => true + */ + function isMatchWith(object, source, customizer) { + customizer = typeof customizer == 'function' ? customizer : undefined; + return baseIsMatch(object, source, getMatchData(source), customizer); + } + + /** + * Checks if `value` is `NaN`. + * + * **Note:** This method is based on + * [`Number.isNaN`](https://mdn.io/Number/isNaN) and is not the same as + * global [`isNaN`](https://mdn.io/isNaN) which returns `true` for + * `undefined` and other non-number values. + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is `NaN`, else `false`. + * @example + * + * _.isNaN(NaN); + * // => true + * + * _.isNaN(new Number(NaN)); + * // => true + * + * isNaN(undefined); + * // => true + * + * _.isNaN(undefined); + * // => false + */ + function isNaN(value) { + // An `NaN` primitive is the only value that is not equal to itself. + // Perform the `toStringTag` check first to avoid errors with some + // ActiveX objects in IE. + return isNumber(value) && value != +value; + } + + /** + * Checks if `value` is a pristine native function. + * + * **Note:** This method can't reliably detect native functions in the presence + * of the core-js package because core-js circumvents this kind of detection. + * Despite multiple requests, the core-js maintainer has made it clear: any + * attempt to fix the detection will be obstructed. As a result, we're left + * with little choice but to throw an error. Unfortunately, this also affects + * packages, like [babel-polyfill](https://www.npmjs.com/package/babel-polyfill), + * which rely on core-js. + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a native function, + * else `false`. + * @example + * + * _.isNative(Array.prototype.push); + * // => true + * + * _.isNative(_); + * // => false + */ + function isNative(value) { + if (isMaskable(value)) { + throw new Error(CORE_ERROR_TEXT); + } + return baseIsNative(value); + } + + /** + * Checks if `value` is `null`. + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is `null`, else `false`. + * @example + * + * _.isNull(null); + * // => true + * + * _.isNull(void 0); + * // => false + */ + function isNull(value) { + return value === null; + } + + /** + * Checks if `value` is `null` or `undefined`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is nullish, else `false`. + * @example + * + * _.isNil(null); + * // => true + * + * _.isNil(void 0); + * // => true + * + * _.isNil(NaN); + * // => false + */ + function isNil(value) { + return value == null; + } + + /** + * Checks if `value` is classified as a `Number` primitive or object. + * + * **Note:** To exclude `Infinity`, `-Infinity`, and `NaN`, which are + * classified as numbers, use the `_.isFinite` method. + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a number, else `false`. + * @example + * + * _.isNumber(3); + * // => true + * + * _.isNumber(Number.MIN_VALUE); + * // => true + * + * _.isNumber(Infinity); + * // => true + * + * _.isNumber('3'); + * // => false + */ + function isNumber(value) { + return typeof value == 'number' || + (isObjectLike(value) && baseGetTag(value) == numberTag); + } + + /** + * Checks if `value` is a plain object, that is, an object created by the + * `Object` constructor or one with a `[[Prototype]]` of `null`. + * + * @static + * @memberOf _ + * @since 0.8.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a plain object, else `false`. + * @example + * + * function Foo() { + * this.a = 1; + * } + * + * _.isPlainObject(new Foo); + * // => false + * + * _.isPlainObject([1, 2, 3]); + * // => false + * + * _.isPlainObject({ 'x': 0, 'y': 0 }); + * // => true + * + * _.isPlainObject(Object.create(null)); + * // => true + */ + function isPlainObject(value) { + if (!isObjectLike(value) || baseGetTag(value) != objectTag) { + return false; + } + var proto = getPrototype(value); + if (proto === null) { + return true; + } + var Ctor = hasOwnProperty.call(proto, 'constructor') && proto.constructor; + return typeof Ctor == 'function' && Ctor instanceof Ctor && + funcToString.call(Ctor) == objectCtorString; + } + + /** + * Checks if `value` is classified as a `RegExp` object. + * + * @static + * @memberOf _ + * @since 0.1.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a regexp, else `false`. + * @example + * + * _.isRegExp(/abc/); + * // => true + * + * _.isRegExp('/abc/'); + * // => false + */ + var isRegExp = nodeIsRegExp ? baseUnary(nodeIsRegExp) : baseIsRegExp; + + /** + * Checks if `value` is a safe integer. An integer is safe if it's an IEEE-754 + * double precision number which isn't the result of a rounded unsafe integer. + * + * **Note:** This method is based on + * [`Number.isSafeInteger`](https://mdn.io/Number/isSafeInteger). + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a safe integer, else `false`. + * @example + * + * _.isSafeInteger(3); + * // => true + * + * _.isSafeInteger(Number.MIN_VALUE); + * // => false + * + * _.isSafeInteger(Infinity); + * // => false + * + * _.isSafeInteger('3'); + * // => false + */ + function isSafeInteger(value) { + return isInteger(value) && value >= -MAX_SAFE_INTEGER && value <= MAX_SAFE_INTEGER; + } + + /** + * Checks if `value` is classified as a `Set` object. + * + * @static + * @memberOf _ + * @since 4.3.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a set, else `false`. + * @example + * + * _.isSet(new Set); + * // => true + * + * _.isSet(new WeakSet); + * // => false + */ + var isSet = nodeIsSet ? baseUnary(nodeIsSet) : baseIsSet; + + /** + * Checks if `value` is classified as a `String` primitive or object. + * + * @static + * @since 0.1.0 + * @memberOf _ + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a string, else `false`. + * @example + * + * _.isString('abc'); + * // => true + * + * _.isString(1); + * // => false + */ + function isString(value) { + return typeof value == 'string' || + (!isArray(value) && isObjectLike(value) && baseGetTag(value) == stringTag); + } + + /** + * Checks if `value` is classified as a `Symbol` primitive or object. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a symbol, else `false`. + * @example + * + * _.isSymbol(Symbol.iterator); + * // => true + * + * _.isSymbol('abc'); + * // => false + */ + function isSymbol(value) { + return typeof value == 'symbol' || + (isObjectLike(value) && baseGetTag(value) == symbolTag); + } + + /** + * Checks if `value` is classified as a typed array. + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a typed array, else `false`. + * @example + * + * _.isTypedArray(new Uint8Array); + * // => true + * + * _.isTypedArray([]); + * // => false + */ + var isTypedArray = nodeIsTypedArray ? baseUnary(nodeIsTypedArray) : baseIsTypedArray; + + /** + * Checks if `value` is `undefined`. + * + * @static + * @since 0.1.0 + * @memberOf _ + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is `undefined`, else `false`. + * @example + * + * _.isUndefined(void 0); + * // => true + * + * _.isUndefined(null); + * // => false + */ + function isUndefined(value) { + return value === undefined; + } + + /** + * Checks if `value` is classified as a `WeakMap` object. + * + * @static + * @memberOf _ + * @since 4.3.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a weak map, else `false`. + * @example + * + * _.isWeakMap(new WeakMap); + * // => true + * + * _.isWeakMap(new Map); + * // => false + */ + function isWeakMap(value) { + return isObjectLike(value) && getTag(value) == weakMapTag; + } + + /** + * Checks if `value` is classified as a `WeakSet` object. + * + * @static + * @memberOf _ + * @since 4.3.0 + * @category Lang + * @param {*} value The value to check. + * @returns {boolean} Returns `true` if `value` is a weak set, else `false`. + * @example + * + * _.isWeakSet(new WeakSet); + * // => true + * + * _.isWeakSet(new Set); + * // => false + */ + function isWeakSet(value) { + return isObjectLike(value) && baseGetTag(value) == weakSetTag; + } + + /** + * Checks if `value` is less than `other`. + * + * @static + * @memberOf _ + * @since 3.9.0 + * @category Lang + * @param {*} value The value to compare. + * @param {*} other The other value to compare. + * @returns {boolean} Returns `true` if `value` is less than `other`, + * else `false`. + * @see _.gt + * @example + * + * _.lt(1, 3); + * // => true + * + * _.lt(3, 3); + * // => false + * + * _.lt(3, 1); + * // => false + */ + var lt = createRelationalOperation(baseLt); + + /** + * Checks if `value` is less than or equal to `other`. + * + * @static + * @memberOf _ + * @since 3.9.0 + * @category Lang + * @param {*} value The value to compare. + * @param {*} other The other value to compare. + * @returns {boolean} Returns `true` if `value` is less than or equal to + * `other`, else `false`. + * @see _.gte + * @example + * + * _.lte(1, 3); + * // => true + * + * _.lte(3, 3); + * // => true + * + * _.lte(3, 1); + * // => false + */ + var lte = createRelationalOperation(function(value, other) { + return value <= other; + }); + + /** + * Converts `value` to an array. + * + * @static + * @since 0.1.0 + * @memberOf _ + * @category Lang + * @param {*} value The value to convert. + * @returns {Array} Returns the converted array. + * @example + * + * _.toArray({ 'a': 1, 'b': 2 }); + * // => [1, 2] + * + * _.toArray('abc'); + * // => ['a', 'b', 'c'] + * + * _.toArray(1); + * // => [] + * + * _.toArray(null); + * // => [] + */ + function toArray(value) { + if (!value) { + return []; + } + if (isArrayLike(value)) { + return isString(value) ? stringToArray(value) : copyArray(value); + } + if (symIterator && value[symIterator]) { + return iteratorToArray(value[symIterator]()); + } + var tag = getTag(value), + func = tag == mapTag ? mapToArray : (tag == setTag ? setToArray : values); + + return func(value); + } + + /** + * Converts `value` to a finite number. + * + * @static + * @memberOf _ + * @since 4.12.0 + * @category Lang + * @param {*} value The value to convert. + * @returns {number} Returns the converted number. + * @example + * + * _.toFinite(3.2); + * // => 3.2 + * + * _.toFinite(Number.MIN_VALUE); + * // => 5e-324 + * + * _.toFinite(Infinity); + * // => 1.7976931348623157e+308 + * + * _.toFinite('3.2'); + * // => 3.2 + */ + function toFinite(value) { + if (!value) { + return value === 0 ? value : 0; + } + value = toNumber(value); + if (value === INFINITY || value === -INFINITY) { + var sign = (value < 0 ? -1 : 1); + return sign * MAX_INTEGER; + } + return value === value ? value : 0; + } + + /** + * Converts `value` to an integer. + * + * **Note:** This method is loosely based on + * [`ToInteger`](http://www.ecma-international.org/ecma-262/7.0/#sec-tointeger). + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to convert. + * @returns {number} Returns the converted integer. + * @example + * + * _.toInteger(3.2); + * // => 3 + * + * _.toInteger(Number.MIN_VALUE); + * // => 0 + * + * _.toInteger(Infinity); + * // => 1.7976931348623157e+308 + * + * _.toInteger('3.2'); + * // => 3 + */ + function toInteger(value) { + var result = toFinite(value), + remainder = result % 1; + + return result === result ? (remainder ? result - remainder : result) : 0; + } + + /** + * Converts `value` to an integer suitable for use as the length of an + * array-like object. + * + * **Note:** This method is based on + * [`ToLength`](http://ecma-international.org/ecma-262/7.0/#sec-tolength). + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to convert. + * @returns {number} Returns the converted integer. + * @example + * + * _.toLength(3.2); + * // => 3 + * + * _.toLength(Number.MIN_VALUE); + * // => 0 + * + * _.toLength(Infinity); + * // => 4294967295 + * + * _.toLength('3.2'); + * // => 3 + */ + function toLength(value) { + return value ? baseClamp(toInteger(value), 0, MAX_ARRAY_LENGTH) : 0; + } + + /** + * Converts `value` to a number. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to process. + * @returns {number} Returns the number. + * @example + * + * _.toNumber(3.2); + * // => 3.2 + * + * _.toNumber(Number.MIN_VALUE); + * // => 5e-324 + * + * _.toNumber(Infinity); + * // => Infinity + * + * _.toNumber('3.2'); + * // => 3.2 + */ + function toNumber(value) { + if (typeof value == 'number') { + return value; + } + if (isSymbol(value)) { + return NAN; + } + if (isObject(value)) { + var other = typeof value.valueOf == 'function' ? value.valueOf() : value; + value = isObject(other) ? (other + '') : other; + } + if (typeof value != 'string') { + return value === 0 ? value : +value; + } + value = value.replace(reTrim, ''); + var isBinary = reIsBinary.test(value); + return (isBinary || reIsOctal.test(value)) + ? freeParseInt(value.slice(2), isBinary ? 2 : 8) + : (reIsBadHex.test(value) ? NAN : +value); + } + + /** + * Converts `value` to a plain object flattening inherited enumerable string + * keyed properties of `value` to own properties of the plain object. + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category Lang + * @param {*} value The value to convert. + * @returns {Object} Returns the converted plain object. + * @example + * + * function Foo() { + * this.b = 2; + * } + * + * Foo.prototype.c = 3; + * + * _.assign({ 'a': 1 }, new Foo); + * // => { 'a': 1, 'b': 2 } + * + * _.assign({ 'a': 1 }, _.toPlainObject(new Foo)); + * // => { 'a': 1, 'b': 2, 'c': 3 } + */ + function toPlainObject(value) { + return copyObject(value, keysIn(value)); + } + + /** + * Converts `value` to a safe integer. A safe integer can be compared and + * represented correctly. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to convert. + * @returns {number} Returns the converted integer. + * @example + * + * _.toSafeInteger(3.2); + * // => 3 + * + * _.toSafeInteger(Number.MIN_VALUE); + * // => 0 + * + * _.toSafeInteger(Infinity); + * // => 9007199254740991 + * + * _.toSafeInteger('3.2'); + * // => 3 + */ + function toSafeInteger(value) { + return value + ? baseClamp(toInteger(value), -MAX_SAFE_INTEGER, MAX_SAFE_INTEGER) + : (value === 0 ? value : 0); + } + + /** + * Converts `value` to a string. An empty string is returned for `null` + * and `undefined` values. The sign of `-0` is preserved. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Lang + * @param {*} value The value to convert. + * @returns {string} Returns the converted string. + * @example + * + * _.toString(null); + * // => '' + * + * _.toString(-0); + * // => '-0' + * + * _.toString([1, 2, 3]); + * // => '1,2,3' + */ + function toString(value) { + return value == null ? '' : baseToString(value); + } + + /*------------------------------------------------------------------------*/ + + /** + * Assigns own enumerable string keyed properties of source objects to the + * destination object. Source objects are applied from left to right. + * Subsequent sources overwrite property assignments of previous sources. + * + * **Note:** This method mutates `object` and is loosely based on + * [`Object.assign`](https://mdn.io/Object/assign). + * + * @static + * @memberOf _ + * @since 0.10.0 + * @category Object + * @param {Object} object The destination object. + * @param {...Object} [sources] The source objects. + * @returns {Object} Returns `object`. + * @see _.assignIn + * @example + * + * function Foo() { + * this.a = 1; + * } + * + * function Bar() { + * this.c = 3; + * } + * + * Foo.prototype.b = 2; + * Bar.prototype.d = 4; + * + * _.assign({ 'a': 0 }, new Foo, new Bar); + * // => { 'a': 1, 'c': 3 } + */ + var assign = createAssigner(function(object, source) { + if (isPrototype(source) || isArrayLike(source)) { + copyObject(source, keys(source), object); + return; + } + for (var key in source) { + if (hasOwnProperty.call(source, key)) { + assignValue(object, key, source[key]); + } + } + }); + + /** + * This method is like `_.assign` except that it iterates over own and + * inherited source properties. + * + * **Note:** This method mutates `object`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @alias extend + * @category Object + * @param {Object} object The destination object. + * @param {...Object} [sources] The source objects. + * @returns {Object} Returns `object`. + * @see _.assign + * @example + * + * function Foo() { + * this.a = 1; + * } + * + * function Bar() { + * this.c = 3; + * } + * + * Foo.prototype.b = 2; + * Bar.prototype.d = 4; + * + * _.assignIn({ 'a': 0 }, new Foo, new Bar); + * // => { 'a': 1, 'b': 2, 'c': 3, 'd': 4 } + */ + var assignIn = createAssigner(function(object, source) { + copyObject(source, keysIn(source), object); + }); + + /** + * This method is like `_.assignIn` except that it accepts `customizer` + * which is invoked to produce the assigned values. If `customizer` returns + * `undefined`, assignment is handled by the method instead. The `customizer` + * is invoked with five arguments: (objValue, srcValue, key, object, source). + * + * **Note:** This method mutates `object`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @alias extendWith + * @category Object + * @param {Object} object The destination object. + * @param {...Object} sources The source objects. + * @param {Function} [customizer] The function to customize assigned values. + * @returns {Object} Returns `object`. + * @see _.assignWith + * @example + * + * function customizer(objValue, srcValue) { + * return _.isUndefined(objValue) ? srcValue : objValue; + * } + * + * var defaults = _.partialRight(_.assignInWith, customizer); + * + * defaults({ 'a': 1 }, { 'b': 2 }, { 'a': 3 }); + * // => { 'a': 1, 'b': 2 } + */ + var assignInWith = createAssigner(function(object, source, srcIndex, customizer) { + copyObject(source, keysIn(source), object, customizer); + }); + + /** + * This method is like `_.assign` except that it accepts `customizer` + * which is invoked to produce the assigned values. If `customizer` returns + * `undefined`, assignment is handled by the method instead. The `customizer` + * is invoked with five arguments: (objValue, srcValue, key, object, source). + * + * **Note:** This method mutates `object`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Object + * @param {Object} object The destination object. + * @param {...Object} sources The source objects. + * @param {Function} [customizer] The function to customize assigned values. + * @returns {Object} Returns `object`. + * @see _.assignInWith + * @example + * + * function customizer(objValue, srcValue) { + * return _.isUndefined(objValue) ? srcValue : objValue; + * } + * + * var defaults = _.partialRight(_.assignWith, customizer); + * + * defaults({ 'a': 1 }, { 'b': 2 }, { 'a': 3 }); + * // => { 'a': 1, 'b': 2 } + */ + var assignWith = createAssigner(function(object, source, srcIndex, customizer) { + copyObject(source, keys(source), object, customizer); + }); + + /** + * Creates an array of values corresponding to `paths` of `object`. + * + * @static + * @memberOf _ + * @since 1.0.0 + * @category Object + * @param {Object} object The object to iterate over. + * @param {...(string|string[])} [paths] The property paths to pick. + * @returns {Array} Returns the picked values. + * @example + * + * var object = { 'a': [{ 'b': { 'c': 3 } }, 4] }; + * + * _.at(object, ['a[0].b.c', 'a[1]']); + * // => [3, 4] + */ + var at = flatRest(baseAt); + + /** + * Creates an object that inherits from the `prototype` object. If a + * `properties` object is given, its own enumerable string keyed properties + * are assigned to the created object. + * + * @static + * @memberOf _ + * @since 2.3.0 + * @category Object + * @param {Object} prototype The object to inherit from. + * @param {Object} [properties] The properties to assign to the object. + * @returns {Object} Returns the new object. + * @example + * + * function Shape() { + * this.x = 0; + * this.y = 0; + * } + * + * function Circle() { + * Shape.call(this); + * } + * + * Circle.prototype = _.create(Shape.prototype, { + * 'constructor': Circle + * }); + * + * var circle = new Circle; + * circle instanceof Circle; + * // => true + * + * circle instanceof Shape; + * // => true + */ + function create(prototype, properties) { + var result = baseCreate(prototype); + return properties == null ? result : baseAssign(result, properties); + } + + /** + * Assigns own and inherited enumerable string keyed properties of source + * objects to the destination object for all destination properties that + * resolve to `undefined`. Source objects are applied from left to right. + * Once a property is set, additional values of the same property are ignored. + * + * **Note:** This method mutates `object`. + * + * @static + * @since 0.1.0 + * @memberOf _ + * @category Object + * @param {Object} object The destination object. + * @param {...Object} [sources] The source objects. + * @returns {Object} Returns `object`. + * @see _.defaultsDeep + * @example + * + * _.defaults({ 'a': 1 }, { 'b': 2 }, { 'a': 3 }); + * // => { 'a': 1, 'b': 2 } + */ + var defaults = baseRest(function(object, sources) { + object = Object(object); + + var index = -1; + var length = sources.length; + var guard = length > 2 ? sources[2] : undefined; + + if (guard && isIterateeCall(sources[0], sources[1], guard)) { + length = 1; + } + + while (++index < length) { + var source = sources[index]; + var props = keysIn(source); + var propsIndex = -1; + var propsLength = props.length; + + while (++propsIndex < propsLength) { + var key = props[propsIndex]; + var value = object[key]; + + if (value === undefined || + (eq(value, objectProto[key]) && !hasOwnProperty.call(object, key))) { + object[key] = source[key]; + } + } + } + + return object; + }); + + /** + * This method is like `_.defaults` except that it recursively assigns + * default properties. + * + * **Note:** This method mutates `object`. + * + * @static + * @memberOf _ + * @since 3.10.0 + * @category Object + * @param {Object} object The destination object. + * @param {...Object} [sources] The source objects. + * @returns {Object} Returns `object`. + * @see _.defaults + * @example + * + * _.defaultsDeep({ 'a': { 'b': 2 } }, { 'a': { 'b': 1, 'c': 3 } }); + * // => { 'a': { 'b': 2, 'c': 3 } } + */ + var defaultsDeep = baseRest(function(args) { + args.push(undefined, customDefaultsMerge); + return apply(mergeWith, undefined, args); + }); + + /** + * This method is like `_.find` except that it returns the key of the first + * element `predicate` returns truthy for instead of the element itself. + * + * @static + * @memberOf _ + * @since 1.1.0 + * @category Object + * @param {Object} object The object to inspect. + * @param {Function} [predicate=_.identity] The function invoked per iteration. + * @returns {string|undefined} Returns the key of the matched element, + * else `undefined`. + * @example + * + * var users = { + * 'barney': { 'age': 36, 'active': true }, + * 'fred': { 'age': 40, 'active': false }, + * 'pebbles': { 'age': 1, 'active': true } + * }; + * + * _.findKey(users, function(o) { return o.age < 40; }); + * // => 'barney' (iteration order is not guaranteed) + * + * // The `_.matches` iteratee shorthand. + * _.findKey(users, { 'age': 1, 'active': true }); + * // => 'pebbles' + * + * // The `_.matchesProperty` iteratee shorthand. + * _.findKey(users, ['active', false]); + * // => 'fred' + * + * // The `_.property` iteratee shorthand. + * _.findKey(users, 'active'); + * // => 'barney' + */ + function findKey(object, predicate) { + return baseFindKey(object, getIteratee(predicate, 3), baseForOwn); + } + + /** + * This method is like `_.findKey` except that it iterates over elements of + * a collection in the opposite order. + * + * @static + * @memberOf _ + * @since 2.0.0 + * @category Object + * @param {Object} object The object to inspect. + * @param {Function} [predicate=_.identity] The function invoked per iteration. + * @returns {string|undefined} Returns the key of the matched element, + * else `undefined`. + * @example + * + * var users = { + * 'barney': { 'age': 36, 'active': true }, + * 'fred': { 'age': 40, 'active': false }, + * 'pebbles': { 'age': 1, 'active': true } + * }; + * + * _.findLastKey(users, function(o) { return o.age < 40; }); + * // => returns 'pebbles' assuming `_.findKey` returns 'barney' + * + * // The `_.matches` iteratee shorthand. + * _.findLastKey(users, { 'age': 36, 'active': true }); + * // => 'barney' + * + * // The `_.matchesProperty` iteratee shorthand. + * _.findLastKey(users, ['active', false]); + * // => 'fred' + * + * // The `_.property` iteratee shorthand. + * _.findLastKey(users, 'active'); + * // => 'pebbles' + */ + function findLastKey(object, predicate) { + return baseFindKey(object, getIteratee(predicate, 3), baseForOwnRight); + } + + /** + * Iterates over own and inherited enumerable string keyed properties of an + * object and invokes `iteratee` for each property. The iteratee is invoked + * with three arguments: (value, key, object). Iteratee functions may exit + * iteration early by explicitly returning `false`. + * + * @static + * @memberOf _ + * @since 0.3.0 + * @category Object + * @param {Object} object The object to iterate over. + * @param {Function} [iteratee=_.identity] The function invoked per iteration. + * @returns {Object} Returns `object`. + * @see _.forInRight + * @example + * + * function Foo() { + * this.a = 1; + * this.b = 2; + * } + * + * Foo.prototype.c = 3; + * + * _.forIn(new Foo, function(value, key) { + * console.log(key); + * }); + * // => Logs 'a', 'b', then 'c' (iteration order is not guaranteed). + */ + function forIn(object, iteratee) { + return object == null + ? object + : baseFor(object, getIteratee(iteratee, 3), keysIn); + } + + /** + * This method is like `_.forIn` except that it iterates over properties of + * `object` in the opposite order. + * + * @static + * @memberOf _ + * @since 2.0.0 + * @category Object + * @param {Object} object The object to iterate over. + * @param {Function} [iteratee=_.identity] The function invoked per iteration. + * @returns {Object} Returns `object`. + * @see _.forIn + * @example + * + * function Foo() { + * this.a = 1; + * this.b = 2; + * } + * + * Foo.prototype.c = 3; + * + * _.forInRight(new Foo, function(value, key) { + * console.log(key); + * }); + * // => Logs 'c', 'b', then 'a' assuming `_.forIn` logs 'a', 'b', then 'c'. + */ + function forInRight(object, iteratee) { + return object == null + ? object + : baseForRight(object, getIteratee(iteratee, 3), keysIn); + } + + /** + * Iterates over own enumerable string keyed properties of an object and + * invokes `iteratee` for each property. The iteratee is invoked with three + * arguments: (value, key, object). Iteratee functions may exit iteration + * early by explicitly returning `false`. + * + * @static + * @memberOf _ + * @since 0.3.0 + * @category Object + * @param {Object} object The object to iterate over. + * @param {Function} [iteratee=_.identity] The function invoked per iteration. + * @returns {Object} Returns `object`. + * @see _.forOwnRight + * @example + * + * function Foo() { + * this.a = 1; + * this.b = 2; + * } + * + * Foo.prototype.c = 3; + * + * _.forOwn(new Foo, function(value, key) { + * console.log(key); + * }); + * // => Logs 'a' then 'b' (iteration order is not guaranteed). + */ + function forOwn(object, iteratee) { + return object && baseForOwn(object, getIteratee(iteratee, 3)); + } + + /** + * This method is like `_.forOwn` except that it iterates over properties of + * `object` in the opposite order. + * + * @static + * @memberOf _ + * @since 2.0.0 + * @category Object + * @param {Object} object The object to iterate over. + * @param {Function} [iteratee=_.identity] The function invoked per iteration. + * @returns {Object} Returns `object`. + * @see _.forOwn + * @example + * + * function Foo() { + * this.a = 1; + * this.b = 2; + * } + * + * Foo.prototype.c = 3; + * + * _.forOwnRight(new Foo, function(value, key) { + * console.log(key); + * }); + * // => Logs 'b' then 'a' assuming `_.forOwn` logs 'a' then 'b'. + */ + function forOwnRight(object, iteratee) { + return object && baseForOwnRight(object, getIteratee(iteratee, 3)); + } + + /** + * Creates an array of function property names from own enumerable properties + * of `object`. + * + * @static + * @since 0.1.0 + * @memberOf _ + * @category Object + * @param {Object} object The object to inspect. + * @returns {Array} Returns the function names. + * @see _.functionsIn + * @example + * + * function Foo() { + * this.a = _.constant('a'); + * this.b = _.constant('b'); + * } + * + * Foo.prototype.c = _.constant('c'); + * + * _.functions(new Foo); + * // => ['a', 'b'] + */ + function functions(object) { + return object == null ? [] : baseFunctions(object, keys(object)); + } + + /** + * Creates an array of function property names from own and inherited + * enumerable properties of `object`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Object + * @param {Object} object The object to inspect. + * @returns {Array} Returns the function names. + * @see _.functions + * @example + * + * function Foo() { + * this.a = _.constant('a'); + * this.b = _.constant('b'); + * } + * + * Foo.prototype.c = _.constant('c'); + * + * _.functionsIn(new Foo); + * // => ['a', 'b', 'c'] + */ + function functionsIn(object) { + return object == null ? [] : baseFunctions(object, keysIn(object)); + } + + /** + * Gets the value at `path` of `object`. If the resolved value is + * `undefined`, the `defaultValue` is returned in its place. + * + * @static + * @memberOf _ + * @since 3.7.0 + * @category Object + * @param {Object} object The object to query. + * @param {Array|string} path The path of the property to get. + * @param {*} [defaultValue] The value returned for `undefined` resolved values. + * @returns {*} Returns the resolved value. + * @example + * + * var object = { 'a': [{ 'b': { 'c': 3 } }] }; + * + * _.get(object, 'a[0].b.c'); + * // => 3 + * + * _.get(object, ['a', '0', 'b', 'c']); + * // => 3 + * + * _.get(object, 'a.b.c', 'default'); + * // => 'default' + */ + function get(object, path, defaultValue) { + var result = object == null ? undefined : baseGet(object, path); + return result === undefined ? defaultValue : result; + } + + /** + * Checks if `path` is a direct property of `object`. + * + * @static + * @since 0.1.0 + * @memberOf _ + * @category Object + * @param {Object} object The object to query. + * @param {Array|string} path The path to check. + * @returns {boolean} Returns `true` if `path` exists, else `false`. + * @example + * + * var object = { 'a': { 'b': 2 } }; + * var other = _.create({ 'a': _.create({ 'b': 2 }) }); + * + * _.has(object, 'a'); + * // => true + * + * _.has(object, 'a.b'); + * // => true + * + * _.has(object, ['a', 'b']); + * // => true + * + * _.has(other, 'a'); + * // => false + */ + function has(object, path) { + return object != null && hasPath(object, path, baseHas); + } + + /** + * Checks if `path` is a direct or inherited property of `object`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Object + * @param {Object} object The object to query. + * @param {Array|string} path The path to check. + * @returns {boolean} Returns `true` if `path` exists, else `false`. + * @example + * + * var object = _.create({ 'a': _.create({ 'b': 2 }) }); + * + * _.hasIn(object, 'a'); + * // => true + * + * _.hasIn(object, 'a.b'); + * // => true + * + * _.hasIn(object, ['a', 'b']); + * // => true + * + * _.hasIn(object, 'b'); + * // => false + */ + function hasIn(object, path) { + return object != null && hasPath(object, path, baseHasIn); + } + + /** + * Creates an object composed of the inverted keys and values of `object`. + * If `object` contains duplicate values, subsequent values overwrite + * property assignments of previous values. + * + * @static + * @memberOf _ + * @since 0.7.0 + * @category Object + * @param {Object} object The object to invert. + * @returns {Object} Returns the new inverted object. + * @example + * + * var object = { 'a': 1, 'b': 2, 'c': 1 }; + * + * _.invert(object); + * // => { '1': 'c', '2': 'b' } + */ + var invert = createInverter(function(result, value, key) { + if (value != null && + typeof value.toString != 'function') { + value = nativeObjectToString.call(value); + } + + result[value] = key; + }, constant(identity)); + + /** + * This method is like `_.invert` except that the inverted object is generated + * from the results of running each element of `object` thru `iteratee`. The + * corresponding inverted value of each inverted key is an array of keys + * responsible for generating the inverted value. The iteratee is invoked + * with one argument: (value). + * + * @static + * @memberOf _ + * @since 4.1.0 + * @category Object + * @param {Object} object The object to invert. + * @param {Function} [iteratee=_.identity] The iteratee invoked per element. + * @returns {Object} Returns the new inverted object. + * @example + * + * var object = { 'a': 1, 'b': 2, 'c': 1 }; + * + * _.invertBy(object); + * // => { '1': ['a', 'c'], '2': ['b'] } + * + * _.invertBy(object, function(value) { + * return 'group' + value; + * }); + * // => { 'group1': ['a', 'c'], 'group2': ['b'] } + */ + var invertBy = createInverter(function(result, value, key) { + if (value != null && + typeof value.toString != 'function') { + value = nativeObjectToString.call(value); + } + + if (hasOwnProperty.call(result, value)) { + result[value].push(key); + } else { + result[value] = [key]; + } + }, getIteratee); + + /** + * Invokes the method at `path` of `object`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Object + * @param {Object} object The object to query. + * @param {Array|string} path The path of the method to invoke. + * @param {...*} [args] The arguments to invoke the method with. + * @returns {*} Returns the result of the invoked method. + * @example + * + * var object = { 'a': [{ 'b': { 'c': [1, 2, 3, 4] } }] }; + * + * _.invoke(object, 'a[0].b.c.slice', 1, 3); + * // => [2, 3] + */ + var invoke = baseRest(baseInvoke); + + /** + * Creates an array of the own enumerable property names of `object`. + * + * **Note:** Non-object values are coerced to objects. See the + * [ES spec](http://ecma-international.org/ecma-262/7.0/#sec-object.keys) + * for more details. + * + * @static + * @since 0.1.0 + * @memberOf _ + * @category Object + * @param {Object} object The object to query. + * @returns {Array} Returns the array of property names. + * @example + * + * function Foo() { + * this.a = 1; + * this.b = 2; + * } + * + * Foo.prototype.c = 3; + * + * _.keys(new Foo); + * // => ['a', 'b'] (iteration order is not guaranteed) + * + * _.keys('hi'); + * // => ['0', '1'] + */ + function keys(object) { + return isArrayLike(object) ? arrayLikeKeys(object) : baseKeys(object); + } + + /** + * Creates an array of the own and inherited enumerable property names of `object`. + * + * **Note:** Non-object values are coerced to objects. + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category Object + * @param {Object} object The object to query. + * @returns {Array} Returns the array of property names. + * @example + * + * function Foo() { + * this.a = 1; + * this.b = 2; + * } + * + * Foo.prototype.c = 3; + * + * _.keysIn(new Foo); + * // => ['a', 'b', 'c'] (iteration order is not guaranteed) + */ + function keysIn(object) { + return isArrayLike(object) ? arrayLikeKeys(object, true) : baseKeysIn(object); + } + + /** + * The opposite of `_.mapValues`; this method creates an object with the + * same values as `object` and keys generated by running each own enumerable + * string keyed property of `object` thru `iteratee`. The iteratee is invoked + * with three arguments: (value, key, object). + * + * @static + * @memberOf _ + * @since 3.8.0 + * @category Object + * @param {Object} object The object to iterate over. + * @param {Function} [iteratee=_.identity] The function invoked per iteration. + * @returns {Object} Returns the new mapped object. + * @see _.mapValues + * @example + * + * _.mapKeys({ 'a': 1, 'b': 2 }, function(value, key) { + * return key + value; + * }); + * // => { 'a1': 1, 'b2': 2 } + */ + function mapKeys(object, iteratee) { + var result = {}; + iteratee = getIteratee(iteratee, 3); + + baseForOwn(object, function(value, key, object) { + baseAssignValue(result, iteratee(value, key, object), value); + }); + return result; + } + + /** + * Creates an object with the same keys as `object` and values generated + * by running each own enumerable string keyed property of `object` thru + * `iteratee`. The iteratee is invoked with three arguments: + * (value, key, object). + * + * @static + * @memberOf _ + * @since 2.4.0 + * @category Object + * @param {Object} object The object to iterate over. + * @param {Function} [iteratee=_.identity] The function invoked per iteration. + * @returns {Object} Returns the new mapped object. + * @see _.mapKeys + * @example + * + * var users = { + * 'fred': { 'user': 'fred', 'age': 40 }, + * 'pebbles': { 'user': 'pebbles', 'age': 1 } + * }; + * + * _.mapValues(users, function(o) { return o.age; }); + * // => { 'fred': 40, 'pebbles': 1 } (iteration order is not guaranteed) + * + * // The `_.property` iteratee shorthand. + * _.mapValues(users, 'age'); + * // => { 'fred': 40, 'pebbles': 1 } (iteration order is not guaranteed) + */ + function mapValues(object, iteratee) { + var result = {}; + iteratee = getIteratee(iteratee, 3); + + baseForOwn(object, function(value, key, object) { + baseAssignValue(result, key, iteratee(value, key, object)); + }); + return result; + } + + /** + * This method is like `_.assign` except that it recursively merges own and + * inherited enumerable string keyed properties of source objects into the + * destination object. Source properties that resolve to `undefined` are + * skipped if a destination value exists. Array and plain object properties + * are merged recursively. Other objects and value types are overridden by + * assignment. Source objects are applied from left to right. Subsequent + * sources overwrite property assignments of previous sources. + * + * **Note:** This method mutates `object`. + * + * @static + * @memberOf _ + * @since 0.5.0 + * @category Object + * @param {Object} object The destination object. + * @param {...Object} [sources] The source objects. + * @returns {Object} Returns `object`. + * @example + * + * var object = { + * 'a': [{ 'b': 2 }, { 'd': 4 }] + * }; + * + * var other = { + * 'a': [{ 'c': 3 }, { 'e': 5 }] + * }; + * + * _.merge(object, other); + * // => { 'a': [{ 'b': 2, 'c': 3 }, { 'd': 4, 'e': 5 }] } + */ + var merge = createAssigner(function(object, source, srcIndex) { + baseMerge(object, source, srcIndex); + }); + + /** + * This method is like `_.merge` except that it accepts `customizer` which + * is invoked to produce the merged values of the destination and source + * properties. If `customizer` returns `undefined`, merging is handled by the + * method instead. The `customizer` is invoked with six arguments: + * (objValue, srcValue, key, object, source, stack). + * + * **Note:** This method mutates `object`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Object + * @param {Object} object The destination object. + * @param {...Object} sources The source objects. + * @param {Function} customizer The function to customize assigned values. + * @returns {Object} Returns `object`. + * @example + * + * function customizer(objValue, srcValue) { + * if (_.isArray(objValue)) { + * return objValue.concat(srcValue); + * } + * } + * + * var object = { 'a': [1], 'b': [2] }; + * var other = { 'a': [3], 'b': [4] }; + * + * _.mergeWith(object, other, customizer); + * // => { 'a': [1, 3], 'b': [2, 4] } + */ + var mergeWith = createAssigner(function(object, source, srcIndex, customizer) { + baseMerge(object, source, srcIndex, customizer); + }); + + /** + * The opposite of `_.pick`; this method creates an object composed of the + * own and inherited enumerable property paths of `object` that are not omitted. + * + * **Note:** This method is considerably slower than `_.pick`. + * + * @static + * @since 0.1.0 + * @memberOf _ + * @category Object + * @param {Object} object The source object. + * @param {...(string|string[])} [paths] The property paths to omit. + * @returns {Object} Returns the new object. + * @example + * + * var object = { 'a': 1, 'b': '2', 'c': 3 }; + * + * _.omit(object, ['a', 'c']); + * // => { 'b': '2' } + */ + var omit = flatRest(function(object, paths) { + var result = {}; + if (object == null) { + return result; + } + var isDeep = false; + paths = arrayMap(paths, function(path) { + path = castPath(path, object); + isDeep || (isDeep = path.length > 1); + return path; + }); + copyObject(object, getAllKeysIn(object), result); + if (isDeep) { + result = baseClone(result, CLONE_DEEP_FLAG | CLONE_FLAT_FLAG | CLONE_SYMBOLS_FLAG, customOmitClone); + } + var length = paths.length; + while (length--) { + baseUnset(result, paths[length]); + } + return result; + }); + + /** + * The opposite of `_.pickBy`; this method creates an object composed of + * the own and inherited enumerable string keyed properties of `object` that + * `predicate` doesn't return truthy for. The predicate is invoked with two + * arguments: (value, key). + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Object + * @param {Object} object The source object. + * @param {Function} [predicate=_.identity] The function invoked per property. + * @returns {Object} Returns the new object. + * @example + * + * var object = { 'a': 1, 'b': '2', 'c': 3 }; + * + * _.omitBy(object, _.isNumber); + * // => { 'b': '2' } + */ + function omitBy(object, predicate) { + return pickBy(object, negate(getIteratee(predicate))); + } + + /** + * Creates an object composed of the picked `object` properties. + * + * @static + * @since 0.1.0 + * @memberOf _ + * @category Object + * @param {Object} object The source object. + * @param {...(string|string[])} [paths] The property paths to pick. + * @returns {Object} Returns the new object. + * @example + * + * var object = { 'a': 1, 'b': '2', 'c': 3 }; + * + * _.pick(object, ['a', 'c']); + * // => { 'a': 1, 'c': 3 } + */ + var pick = flatRest(function(object, paths) { + return object == null ? {} : basePick(object, paths); + }); + + /** + * Creates an object composed of the `object` properties `predicate` returns + * truthy for. The predicate is invoked with two arguments: (value, key). + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Object + * @param {Object} object The source object. + * @param {Function} [predicate=_.identity] The function invoked per property. + * @returns {Object} Returns the new object. + * @example + * + * var object = { 'a': 1, 'b': '2', 'c': 3 }; + * + * _.pickBy(object, _.isNumber); + * // => { 'a': 1, 'c': 3 } + */ + function pickBy(object, predicate) { + if (object == null) { + return {}; + } + var props = arrayMap(getAllKeysIn(object), function(prop) { + return [prop]; + }); + predicate = getIteratee(predicate); + return basePickBy(object, props, function(value, path) { + return predicate(value, path[0]); + }); + } + + /** + * This method is like `_.get` except that if the resolved value is a + * function it's invoked with the `this` binding of its parent object and + * its result is returned. + * + * @static + * @since 0.1.0 + * @memberOf _ + * @category Object + * @param {Object} object The object to query. + * @param {Array|string} path The path of the property to resolve. + * @param {*} [defaultValue] The value returned for `undefined` resolved values. + * @returns {*} Returns the resolved value. + * @example + * + * var object = { 'a': [{ 'b': { 'c1': 3, 'c2': _.constant(4) } }] }; + * + * _.result(object, 'a[0].b.c1'); + * // => 3 + * + * _.result(object, 'a[0].b.c2'); + * // => 4 + * + * _.result(object, 'a[0].b.c3', 'default'); + * // => 'default' + * + * _.result(object, 'a[0].b.c3', _.constant('default')); + * // => 'default' + */ + function result(object, path, defaultValue) { + path = castPath(path, object); + + var index = -1, + length = path.length; + + // Ensure the loop is entered when path is empty. + if (!length) { + length = 1; + object = undefined; + } + while (++index < length) { + var value = object == null ? undefined : object[toKey(path[index])]; + if (value === undefined) { + index = length; + value = defaultValue; + } + object = isFunction(value) ? value.call(object) : value; + } + return object; + } + + /** + * Sets the value at `path` of `object`. If a portion of `path` doesn't exist, + * it's created. Arrays are created for missing index properties while objects + * are created for all other missing properties. Use `_.setWith` to customize + * `path` creation. + * + * **Note:** This method mutates `object`. + * + * @static + * @memberOf _ + * @since 3.7.0 + * @category Object + * @param {Object} object The object to modify. + * @param {Array|string} path The path of the property to set. + * @param {*} value The value to set. + * @returns {Object} Returns `object`. + * @example + * + * var object = { 'a': [{ 'b': { 'c': 3 } }] }; + * + * _.set(object, 'a[0].b.c', 4); + * console.log(object.a[0].b.c); + * // => 4 + * + * _.set(object, ['x', '0', 'y', 'z'], 5); + * console.log(object.x[0].y.z); + * // => 5 + */ + function set(object, path, value) { + return object == null ? object : baseSet(object, path, value); + } + + /** + * This method is like `_.set` except that it accepts `customizer` which is + * invoked to produce the objects of `path`. If `customizer` returns `undefined` + * path creation is handled by the method instead. The `customizer` is invoked + * with three arguments: (nsValue, key, nsObject). + * + * **Note:** This method mutates `object`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Object + * @param {Object} object The object to modify. + * @param {Array|string} path The path of the property to set. + * @param {*} value The value to set. + * @param {Function} [customizer] The function to customize assigned values. + * @returns {Object} Returns `object`. + * @example + * + * var object = {}; + * + * _.setWith(object, '[0][1]', 'a', Object); + * // => { '0': { '1': 'a' } } + */ + function setWith(object, path, value, customizer) { + customizer = typeof customizer == 'function' ? customizer : undefined; + return object == null ? object : baseSet(object, path, value, customizer); + } + + /** + * Creates an array of own enumerable string keyed-value pairs for `object` + * which can be consumed by `_.fromPairs`. If `object` is a map or set, its + * entries are returned. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @alias entries + * @category Object + * @param {Object} object The object to query. + * @returns {Array} Returns the key-value pairs. + * @example + * + * function Foo() { + * this.a = 1; + * this.b = 2; + * } + * + * Foo.prototype.c = 3; + * + * _.toPairs(new Foo); + * // => [['a', 1], ['b', 2]] (iteration order is not guaranteed) + */ + var toPairs = createToPairs(keys); + + /** + * Creates an array of own and inherited enumerable string keyed-value pairs + * for `object` which can be consumed by `_.fromPairs`. If `object` is a map + * or set, its entries are returned. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @alias entriesIn + * @category Object + * @param {Object} object The object to query. + * @returns {Array} Returns the key-value pairs. + * @example + * + * function Foo() { + * this.a = 1; + * this.b = 2; + * } + * + * Foo.prototype.c = 3; + * + * _.toPairsIn(new Foo); + * // => [['a', 1], ['b', 2], ['c', 3]] (iteration order is not guaranteed) + */ + var toPairsIn = createToPairs(keysIn); + + /** + * An alternative to `_.reduce`; this method transforms `object` to a new + * `accumulator` object which is the result of running each of its own + * enumerable string keyed properties thru `iteratee`, with each invocation + * potentially mutating the `accumulator` object. If `accumulator` is not + * provided, a new object with the same `[[Prototype]]` will be used. The + * iteratee is invoked with four arguments: (accumulator, value, key, object). + * Iteratee functions may exit iteration early by explicitly returning `false`. + * + * @static + * @memberOf _ + * @since 1.3.0 + * @category Object + * @param {Object} object The object to iterate over. + * @param {Function} [iteratee=_.identity] The function invoked per iteration. + * @param {*} [accumulator] The custom accumulator value. + * @returns {*} Returns the accumulated value. + * @example + * + * _.transform([2, 3, 4], function(result, n) { + * result.push(n *= n); + * return n % 2 == 0; + * }, []); + * // => [4, 9] + * + * _.transform({ 'a': 1, 'b': 2, 'c': 1 }, function(result, value, key) { + * (result[value] || (result[value] = [])).push(key); + * }, {}); + * // => { '1': ['a', 'c'], '2': ['b'] } + */ + function transform(object, iteratee, accumulator) { + var isArr = isArray(object), + isArrLike = isArr || isBuffer(object) || isTypedArray(object); + + iteratee = getIteratee(iteratee, 4); + if (accumulator == null) { + var Ctor = object && object.constructor; + if (isArrLike) { + accumulator = isArr ? new Ctor : []; + } + else if (isObject(object)) { + accumulator = isFunction(Ctor) ? baseCreate(getPrototype(object)) : {}; + } + else { + accumulator = {}; + } + } + (isArrLike ? arrayEach : baseForOwn)(object, function(value, index, object) { + return iteratee(accumulator, value, index, object); + }); + return accumulator; + } + + /** + * Removes the property at `path` of `object`. + * + * **Note:** This method mutates `object`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Object + * @param {Object} object The object to modify. + * @param {Array|string} path The path of the property to unset. + * @returns {boolean} Returns `true` if the property is deleted, else `false`. + * @example + * + * var object = { 'a': [{ 'b': { 'c': 7 } }] }; + * _.unset(object, 'a[0].b.c'); + * // => true + * + * console.log(object); + * // => { 'a': [{ 'b': {} }] }; + * + * _.unset(object, ['a', '0', 'b', 'c']); + * // => true + * + * console.log(object); + * // => { 'a': [{ 'b': {} }] }; + */ + function unset(object, path) { + return object == null ? true : baseUnset(object, path); + } + + /** + * This method is like `_.set` except that accepts `updater` to produce the + * value to set. Use `_.updateWith` to customize `path` creation. The `updater` + * is invoked with one argument: (value). + * + * **Note:** This method mutates `object`. + * + * @static + * @memberOf _ + * @since 4.6.0 + * @category Object + * @param {Object} object The object to modify. + * @param {Array|string} path The path of the property to set. + * @param {Function} updater The function to produce the updated value. + * @returns {Object} Returns `object`. + * @example + * + * var object = { 'a': [{ 'b': { 'c': 3 } }] }; + * + * _.update(object, 'a[0].b.c', function(n) { return n * n; }); + * console.log(object.a[0].b.c); + * // => 9 + * + * _.update(object, 'x[0].y.z', function(n) { return n ? n + 1 : 0; }); + * console.log(object.x[0].y.z); + * // => 0 + */ + function update(object, path, updater) { + return object == null ? object : baseUpdate(object, path, castFunction(updater)); + } + + /** + * This method is like `_.update` except that it accepts `customizer` which is + * invoked to produce the objects of `path`. If `customizer` returns `undefined` + * path creation is handled by the method instead. The `customizer` is invoked + * with three arguments: (nsValue, key, nsObject). + * + * **Note:** This method mutates `object`. + * + * @static + * @memberOf _ + * @since 4.6.0 + * @category Object + * @param {Object} object The object to modify. + * @param {Array|string} path The path of the property to set. + * @param {Function} updater The function to produce the updated value. + * @param {Function} [customizer] The function to customize assigned values. + * @returns {Object} Returns `object`. + * @example + * + * var object = {}; + * + * _.updateWith(object, '[0][1]', _.constant('a'), Object); + * // => { '0': { '1': 'a' } } + */ + function updateWith(object, path, updater, customizer) { + customizer = typeof customizer == 'function' ? customizer : undefined; + return object == null ? object : baseUpdate(object, path, castFunction(updater), customizer); + } + + /** + * Creates an array of the own enumerable string keyed property values of `object`. + * + * **Note:** Non-object values are coerced to objects. + * + * @static + * @since 0.1.0 + * @memberOf _ + * @category Object + * @param {Object} object The object to query. + * @returns {Array} Returns the array of property values. + * @example + * + * function Foo() { + * this.a = 1; + * this.b = 2; + * } + * + * Foo.prototype.c = 3; + * + * _.values(new Foo); + * // => [1, 2] (iteration order is not guaranteed) + * + * _.values('hi'); + * // => ['h', 'i'] + */ + function values(object) { + return object == null ? [] : baseValues(object, keys(object)); + } + + /** + * Creates an array of the own and inherited enumerable string keyed property + * values of `object`. + * + * **Note:** Non-object values are coerced to objects. + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category Object + * @param {Object} object The object to query. + * @returns {Array} Returns the array of property values. + * @example + * + * function Foo() { + * this.a = 1; + * this.b = 2; + * } + * + * Foo.prototype.c = 3; + * + * _.valuesIn(new Foo); + * // => [1, 2, 3] (iteration order is not guaranteed) + */ + function valuesIn(object) { + return object == null ? [] : baseValues(object, keysIn(object)); + } + + /*------------------------------------------------------------------------*/ + + /** + * Clamps `number` within the inclusive `lower` and `upper` bounds. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category Number + * @param {number} number The number to clamp. + * @param {number} [lower] The lower bound. + * @param {number} upper The upper bound. + * @returns {number} Returns the clamped number. + * @example + * + * _.clamp(-10, -5, 5); + * // => -5 + * + * _.clamp(10, -5, 5); + * // => 5 + */ + function clamp(number, lower, upper) { + if (upper === undefined) { + upper = lower; + lower = undefined; + } + if (upper !== undefined) { + upper = toNumber(upper); + upper = upper === upper ? upper : 0; + } + if (lower !== undefined) { + lower = toNumber(lower); + lower = lower === lower ? lower : 0; + } + return baseClamp(toNumber(number), lower, upper); + } + + /** + * Checks if `n` is between `start` and up to, but not including, `end`. If + * `end` is not specified, it's set to `start` with `start` then set to `0`. + * If `start` is greater than `end` the params are swapped to support + * negative ranges. + * + * @static + * @memberOf _ + * @since 3.3.0 + * @category Number + * @param {number} number The number to check. + * @param {number} [start=0] The start of the range. + * @param {number} end The end of the range. + * @returns {boolean} Returns `true` if `number` is in the range, else `false`. + * @see _.range, _.rangeRight + * @example + * + * _.inRange(3, 2, 4); + * // => true + * + * _.inRange(4, 8); + * // => true + * + * _.inRange(4, 2); + * // => false + * + * _.inRange(2, 2); + * // => false + * + * _.inRange(1.2, 2); + * // => true + * + * _.inRange(5.2, 4); + * // => false + * + * _.inRange(-3, -2, -6); + * // => true + */ + function inRange(number, start, end) { + start = toFinite(start); + if (end === undefined) { + end = start; + start = 0; + } else { + end = toFinite(end); + } + number = toNumber(number); + return baseInRange(number, start, end); + } + + /** + * Produces a random number between the inclusive `lower` and `upper` bounds. + * If only one argument is provided a number between `0` and the given number + * is returned. If `floating` is `true`, or either `lower` or `upper` are + * floats, a floating-point number is returned instead of an integer. + * + * **Note:** JavaScript follows the IEEE-754 standard for resolving + * floating-point values which can produce unexpected results. + * + * @static + * @memberOf _ + * @since 0.7.0 + * @category Number + * @param {number} [lower=0] The lower bound. + * @param {number} [upper=1] The upper bound. + * @param {boolean} [floating] Specify returning a floating-point number. + * @returns {number} Returns the random number. + * @example + * + * _.random(0, 5); + * // => an integer between 0 and 5 + * + * _.random(5); + * // => also an integer between 0 and 5 + * + * _.random(5, true); + * // => a floating-point number between 0 and 5 + * + * _.random(1.2, 5.2); + * // => a floating-point number between 1.2 and 5.2 + */ + function random(lower, upper, floating) { + if (floating && typeof floating != 'boolean' && isIterateeCall(lower, upper, floating)) { + upper = floating = undefined; + } + if (floating === undefined) { + if (typeof upper == 'boolean') { + floating = upper; + upper = undefined; + } + else if (typeof lower == 'boolean') { + floating = lower; + lower = undefined; + } + } + if (lower === undefined && upper === undefined) { + lower = 0; + upper = 1; + } + else { + lower = toFinite(lower); + if (upper === undefined) { + upper = lower; + lower = 0; + } else { + upper = toFinite(upper); + } + } + if (lower > upper) { + var temp = lower; + lower = upper; + upper = temp; + } + if (floating || lower % 1 || upper % 1) { + var rand = nativeRandom(); + return nativeMin(lower + (rand * (upper - lower + freeParseFloat('1e-' + ((rand + '').length - 1)))), upper); + } + return baseRandom(lower, upper); + } + + /*------------------------------------------------------------------------*/ + + /** + * Converts `string` to [camel case](https://en.wikipedia.org/wiki/CamelCase). + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category String + * @param {string} [string=''] The string to convert. + * @returns {string} Returns the camel cased string. + * @example + * + * _.camelCase('Foo Bar'); + * // => 'fooBar' + * + * _.camelCase('--foo-bar--'); + * // => 'fooBar' + * + * _.camelCase('__FOO_BAR__'); + * // => 'fooBar' + */ + var camelCase = createCompounder(function(result, word, index) { + word = word.toLowerCase(); + return result + (index ? capitalize(word) : word); + }); + + /** + * Converts the first character of `string` to upper case and the remaining + * to lower case. + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category String + * @param {string} [string=''] The string to capitalize. + * @returns {string} Returns the capitalized string. + * @example + * + * _.capitalize('FRED'); + * // => 'Fred' + */ + function capitalize(string) { + return upperFirst(toString(string).toLowerCase()); + } + + /** + * Deburrs `string` by converting + * [Latin-1 Supplement](https://en.wikipedia.org/wiki/Latin-1_Supplement_(Unicode_block)#Character_table) + * and [Latin Extended-A](https://en.wikipedia.org/wiki/Latin_Extended-A) + * letters to basic Latin letters and removing + * [combining diacritical marks](https://en.wikipedia.org/wiki/Combining_Diacritical_Marks). + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category String + * @param {string} [string=''] The string to deburr. + * @returns {string} Returns the deburred string. + * @example + * + * _.deburr('déjà vu'); + * // => 'deja vu' + */ + function deburr(string) { + string = toString(string); + return string && string.replace(reLatin, deburrLetter).replace(reComboMark, ''); + } + + /** + * Checks if `string` ends with the given target string. + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category String + * @param {string} [string=''] The string to inspect. + * @param {string} [target] The string to search for. + * @param {number} [position=string.length] The position to search up to. + * @returns {boolean} Returns `true` if `string` ends with `target`, + * else `false`. + * @example + * + * _.endsWith('abc', 'c'); + * // => true + * + * _.endsWith('abc', 'b'); + * // => false + * + * _.endsWith('abc', 'b', 2); + * // => true + */ + function endsWith(string, target, position) { + string = toString(string); + target = baseToString(target); + + var length = string.length; + position = position === undefined + ? length + : baseClamp(toInteger(position), 0, length); + + var end = position; + position -= target.length; + return position >= 0 && string.slice(position, end) == target; + } + + /** + * Converts the characters "&", "<", ">", '"', and "'" in `string` to their + * corresponding HTML entities. + * + * **Note:** No other characters are escaped. To escape additional + * characters use a third-party library like [_he_](https://mths.be/he). + * + * Though the ">" character is escaped for symmetry, characters like + * ">" and "/" don't need escaping in HTML and have no special meaning + * unless they're part of a tag or unquoted attribute value. See + * [Mathias Bynens's article](https://mathiasbynens.be/notes/ambiguous-ampersands) + * (under "semi-related fun fact") for more details. + * + * When working with HTML you should always + * [quote attribute values](http://wonko.com/post/html-escaping) to reduce + * XSS vectors. + * + * @static + * @since 0.1.0 + * @memberOf _ + * @category String + * @param {string} [string=''] The string to escape. + * @returns {string} Returns the escaped string. + * @example + * + * _.escape('fred, barney, & pebbles'); + * // => 'fred, barney, & pebbles' + */ + function escape(string) { + string = toString(string); + return (string && reHasUnescapedHtml.test(string)) + ? string.replace(reUnescapedHtml, escapeHtmlChar) + : string; + } + + /** + * Escapes the `RegExp` special characters "^", "$", "\", ".", "*", "+", + * "?", "(", ")", "[", "]", "{", "}", and "|" in `string`. + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category String + * @param {string} [string=''] The string to escape. + * @returns {string} Returns the escaped string. + * @example + * + * _.escapeRegExp('[lodash](https://lodash.com/)'); + * // => '\[lodash\]\(https://lodash\.com/\)' + */ + function escapeRegExp(string) { + string = toString(string); + return (string && reHasRegExpChar.test(string)) + ? string.replace(reRegExpChar, '\\$&') + : string; + } + + /** + * Converts `string` to + * [kebab case](https://en.wikipedia.org/wiki/Letter_case#Special_case_styles). + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category String + * @param {string} [string=''] The string to convert. + * @returns {string} Returns the kebab cased string. + * @example + * + * _.kebabCase('Foo Bar'); + * // => 'foo-bar' + * + * _.kebabCase('fooBar'); + * // => 'foo-bar' + * + * _.kebabCase('__FOO_BAR__'); + * // => 'foo-bar' + */ + var kebabCase = createCompounder(function(result, word, index) { + return result + (index ? '-' : '') + word.toLowerCase(); + }); + + /** + * Converts `string`, as space separated words, to lower case. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category String + * @param {string} [string=''] The string to convert. + * @returns {string} Returns the lower cased string. + * @example + * + * _.lowerCase('--Foo-Bar--'); + * // => 'foo bar' + * + * _.lowerCase('fooBar'); + * // => 'foo bar' + * + * _.lowerCase('__FOO_BAR__'); + * // => 'foo bar' + */ + var lowerCase = createCompounder(function(result, word, index) { + return result + (index ? ' ' : '') + word.toLowerCase(); + }); + + /** + * Converts the first character of `string` to lower case. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category String + * @param {string} [string=''] The string to convert. + * @returns {string} Returns the converted string. + * @example + * + * _.lowerFirst('Fred'); + * // => 'fred' + * + * _.lowerFirst('FRED'); + * // => 'fRED' + */ + var lowerFirst = createCaseFirst('toLowerCase'); + + /** + * Pads `string` on the left and right sides if it's shorter than `length`. + * Padding characters are truncated if they can't be evenly divided by `length`. + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category String + * @param {string} [string=''] The string to pad. + * @param {number} [length=0] The padding length. + * @param {string} [chars=' '] The string used as padding. + * @returns {string} Returns the padded string. + * @example + * + * _.pad('abc', 8); + * // => ' abc ' + * + * _.pad('abc', 8, '_-'); + * // => '_-abc_-_' + * + * _.pad('abc', 3); + * // => 'abc' + */ + function pad(string, length, chars) { + string = toString(string); + length = toInteger(length); + + var strLength = length ? stringSize(string) : 0; + if (!length || strLength >= length) { + return string; + } + var mid = (length - strLength) / 2; + return ( + createPadding(nativeFloor(mid), chars) + + string + + createPadding(nativeCeil(mid), chars) + ); + } + + /** + * Pads `string` on the right side if it's shorter than `length`. Padding + * characters are truncated if they exceed `length`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category String + * @param {string} [string=''] The string to pad. + * @param {number} [length=0] The padding length. + * @param {string} [chars=' '] The string used as padding. + * @returns {string} Returns the padded string. + * @example + * + * _.padEnd('abc', 6); + * // => 'abc ' + * + * _.padEnd('abc', 6, '_-'); + * // => 'abc_-_' + * + * _.padEnd('abc', 3); + * // => 'abc' + */ + function padEnd(string, length, chars) { + string = toString(string); + length = toInteger(length); + + var strLength = length ? stringSize(string) : 0; + return (length && strLength < length) + ? (string + createPadding(length - strLength, chars)) + : string; + } + + /** + * Pads `string` on the left side if it's shorter than `length`. Padding + * characters are truncated if they exceed `length`. + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category String + * @param {string} [string=''] The string to pad. + * @param {number} [length=0] The padding length. + * @param {string} [chars=' '] The string used as padding. + * @returns {string} Returns the padded string. + * @example + * + * _.padStart('abc', 6); + * // => ' abc' + * + * _.padStart('abc', 6, '_-'); + * // => '_-_abc' + * + * _.padStart('abc', 3); + * // => 'abc' + */ + function padStart(string, length, chars) { + string = toString(string); + length = toInteger(length); + + var strLength = length ? stringSize(string) : 0; + return (length && strLength < length) + ? (createPadding(length - strLength, chars) + string) + : string; + } + + /** + * Converts `string` to an integer of the specified radix. If `radix` is + * `undefined` or `0`, a `radix` of `10` is used unless `value` is a + * hexadecimal, in which case a `radix` of `16` is used. + * + * **Note:** This method aligns with the + * [ES5 implementation](https://es5.github.io/#x15.1.2.2) of `parseInt`. + * + * @static + * @memberOf _ + * @since 1.1.0 + * @category String + * @param {string} string The string to convert. + * @param {number} [radix=10] The radix to interpret `value` by. + * @param- {Object} [guard] Enables use as an iteratee for methods like `_.map`. + * @returns {number} Returns the converted integer. + * @example + * + * _.parseInt('08'); + * // => 8 + * + * _.map(['6', '08', '10'], _.parseInt); + * // => [6, 8, 10] + */ + function parseInt(string, radix, guard) { + if (guard || radix == null) { + radix = 0; + } else if (radix) { + radix = +radix; + } + return nativeParseInt(toString(string).replace(reTrimStart, ''), radix || 0); + } + + /** + * Repeats the given string `n` times. + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category String + * @param {string} [string=''] The string to repeat. + * @param {number} [n=1] The number of times to repeat the string. + * @param- {Object} [guard] Enables use as an iteratee for methods like `_.map`. + * @returns {string} Returns the repeated string. + * @example + * + * _.repeat('*', 3); + * // => '***' + * + * _.repeat('abc', 2); + * // => 'abcabc' + * + * _.repeat('abc', 0); + * // => '' + */ + function repeat(string, n, guard) { + if ((guard ? isIterateeCall(string, n, guard) : n === undefined)) { + n = 1; + } else { + n = toInteger(n); + } + return baseRepeat(toString(string), n); + } + + /** + * Replaces matches for `pattern` in `string` with `replacement`. + * + * **Note:** This method is based on + * [`String#replace`](https://mdn.io/String/replace). + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category String + * @param {string} [string=''] The string to modify. + * @param {RegExp|string} pattern The pattern to replace. + * @param {Function|string} replacement The match replacement. + * @returns {string} Returns the modified string. + * @example + * + * _.replace('Hi Fred', 'Fred', 'Barney'); + * // => 'Hi Barney' + */ + function replace() { + var args = arguments, + string = toString(args[0]); + + return args.length < 3 ? string : string.replace(args[1], args[2]); + } + + /** + * Converts `string` to + * [snake case](https://en.wikipedia.org/wiki/Snake_case). + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category String + * @param {string} [string=''] The string to convert. + * @returns {string} Returns the snake cased string. + * @example + * + * _.snakeCase('Foo Bar'); + * // => 'foo_bar' + * + * _.snakeCase('fooBar'); + * // => 'foo_bar' + * + * _.snakeCase('--FOO-BAR--'); + * // => 'foo_bar' + */ + var snakeCase = createCompounder(function(result, word, index) { + return result + (index ? '_' : '') + word.toLowerCase(); + }); + + /** + * Splits `string` by `separator`. + * + * **Note:** This method is based on + * [`String#split`](https://mdn.io/String/split). + * + * @static + * @memberOf _ + * @since 4.0.0 + * @category String + * @param {string} [string=''] The string to split. + * @param {RegExp|string} separator The separator pattern to split by. + * @param {number} [limit] The length to truncate results to. + * @returns {Array} Returns the string segments. + * @example + * + * _.split('a-b-c', '-', 2); + * // => ['a', 'b'] + */ + function split(string, separator, limit) { + if (limit && typeof limit != 'number' && isIterateeCall(string, separator, limit)) { + separator = limit = undefined; + } + limit = limit === undefined ? MAX_ARRAY_LENGTH : limit >>> 0; + if (!limit) { + return []; + } + string = toString(string); + if (string && ( + typeof separator == 'string' || + (separator != null && !isRegExp(separator)) + )) { + separator = baseToString(separator); + if (!separator && hasUnicode(string)) { + return castSlice(stringToArray(string), 0, limit); + } + } + return string.split(separator, limit); + } + + /** + * Converts `string` to + * [start case](https://en.wikipedia.org/wiki/Letter_case#Stylistic_or_specialised_usage). + * + * @static + * @memberOf _ + * @since 3.1.0 + * @category String + * @param {string} [string=''] The string to convert. + * @returns {string} Returns the start cased string. + * @example + * + * _.startCase('--foo-bar--'); + * // => 'Foo Bar' + * + * _.startCase('fooBar'); + * // => 'Foo Bar' + * + * _.startCase('__FOO_BAR__'); + * // => 'FOO BAR' + */ + var startCase = createCompounder(function(result, word, index) { + return result + (index ? ' ' : '') + upperFirst(word); + }); + + /** + * Checks if `string` starts with the given target string. + * + * @static + * @memberOf _ + * @since 3.0.0 + * @category String + * @param {string} [string=''] The string to inspect. + * @param {string} [target] The string to search for. + * @param {number} [position=0] The position to search from. + * @returns {boolean} Returns `true` if `string` starts with `target`, + * else `false`. + * @example + * + * _.startsWith('abc', 'a'); + * // => true + * + * _.startsWith('abc', 'b'); + * // => false + * + * _.startsWith('abc', 'b', 1); + * // => true + */ + function startsWith(string, target, position) { + string = toString(string); + position = position == null + ? 0 + : baseClamp(toInteger(position), 0, string.length); + + target = baseToString(target); + return string.slice(position, position + target.length) == target; + } + + /** + * Creates a compiled template function that can interpolate data properties + * in "interpolate" delimiters, HTML-escape interpolated data properties in + * "escape" delimiters, and execute JavaScript in "evaluate" delimiters. Data + * properties may be accessed as free variables in the template. If a setting + * object is given, it takes precedence over `_.templateSettings` values. + * + * **Note:** In the development build `_.template` utilizes + * [sourceURLs](http://www.html5rocks.com/en/tutorials/developertools/sourcemaps/#toc-sourceurl) + * for easier debugging. + * + * For more information on precompiling templates see + * [lodash's custom builds documentation](https://lodash.com/custom-builds). + * + * For more information on Chrome extension sandboxes see + * [Chrome's extensions documentation](https://developer.chrome.com/extensions/sandboxingEval). + * + * @static + * @since 0.1.0 + * @memberOf _ + * @category String + * @param {string} [string=''] The template string. + * @param {Object} [options={}] The options object. + * @param {RegExp} [options.escape=_.templateSettings.escape] + * The HTML "escape" delimiter. + * @param {RegExp} [options.evaluate=_.templateSettings.evaluate] + * The "evaluate" delimiter. + * @param {Object} [options.imports=_.templateSettings.imports] + * An object to import into the template as free variables. + * @param {RegExp} [options.interpolate=_.templateSettings.interpolate] + * The "interpolate" delimiter. + * @param {string} [options.sourceURL='lodash.templateSources[n]'] + * The sourceURL of the compiled template. + * @param {string} [options.variable='obj'] + * The data object variable name. + * @param- {Object} [guard] Enables use as an iteratee for methods like `_.map`. + * @returns {Function} Returns the compiled template function. + * @example + * + * // Use the "interpolate" delimiter to create a compiled template. + * var compiled = _.template('hello <%= user %>!'); + * compiled({ 'user': 'fred' }); + * // => 'hello fred!' + * + * // Use the HTML "escape" delimiter to escape data property values. + * var compiled = _.template('<%- value %>'); + * compiled({ 'value': ' + + + diff --git a/node_modules/tape/example/static/server.js b/node_modules/tape/example/static/server.js new file mode 100644 index 0000000..80cea43 --- /dev/null +++ b/node_modules/tape/example/static/server.js @@ -0,0 +1,4 @@ +var http = require('http'); +var ecstatic = require('ecstatic')(__dirname); +var server = http.createServer(ecstatic); +server.listen(8000); diff --git a/node_modules/tape/example/stream/object.js b/node_modules/tape/example/stream/object.js new file mode 100644 index 0000000..20f0819 --- /dev/null +++ b/node_modules/tape/example/stream/object.js @@ -0,0 +1,10 @@ +var test = require('../../'); +var path = require('path'); + +test.createStream({ objectMode: true }).on('data', function (row) { + console.log(JSON.stringify(row)); +}); + +process.argv.slice(2).forEach(function (file) { + require(path.resolve(file)); +}); diff --git a/node_modules/tape/example/stream/tap.js b/node_modules/tape/example/stream/tap.js new file mode 100644 index 0000000..9ea9ff7 --- /dev/null +++ b/node_modules/tape/example/stream/tap.js @@ -0,0 +1,8 @@ +var test = require('../../'); +var path = require('path'); + +test.createStream().pipe(process.stdout); + +process.argv.slice(2).forEach(function (file) { + require(path.resolve(file)); +}); diff --git a/node_modules/tape/example/stream/test/x.js b/node_modules/tape/example/stream/test/x.js new file mode 100644 index 0000000..7dbb98a --- /dev/null +++ b/node_modules/tape/example/stream/test/x.js @@ -0,0 +1,5 @@ +var test = require('../../../'); +test(function (t) { + t.plan(1); + t.equal('beep', 'boop'); +}); diff --git a/node_modules/tape/example/stream/test/y.js b/node_modules/tape/example/stream/test/y.js new file mode 100644 index 0000000..28606d5 --- /dev/null +++ b/node_modules/tape/example/stream/test/y.js @@ -0,0 +1,11 @@ +var test = require('../../../'); +test(function (t) { + t.plan(2); + t.equal(1+1, 2); + t.ok(true); +}); + +test('wheee', function (t) { + t.ok(true); + t.end(); +}); diff --git a/node_modules/tape/example/throw.js b/node_modules/tape/example/throw.js new file mode 100644 index 0000000..ef82c3a --- /dev/null +++ b/node_modules/tape/example/throw.js @@ -0,0 +1,11 @@ +'use strict'; + +var test = require('../'); + +test('throw', function (t) { + t.plan(2); + + setTimeout(function () { + throw new Error('doom'); + }, 100); +}); diff --git a/node_modules/tape/example/timing.js b/node_modules/tape/example/timing.js new file mode 100644 index 0000000..614c144 --- /dev/null +++ b/node_modules/tape/example/timing.js @@ -0,0 +1,12 @@ +var test = require('../'); + +test('timing test', function (t) { + t.plan(2); + + t.equal(typeof Date.now, 'function'); + var start = new Date; + + setTimeout(function () { + t.equal(new Date - start, 100); + }, 100); +}); diff --git a/node_modules/tape/example/too_many.js b/node_modules/tape/example/too_many.js new file mode 100644 index 0000000..cdcb5ee --- /dev/null +++ b/node_modules/tape/example/too_many.js @@ -0,0 +1,35 @@ +var falafel = require('falafel'); +var test = require('../'); + +test('array', function (t) { + t.plan(3); + + var src = '(' + function () { + var xs = [ 1, 2, [ 3, 4 ] ]; + var ys = [ 5, 6 ]; + g([ xs, ys ]); + } + ')()'; + + var output = falafel(src, function (node) { + if (node.type === 'ArrayExpression') { + node.update('fn(' + node.source() + ')'); + } + }); + + var arrays = [ + [ 3, 4 ], + [ 1, 2, [ 3, 4 ] ], + [ 5, 6 ], + [ [ 1, 2, [ 3, 4 ] ], [ 5, 6 ] ], + ]; + + Function(['fn','g'], output)( + function (xs) { + t.same(arrays.shift(), xs); + return xs; + }, + function (xs) { + t.same(xs, [ [ 1, 2, [ 3, 4 ] ], [ 5, 6 ] ]); + } + ); +}); diff --git a/node_modules/tape/example/two.js b/node_modules/tape/example/two.js new file mode 100644 index 0000000..78e49c3 --- /dev/null +++ b/node_modules/tape/example/two.js @@ -0,0 +1,18 @@ +var test = require('../'); + +test('one', function (t) { + t.plan(2); + t.ok(true); + setTimeout(function () { + t.equal(1+3, 4); + }, 100); +}); + +test('two', function (t) { + t.plan(3); + t.equal(5, 2+3); + setTimeout(function () { + t.equal('a'.charCodeAt(0), 97); + t.ok(true); + }, 50); +}); diff --git a/node_modules/tape/index.js b/node_modules/tape/index.js new file mode 100644 index 0000000..7ab2951 --- /dev/null +++ b/node_modules/tape/index.js @@ -0,0 +1,150 @@ +var defined = require('defined'); +var createDefaultStream = require('./lib/default_stream'); +var Test = require('./lib/test'); +var createResult = require('./lib/results'); +var through = require('through'); + +var canEmitExit = typeof process !== 'undefined' && process + && typeof process.on === 'function' && process.browser !== true +; +var canExit = typeof process !== 'undefined' && process + && typeof process.exit === 'function' +; + +exports = module.exports = (function () { + var harness; + var lazyLoad = function () { + return getHarness().apply(this, arguments); + }; + + lazyLoad.only = function () { + return getHarness().only.apply(this, arguments); + }; + + lazyLoad.createStream = function (opts) { + if (!opts) opts = {}; + if (!harness) { + var output = through(); + getHarness({ stream: output, objectMode: opts.objectMode }); + return output; + } + return harness.createStream(opts); + }; + + lazyLoad.onFinish = function () { + return getHarness().onFinish.apply(this, arguments); + }; + + lazyLoad.onFailure = function () { + return getHarness().onFailure.apply(this, arguments); + }; + + lazyLoad.getHarness = getHarness; + + return lazyLoad; + + function getHarness(opts) { + if (!opts) opts = {}; + opts.autoclose = !canEmitExit; + if (!harness) harness = createExitHarness(opts); + return harness; + } +})(); + +function createExitHarness(conf) { + if (!conf) conf = {}; + var harness = createHarness({ + autoclose: defined(conf.autoclose, false) + }); + + var stream = harness.createStream({ objectMode: conf.objectMode }); + var es = stream.pipe(conf.stream || createDefaultStream()); + if (canEmitExit) { + es.on('error', function (err) { harness._exitCode = 1; }); + } + + var ended = false; + stream.on('end', function () { ended = true; }); + + if (conf.exit === false) return harness; + if (!canEmitExit || !canExit) return harness; + + process.on('exit', function (code) { + // let the process exit cleanly. + if (code !== 0) { + return; + } + + if (!ended) { + var only = harness._results._only; + for (var i = 0; i < harness._tests.length; i++) { + var t = harness._tests[i]; + if (only && t !== only) continue; + t._exit(); + } + } + harness.close(); + process.exit(code || harness._exitCode); + }); + + return harness; +} + +exports.createHarness = createHarness; +exports.Test = Test; +exports.test = exports; // tap compat +exports.test.skip = Test.skip; + +function createHarness(conf_) { + if (!conf_) conf_ = {}; + var results = createResult(); + if (conf_.autoclose !== false) { + results.once('done', function () { results.close(); }); + } + + var test = function (name, conf, cb) { + var t = new Test(name, conf, cb); + test._tests.push(t); + + (function inspectCode(st) { + st.on('test', function sub(st_) { + inspectCode(st_); + }); + st.on('result', function (r) { + if (!r.todo && !r.ok && typeof r !== 'string') test._exitCode = 1; + }); + })(t); + + results.push(t); + return t; + }; + test._results = results; + + test._tests = []; + + test.createStream = function (opts) { + return results.createStream(opts); + }; + + test.onFinish = function (cb) { + results.on('done', cb); + }; + + test.onFailure = function (cb) { + results.on('fail', cb); + }; + + var only = false; + test.only = function () { + if (only) throw new Error('there can only be one only test'); + only = true; + var t = test.apply(null, arguments); + results.only(t); + return t; + }; + test._exitCode = 0; + + test.close = function () { results.close(); }; + + return test; +} diff --git a/node_modules/tape/lib/default_stream.js b/node_modules/tape/lib/default_stream.js new file mode 100644 index 0000000..2744258 --- /dev/null +++ b/node_modules/tape/lib/default_stream.js @@ -0,0 +1,30 @@ +var through = require('through'); +var fs = require('fs'); + +module.exports = function () { + var line = ''; + var stream = through(write, flush); + return stream; + + function write(buf) { + for (var i = 0; i < buf.length; i++) { + var c = typeof buf === 'string' + ? buf.charAt(i) + : String.fromCharCode(buf[i]) + ; + if (c === '\n') flush(); + else line += c; + } + } + + function flush() { + if (fs.writeSync && /^win/.test(process.platform)) { + try { fs.writeSync(1, line + '\n'); } + catch (e) { stream.emit('error', e); } + } else { + try { console.log(line); } + catch (e) { stream.emit('error', e); } + } + line = ''; + } +}; diff --git a/node_modules/tape/lib/results.js b/node_modules/tape/lib/results.js new file mode 100644 index 0000000..89da4b0 --- /dev/null +++ b/node_modules/tape/lib/results.js @@ -0,0 +1,214 @@ +var defined = require('defined'); +var EventEmitter = require('events').EventEmitter; +var inherits = require('inherits'); +var through = require('through'); +var resumer = require('resumer'); +var inspect = require('object-inspect'); +var bind = require('function-bind'); +var has = require('has'); +var regexpTest = bind.call(Function.call, RegExp.prototype.test); +var yamlIndicators = /\:|\-|\?/; +var nextTick = typeof setImmediate !== 'undefined' + ? setImmediate + : process.nextTick +; + +module.exports = Results; +inherits(Results, EventEmitter); + +function coalesceWhiteSpaces(str) { + return String(str).replace(/\s+/g, ' '); +} + +function Results() { + if (!(this instanceof Results)) return new Results; + this.count = 0; + this.fail = 0; + this.pass = 0; + this.todo = 0; + this._stream = through(); + this.tests = []; + this._only = null; + this._isRunning = false; +} + +Results.prototype.createStream = function (opts) { + if (!opts) opts = {}; + var self = this; + var output, testId = 0; + if (opts.objectMode) { + output = through(); + self.on('_push', function ontest(t, extra) { + if (!extra) extra = {}; + var id = testId++; + t.once('prerun', function () { + var row = { + type: 'test', + name: t.name, + id: id, + skip: t._skip, + todo: t._todo + }; + if (has(extra, 'parent')) { + row.parent = extra.parent; + } + output.queue(row); + }); + t.on('test', function (st) { + ontest(st, { parent: id }); + }); + t.on('result', function (res) { + if (res && typeof res === 'object') { + res.test = id; + res.type = 'assert'; + } + output.queue(res); + }); + t.on('end', function () { + output.queue({ type: 'end', test: id }); + }); + }); + self.on('done', function () { output.queue(null); }); + } else { + output = resumer(); + output.queue('TAP version 13\n'); + self._stream.pipe(output); + } + + if (!this._isRunning) { + this._isRunning = true; + nextTick(function next() { + var t; + while (t = getNextTest(self)) { + t.run(); + if (!t.ended) return t.once('end', function () { nextTick(next); }); + } + self.emit('done'); + }); + } + + return output; +}; + +Results.prototype.push = function (t) { + var self = this; + self.tests.push(t); + self._watch(t); + self.emit('_push', t); +}; + +Results.prototype.only = function (t) { + this._only = t; +}; + +Results.prototype._watch = function (t) { + var self = this; + var write = function (s) { self._stream.queue(s); }; + t.once('prerun', function () { + var premsg = ''; + if (t._skip) premsg = 'SKIP '; + else if (t._todo) premsg = 'TODO '; + write('# ' + premsg + coalesceWhiteSpaces(t.name) + '\n'); + }); + + t.on('result', function (res) { + if (typeof res === 'string') { + write('# ' + res + '\n'); + return; + } + write(encodeResult(res, self.count + 1)); + self.count ++; + + if (res.ok || res.todo) self.pass ++; + else { + self.fail ++; + self.emit('fail'); + } + }); + + t.on('test', function (st) { self._watch(st); }); +}; + +Results.prototype.close = function () { + var self = this; + if (self.closed) self._stream.emit('error', new Error('ALREADY CLOSED')); + self.closed = true; + var write = function (s) { self._stream.queue(s); }; + + write('\n1..' + self.count + '\n'); + write('# tests ' + self.count + '\n'); + write('# pass ' + (self.pass + self.todo) + '\n'); + if (self.todo) write('# todo ' + self.todo + '\n'); + if (self.fail) write('# fail ' + self.fail + '\n'); + else write('\n# ok\n'); + + self._stream.queue(null); +}; + +function encodeResult(res, count) { + var output = ''; + output += (res.ok ? 'ok ' : 'not ok ') + count; + output += res.name ? ' ' + coalesceWhiteSpaces(res.name) : ''; + + if (res.skip) { + output += ' # SKIP' + ((typeof res.skip === 'string') ? ' ' + coalesceWhiteSpaces(res.skip) : ''); + } else if (res.todo) { + output += ' # TODO' + ((typeof res.todo === 'string') ? ' ' + coalesceWhiteSpaces(res.todo) : ''); + }; + + output += '\n'; + if (res.ok) return output; + + var outer = ' '; + var inner = outer + ' '; + output += outer + '---\n'; + output += inner + 'operator: ' + res.operator + '\n'; + + if (has(res, 'expected') || has(res, 'actual')) { + var ex = inspect(res.expected, {depth: res.objectPrintDepth}); + var ac = inspect(res.actual, {depth: res.objectPrintDepth}); + + if (Math.max(ex.length, ac.length) > 65 || invalidYaml(ex) || invalidYaml(ac)) { + output += inner + 'expected: |-\n' + inner + ' ' + ex + '\n'; + output += inner + 'actual: |-\n' + inner + ' ' + ac + '\n'; + } else { + output += inner + 'expected: ' + ex + '\n'; + output += inner + 'actual: ' + ac + '\n'; + } + } + if (res.at) { + output += inner + 'at: ' + res.at + '\n'; + } + + var actualStack = res.actual && (typeof res.actual === 'object' || typeof res.actual === 'function') ? res.actual.stack : undefined; + var errorStack = res.error && res.error.stack; + var stack = defined(actualStack, errorStack); + if (stack) { + var lines = String(stack).split('\n'); + output += inner + 'stack: |-\n'; + for (var i = 0; i < lines.length; i++) { + output += inner + ' ' + lines[i] + '\n'; + } + } + + output += outer + '...\n'; + return output; +} + +function getNextTest(results) { + if (!results._only) { + return results.tests.shift(); + } + + do { + var t = results.tests.shift(); + if (!t) continue; + if (results._only === t) { + return t; + } + } while (results.tests.length !== 0); +} + +function invalidYaml(str) { + return regexpTest(yamlIndicators, str); +} diff --git a/node_modules/tape/lib/test.js b/node_modules/tape/lib/test.js new file mode 100644 index 0000000..3e75ee2 --- /dev/null +++ b/node_modules/tape/lib/test.js @@ -0,0 +1,599 @@ +var deepEqual = require('deep-equal'); +var defined = require('defined'); +var path = require('path'); +var inherits = require('inherits'); +var EventEmitter = require('events').EventEmitter; +var has = require('has'); +var isRegExp = require('is-regex'); +var trim = require('string.prototype.trim'); +var bind = require('function-bind'); +var forEach = require('for-each'); +var inspect = require('object-inspect'); +var isEnumerable = bind.call(Function.call, Object.prototype.propertyIsEnumerable); +var toLowerCase = bind.call(Function.call, String.prototype.toLowerCase); +var $test = bind.call(Function.call, RegExp.prototype.test); + +module.exports = Test; + +var nextTick = typeof setImmediate !== 'undefined' + ? setImmediate + : process.nextTick; +var safeSetTimeout = setTimeout; +var safeClearTimeout = clearTimeout; + +inherits(Test, EventEmitter); + +var getTestArgs = function (name_, opts_, cb_) { + var name = '(anonymous)'; + var opts = {}; + var cb; + + for (var i = 0; i < arguments.length; i++) { + var arg = arguments[i]; + var t = typeof arg; + if (t === 'string') { + name = arg; + } else if (t === 'object') { + opts = arg || opts; + } else if (t === 'function') { + cb = arg; + } + } + return { name: name, opts: opts, cb: cb }; +}; + +function Test(name_, opts_, cb_) { + if (! (this instanceof Test)) { + return new Test(name_, opts_, cb_); + } + + var args = getTestArgs(name_, opts_, cb_); + + this.readable = true; + this.name = args.name || '(anonymous)'; + this.assertCount = 0; + this.pendingCount = 0; + this._skip = args.opts.skip || false; + this._todo = args.opts.todo || false; + this._timeout = args.opts.timeout; + this._plan = undefined; + this._cb = args.cb; + this._progeny = []; + this._ok = true; + var depthEnvVar = process.env.NODE_TAPE_OBJECT_PRINT_DEPTH; + if (args.opts.objectPrintDepth) { + this._objectPrintDepth = args.opts.objectPrintDepth; + } else if (depthEnvVar) { + if (toLowerCase(depthEnvVar) === 'infinity') { + this._objectPrintDepth = Infinity; + } else { + this._objectPrintDepth = depthEnvVar; + } + } else { + this._objectPrintDepth = 5; + } + + for (var prop in this) { + this[prop] = (function bind(self, val) { + if (typeof val === 'function') { + return function bound() { + return val.apply(self, arguments); + }; + } + return val; + })(this, this[prop]); + } +} + +Test.prototype.run = function () { + this.emit('prerun'); + if (!this._cb || this._skip) { + return this._end(); + } + if (this._timeout != null) { + this.timeoutAfter(this._timeout); + } + this._cb(this); + this.emit('run'); +}; + +Test.prototype.test = function (name, opts, cb) { + var self = this; + var t = new Test(name, opts, cb); + this._progeny.push(t); + this.pendingCount++; + this.emit('test', t); + t.on('prerun', function () { + self.assertCount++; + }); + + if (!self._pendingAsserts()) { + nextTick(function () { + self._end(); + }); + } + + nextTick(function () { + if (!self._plan && self.pendingCount == self._progeny.length) { + self._end(); + } + }); +}; + +Test.prototype.comment = function (msg) { + var that = this; + forEach(trim(msg).split('\n'), function (aMsg) { + that.emit('result', trim(aMsg).replace(/^#\s*/, '')); + }); +}; + +Test.prototype.plan = function (n) { + this._plan = n; + this.emit('plan', n); +}; + +Test.prototype.timeoutAfter = function (ms) { + if (!ms) throw new Error('timeoutAfter requires a timespan'); + var self = this; + var timeout = safeSetTimeout(function () { + self.fail('test timed out after ' + ms + 'ms'); + self.end(); + }, ms); + this.once('end', function () { + safeClearTimeout(timeout); + }); +}; + +Test.prototype.end = function (err) { + var self = this; + if (arguments.length >= 1 && !!err) { + this.ifError(err); + } + + if (this.calledEnd) { + this.fail('.end() called twice'); + } + this.calledEnd = true; + this._end(); +}; + +Test.prototype._end = function (err) { + var self = this; + if (this._progeny.length) { + var t = this._progeny.shift(); + t.on('end', function () { self._end(); }); + t.run(); + return; + } + + if (!this.ended) this.emit('end'); + var pendingAsserts = this._pendingAsserts(); + if (!this._planError && this._plan !== undefined && pendingAsserts) { + this._planError = true; + this.fail('plan != count', { + expected: this._plan, + actual: this.assertCount + }); + } + this.ended = true; +}; + +Test.prototype._exit = function () { + if (this._plan !== undefined && + !this._planError && this.assertCount !== this._plan) { + this._planError = true; + this.fail('plan != count', { + expected: this._plan, + actual: this.assertCount, + exiting: true + }); + } else if (!this.ended) { + this.fail('test exited without ending: ' + this.name, { + exiting: true + }); + } +}; + +Test.prototype._pendingAsserts = function () { + if (this._plan === undefined) { + return 1; + } + return this._plan - (this._progeny.length + this.assertCount); +}; + +Test.prototype._assert = function assert(ok, opts) { + var self = this; + var extra = opts.extra || {}; + + ok = !!ok || !!extra.skip; + + var res = { + id: self.assertCount++, + ok: ok, + skip: defined(extra.skip, opts.skip), + todo: defined(extra.todo, opts.todo, self._todo), + name: defined(extra.message, opts.message, '(unnamed assert)'), + operator: defined(extra.operator, opts.operator), + objectPrintDepth: self._objectPrintDepth + }; + if (has(opts, 'actual') || has(extra, 'actual')) { + res.actual = defined(extra.actual, opts.actual); + } + if (has(opts, 'expected') || has(extra, 'expected')) { + res.expected = defined(extra.expected, opts.expected); + } + this._ok = !!(this._ok && ok); + + if (!ok && !res.todo) { + res.error = defined(extra.error, opts.error, new Error(res.name)); + } + + if (!ok) { + var e = new Error('exception'); + var err = (e.stack || '').split('\n'); + var dir = __dirname + path.sep; + + for (var i = 0; i < err.length; i++) { + /* + Stack trace lines may resemble one of the following. We need + to correctly extract a function name (if any) and path / line + number for each line. + + at myFunction (/path/to/file.js:123:45) + at myFunction (/path/to/file.other-ext:123:45) + at myFunction (/path to/file.js:123:45) + at myFunction (C:\path\to\file.js:123:45) + at myFunction (/path/to/file.js:123) + at Test.
type-detect
+
++ Improved typeof detection for node and the browser. +
+ +
+
+ 
+
+
+ 
+
+
+ 
+
+
+ 
+
+
+ 
+
+
+ 
+
+
+ 
+
+
+
| Supported Browsers | |||||
|---|---|---|---|---|---|
| ✅ | +✅ | +✅ | +✅ | +9, 10, 11 | +|
+
+
+ 
+
+
+
+## What is Type-Detect?
+
+Type Detect is a module which you can use to detect the type of a given object. It returns a string representation of the object's type, either using [`typeof`](http://www.ecma-international.org/ecma-262/6.0/index.html#sec-typeof-operator) or [`@@toStringTag`](http://www.ecma-international.org/ecma-262/6.0/index.html#sec-symbol.tostringtag). It also normalizes some object names for consistency among browsers.
+
+## Why?
+
+The `typeof` operator will only specify primitive values; everything else is `"object"` (including `null`, arrays, regexps, etc). Many developers use `Object.prototype.toString()` - which is a fine alternative and returns many more types (null returns `[object Null]`, Arrays as `[object Array]`, regexps as `[object RegExp]` etc).
+
+Sadly, `Object.prototype.toString` is slow, and buggy. By slow - we mean it is slower than `typeof`. By buggy - we mean that some values (like Promises, the global object, iterators, dataviews, a bunch of HTML elements) all report different things in different browsers.
+
+`type-detect` fixes all of the shortcomings with `Object.prototype.toString`. We have extra code to speed up checks of JS and DOM objects, as much as 20-30x faster for some values. `type-detect` also fixes any consistencies with these objects.
+
+## Installation
+
+### Node.js
+
+`type-detect` is available on [npm](http://npmjs.org). To install it, type:
+
+ $ npm install type-detect
+
+### Browsers
+
+You can also use it within the browser; install via npm and use the `type-detect.js` file found within the download. For example:
+
+```html
+
+```
+
+## Usage
+
+The primary export of `type-detect` is function that can serve as a replacement for `typeof`. The results of this function will be more specific than that of native `typeof`.
+
+```js
+var type = require('type-detect');
+```
+
+#### array
+
+```js
+assert(type([]) === 'Array');
+assert(type(new Array()) === 'Array');
+```
+
+#### regexp
+
+```js
+assert(type(/a-z/gi) === 'RegExp');
+assert(type(new RegExp('a-z')) === 'RegExp');
+```
+
+#### function
+
+```js
+assert(type(function () {}) === 'function');
+```
+
+#### arguments
+
+```js
+(function () {
+ assert(type(arguments) === 'Arguments');
+})();
+```
+
+#### date
+
+```js
+assert(type(new Date) === 'Date');
+```
+
+#### number
+
+```js
+assert(type(1) === 'number');
+assert(type(1.234) === 'number');
+assert(type(-1) === 'number');
+assert(type(-1.234) === 'number');
+assert(type(Infinity) === 'number');
+assert(type(NaN) === 'number');
+assert(type(new Number(1)) === 'Number'); // note - the object version has a capital N
+```
+
+#### string
+
+```js
+assert(type('hello world') === 'string');
+assert(type(new String('hello')) === 'String'); // note - the object version has a capital S
+```
+
+#### null
+
+```js
+assert(type(null) === 'null');
+assert(type(undefined) !== 'null');
+```
+
+#### undefined
+
+```js
+assert(type(undefined) === 'undefined');
+assert(type(null) !== 'undefined');
+```
+
+#### object
+
+```js
+var Noop = function () {};
+assert(type({}) === 'Object');
+assert(type(Noop) !== 'Object');
+assert(type(new Noop) === 'Object');
+assert(type(new Object) === 'Object');
+```
+
+#### ECMA6 Types
+
+All new ECMAScript 2015 objects are also supported, such as Promises and Symbols:
+
+```js
+assert(type(new Map() === 'Map');
+assert(type(new WeakMap()) === 'WeakMap');
+assert(type(new Set()) === 'Set');
+assert(type(new WeakSet()) === 'WeakSet');
+assert(type(Symbol()) === 'symbol');
+assert(type(new Promise(callback) === 'Promise');
+assert(type(new Int8Array()) === 'Int8Array');
+assert(type(new Uint8Array()) === 'Uint8Array');
+assert(type(new UInt8ClampedArray()) === 'Uint8ClampedArray');
+assert(type(new Int16Array()) === 'Int16Array');
+assert(type(new Uint16Array()) === 'Uint16Array');
+assert(type(new Int32Array()) === 'Int32Array');
+assert(type(new UInt32Array()) === 'Uint32Array');
+assert(type(new Float32Array()) === 'Float32Array');
+assert(type(new Float64Array()) === 'Float64Array');
+assert(type(new ArrayBuffer()) === 'ArrayBuffer');
+assert(type(new DataView(arrayBuffer)) === 'DataView');
+```
+
+Also, if you use `Symbol.toStringTag` to change an Objects return value of the `toString()` Method, `type()` will return this value, e.g:
+
+```js
+var myObject = {};
+myObject[Symbol.toStringTag] = 'myCustomType';
+assert(type(myObject) === 'myCustomType');
+```
diff --git a/node_modules/type-detect/index.js b/node_modules/type-detect/index.js
new file mode 100644
index 0000000..98a1e03
--- /dev/null
+++ b/node_modules/type-detect/index.js
@@ -0,0 +1,378 @@
+/* !
+ * type-detect
+ * Copyright(c) 2013 jake luer