documentation/index.js

var fs = require('fs'),
  doctrine = require('doctrine'),
  esprima = require('esprima'),
  through = require('through'),
  types = require('ast-types'),
  mdeps = require('module-deps')
  path = require('path');

// Skip external modules. Based on http://git.io/pzPO.
var externalModuleRegexp = process.platform === 'win32' ?
  /^(\.|\w:)/ :
  /^[\/.]/;

/**
 * Generate JavaScript documentation as a list of parsed JSDoc
 * comments, given a root file as a path.
 *
 * @param {String} index the file to start from
 * @return {Object} stream of output
 */
module.exports = function(index) {
  var md = mdeps({
    filter: function(id) {
      return externalModuleRegexp.test(id);
    }
  });

  md.end({ file: path.resolve(index) });

  /**
   * Documentation stream parser: this receives a module-dep item,
   * reads the file, parses the JavaScript, parses the JSDoc, and
   * emits parsed comments.
   * @param {Object} data
   */
  function docParserStream(data) {
    var code = fs.readFileSync(data.file),
      ast = esprima.parse(code, { attachComment: true }),
      docs = [];
    types.visit(ast, {
      visitMemberExpression: function(path) {
        var node = path.value;
        if (node.leadingComments) {
          node.leadingComments.filter(function(c) {
            return c.type === 'Block';
          }).map(function(comment) {
            docs.push(doctrine.parse(comment.value, { unwrap: true }));
          });
        }
        this.traverse(path);
      }
    });
    docs.forEach(this.push);
  }

  return md.pipe(through(docParserStream));
};