Rename mdast to remark

Note that the AST now carries the name “mdast”, meaning
utilities (such as mdast-util-inject) keep their name.

This name-change includes the `mdast` formatter, which also changed
to `remark`.

Additionally:

* Update relating packages.
* Fix a bug where `text` nodes without value were
  [generated](https://github.com/wooorm/documentation/blob/6b905aefb160dde8d7c911daa4bd959cbec4aebe/lib/output/markdown_ast.js#L144).

Author: wooorm

docs/NODE_API.md

@@ -18,7 +18,7 @@ Returns **string** potentially linked HTML
 
 # commentsToAST
 
-Given a hierarchy-nested set of comments, generate an mdast-compatible
+Given a hierarchy-nested set of comments, generate an remark-compatible
 Abstract Syntax Usable for generating Markdown output
 
 
@@ -583,7 +583,7 @@ split from the main function to handle hierarchially nested comments
 
 
 
-Returns **Object** mdast-compatible AST
+Returns **Object** remark-compatible AST
 
 
 

index.js

@@ -183,6 +183,6 @@ module.exports.expandInputs = expandInputs;
 module.exports.formats = {
   html: require('./lib/output/html'),
   md: require('./lib/output/markdown'),
-  mdast: require('./lib/output/markdown_ast'),
+  remark: require('./lib/output/markdown_ast'),
   json: require('./lib/output/json')
 };

lib/commands/readme.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var fs = require('fs');
-var mdast = require('mdast');
+var remark = require('remark');
 var inject = require('mdast-util-inject');
 var chalk = require('chalk');
 var disparity = require('disparity');
@@ -38,7 +38,7 @@ module.exports.parseArgs = function (yargs) {
 
 function readme(documentation, parsedArgs) {
   var readmeOptions = parsedArgs.commandOptions;
-  readmeOptions.format = 'mdast';
+  readmeOptions.format = 'remark';
   /* eslint no-console: 0 */
   var log = readmeOptions.q ? function () {}
   : console.log.bind(console, '[documentation-readme] ');
@@ -51,7 +51,7 @@ function readme(documentation, parsedArgs) {
       throw err;
     }
     var readmeContent = fs.readFileSync(readmeFile, 'utf8');
-    mdast.use(plugin, {
+    remark.use(plugin, {
       section: readmeOptions.section,
       toInject: docsAst
     }).process(readmeContent, onInjected.bind(null, readmeContent));
@@ -81,8 +81,8 @@ function readme(documentation, parsedArgs) {
   }
 }
 
-// wrap the inject utility as an mdast plugin
-function plugin(mdast, options) {
+// wrap the inject utility as an remark plugin
+function plugin(remark, options) {
   return function transform(targetAst, file, next) {
     if (!inject(options.section, targetAst, options.toInject)) {
       return next(new Error('Heading ' + options.section + ' not found.'));

lib/output/markdown.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var mdast = require('mdast'),
-  toc = require('mdast-toc'),
+var remark = require('remark'),
+  toc = require('remark-toc'),
   markdownAST = require('./markdown_ast');
 
 /**
@@ -15,7 +15,7 @@ var mdast = require('mdast'),
  * @return {undefined} calls callback
  */
 module.exports = function (comments, opts, callback) {
-  var processor = mdast().use(toc);
+  var processor = remark().use(toc);
   markdownAST(comments, opts, function (err, ast) {
     var processedAST = processor.run(ast);
     return callback(null, processor.stringify(processedAST));

lib/output/markdown_ast.js

@@ -1,11 +1,11 @@
-var mdast = require('mdast'),
+var remark = require('remark'),
   u = require('unist-builder'),
   formatType = require('documentation-theme-utils').formatType,
   formatInlineTags = require('../format_inline_tags'),
   hljs = require('highlight.js');
 
 /**
- * Given a hierarchy-nested set of comments, generate an mdast-compatible
+ * Given a hierarchy-nested set of comments, generate an remark-compatible
  * Abstract Syntax Tree usable for generating Markdown output
  *
  * @param {Array<Object>} comments nested comment
@@ -25,7 +25,7 @@ function commentsToAST(comments, opts, callback) {
    *
    * @param {number} depth nesting of the comment, starting at 1
    * @param {Object} comment a single comment
-   * @returns {Object} mdast-compatible AST
+   * @returns {Object} remark-compatible AST
    */
   function generate(depth, comment) {
 
@@ -37,7 +37,7 @@ function commentsToAST(comments, opts, callback) {
             u('text', ' '),
             !!param.type && u('strong', formatType(param.type)),
             u('text', ' ')
-          ].concat(mdast.parse(formatInlineTags(param.description)).children)
+          ].concat(remark.parse(formatInlineTags(param.description)).children)
           .concat([
             !!param.default && u('paragraph', [
               u('text', ' (optional, default '),
@@ -74,7 +74,7 @@ function commentsToAST(comments, opts, callback) {
               u('strong', formatType(property.type)),
               u('text', ' ')
             ]
-            .concat(mdast.parse(formatInlineTags(property.description)).children)
+            .concat(remark.parse(formatInlineTags(property.description)).children)
             .filter(Boolean)),
             property.properties && propertyList(property.properties)
           ].filter(Boolean));
@@ -95,7 +95,7 @@ function commentsToAST(comments, opts, callback) {
           u('text', 'Returns '),
           u('strong', formatType(returns.type)),
           u('text', ' ')
-        ].concat(mdast.parse(formatInlineTags(returns.description)).children));
+        ].concat(remark.parse(formatInlineTags(returns.description)).children));
       });
     }
 
@@ -141,10 +141,10 @@ function commentsToAST(comments, opts, callback) {
           })));
     }
 
-    return [u('heading', { depth: depth }, [u('text', comment.name)])]
+    return [u('heading', { depth: depth }, [u('text', comment.name || '')])]
     .concat(githubLink(comment))
     .concat(augmentsLink(comment))
-    .concat(mdast.parse(formatInlineTags(comment.description)).children)
+    .concat(remark.parse(formatInlineTags(comment.description)).children)
     .concat(paramSection(comment))
     .concat(propertySection(comment))
     .concat(examplesSection(comment))

package.json

@@ -26,8 +26,8 @@
     "highlight.js": "^8.4.0",
     "js-yaml": "^3.3.1",
     "jsdoc-inline-lex": "^1.0.1",
-    "mdast": "^2.0.0",
-    "mdast-toc": "^1.1.0",
+    "remark": "^3.0.0",
+    "remark-toc": "^2.0.0",
     "mdast-util-inject": "^1.1.0",
     "micromatch": "^2.1.6",
     "mime": "^1.3.4",