feat(obj): allow to add additional properties

README.md

@@ -204,6 +204,22 @@ output = {
 }
 ```
 
+Add title and description:
+```js
+ms.obj({
+  displayName: 'string',
+}, {title: 'Title', description: 'Desc.'})
+```
+
+Add dependencies:
+```js
+ms.obj({
+  creditCard: 'string',
+  address: 'string'
+}, {dependencies: {creditCard: 'address'}})
+```
+
+
 ## Arrays
 
 ```js

index.js

@@ -33,13 +33,16 @@ module.exports = {
   // Methods
   // -------
 
-  obj (microschema = {}, {strict, required} = {}) {
+  obj (microschema = {}, {strict, required, title, description, dependencies} = {}) {
     const jsonSchema = {
       type: 'object',
       properties: {}
     }
 
+    if (title) jsonSchema.title = title
+    if (description) jsonSchema.description = description
     if (strict) jsonSchema.additionalProperties = false
+    if (dependencies) setDependencies(jsonSchema, dependencies)
 
     if (required) {
       if (!Array.isArray(required)) throw new Error("'required' must be an array")
@@ -196,3 +199,12 @@ function isString (str) {
 function isNumber (nr) {
   return typeof nr === 'number'
 }
+
+function setDependencies (jsonSchema, dependencies) {
+  const formattedDeps = {}
+  for (const prop in dependencies) {
+    const value = dependencies[prop]
+    formattedDeps[prop] = isString(value) ? [value] : value
+  }
+  jsonSchema.dependencies = formattedDeps
+}

test.js

@@ -2,6 +2,44 @@ const ms = require('./index')
 const test = require('ava').test
 const assert = require('assert')
 
+test('obj() creates an object with title and description', function (t) {
+  const schema = ms.obj({
+    displayName: 'string'
+  }, {
+    title: 'Title',
+    description: 'Desc.'
+  })
+
+  assert.deepEqual(schema, {
+    type: 'object',
+    properties: {
+      displayName: {type: 'string'}
+    },
+    title: 'Title',
+    description: 'Desc.'
+  })
+})
+
+test('obj() creates an object with dependencies', function (t) {
+  const schema = ms.obj({
+    name: 'string',
+    displayName: 'string'
+  }, {
+    dependencies: {name: 'displayName'}
+  })
+
+  assert.deepEqual(schema, {
+    type: 'object',
+    properties: {
+      name: {type: 'string'},
+      displayName: {type: 'string'}
+    },
+    dependencies: {
+      name: ['displayName']
+    }
+  })
+})
+
 test('strictObj() creates an object with a single property', function (t) {
   const schema = ms.strictObj({foo: 'string'})