markdown-maker 1.9.2 → 1.10.1

package/.github/workflows/node.js.yml

@@ -12,7 +12,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [12.x, 14.x, 15.x]
+        node-version: [16.x, 18.x, 20.x]
         # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
 
     steps:

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "markdown-maker",
-    "version": "1.9.2",
+    "version": "1.10.1",
     "description": "",
     "main": "src/cltool.ts",
     "bin": {
@@ -23,7 +23,7 @@
         ]
     },
     "scripts": {
-        "test": "mocha",
+        "test": "mocha --require test/hooks.js",
         "test:yarn": "mocha",
         "bundle": "tsc --project tsconfig.json",
         "main": "node build/cltool.js document/main.md -o dist/bundle.md --debug",
@@ -52,6 +52,7 @@
         "colors": "^1.4.0",
         "colors.ts": "^1.0.20",
         "marked": "^2.0.1",
+        "node-html-parser": "^6.1.13",
         "require-runtime": "^2.0.0",
         "ws": "^8.8.1"
     },

package/src/cltool.ts

@@ -11,7 +11,7 @@ const { version } = require("../package.json"); /* package version number */
 const choki = require("chokidar");
 
 export const argParser = new ArgumentParser({
-    description: "Markdown bundler, with extra options",
+    description: "Markdown bundler, with extra options. Extension file is loaded from ./extensions.js, if it exists",
     prog: "mdparse",
 });
 
@@ -92,6 +92,14 @@ function main() {
         clargs = argParser.parse_args();
     }
 
+    /* if src is init, create config file and exit */
+    if (clargs.src == "init") {
+        const template = fs.readFileSync(path.join(__dirname, "..", "src", "templates", "configTemplate.json"));
+        fs.writeFileSync(configFileName, template);
+        fs.writeFileSync("main.md", "# Main\n");
+        return;
+    }
+
     /* helper method for calling parser */
     const compile = (source, output, cb?) => {
         /* load data from file, if it exists,
@@ -140,9 +148,8 @@ function main() {
 
     /* compile once */
     if (!clargs.watch) compile(clargs.src, clargs.output);
-
     /* watch the folder and recompile on change */
-    if (clargs.watch) {
+    else {
         const srcDirName = path.dirname(clargs.src);
         console.log(`Watching ${srcDirName} for changes...`.yellow);
         server = new WebSocketServer({ port: 7788 });
@@ -154,6 +161,7 @@ function main() {
             console.log(e.message);
         }
     }
+
 }
 
 /* main entrypoint */

package/src/commands.ts

@@ -3,6 +3,7 @@ import Parser from "./parse";
 import * as fs from "fs";
 import templates, { new_template } from "./templates";
 import requireRuntime from "require-runtime";
+import * as nodeHtmlParser from "node-html-parser";
 
 export class MDMError extends Error {
     match: RegExpMatchArray;
@@ -42,7 +43,7 @@ export class Command {
     constructor(
         validator: RegExp,
         acter: (match: RegExpMatchArray, parser: Parser) => string | void,
-        type: CommandType,
+        type: CommandType
     ) {
         this.type = type;
         this.validator = validator;
@@ -71,7 +72,7 @@ export class Command {
 new Command(
     /(\s|^)<(.+)>/,
     (match, parser) => `${match[1]}#mdvar<${match[2]}>`,
-    CommandType.PREPARSE,
+    CommandType.PREPARSE
 );
 
 /* mddef */
@@ -80,7 +81,7 @@ new Command(
     (match, parser) => {
         parser.opts.defs[match[1]] = match[2].replace("_", " ");
     },
-    CommandType.PARSE,
+    CommandType.PARSE
 );
 
 /* mdvar */
@@ -92,7 +93,7 @@ new Command(
             throw new Error(`Undefined variable: ${match[1]}`);
         return (value = value || `<${match[1]}>`);
     },
-    CommandType.PARSE,
+    CommandType.PARSE
 );
 
 /** mdinclude */
@@ -107,17 +108,31 @@ new Command(
         }
 
         /* get the matching group */
-        const [_, name, condition] = match;
+        let [_, name, condition] = match;
 
         /* implement conditional imports */
         if (condition && !parser.opts.args.includes(condition)) return;
 
+        const fsstat = fs.lstatSync(path.join(parser.wd, name));
+        if (fsstat.isDirectory()) {
+            /* check if a file with the same name of the
+             * exists in the folder */
+
+            if (fs.existsSync(path.join(parser.wd, name, `${name}.md`))) {
+                name = path.join(name, `${name}.md`);
+            } else {
+                throw new Error(
+                    `No entry file found in folder "${name}". Looking for "${name}.md"`
+                );
+            }
+        }
+
         const recursiveParser = new Parser(
             path.join(parser.wd, name),
             parser.opts,
             {
                 parent: parser,
-            },
+            }
         );
 
         /* keep the options the same */
@@ -134,7 +149,7 @@ new Command(
         parser.opts.depth--;
         return blob;
     },
-    CommandType.PARSE,
+    CommandType.PARSE
 );
 
 /* mdlabel */
@@ -149,7 +164,7 @@ new Command(
         parser.opts.secs.push({ level, title });
         return `<span id="${link}"></span>`;
     },
-    CommandType.PREPARSE,
+    CommandType.PREPARSE
 );
 
 /* mdref */
@@ -163,7 +178,7 @@ new Command(
 
             if (i === parser.opts.secs.length - 1)
                 throw new Error(
-                    `Reference to [${match[1]}] could not be resolved!`,
+                    `Reference to [${match[1]}] could not be resolved!`
                 );
         }
 
@@ -174,12 +189,12 @@ new Command(
         else if (parser.opts.targetType === TargetType.MARKDOWN)
             return `[${match[1]}](#${link})`;
     },
-    CommandType.PARSE,
+    CommandType.PARSE
 );
 
 /* mdtemplate */
 new Command(
-    /#mdtemplate<([\w\W]+)>/,
+    /#mdtemplate<(\w+?)>/,
     (match, parser) => {
         const template = match[1];
         const replacement = templates[template];
@@ -190,49 +205,92 @@ new Command(
             throw new MDMError(`Template \"${template}\" not found!`, match);
         }
     },
-    CommandType.PARSE,
+    CommandType.PARSE
 );
 
