First checkin.

Author: Wobbabits

.editorconfig

@@ -0,0 +1,19 @@
+# http://editorconfig.org
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_size = 2
+indent_style = space
+max_line_length = 80
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+max_line_length = 0
+trim_trailing_whitespace = false
+
+[COMMIT_EDITMSG]
+max_line_length = 0

.eslintrc.json

@@ -0,0 +1,64 @@
+{
+  "parserOptions": {
+    "ecmaVersion": 5,
+    "sourceType": "module",
+    "ecmaFeatures": {
+      "globalReturn": true
+    }
+  },
+  "rules": {
+    "constructor-super": 2,
+    "no-case-declarations": 2,
+    "no-class-assign": 2,
+    "no-compare-neg-zero": 2,
+    "no-cond-assign": 2,
+    "no-console": 0,
+    "no-const-assign": 2,
+    "no-constant-condition": 2,
+    "no-control-regex": 2,
+    "no-debugger": 2,
+    "no-delete-var": 2,
+    "no-dupe-args": 2,
+    "no-dupe-class-members": 2,
+    "no-dupe-keys": 2,
+    "no-duplicate-case": 2,
+    "no-empty-character-class": 2,
+    "no-empty-pattern": 2,
+    "no-empty": 0,
+    "no-ex-assign": 2,
+    "no-extra-boolean-cast": 2,
+    "no-extra-semi": 2,
+    "no-fallthrough": 2,
+    "no-func-assign": 2,
+    "no-global-assign": 2,
+    "no-inner-declarations": 2,
+    "no-invalid-regexp": 2,
+    "no-irregular-whitespace": 2,
+    "no-mixed-spaces-and-tabs": 2,
+    "no-new-symbol": 2,
+    "no-obj-calls": 2,
+    "no-octal": 2,
+    "no-redeclare": 2,
+    "no-regex-spaces": 2,
+    "no-self-assign": 2,
+    "no-sparse-arrays": 2,
+    "no-this-before-super": 2,
+    "no-undef": 2,
+    "no-unexpected-multiline": 2,
+    "no-unreachable": 2,
+    "no-unsafe-finally": 2,
+    "no-unsafe-negation": 2,
+    "no-unused-labels": 2,
+    "no-unused-vars": 2,
+    "no-useless-escape": 2,
+    "require-yield": 2,
+    "use-isnan": 2,
+    "valid-typeof": 2,
+    "arrow-body-style": [2, "as-needed"],
+    "arrow-parens": [2, "as-needed"],
+    "yoda": 2
+  },
+  "env": {
+    "browser": true
+  }
+}

.gitignore

@@ -0,0 +1,13 @@
+.DS_Store
+.svn
+._*
+*.tgz
+.Spotlight-V100
+.Trashes
+npm-debug.log
+node_modules
+coverage
+
+# Editor and IDE configuration
+.vscode/
+.idea/

README.md

@@ -0,0 +1,40 @@
+# @composi/merge
+
+This function takes objects and returns a new object with all of their properties. The last object's properties will replace those of the earlier when these have the same name.
+
+Merge does a deep copy of objects, but ignores non-iterable properties.
+
+### Note:
+
+Passing in non-object values, such as string or numbers, will result in unpredictable results. Merge must be used only for combining objects.
+
+## Install
+
+```
+npm install --save-dev @composi/merge
+```
+
+## Using
+
+Merge two objects:
+
+```javascript
+import { merge } from '@composi/merge'
+
+const obj1 = {name: 'Mary'}
+const obj2 = {job: 'project manager'}
+const person = merge(obj1, obj2)
+// returns {name: 'Mary', job: 'project manager'}
+```
+
+## Clone an Object
+
+You can clone an object with merge. Just pass in the object. The return object will be a clone:
+
+```javascript
+import { merge } from '@composi/merge'
+
+const obj1 = {name: 'Joe', job: 'mechanic'}
+const obj2 = merge(obj1)
+obj1 === obj2 // returns false
+```