Fix code-style

Author: wooorm

.jscs.json

@@ -5,8 +5,19 @@
     "unist-util-inspect.js",
     "unist-util-inspect.min.js"
   ],
+  "preset": "yandex",
+  "requireQuotedKeysInObjects": true,
+  "disallowQuotedKeysInObjects": false,
+  "maximumLineLength": {
+    "value": 79,
+    "allExcept": [
+      "regex",
+      "urlComments"
+    ]
+  },
   "jsDoc": {
     "checkAnnotations": "jsdoc3",
+    "checkParamExistence": true,
     "checkParamNames": true,
     "checkRedundantAccess": true,
     "checkRedundantParams": true,
@@ -16,126 +27,9 @@
     "enforceExistence": true,
     "requireHyphenBeforeDescription": true,
     "requireNewlineAfterDescription": true,
+    "requireParamDescription": true,
     "requireParamTypes": true,
+    "requireReturnDescription": true,
     "requireReturnTypes": true
-  },
-  "requireCurlyBraces": [
-    "if",
-    "else",
-    "for",
-    "while",
-    "do",
-    "try",
-    "catch"
-  ],
-  "requireSpaceAfterKeywords": [
-    "if",
-    "else",
-    "for",
-    "while",
-    "do",
-    "switch",
-    "return",
-    "try",
-    "catch"
-  ],
-  "requireSpaceBeforeBlockStatements": true,
-  "requireParenthesesAroundIIFE": true,
-  "requireSpacesInConditionalExpression": true,
-  "requireSpacesInFunctionExpression": {
-    "beforeOpeningCurlyBrace": true
-  },
-  "requireSpacesInAnonymousFunctionExpression": {
-    "beforeOpeningRoundBrace": true,
-    "beforeOpeningCurlyBrace": true
-  },
-  "requireSpacesInNamedFunctionExpression": {
-    "beforeOpeningRoundBrace": true,
-    "beforeOpeningCurlyBrace": true
-  },
-  "requireBlocksOnNewline": true,
-  "disallowEmptyBlocks": true,
-  "disallowSpacesInsideObjectBrackets": true,
-  "disallowSpacesInsideArrayBrackets": true,
-  "disallowSpacesInsideParentheses": true,
-  "requireSpacesInsideObjectBrackets": "all",
-  "disallowDanglingUnderscores": true,
-  "disallowSpaceAfterObjectKeys": true,
-  "requireCommaBeforeLineBreak": true,
-  "requireOperatorBeforeLineBreak": [
-    "?",
-    "+",
-    "-",
-    "/",
-    "*",
-    "=",
-    "==",
-    "===",
-    "!=",
-    "!==",
-    ">",
-    ">=",
-    "<",
-    "<="
-  ],
-  "requireSpaceBeforeBinaryOperators": [
-    "+",
-    "-",
-    "/",
-    "*",
-    "=",
-    "==",
-    "===",
-    "!=",
-    "!=="
-  ],
-  "requireSpaceAfterBinaryOperators": [
-    "+",
-    "-",
-    "/",
-    "*",
-    "=",
-    "==",
-    "===",
-    "!=",
-    "!=="
-  ],
-  "disallowSpaceAfterPrefixUnaryOperators": [
-    "++",
-    "--",
-    "+",
-    "-",
-    "~",
-    "!"
-  ],
-  "disallowSpaceBeforePostfixUnaryOperators": [
-    "++",
-    "--"
-  ],
-  "disallowImplicitTypeConversion": [
-    "numeric",
-    "boolean",
-    "binary",
-    "string"
-  ],
-  "requireCamelCaseOrUpperCaseIdentifiers": true,
-  "disallowKeywords": [
-    "with"
-  ],
-  "disallowMultipleLineStrings": true,
-  "disallowMultipleLineBreaks": true,
-  "validateLineBreaks": "LF",
-  "validateQuoteMarks": "'",
-  "disallowMixedSpacesAndTabs": true,
-  "disallowTrailingWhitespace": true,
-  "disallowTrailingComma": true,
-  "disallowKeywordsOnNewLine": [
-    "else"
-  ],
-  "requireLineFeedAtFileEnd": true,
-  "maximumLineLength": 78,
-  "requireCapitalizedConstructors": true,
-  "safeContextKeyword": "self",
-  "requireDotNotation": true,
-  "disallowYodaConditions": true
+  }
 }

index.js

@@ -23,9 +23,9 @@ var isEmpty = require('is-empty');
 /**
  * Factory to wrap values in ANSI colours.
  *
- * @param {string} open
- * @param {string} close
- * @return {function(string): string}
+ * @param {string} open - Opening sequence.
+ * @param {string} close - Closing sequence.
+ * @return {function(string): string} - Bound function.
  */
 function ansiColor(open, close) {
     return function (value) {
@@ -56,8 +56,8 @@ var COLOR_EXPRESSION = new RegExp(
 /**
  * Remove ANSI colour from `value`.
  *
- * @param {string} value
- * @return {string}
+ * @param {string} value - Value to strip.
+ * @return {string} - Stripped value.
  */
 function stripColor(value) {
     return value.replace(COLOR_EXPRESSION, '');
@@ -77,8 +77,8 @@ var STOP = CHAR_SPLIT + CHAR_HORIZONTAL_LINE + ' ';
 /**
  * Colored nesting formatter.
  *
- * @param {string} value
- * @return {string}
+ * @param {string} value - Value to format as nesting.
+ * @return {string} - Formatted value.
  */
 function formatNesting(value) {
     return dim(value);
@@ -120,7 +120,11 @@ function stringify(start, end) {
     var positions = [];
     var offsets = [];
 
-    /** Add a position. */
+    /**
+     * Add a position.
+     *
+     * @param {Position} position - Position to add.
+     */
     function add(position) {
         var tuple = compile(position);
 
@@ -134,7 +138,7 @@ function stringify(start, end) {
     }
 
     add(start);
-    add(end)
+    add(end);
 
     if (positions.length) {
         values.push(positions.join('-'));
@@ -150,8 +154,8 @@ function stringify(start, end) {
 /**
  * Colored node formatter.
  *
- * @param {Node} node
- * @return {string}
+ * @param {Node} node - Node to format.
+ * @return {string} - Formatted node.
  */
 function formatNode(node) {
     var log = node.type;
@@ -178,8 +182,9 @@ function formatNode(node) {
 /**
  * Inspects a node.
  *
- * @this {Node}
- * @return {string}
+ * @param {Node} node - Node to inspect.
+ * @param {string?} [pad] - Padding.
+ * @return {string} - Formatted node.
  */
 function inspect(node, pad) {
     var result;
@@ -237,8 +242,9 @@ function inspect(node, pad) {
 /**
  * Inspects a node, without using color.
  *
- * @return {string}
- * @this {Node}
+ * @param {Node} node - Node to inspect.
+ * @param {string?} [pad] - Padding.
+ * @return {string} - Formatted node.
  */
 function noColor(node, pad) {
     return stripColor(inspect(node, pad));