planning

node_modules/value-equal/README.md

@@ -0,0 +1,54 @@
+# value-equal [![Travis][build-badge]][build] [![npm package][npm-badge]][npm]
+
+[build-badge]: https://img.shields.io/travis/mjackson/value-equal/master.svg?style=flat-square
+[build]: https://travis-ci.org/mjackson/value-equal
+[npm-badge]: https://img.shields.io/npm/v/value-equal.svg?style=flat-square
+[npm]: https://www.npmjs.org/package/value-equal
+
+[`value-equal`](https://www.npmjs.com/package/value-equal) determines if two JavaScript values are equal using [`Object.prototype.valueOf`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/valueOf).
+
+In many instances when I'm checking for object equality, what I really want to know is if their **values** are equal. This is good for:
+
+- Stuff you keep in `localStorage`
+- `window.history.state` values
+- Query strings
+
+## Installation
+
+Using [npm](https://www.npmjs.com/):
+
+    $ npm install --save value-equal
+
+Then with a module bundler like [webpack](https://webpack.github.io/), use as you would anything else:
+
+```js
+// using ES6 modules
+import valueEqual from 'value-equal';
+
+// using CommonJS modules
+var valueEqual = require('value-equal');
+```
+
+The UMD build is also available on [unpkg](https://unpkg.com):
+
+```html
+<script src="https://unpkg.com/value-equal"></script>
+```
+
+You can find the library on `window.valueEqual`.
+
+## Usage
+
+```js
+valueEqual(1, 1); // true
+valueEqual('asdf', 'asdf'); // true
+valueEqual('asdf', new String('asdf')); // true
+valueEqual(true, true); // true
+valueEqual(true, false); // false
+valueEqual({ a: 'a' }, { a: 'a' }); // true
+valueEqual({ a: 'a' }, { a: 'b' }); // false
+valueEqual([1, 2, 3], [1, 2, 3]); // true
+valueEqual([1, 2, 3], [2, 3, 4]); // false
+```
+
+That's it. Enjoy!