+/* mdmaketoc */
 new Command(
     /#mdmaketoc(?:<>)?/,
     (match, parser) => parser.gen_toc(),
-    CommandType.POSTPARSE,
+    CommandType.POSTPARSE
 );
 
-export function load_extensions(parser: Parser) {
-    /* global extention */
-    const global_extensions_path = path.join(process.cwd(), "extensions.js");
-    if (fs.existsSync(global_extensions_path)) {
-        const extensions = requireRuntime(global_extensions_path);
+/* basic mdhook */
+new Command(
+    /#mdhook<(\w+)>/,
+    (match, parser) => {
+        if (parser.opts.hooks[match[1]]) {
+            return parser.opts.hooks[match[1]]();
+        }
+    },
+    CommandType.POSTPARSE
+);
+
+/* mdadvhook */
+new Command(
+    /\#mdadvhook<(\w+)>([\w\W]+?)\#mdendhook/,
+    (match, parser) => {
+        if (parser.opts.adv_hooks[match[1]]) {
+            const innerElements = match[2].trim();
+            /* Find tagNames in innerElements */
+            const re = /<(\w+)[\s=\w\"\'-]*>/g;
+            const tags = [];
+            innerElements.match(re)?.forEach((tag) => {
+                tags.push(tag.slice(1, -1).split(" ")[0]);
+            });
+            /* Evil type hack */
+            const root = nodeHtmlParser.parse(innerElements, {
+                voidTag: {
+                    tags,
+                    closingSlash: true,
+                },
+            }) as any as HTMLElement;
+
+            const helper = (node: HTMLElement) => {
+                /*  */
+                const map: { [tag: string]: HTMLElement } = {};
+                for (let tag of tags) {
+                    const el = node.getElementsByTagName(tag)[0];
+                    const dataTag = el.toString().match(/data-tag="([\w-]+)"/);
+                    if (!dataTag || dataTag[1] == undefined) continue;
+                    el.tagName = dataTag[1];
+                    el.removeAttribute("data-tag");
+                    map[tag] = el;
+                }
+                return map;
+            };
+
+            const hooked = parser.opts.adv_hooks[match[1]](root, helper(root));
+            return hooked.toString();
+        }
+    },
+    CommandType.POSTPARSE
+);
+
+const loaded_extentions: fs.PathLike[] = [];
+
+function load_extension(parser: Parser, file: fs.PathLike) {
+    if (loaded_extentions.includes(file)) return;
+    if (fs.existsSync(file)) {
+        const extensions = requireRuntime(file);
+        loaded_extentions.push(file);
         extensions.main(new_template, new_command);
 
         if (parser.opts.verbose)
-            console.log(
-                `Loaded global extensions from ${global_extensions_path}`
-                    .yellow,
-            );
+            console.log(`Loaded extensions from ${file}`.yellow);
     } else if (parser.opts.debug) {
-        console.log(
-            `No global extensions found at ${global_extensions_path}`.red,
-        );
+        console.log(`No extensions found at ${file}`.red);
     }
+}
+
+export function load_extensions(parser: Parser) {
+    /* global extention */
+    const global_extensions_path = path.join(__dirname, "extensions.js");
+    load_extension(parser, global_extensions_path);
 
     /* project extention */
     const project_extensions_path = path.join(parser.wd_full, "extensions.js");
-    if (fs.existsSync(project_extensions_path)) {
-        const extensions = requireRuntime(project_extensions_path);
-        extensions.main(new_template, new_command);
-
-        if (parser.opts.verbose)
-            console.log(
-                `Loaded project extensions from ${project_extensions_path}`
-                    .yellow,
-            );
-    } else if (parser.opts.debug) {
-        console.log(
-            `No project extensions found at ${project_extensions_path}!`.red,
-        );
-    }
+    load_extension(parser, project_extensions_path);
 }
 
 /**
@@ -244,7 +302,7 @@ export function load_extensions(parser: Parser) {
 export function new_command(
     regex: RegExp,
     acter: (match: RegExpMatchArray, parser: Parser) => string,
-    type?: CommandType,
+    type?: CommandType
 ) {
     new Command(regex, acter, type || CommandType.PARSE);
 }

package/src/parse.ts

@@ -1,9 +1,10 @@
-const fs = require("fs"); /* for handling reading of files */
-const path = require("path"); /* for handling file paths */
+import fs from "fs"; /* for handling reading of files */
+import path from "path"; /* for handling file paths */
 
 import Colors = require("colors.ts"); /* for adding colours to strings */
 Colors.enable();
-const marked = require("marked");
+import marked from "marked";
+
 import { Command, commands, load_extensions, MDMError } from "./commands";
 
 enum TargetType {
@@ -43,6 +44,13 @@ class Parser {
         targetType: TargetType | undefined;
         only_warn: boolean;
         parent?: Parser;
+        hooks: { [key: string]: () => string };
+        adv_hooks: {
+            [key: string]: (
+                tree: HTMLElement,
+                map: { [tag: string]: HTMLElement }
+            ) => HTMLElement;
+        };
         isFileCallback: (s: string) => false | string;
     };
     raw: string;
@@ -89,6 +97,8 @@ class Parser {
             targetType: undefined,
             only_warn: false,
             parent: undefined,
+            hooks: {},
+            adv_hooks: {},
             isFileCallback: (f) => {
                 if (!fs.existsSync(f)) return false;
                 return fs.readFileSync(f, "utf-8") + "\n";
@@ -237,13 +247,27 @@ class Parser {
             const link = this.titleId(title);
 
             let __line =
-                hor.repeat(Math.max(sec.level - 1, 0)) + beg + `[${title}](#${link})`;
+                hor.repeat(Math.max(sec.level - 1, 0)) +
+                beg +
+                `[${title}](#${link})`;
 
             __blob.push(__line);
         });
         return __blob.join("\n");
     }
 
+    add_hook(name: string, hook: () => string) {
+        if (this.opts.hooks[name] != undefined)
+            throw new Error(`Hook ${name} already exists!`);
+        this.opts.hooks[name] = hook;
+    }
+
+    add_adv_hook(name: string, hook: (tree: HTMLElement) => HTMLElement) {
+        if (this.opts.hooks[name] != undefined)
+            throw new Error(`Hook ${name} already exists!`);
+        this.opts.adv_hooks[name] = hook;
+    }
+
     line_num_from_index(index: number) {
         return this.raw.substring(0, index).split("\n").length + 1;
     }
@@ -258,27 +282,21 @@ class Parser {
     /* output the parsed document to bundle */
     to(bundleName: string, callback: (fileName: string) => void) {
         const dir = path.dirname(bundleName);
-        var called = false;
         if (callback === undefined) callback = () => {};
 
         if (!fs.existsSync(dir)) {
             fs.mkdirSync(dir, { recursive: true });
         }
-        this.get(TargetType.MARKDOWN, (blob) => {
-            fs.writeFile(bundleName, blob, () => {
-                if (!this.opts.html) {
-                    callback(bundleName);
-                    called = true;
-                }
-            });
-        });
 
-        if (this.opts.html) {
-            const htmlFileName = bundleName.replace(".md", ".html");
-            fs.writeFile(htmlFileName, this.html(), () => {
-                if (!called) callback(htmlFileName);
-                called = true;
+        if (!this.opts.html) {
+            this.get(TargetType.MARKDOWN, (blob) => {
+                fs.writeFile(bundleName, blob, () => callback(bundleName));
             });
+        } else {
+            const htmlFileName = bundleName.replace(".md", ".html");
+            fs.writeFile(htmlFileName, this.html(), () =>
+                callback(htmlFileName)
+            );
         }
     }
 
@@ -293,7 +311,7 @@ class Parser {
         return htmlFormatted;
     }
 
-    get(targetType?: TargetType, callback?) {
+    get(targetType?: TargetType, callback?: (blob: string) => void): string {
         /* If target type is undefined, markdown is the default */
         if (targetType === undefined) targetType = TargetType.MARKDOWN;
         if (this.blobs[targetType]) {
@@ -309,8 +327,8 @@ class Parser {
                 if (callback) callback(blob);
                 return blob;
             } catch (error) {
+                /* Compile a traceback of error */
                 let traceback = "";
-
                 let p: Parser = this;
 
                 do {
@@ -318,13 +336,15 @@ class Parser {
                         traceback += `\n...on line ${p.line_num_from_index(
                             error.match.index
                         )} in ${p.file}`.grey(15);
-                    else traceback += `\n...on line ${p.line_num} in ${p.file}`.grey(15);
+                    else
+                        traceback +=
+                            `\n...on line ${p.line_num} in ${p.file}`.grey(15);
                     if (p.parent) p = p.parent;
                 } while (p.parent);
 
                 error.message += traceback;
 
-                /* only interested in stacktrace, when debugging */
+                /* only interested in node stacktrace when debugging */
                 if (!this.opts.debug) error.stack = "";
 
                 if (this.opts.only_warn) console.error(error);
@@ -345,7 +365,7 @@ export function splice(
     return start + newSubStr + end;
 }
 
-/* add extention to marked */
+/* add extention to marked for classed blockquotes*/
 marked.use({
     renderer: {
         blockquote(quote) {
@@ -359,7 +379,8 @@ marked.use({
             const id = args.filter((arg) => arg.startsWith("#"));
 
             const classNames = classes.map((c) => c.slice(1));
-            const classText = classes.length > 0 ? `class="${classNames.join(" ")}"` : "";
+            const classText =
+                classes.length > 0 ? `class="${classNames.join(" ")}"` : "";
             const idText = id.length > 0 ? `id="${id[0].slice(1)}"` : "";
 
             /* remove the ending from the quote */

package/src/templates/configTemplate.json

@@ -0,0 +1,13 @@
+{
+	"opts": {
+		"src": "main.md",
+		"verbose": false,
+		"debug": false,
+		"output": "dist/bundle.md",
+		"max-depth": 3,
+		"toc-level": 3,
+		"watch": false,
+		"html": false,
+		"allow-undefined": false
+	}
+}

package/test/advanced.test.js

@@ -1,12 +1,16 @@
 const util = require("./tester.test.js");
 
-util.put(
-    "module.exports = {main: (new_template, new_command) => {new_template('hi', 'hello'); new_command(/#test_cmd/, (t,p) => 'yeet', 0);}};",
-    "extensions.js"
-);
+const putTemplate = () => {
+    util.put(
+        "module.exports = {main: (new_template, new_command) => {new_template('hi', 'hello'); new_command(/#test_cmd/, (t,p) => 'yeet', 0);}};",
+        "extensions.js"
+    );
+};
 
 describe("Use of templates", () => {
+    beforeEach(putTemplate);
     it("should import presentation template as expected", () => {
+        putTemplate();
         const output = new util.Parser("#mdtemplate<presentation>").get();
         const template = `<style>html {width: 100vw;height: 100vh;}.slide {padding: 5%;border-radius: 25px;margin: 0;}div > .slide-num {position: absolute;top: 12.5%;right: 15%;/* font-size: 150%; */}body {margin: 5% 15%;}img {max-width: 100%;max-height: 40vh;}</style><script>document.addEventListener("DOMContentLoaded", () => {let current_slide = 0;const all_slides = document.querySelectorAll("div.slide");const num_slides = all_slides.length;all_slides.forEach((slide) => {const num_elem = document.createElement("p");num_elem.classList.add("slide-num");slide.appendChild(num_elem);});onkeydown = (ev) => {if (ev.key == "ArrowRight" && current_slide < all_slides.length - 1)update_slide(++current_slide);else if (ev.key == "ArrowLeft" && current_slide > 0)update_slide(--current_slide);};const update_slide = (index) => {all_slides.forEach((slide) => (slide.style.display = "none"));all_slides[current_slide].style.display = "block";all_slides[current_slide].lastChild.textContent = \`\${current_slide + 1} / \${num_slides}\`;};update_slide(current_slide);});</script>`;
 
@@ -14,22 +18,20 @@ describe("Use of templates", () => {
     });
 
     it("should use custom templates from project extensions.js file", () => {
+        putTemplate();
         util.put("#mdtemplate<hi>", "sample1.md");
 
         util.assert.strictEqual(
             new util.Parser("test/test-files/sample1.md").get(),
             "hello\n\n"
         );
-
-        /* make sure to remove after, to not mess with future tests */
     });
 
     it("should use custom commands from project extensions.js file", () => {
+        putTemplate();
         util.put("#test_cmd", "sample1.md");
 
         const parser = new util.Parser("test/test-files/sample1.md");
         util.assert.strictEqual(parser.get(), "yeet\n\n");
-
-        /* make sure to remove after, to not mess with future tests */
     });
 });

package/test/basic.test.js

@@ -54,4 +54,14 @@ describe("Basic features", () => {
 
         util.assert.strictEqual(parser.get(), "### Title\n[Title](#title)\n\n");
     });
+    it("should include file with same name as folder when including a folder", () => {
+        util.put("#mdinclude<sample_fld>", "sample1.md");
+        util.putDir("sample_fld");
+        util.put("hello", util.path.join("sample_fld", "sample_fld.md"));
+
+        const parser = new util.Parser("test/test-files/sample1.md");
+        const output = parser.get();
+
+        util.assert.strictEqual(output, "hello\n\n");
+    });
 });

package/test/errors.test.js

@@ -1,4 +1,3 @@
-const { Parser } = require("marked");
 const util = require("./tester.test.js");
 
 describe("Error handling", () => {
@@ -23,4 +22,26 @@ describe("Error handling", () => {
 
         util.assert.strictEqual(e.message.replace(/(\\)+/g, "/"), answer);
     });
+    it("should dissallow loading a folder without an entry file", () => {
+        util.put("#mdinclude<sample_fld>", "sample1.md");
+        util.putDir("sample_fld");
+
+        const parser = new util.Parser("test/test-files/sample1.md");
+
+        let e;
+        util.assert.throws(() => {
+            try {
+                parser.get();
+            } catch (_e) {
+                e = _e;
+                throw _e;
+            }
+        }, Error);
+
+        let answer =
+            'No entry file found in folder "sample_fld". Looking for "sample_fld.md"' +
+            "\n...on line 1 in test/test-files/sample1.md".grey(15);
+
+        util.assert.strictEqual(e.message.replace(/(\\)+/g, "/"), answer);
+    });
 });

package/test/hooks.js

@@ -0,0 +1,9 @@
+const fs = require("fs");
+
+exports.mochaHooks = {
+    beforeEach(done) {
+        fs.rmSync("test/test-files", { recursive: true });
+        fs.mkdirSync("test/test-files");
+        done();
+    },
+};

package/test/hooks.test.js

@@ -0,0 +1,114 @@
+const util = require("./tester.test.js");
+
+describe("Use of markdown hooks for SSR", () => {
+    it("should allow a simple hook to be used", () => {
+        util.put("#mdhook<test>", "sample1.md");
+
+        const parser = new util.Parser("test/test-files/sample1.md");
+        parser.add_hook("test", () => "hello");
+        const output = parser.get();
+
+        util.assert.strictEqual(output, "hello\n\n");
+    });
+    it("should allow advanced hooks to be used", () => {
+        util.put(
+            "#mdadvhook<test>\n<b>Bold</b>\n<p>Paragraph</p>\n#mdendhook",
+            "sample1.md"
+        );
+
+        const replacer = (arg) => {
+            const elem = new util.html.HTMLElement("p", {});
+            elem.set_content("complete");
+            return elem;
+        };
+
+        const parser = new util.Parser("test/test-files/sample1.md");
+        parser.opts.allow_undefined = true;
+        parser.add_adv_hook("test", replacer);
+        const output = parser.get();
+
+        util.assert.strictEqual(output, "<p>complete</p>\n\n");
+    });
+    it("should allow for hooks to be used in HTML", () => {
+        util.put("<html><body>#mdhook<test></body></html>", "sample1.html");
+
+        const parser = new util.Parser("test/test-files/sample1.html");
+        parser.opts.allow_undefined = true;
+        parser.add_hook("test", () => "hello");
+        const output = parser.get();
+
+        util.assert.strictEqual(output, "<html><body>hello</body></html>\n\n");
+    });
+    it("should allow for hooks to be used in HTML with advanced hooks", () => {
+        util.put(
+            "<html><body>#mdadvhook<test>\n<b>Bold</b>\n<p>Paragraph</p>\n#mdendhook</body></html>",
+            "sample1.html"
+        );
+
+        const replacer = (arg) => {
+            const elem = new util.html.HTMLElement("p", {});
+            elem.set_content("complete");
+            return elem;
+        };
+
+        const parser = new util.Parser("test/test-files/sample1.html");
+        parser.opts.allow_undefined = true;
+        parser.add_adv_hook("test", replacer);
+        const output = parser.get();
+
+        util.assert.strictEqual(
+            output,
+            "<html><body><p>complete</p></body></html>\n\n"
+        );
+    });
+    it("should allow for extracting a node from the document as a template manually with ids", () => {
+        util.put(
+            `<html><body>#mdadvhook<template><name id="b"></name><class id="p"></class>#mdendhook</body></html>`,
+            "sample1.html"
+        );
+
+        const replacer = (elem) => {
+            const nameElem = elem.getElementsByTagName("name")[0];
+            nameElem.tagName = nameElem.id;
+            nameElem.removeAttribute("id");
+            nameElem.set_content("bold");
+            const classElem = elem.getElementsByTagName("class")[0];
+            classElem.tagName = classElem.id;
+            classElem.removeAttribute("id");
+            classElem.set_content("paragraph");
+            return elem;
+        };
+
+        const parser = new util.Parser("test/test-files/sample1.html");
+        parser.opts.allow_undefined = true;
+        parser.add_adv_hook("template", replacer);
+        const output = parser.get();
+
+        util.assert.strictEqual(
+            output,
+            "<html><body><b>bold</b><p>paragraph</p></body></html>\n\n"
+        );
+    });
+    it("should allow for extracting a node from the document as a template using map and data-tags", () => {
+        util.put(
+            `<html><body>#mdadvhook<template><name data-tag="b"></name><class data-tag="p"></class>#mdendhook</body></html>`,
+            "sample1.html"
+        );
+
+        const replacer = (elem, map) => {
+            map["name"].set_content("bold");
+            map["class"].set_content("paragraph");
+            return elem;
+        };
+
+        const parser = new util.Parser("test/test-files/sample1.html");
+        parser.opts.allow_undefined = true;
+        parser.add_adv_hook("template", replacer);
+        const output = parser.get();
+
+        util.assert.strictEqual(
+            output,
+            "<html><body><b>bold</b><p>paragraph</p></body></html>\n\n"
+        );
+    });
+});

package/test/line.test.js

@@ -3,7 +3,7 @@ const util = require("./tester.test");
 describe("Managing blank lines", () => {
     it("should always end with 2 blank lines, even with no input", () => {
         const output = new util.Parser("").get();
-        util.assert.strictEqual(output, "\n\n")
+        util.assert.strictEqual(output, "\n\n");
     });
 
     it("should reduce blank lines to 2", () => {
@@ -16,8 +16,6 @@ describe("Managing blank lines", () => {
 
     it("should allow words when removing blank lines", () => {
         const output = new util.Parser("hii\n\n\n").get();
-        util.assert.strictEqual(output, "hii\n\n")
+        util.assert.strictEqual(output, "hii\n\n");
     });
 });
-
-

package/test/target.test.js

@@ -1,35 +1,43 @@
 const util = require("./tester.test.js");
 
 describe("Target specific functionality", () => {
-
-	describe("HTML", () => {
-		it("Should include `#mdlabel` command, when compiling HTML", () => {
-			const parser = new util.Parser("#mdlabel<0,Cool!>");
-			const html = parser.get(util.TargetType.HTML);
-
-			util.assert.strictEqual(html, '<span id="cool"></span>\n\n')
-		});
-
-		it("Should link to sections with #mdref", () => {
-			const parser = new util.Parser("#mdlabel<0,Cool!>\n#mdlabel<1,coolzz>\n#mdref<Cool!>");
-			const html = parser.get(util.TargetType.HTML);
-
-			util.assert.strictEqual(html, '<span id="cool"></span>\n<span id="coolzz"></span>\n<a href="#cool">Cool!</a>\n\n');
-		})
-	});
-
-	describe("Markdown", () => {
-		it("Should not include `#mdlabel` command, when compiling Markdown", () => {
-			const parser = new util.Parser("#mdlabel<0,Cool!>");
-
-			const md = parser.get(util.TargetType.MARKDOWN);
-			util.assert.strictEqual(md, '\n\n')
-		});
-		it("Should include #mdref to title elements in markdown", () => {
-			const output = new util.Parser("# Some Title!\n#mdref<Some Title!>").get();
-
-			util.assert.strictEqual(output, '# Some Title!\n[Some Title!](#some-title)\n\n')
-		});
-
-	})
-});
+    describe("HTML", () => {
+        it("Should include `#mdlabel` command, when compiling HTML", () => {
+            const parser = new util.Parser("#mdlabel<0,Cool!>");
+            const html = parser.get(util.TargetType.HTML);
+
+            util.assert.strictEqual(html, '<span id="cool"></span>\n\n');
+        });
+
+        it("Should link to sections with #mdref", () => {
+            const parser = new util.Parser(
+                "#mdlabel<0,Cool!>\n#mdlabel<1,coolzz>\n#mdref<Cool!>"
+            );
+            const html = parser.get(util.TargetType.HTML);
+
+            util.assert.strictEqual(
+                html,
+                '<span id="cool"></span>\n<span id="coolzz"></span>\n<a href="#cool">Cool!</a>\n\n'
+            );
+        });
+    });
+
+    describe("Markdown", () => {
+        it("Should not include `#mdlabel` command, when compiling Markdown", () => {
+            const parser = new util.Parser("#mdlabel<0,Cool!>");
+
+            const md = parser.get(util.TargetType.MARKDOWN);
+            util.assert.strictEqual(md, "\n\n");
+        });
+        it("Should include #mdref to title elements in markdown", () => {
+            const output = new util.Parser(
+                "# Some Title!\n#mdref<Some Title!>"
+            ).get();
+
+            util.assert.strictEqual(
+                output,
+                "# Some Title!\n[Some Title!](#some-title)\n\n"
+            );
+        });
+    });
+});

package/test/tester.test.js

@@ -1,8 +1,8 @@
 const fs = require("fs");
 const assert = require("assert");
 const Parser = require("../build/parse");
-
-
+const path = require("path");
+const html = require("node-html-parser");
 
 /* make folder for temporary files, if it doesn't exist */
 if (
@@ -12,8 +12,16 @@ if (
     fs.mkdirSync("test/test-files");
 }
 
+/**
+ * Create a new file under `test/test-files` with the given content.
+ * @param {string} text
+ * @param {string} file
+ */
 function put(text, file) {
-    fs.writeFileSync("test/test-files/" + file, text);
+    fs.writeFileSync(path.join("test", "test-files", file), text);
+}
+function putDir(name) {
+    fs.mkdirSync(path.join("test", "test-files", name));
 }
 
 const TargetType = {
@@ -22,9 +30,12 @@ const TargetType = {
 };
 
 module.exports = {
-    fs,
     assert,
+    fs,
+    html,
+    path,
     Parser,
     put,
+    putDir,
     TargetType,
 };

package/test/vars.test.js

@@ -1,57 +1,49 @@
-const util = require("./tester.test");
+const util = require("./tester.test.js");
 
 describe("Use variables", () => {
-    it('should replace var with the value', () => {
+    it("should replace var with the value", () => {
         const output = new util.Parser("#mddef<hi=yo>\n#mdvar<hi>").get();
 
-        util.assert.strictEqual(output, "\nyo\n\n")
+        util.assert.strictEqual(output, "\nyo\n\n");
     });
-    it('should use variable shorthand', () => {
+    it("should use variable shorthand", () => {
         const output = new util.Parser("#mddef<hi=yo>\n<hi>").get();
 
-        util.assert.strictEqual(output, "\nyo\n\n")
+        util.assert.strictEqual(output, "\nyo\n\n");
     });
-    it('should use variables across files', () => {
+    it("should use variables across files", () => {
         util.put("#mddef<hi=yo>\n#mdinclude<sample2.md>", "sample1.md");
         util.put("<hi>", "sample2.md");
 
         const output = new util.Parser("test/test-files/sample1.md").get();
 
-        util.assert.strictEqual(output, "\nyo\n\n")
-    })
-    it('should throw if undefined variable', () => {
-
+        util.assert.strictEqual(output, "\nyo\n\n");
+    });
+    it("should throw if undefined variable", () => {
         const parser = new util.Parser("<yo>");
 
         let e;
         /* should throw an error */
-        util.assert.throws(
-            () => {
-                try {
-                    parser.get();
-                } catch (_e) {
-                    e = _e;
-                    throw _e;
-                }
+        util.assert.throws(() => {
+            try {
+                parser.get();
+            } catch (_e) {
+                e = _e;
+                throw _e;
             }
-        );
-
-
-
+        });
     });
 
-    it('should preserve whatever comes after', () => {
+    it("should preserve whatever comes after", () => {
         const output = new util.Parser("#mddef<hi=yo>\n<hi>,").get();
         util.assert.strictEqual(output, "\nyo,\n\n");
     });
 
-    it('should replace underscore with space', () => {
-        const output = new util.Parser("#mddef<name=Mr_Sir>\n#mdvar<name>").get();
+    it("should replace underscore with space", () => {
+        const output = new util.Parser(
+            "#mddef<name=Mr_Sir>\n#mdvar<name>"
+        ).get();
 
-        util.assert.strictEqual(output, "\nMr Sir\n\n")
+        util.assert.strictEqual(output, "\nMr Sir\n\n");
     });
-
 });
-
-
-

package/doc/.mdmconfig.json

@@ -1,7 +0,0 @@
-{
-    "opts": {
-        "src": "main.md",
-        "use-underscore": true,
-        "html": true
-    }
-}

package/doc/main.md

@@ -1,2 +0,0 @@
-Hello there!
-#mdinclude<other.md>

package/doc/other.md

@@ -1 +0,0 @@
-From the other siiiiiide!

package/re-test.js

@@ -1,10 +0,0 @@
-const s = "hello1, hello2, hello3";
-
-const re = /hello(?<digit>\d)/g;
-
-let m = s.replace(re, (match, ...args) => {
-	console.log(args);
-	return "world";
-});
-
-console.log({ s, m });