vuepress-jsdoc 4.2.0 → 4.3.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
+## 4.3.0 (2022-02-15)
+
+* feat(include): add include flag, fix some bugs and improve performance ([082a60a](https://github.com/ph1p/vuepress-jsdoc/commit/082a60a))
+
+
+
 ## 4.2.0 (2021-11-17)
 
+* 4.2.0 ([3cdbc8a](https://github.com/ph1p/vuepress-jsdoc/commit/3cdbc8a))
 * build(deps): update dependencies ([858dff8](https://github.com/ph1p/vuepress-jsdoc/commit/858dff8))
 
 

package/README.md

@@ -66,6 +66,7 @@ Use these options after `vuepress-jsdoc`.
 | --version         | -v    |                 | Show current version                                                                                                                            |
 | --readme          | -r    |                 | Path to custom readme file                                                                                                                      |
 | --exclude         | -e    |                 | Pattern to exclude files/folders (Comma seperated) - \*.test.js,exclude.js [more information](https://github.com/micromatch/micromatch#ismatch) |
+| --include         | -e    |                 | Pattern to include files/folders (Comma seperated) - \*.test.js,exclude.js [more information](https://github.com/micromatch/micromatch#ismatch) |
 | --rmPattern       | -rm   |                 | Pattern when removing files. You can ex- and include files. (glob pattern)                                                                      |
 | --partials        | -p    |                 | jsdoc2markdown partial templates (overwrites default ones)                                                                                      |
 | --jsDocConfigPath | -c    |                 | Path to [JsDoc Config](http://usejsdoc.org/about-configuring-jsdoc.html) (experimental)                                                         |
@@ -162,7 +163,7 @@ Use `headline` to add a custom `h1` title.
 To use typescript, you have to install these dev-dependencies:
 
 ```bash
-yarn add -D typescript jsdoc-babel @babel/cli @babel/core @babel/preset-env @babel/preset-typescript jsdoc-to-markdown
+npm install -D typescript jsdoc-babel @babel/cli @babel/core @babel/preset-env @babel/preset-typescript jsdoc-to-markdown
 ```
 
 Next, you have to add a `jsdoc.json` to your project with some settings and add it with the `-c` parameter.

package/dist/cmds.js

@@ -23,6 +23,7 @@ exports.default = (function (version) {
         .option('-f, --folder <string>', 'Folder inside destination folder. Gets overwritten everytime', 'code')
         .option('-t, --title <string>', 'Title of your documentation', 'API')
         .option('-r, --readme <string>', 'Path to your custom readme')
+        .option('-i, --include <string>', 'Pattern to include files/folders (Comma seperated) - *.test.js,include.js')
         .option('-e, --exclude <string>', 'Pattern to exclude files/folders (Comma seperated) - *.test.js,exclude.js')
         .option('-w, --watch', 'This flag watches your source files')
         .option('-rm, --rmPattern [files...]', 'Pattern when removing files. You can ex- and include files. (glob pattern)', '')

package/dist/index.js

@@ -88,7 +88,6 @@ var chokidar_1 = __importDefault(require("chokidar"));
 var del_1 = __importDefault(require("del"));
 var promises_1 = __importDefault(require("fs/promises"));
 var mkdirp_1 = __importDefault(require("mkdirp"));
-var path_1 = require("path");
 var readline_1 = __importDefault(require("readline"));
 var constants_1 = require("./constants");
 var list_folder_1 = require("./lib/list-folder");
@@ -100,7 +99,7 @@ var vue_sidebar_1 = require("./lib/vue-sidebar");
  * @returns {Promise}
  */
 var createVuepressSidebar = function (options) {
-    return promises_1.default.writeFile(options.docsFolder + "/config.js", "exports.fileTree=" + JSON.stringify(options.fileTree) + ";exports.sidebarTree = (title = 'Mainpage') => (" + JSON.stringify((0, vue_sidebar_1.generateVueSidebar)(options)).replace('::vuepress-jsdoc-title::', '"+title+"') + ");");
+    return promises_1.default.writeFile("".concat(options.docsFolder, "/config.js"), "exports.fileTree=".concat(JSON.stringify(options.fileTree), ";exports.sidebarTree = (title = 'Mainpage') => (").concat(JSON.stringify((0, vue_sidebar_1.generateVueSidebar)(options)).replace('::vuepress-jsdoc-title::', '"+title+"'), ");"));
 };
 /**
  * Parse file
@@ -108,31 +107,17 @@ var createVuepressSidebar = function (options) {
  * @param {CLIArguments} argv
  * @returns {Promise}
  */
-var parseDirectoryFile = function (file, argv) { return __awaiter(void 0, void 0, void 0, function () {
-    var _a, srcFolder, docsFolder, partials, dest, content;
-    return __generator(this, function (_b) {
-        switch (_b.label) {
-            case 0:
-                _a = parseArguments(argv), srcFolder = _a.srcFolder, docsFolder = _a.docsFolder, partials = _a.partials;
-                if (!(!file.isDir && file.folder)) return [3 /*break*/, 5];
-                dest = (0, path_1.join)(docsFolder, file.folder.replace(srcFolder, ''));
-                content = void 0;
-                if (!['.jsx', '.tsx', '.ts', '.js'].includes(file.ext || '')) return [3 /*break*/, 2];
-                return [4 /*yield*/, (0, parser_1.parseFile)(file, srcFolder, docsFolder, argv.jsDocConfigPath, partials)];
-            case 1:
-                content = _b.sent();
-                _b.label = 2;
-            case 2:
-                if (!(file.ext === '.vue')) return [3 /*break*/, 4];
-                return [4 /*yield*/, (0, parser_1.parseVueFile)(file, srcFolder, docsFolder)];
-            case 3:
-                content = _b.sent();
-                _b.label = 4;
-            case 4: return [2 /*return*/, { content: content, dest: dest }];
-            case 5: return [2 /*return*/];
+var parseDirectoryFile = function (file, argv) {
+    var _a = parseArguments(argv), srcFolder = _a.srcFolder, docsFolder = _a.docsFolder, partials = _a.partials;
+    if (!file.isDir && file.folder) {
+        if (['.jsx', '.tsx', '.ts', '.js'].includes(file.ext || '')) {
+            return (0, parser_1.parseFile)(file, srcFolder, docsFolder, argv.jsDocConfigPath, partials);
         }
-    });
-}); };
+        if (file.ext === '.vue') {
+            return (0, parser_1.parseVueFile)(file, srcFolder, docsFolder);
+        }
+    }
+};
 /**
  * Create the readme file. First page when entering the documentation.
  * @param {CLIArguments} argv
@@ -145,23 +130,23 @@ var createReadmeFile = function (argv, deletedPaths) { return __awaiter(void 0,
         switch (_b.label) {
             case 0:
                 _a = parseArguments(argv), srcFolder = _a.srcFolder, codeFolder = _a.codeFolder, docsFolder = _a.docsFolder, title = _a.title, readme = _a.readme;
-                readMeContent = "### Welcome to " + title;
-                readmePath = readme || srcFolder + "/README.md";
+                readMeContent = "### Welcome to ".concat(title);
+                readmePath = readme || "".concat(srcFolder, "/README.md");
                 _b.label = 1;
             case 1:
                 _b.trys.push([1, 3, , 4]);
                 return [4 /*yield*/, promises_1.default.readFile(readmePath, 'utf-8')];
             case 2:
                 readMeContent = _b.sent();
-                if (deletedPaths === null || deletedPaths === void 0 ? void 0 : deletedPaths.some(function (p) { return p.indexOf(codeFolder + "/README.md") !== -1; })) {
-                    console.log("\n" + chalk_1.default.white.bgBlack(' README ') + " " + chalk_1.default.dim(readmePath.replace('README.md', '')) + chalk_1.default.bold('README.md') + " \u2192  " + chalk_1.default.dim(docsFolder) + chalk_1.default.bold('/README.md'));
+                if (deletedPaths === null || deletedPaths === void 0 ? void 0 : deletedPaths.some(function (p) { return p.indexOf("".concat(codeFolder, "/README.md")) !== -1; })) {
+                    console.log("\n".concat(chalk_1.default.white.bgBlack(' README '), " ").concat(chalk_1.default.dim(readmePath.replace('README.md', ''))).concat(chalk_1.default.bold('README.md'), " \u2192  ").concat(chalk_1.default.dim(docsFolder)).concat(chalk_1.default.bold('/README.md')));
                 }
                 return [3 /*break*/, 4];
             case 3:
                 e_1 = _b.sent();
-                console.log("\n" + chalk_1.default.white.bgBlack(' README ') + " Add default README.md");
+                console.log("\n".concat(chalk_1.default.white.bgBlack(' README '), " Add default README.md"));
                 return [3 /*break*/, 4];
-            case 4: return [4 /*yield*/, promises_1.default.writeFile(docsFolder + "/README.md", readMeContent)];
+            case 4: return [4 /*yield*/, promises_1.default.writeFile("".concat(docsFolder, "/README.md"), readMeContent)];
             case 5:
                 _b.sent();
                 return [2 /*return*/];
@@ -175,10 +160,11 @@ var createReadmeFile = function (argv, deletedPaths) { return __awaiter(void 0,
  */
 var parseArguments = function (argv) {
     return {
+        include: (argv.include || '').split(',').filter(Boolean),
         exclude: (argv.exclude || '').split(',').filter(Boolean),
         srcFolder: argv.source.replace('./', ''),
         codeFolder: argv.folder,
-        docsFolder: argv.dist + "/" + argv.folder,
+        docsFolder: "".concat(argv.dist, "/").concat(argv.folder),
         title: argv.title,
         readme: argv.readme,
         rmPattern: argv.rmPattern || [],
@@ -190,17 +176,17 @@ var parseArguments = function (argv) {
  * @param {object} argv passed arguments
  */
 var generate = function (argv) { return __awaiter(void 0, void 0, void 0, function () {
-    var _a, exclude, srcFolder, codeFolder, docsFolder, title, rmPattern, startTime, deletedPaths, lsFolder, parsePromises, _b, _c, file, e_2_1, _d, _e, file, data, e_3_1, result, _f, _g, file, _h, _j, entry, color, resultTime;
+    var _a, exclude, include, srcFolder, codeFolder, docsFolder, title, rmPattern, startTime, deletedPaths, lsFolder, parsePromises, _b, _c, file, e_2_1, _loop_1, _d, _e, file, result, _f, _g, file, _h, _j, entry, color, resultTime;
     var e_2, _k, e_3, _l, e_4, _m, e_5, _o, _p;
     return __generator(this, function (_q) {
         switch (_q.label) {
             case 0:
-                _a = parseArguments(argv), exclude = _a.exclude, srcFolder = _a.srcFolder, codeFolder = _a.codeFolder, docsFolder = _a.docsFolder, title = _a.title, rmPattern = _a.rmPattern;
+                _a = parseArguments(argv), exclude = _a.exclude, include = _a.include, srcFolder = _a.srcFolder, codeFolder = _a.codeFolder, docsFolder = _a.docsFolder, title = _a.title, rmPattern = _a.rmPattern;
                 startTime = +new Date();
-                return [4 /*yield*/, (0, del_1.default)(__spreadArray([docsFolder + "/**/*"], __read(rmPattern), false))];
+                return [4 /*yield*/, (0, del_1.default)(__spreadArray(["".concat(docsFolder, "/**/*")], __read(rmPattern), false))];
             case 1:
                 deletedPaths = _q.sent();
-                return [4 /*yield*/, (0, list_folder_1.listFolder)(srcFolder, exclude)];
+                return [4 /*yield*/, (0, list_folder_1.listFolder)(srcFolder, exclude, include)];
             case 2:
                 lsFolder = _q.sent();
                 return [4 /*yield*/, (0, mkdirp_1.default)(docsFolder)];
@@ -218,7 +204,7 @@ var generate = function (argv) { return __awaiter(void 0, void 0, void 0, functi
                 if (!!file.isDir) return [3 /*break*/, 7];
                 readline_1.default.clearLine(process.stdout, 0);
                 readline_1.default.cursorTo(process.stdout, 0);
-                process.stdout.write(chalk_1.default.dim(" " + file.path + " "));
+                process.stdout.write(chalk_1.default.dim(" ".concat(file.path, " ")));
                 return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 20); })];
             case 6:
                 _q.sent();
@@ -240,38 +226,40 @@ var generate = function (argv) { return __awaiter(void 0, void 0, void 0, functi
             case 11:
                 readline_1.default.clearLine(process.stdout, 0);
                 readline_1.default.cursorTo(process.stdout, 0);
-                _q.label = 12;
-            case 12:
-                _q.trys.push([12, 17, 18, 19]);
-                _d = __values(lsFolder.paths), _e = _d.next();
-                _q.label = 13;
-            case 13:
-                if (!!_e.done) return [3 /*break*/, 16];
-                file = _e.value;
-                return [4 /*yield*/, parseDirectoryFile(file, argv)];
-            case 14:
-                data = _q.sent();
-                if (data) {
-                    parsePromises.push((0, parser_1.writeContentToFile)(data.content, data.dest));
-                }
-                _q.label = 15;
-            case 15:
-                _e = _d.next();
-                return [3 /*break*/, 13];
-            case 16: return [3 /*break*/, 19];
-            case 17:
-                e_3_1 = _q.sent();
-                e_3 = { error: e_3_1 };
-                return [3 /*break*/, 19];
-            case 18:
+                _loop_1 = function (file) {
+                    parsePromises.push((function () { return __awaiter(void 0, void 0, void 0, function () {
+                        var data;
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0: return [4 /*yield*/, parseDirectoryFile(file, argv)];
+                                case 1:
+                                    data = _a.sent();
+                                    if (data && (data === null || data === void 0 ? void 0 : data.relativePathDest)) {
+                                        return [2 /*return*/, (0, parser_1.writeContentToFile)(data, data.relativePathDest)];
+                                    }
+                                    return [2 /*return*/];
+                            }
+                        });
+                    }); })());
+                };
                 try {
-                    if (_e && !_e.done && (_l = _d.return)) _l.call(_d);
+                    // iterate through files and parse them
+                    for (_d = __values(lsFolder.paths), _e = _d.next(); !_e.done; _e = _d.next()) {
+                        file = _e.value;
+                        _loop_1(file);
+                    }
                 }
-                finally { if (e_3) throw e_3.error; }
-                return [7 /*endfinally*/];
-            case 19: return [4 /*yield*/, Promise.all(parsePromises)];
-            case 20:
+                catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                finally {
+                    try {
+                        if (_e && !_e.done && (_l = _d.return)) _l.call(_d);
+                    }
+                    finally { if (e_3) throw e_3.error; }
+                }
+                return [4 /*yield*/, Promise.all(parsePromises)];
+            case 12:
                 result = _q.sent();
+                result = result.filter(Boolean);
                 // write vuepress sidebar
                 return [4 /*yield*/, createVuepressSidebar({
                         fileTree: lsFolder.tree,
@@ -280,14 +268,14 @@ var generate = function (argv) { return __awaiter(void 0, void 0, void 0, functi
                         codeFolder: codeFolder,
                         title: title
                     })];
-            case 21:
+            case 13:
                 // write vuepress sidebar
                 _q.sent();
                 try {
                     // print stats
                     for (_f = __values(lsFolder.excluded), _g = _f.next(); !_g.done; _g = _f.next()) {
                         file = _g.value;
-                        console.log(chalk_1.default.reset.inverse.bold.blue(' EXCLUDE '), "" + chalk_1.default.dim(file.folder) + chalk_1.default.bold(file.name + file.ext));
+                        console.log(chalk_1.default.reset.inverse.bold.blue(' EXCLUDE '), "".concat(chalk_1.default.dim(file.folder)).concat(chalk_1.default.bold(file.name + file.ext)));
                     }
                 }
                 catch (e_4_1) { e_4 = { error: e_4_1 }; }
@@ -309,7 +297,7 @@ var generate = function (argv) { return __awaiter(void 0, void 0, void 0, functi
                             _p[constants_1.StatisticType.EMPTY] = 'yellow',
                             _p[constants_1.StatisticType.EXCLUDE] = 'blue',
                             _p)[entry.type];
-                        console.log(chalk_1.default.reset.inverse.bold[color](" " + entry.type + " "), "" + chalk_1.default.dim(entry.relativePathSrc) + chalk_1.default.bold(entry.file.name + entry.file.ext) + " \u2192 " + chalk_1.default.dim(entry.relativePathDest) + chalk_1.default.bold(entry.file.name + '.md'));
+                        console.log(chalk_1.default.reset.inverse.bold[color](" ".concat(entry.type, " ")), "".concat(chalk_1.default.dim(entry.relativePathSrc)).concat(chalk_1.default.bold(entry.file.name + entry.file.ext), " \u2192 ").concat(chalk_1.default.dim(entry.relativePathDest)).concat(chalk_1.default.bold(entry.file.name + '.md')));
                     }
                 }
                 catch (e_5_1) { e_5 = { error: e_5_1 }; }
@@ -321,11 +309,11 @@ var generate = function (argv) { return __awaiter(void 0, void 0, void 0, functi
                 }
                 // create README.md
                 return [4 /*yield*/, createReadmeFile(argv, deletedPaths)];
-            case 22:
+            case 14:
                 // create README.md
                 _q.sent();
                 resultTime = (Math.abs(startTime - +new Date()) / 1000).toFixed(2);
-                console.log("\n\u23F0 Time: " + resultTime + "s");
+                console.log("\n\u23F0 Time: ".concat(resultTime, "s"));
                 watchFiles(argv);
                 return [2 /*return*/];
         }
@@ -337,50 +325,46 @@ exports.generate = generate;
  * @param {CLIArguments} argv
  */
 var watchFiles = function (argv) {
-    var _a = parseArguments(argv), exclude = _a.exclude, srcFolder = _a.srcFolder, codeFolder = _a.codeFolder, docsFolder = _a.docsFolder, title = _a.title;
+    var _a = parseArguments(argv), exclude = _a.exclude, include = _a.include, srcFolder = _a.srcFolder, codeFolder = _a.codeFolder, docsFolder = _a.docsFolder, title = _a.title;
     if (argv.watch) {
         console.log('\n---\n\n👀 watching files...');
-        var watcher = chokidar_1.default.watch([srcFolder, argv.readme, srcFolder + "/README.md"].filter(Boolean), {
+        var watcher = chokidar_1.default.watch([srcFolder, argv.readme, "".concat(srcFolder, "/README.md")].filter(Boolean), {
             ignored: /(^|[\/\\])\../,
             persistent: true
         });
         watcher.on('change', function (path) { return __awaiter(void 0, void 0, void 0, function () {
-            var lsFolder, file, data;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, (0, list_folder_1.listFolder)(srcFolder, exclude)];
+            var lsFolder, file;
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0: return [4 /*yield*/, (0, list_folder_1.listFolder)(srcFolder, exclude, include)];
                     case 1:
-                        lsFolder = _a.sent();
+                        lsFolder = _b.sent();
                         file = lsFolder.paths.find(function (p) { return p.path === path; });
                         readline_1.default.clearLine(process.stdout, 0);
                         readline_1.default.cursorTo(process.stdout, 0);
-                        if (!(path === 'README.md' || path === srcFolder + "/README.md")) return [3 /*break*/, 3];
+                        if (!(path === 'README.md' || path === "".concat(srcFolder, "/README.md"))) return [3 /*break*/, 3];
                         return [4 /*yield*/, createReadmeFile(argv)];
                     case 2:
-                        _a.sent();
-                        _a.label = 3;
+                        _b.sent();
+                        _b.label = 3;
                     case 3:
-                        if (!file) return [3 /*break*/, 8];
-                        process.stdout.write(chalk_1.default.dim("update " + (file.name + file.ext)));
-                        return [4 /*yield*/, parseDirectoryFile(file, argv)];
-                    case 4:
-                        data = _a.sent();
-                        if (!data) return [3 /*break*/, 6];
-                        return [4 /*yield*/, (0, parser_1.writeContentToFile)(data.content, data.dest)];
-                    case 5:
-                        _a.sent();
-                        _a.label = 6;
-                    case 6: return [4 /*yield*/, createVuepressSidebar({
-                            fileTree: lsFolder.tree,
-                            srcFolder: srcFolder,
-                            docsFolder: docsFolder,
-                            codeFolder: codeFolder,
-                            title: title
-                        })];
-                    case 7:
-                        _a.sent();
-                        _a.label = 8;
-                    case 8: return [2 /*return*/];
+                        if (file) {
+                            process.stdout.write(chalk_1.default.dim("update ".concat(file.name + file.ext)));
+                            (_a = parseDirectoryFile(file, argv)) === null || _a === void 0 ? void 0 : _a.then(function (data) {
+                                if (data) {
+                                    (0, parser_1.writeContentToFile)(data, data.relativePathDest);
+                                }
+                                createVuepressSidebar({
+                                    fileTree: lsFolder.tree,
+                                    srcFolder: srcFolder,
+                                    docsFolder: docsFolder,
+                                    codeFolder: codeFolder,
+                                    title: title
+                                });
+                            });
+                        }
+                        return [2 /*return*/];
                 }
             });
         }); });

package/dist/interfaces.d.ts

@@ -6,6 +6,7 @@ export interface DirectoryFile {
     folder?: string;
 }
 export interface CLIArguments {
+    include: string;
     exclude: string;
     partials: string[];
     rmPattern: string[];

package/dist/lib/comment-parser.js

@@ -53,10 +53,10 @@ exports.parseComment = parseComment;
 var parseVuepressFileHeader = function (content, file) {
     var _a = (0, exports.parseComment)(content), frontmatter = _a.frontmatter, attributes = _a.attributes;
     var fileContent = '---\n';
-    fileContent += !(attributes === null || attributes === void 0 ? void 0 : attributes.title) ? "title: " + file.name : '';
+    fileContent += !(attributes === null || attributes === void 0 ? void 0 : attributes.title) ? "title: ".concat(file.name) : '';
     if (frontmatter) {
         fileContent += !(attributes === null || attributes === void 0 ? void 0 : attributes.title) ? '\n' : '';
-        fileContent += "" + frontmatter;
+        fileContent += "".concat(frontmatter);
     }
     fileContent += '\n---\n';
     if ((attributes === null || attributes === void 0 ? void 0 : attributes.title) || file.ext !== '.vue') {
@@ -67,7 +67,7 @@ var parseVuepressFileHeader = function (content, file) {
         else if (attributes === null || attributes === void 0 ? void 0 : attributes.title) {
             headline = attributes.title;
         }
-        fileContent += "\n# " + headline + "\n\n";
+        fileContent += "\n# ".concat(headline, "\n\n");
     }
     return fileContent;
 };

package/dist/lib/list-folder.d.ts

@@ -3,11 +3,12 @@ import { DirectoryFile, FileTree } from '../interfaces';
  * Recursively traverse folders and return exluded files, a file list and a file tree.
  * @param {string} srcPath path to source dir
  * @param {array} exclude exluded file patter list
+ * @param {array} include included file patter list
  * @param {string} mainPath path to hold source dir
  * @param {object} tree tree array
  * @returns {object} paths array, tree, excluded array
  */
-export declare const listFolder: (srcPath: string, exclude: string[], mainPath?: string | undefined, tree?: FileTree[]) => Promise<{
+export declare const listFolder: (srcPath: string, exclude: string[], include: string[], mainPath?: string | undefined, tree?: FileTree[]) => Promise<{
     paths: DirectoryFile[];
     tree: FileTree[];
     excluded: DirectoryFile[];

package/dist/lib/list-folder.js

@@ -100,11 +100,12 @@ var path_1 = __importDefault(require("path"));
  * Recursively traverse folders and return exluded files, a file list and a file tree.
  * @param {string} srcPath path to source dir
  * @param {array} exclude exluded file patter list
+ * @param {array} include included file patter list
  * @param {string} mainPath path to hold source dir
  * @param {object} tree tree array
  * @returns {object} paths array, tree, excluded array
  */
-var listFolder = function (srcPath, exclude, mainPath, tree) {
+var listFolder = function (srcPath, exclude, include, mainPath, tree) {
     if (tree === void 0) { tree = []; }
     return __awaiter(void 0, void 0, void 0, function () {
         var paths, excluded, dirs, _a, dirs_1, dirs_1_1, dirent, filePath, isDir, ext, name_1, folder, file, baseSrc, treeEntry, _b, _c, _d, _e, e_1_1;
@@ -115,7 +116,11 @@ var listFolder = function (srcPath, exclude, mainPath, tree) {
                     if (!Boolean(exclude) || !Array.isArray(exclude)) {
                         exclude = [];
                     }
+                    if (!Boolean(include) || !Array.isArray(include)) {
+                        include = [];
+                    }
                     exclude = exclude.filter(Boolean);
+                    include = include.filter(Boolean);
                     paths = [];
                     excluded = [];
                     if (!srcPath) return [3 /*break*/, 2];
@@ -151,7 +156,8 @@ var listFolder = function (srcPath, exclude, mainPath, tree) {
                     if (name_1.toLowerCase() === 'readme')
                         return [3 /*break*/, 10];
                     baseSrc = mainPath || srcPath;
-                    if (!!micromatch_1.default.isMatch(path_1.default.join(srcPath.replace(baseSrc, ''), dirent.name), exclude)) return [3 /*break*/, 9];
+                    if (!(micromatch_1.default.every(path_1.default.join(srcPath.replace(baseSrc, ''), dirent.name), __spreadArray(__spreadArray([], __read(include), false), __read(exclude.map(function (e) { return '!' + e; })), false)) ||
+                        isDir)) return [3 /*break*/, 9];
                     treeEntry = {
                         name: name_1
                     };
@@ -160,12 +166,12 @@ var listFolder = function (srcPath, exclude, mainPath, tree) {
                     _c = (_b = paths.push).apply;
                     _d = [paths];
                     _e = [[]];
-                    return [4 /*yield*/, (0, exports.listFolder)(filePath, exclude, baseSrc, treeEntry.children)];
+                    return [4 /*yield*/, (0, exports.listFolder)(filePath, exclude, include, baseSrc, treeEntry.children)];
                 case 6:
                     _c.apply(_b, _d.concat([__spreadArray.apply(void 0, _e.concat([__read.apply(void 0, [(_g.sent()).paths]), false]))]));
                     return [3 /*break*/, 8];
                 case 7:
-                    treeEntry = __assign(__assign({}, treeEntry), { path: "/" + name_1, fullPath: path_1.default.join(srcPath, name_1), ext: ext });
+                    treeEntry = __assign(__assign({}, treeEntry), { path: "/".concat(name_1), fullPath: path_1.default.join(srcPath, name_1), ext: ext });
                     _g.label = 8;
                 case 8:
                     tree.push(treeEntry);

package/dist/lib/parser.js

@@ -123,6 +123,7 @@ var parseFile = function (file, srcFolder, destFolder, configPath, partials) { r
                     fileName = 'index';
                 }
                 return [4 /*yield*/, jsdoc_to_markdown_1.default.render({
+                        'no-cache': configPath ? true : false,
                         files: [(0, path_1.join)(process.cwd(), file.folder, fileName + file.ext)],
                         configure: configPath,
                         partial: __spreadArray([
@@ -133,7 +134,7 @@ var parseFile = function (file, srcFolder, destFolder, configPath, partials) { r
             case 2:
                 content = _b.sent();
                 _a = comment_parser_1.parseVuepressFileHeader;
-                return [4 /*yield*/, promises_1.default.readFile("" + (0, path_1.join)(folderInSrc, fileName + file.ext), 'utf-8')];
+                return [4 /*yield*/, promises_1.default.readFile("".concat((0, path_1.join)(folderInSrc, fileName + file.ext)), 'utf-8')];
             case 3:
                 fileContent = _a.apply(void 0, [_b.sent(), file]);
                 if (content) {
@@ -195,7 +196,7 @@ var parseVueFile = function (file, srcFolder, destFolder) { return __awaiter(voi
             case 2:
                 data = _b.sent();
                 _a = comment_parser_1.parseVuepressFileHeader;
-                return [4 /*yield*/, promises_1.default.readFile("" + (0, path_1.join)(folderInSrc, fileName + file.ext), 'utf-8')];
+                return [4 /*yield*/, promises_1.default.readFile("".concat((0, path_1.join)(folderInSrc, fileName + file.ext)), 'utf-8')];
             case 3:
                 fileContent = _a.apply(void 0, [_b.sent(), file]);
                 if (data.content) {
@@ -244,7 +245,7 @@ var writeContentToFile = function (parseData, dest) { return __awaiter(void 0, v
             case 1:
                 _b.trys.push([1, 5, , 6]);
                 if (!(parseData === null || parseData === void 0 ? void 0 : parseData.content)) return [3 /*break*/, 4];
-                path = (0, path_1.join)(dest, parseData.file.name) + ".md";
+                path = "".concat((0, path_1.join)(dest, parseData.file.name), ".md");
                 return [4 /*yield*/, (0, mkdirp_1.default)(dest)];
             case 2:
                 _b.sent();

package/dist/lib/vue-sidebar.js

@@ -50,7 +50,7 @@ var generateVueSidebar = function (_a) {
                 }
                 else if (child.fullPath) {
                     if (fs_1.default.existsSync((0, path_1.join)(docsFolder, child.fullPath.replace(srcFolder, '')) + '.md')) {
-                        newChildren.push(child.fullPath.replace(srcFolder + "/", ''));
+                        newChildren.push(child.fullPath.replace("".concat(srcFolder, "/"), ''));
                     }
                 }
             }
@@ -70,7 +70,7 @@ var generateVueSidebar = function (_a) {
         children: buildChildren(folder.children, folder.name, 0)
     }); });
     return _b = {},
-        _b["/" + codeFolder + "/"] = [
+        _b["/".concat(codeFolder, "/")] = [
             {
                 title: title,
                 collapsable: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vuepress-jsdoc",
-  "version": "4.2.0",
+  "version": "4.3.0",
   "description": "Generate jsdoc markdown files for vuepress",
   "main": "dist/index.js",
   "scripts": {
@@ -13,7 +13,7 @@
     "prepublishOnly": "npm i && npm run build",
     "prepare": "husky install",
     "version": "conventional-changelog -p karma -i CHANGELOG.md -s -r 0 && git add .",
-    "docs": "./bin/vuepress-jsdoc.js --source=./dist --partials=./example/partials/*.hbs --readme ./README.md --exclude=\"**/*.d.ts,**/interfaces.*,**/constants.*\"",
+    "docs": "./bin/vuepress-jsdoc.js --source=./dist --partials=./example/partials/*.hbs --readme ./README.md --include=\"**/*.(ts|js)\" --exclude=\"**/*.d.ts,**/interfaces.*,**/constants.*\"",
     "docs:dev": "npx concurrently --kill-others \"npm run dev\" \"npm run docs && npx vuepress dev documentation\"",
     "docs:build": "npm run build && npm run docs && npx vuepress build documentation"
   },
@@ -80,35 +80,35 @@
   },
   "dependencies": {
     "chalk": "^4.1.2",
-    "chokidar": "^3.5.2",
-    "commander": "^8.3.0",
+    "chokidar": "^3.5.3",
+    "commander": "^9.0.0",
     "del": "^6.0.0",
     "front-matter": "^4.0.2",
-    "jsdoc-to-markdown": "^7.1.0",
+    "jsdoc-to-markdown": "^7.1.1",
     "micromatch": "^4.0.4",
     "mkdirp": "^1.0.4",
-    "vue-docgen-cli": "^4.41.3"
+    "vue-docgen-cli": "^4.44.15"
   },
   "devDependencies": {
-    "@types/jest": "^27.0.2",
-    "@types/jsdoc-to-markdown": "^7.0.1",
+    "@types/jest": "^27.4.0",
+    "@types/jsdoc-to-markdown": "^7.0.3",
     "@types/micromatch": "^4.0.2",
     "@types/mkdirp": "^1.0.2",
-    "@typescript-eslint/eslint-plugin": "^5.4.0",
-    "@typescript-eslint/parser": "^5.4.0",
-    "babel-jest": "^27.3.1",
+    "@typescript-eslint/eslint-plugin": "^5.12.0",
+    "@typescript-eslint/parser": "^5.12.0",
+    "babel-jest": "^27.5.1",
     "cross-env": "^7.0.3",
-    "eslint": "^8.2.0",
+    "eslint": "^8.9.0",
     "eslint-config-prettier": "^8.3.0",
-    "eslint-plugin-import": "^2.25.3",
-    "eslint-plugin-jest": "^25.2.4",
+    "eslint-plugin-import": "^2.25.4",
+    "eslint-plugin-jest": "^26.1.1",
     "eslint-plugin-prefer-arrow": "^1.2.3",
     "husky": "^7.0.4",
-    "jest": "^27.3.1",
-    "lint-staged": "^12.0.2",
-    "memfs": "^3.3.0",
-    "ts-jest": "^27.0.7",
-    "typescript": "^4.4.4"
+    "jest": "^27.5.1",
+    "lint-staged": "^12.3.4",
+    "memfs": "^3.4.1",
+    "ts-jest": "^27.1.3",
+    "typescript": "^4.5.5"
   },
   "lint-staged": {
     "src/**/*.{css,scss,json}": [