markdown-maker 1.10.2 → 1.10.3

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

@@ -1,35 +1,30 @@
 # This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
 # For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
 
-name: Mocha
+name: Jest
 
 on: [push, pull_request]
 
 jobs:
-  build:
+    build:
+        runs-on: ubuntu-latest
 
-    runs-on: ubuntu-latest
+        strategy:
+            matrix:
+                node-version: [20.x, 21.x, 22.x]
+                # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
 
-    strategy:
-      matrix:
-        node-version: [16.x, 18.x, 20.x]
-        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
-
-    steps:
-    - uses: actions/checkout@v2
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v1
-      with:
-        node-version: ${{ matrix.node-version }}
-    - name: yarn install
-      uses: borales/actions-yarn@v3.0.0
-      with:
-        cmd: install # will run `yarn install` command
-    - name: yarn build
-      uses: borales/actions-yarn@v3.0.0
-      with:
-        cmd: build # will run `yarn build` command
-    - name: yarn test
-      uses: borales/actions-yarn@v3.0.0
-      with:
-        cmd: test # will run `yarn test` command
+        steps:
+            - uses: actions/checkout@v2
+            - name: Use Node.js ${{ matrix.node-version }}
+              uses: actions/setup-node@v1
+              with:
+                  node-version: ${{ matrix.node-version }}
+            - name: yarn install
+              uses: borales/actions-yarn@v3.0.0
+              with:
+                  cmd: install # will run `yarn install` command
+            - name: yarn test
+              uses: borales/actions-yarn@v3.0.0
+              with:
+                  cmd: test # will run `yarn test` command

package/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+	"recommendations": ["orta.vscode-jest", "github.vscode-github-actions"]
+}

package/.vscode/settings.json

@@ -1,5 +1,10 @@
 {
-    "editor.formatOnPaste": true,
-    "editor.defaultFormatter": "esbenp.prettier-vscode",
-    "prettier.tabWidth": 4
+	"editor.formatOnPaste": true,
+	"editor.defaultFormatter": "esbenp.prettier-vscode",
+	"prettier.tabWidth": 4,
+	"prettier.useEditorConfig": true,
+	"prettier.configPath": "",
+	"prettier.requireConfig": false,
+	"prettier.useTabs": true,
+	"jest.jestCommandLine": "npx jest -i"
 }

package/.vscode/snippets.code-snippets

@@ -1,9 +1,9 @@
 {
-	// Place your markdown-maker workspace snippets here. Each snippet is defined under a snippet name and has a scope, prefix, body and 
-	// description. Add comma separated ids of the languages where the snippet is applicable in the scope field. If scope 
-	// is left empty or omitted, the snippet gets applied to all languages. The prefix is what is 
-	// used to trigger the snippet and the body will be expanded and inserted. Possible variables are: 
-	// $1, $2 for tab stops, $0 for the final cursor position, and ${1:label}, ${2:another} for placeholders. 
+	// Place your markdown-maker workspace snippets here. Each snippet is defined under a snippet name and has a scope, prefix, body and
+	// description. Add comma separated ids of the languages where the snippet is applicable in the scope field. If scope
+	// is left empty or omitted, the snippet gets applied to all languages. The prefix is what is
+	// used to trigger the snippet and the body will be expanded and inserted. Possible variables are:
+	// $1, $2 for tab stops, $0 for the final cursor position, and ${1:label}, ${2:another} for placeholders.
 	// Placeholders with the same ids are connected.
 	// Example:
 	// "Print to console": {
@@ -15,7 +15,7 @@
 	// 	],
 	// 	"description": "Log output to console"
 	// }
-	"MD Command" : {
+	"MD Command": {
 		"scope": "javascript,typescript",
 		"prefix": "cummy",
 		"body": [
@@ -27,6 +27,4 @@
 		],
 		"description": "Snippet for a new command"
 	}
-
 }
-

package/jest.config.js

@@ -0,0 +1,7 @@
+module.exports = {
+	transform: { "^.+\\.ts?$": "ts-jest" },
+	testEnvironment: "node",
+	testRegex: "/tests/.*\\.(test|spec)?\\.(ts|tsx)$",
+	moduleFileExtensions: ["ts", "tsx", "js", "jsx", "json", "node"],
+	maxWorkers: 1,
+};

package/package.json

@@ -1,42 +1,43 @@
 {
-    "name": "markdown-maker",
-    "version": "1.10.2",
-    "description": "A superset-compiler for markdown using marked",
-    "main": "src/main.ts",
-    "bin": {
-        "mdparse": "bundle/main.js"
-    },
-    "scripts": {
-        "test": "mocha --require test/hooks.js",
-        "test:yarn": "mocha",
-        "bundle": "tsc --project tsconfig.json",
-        "main": "node bundle/main.js document/main.md -o dist/bundle.md --debug",
-        "debug": "node src/main.js -db document/main.md -o dist/bundle.md",
-        "clear": "rm -rf bundle bin",
-        "pretest": "npm run bundle",
-        "pretest:yarn": "yarn bundle"
-    },
-    "keywords": [],
-    "author": "blitzher",
-    "license": "MIT",
-    "dependencies": {
-        "argparse": "^2.0.1",
-        "chokidar": "^3.5.1",
-        "colors.ts": "^1.0.20",
-        "marked": "^2.0.1",
-        "node-html-parser": "^6.1.13",
-        "require-runtime": "^2.0.0",
-        "ws": "^8.8.1"
-    },
-    "devDependencies": {
-        "@types/argparse": "^2.0.16",
-        "@types/chokidar": "^2.1.3",
-        "@types/colors": "^1.2.1",
-        "@types/node": "^15.6.1",
-        "@types/ws": "^8.5.3",
-        "cloc": "^2.7.0",
-        "mocha": "^8.3.1",
-        "prettier": "^2.3.0",
-        "typescript": "^4.3.2"
-    }
+	"name": "markdown-maker",
+	"version": "1.10.3",
+	"description": "A superset-compiler for markdown using marked",
+	"main": "src/main.ts",
+	"bin": {
+		"mdparse": "bundle/main.js"
+	},
+	"scripts": {
+		"test": "jest",
+		"bundle": "tsc --project tsconfig.json",
+		"main": "node bundle/main.js",
+		"clean": "rm -rf bundle bin",
+		"pretest": "npm run bundle"
+	},
+	"keywords": [],
+	"author": "blitzher",
+	"license": "MIT",
+	"dependencies": {
+		"argparse": "^2.0.1",
+		"chokidar": "^3.5.1",
+		"colors.ts": "^1.0.20",
+		"marked": "^12.0.2",
+		"node-html-parser": "^6.1.13",
+		"require-runtime": "^2.0.0",
+		"ts-node": "^10.9.2",
+		"ws": "^8.8.1"
+	},
+	"devDependencies": {
+		"@types/argparse": "^2.0.16",
+		"@types/chokidar": "^2.1.3",
+		"@types/colors": "^1.2.1",
+		"@types/jest": "^29.5.12",
+		"@types/node": "^15.6.1",
+		"@types/ws": "^8.5.3",
+		"@types/xregexp": "^4.4.0",
+		"cloc": "^2.7.0",
+		"jest": "^29.7.0",
+		"prettier": "^2.3.0",
+		"ts-jest": "^29.1.2",
+		"typescript": "^4.3.2"
+	}
 }

package/src/cltool.ts

@@ -1,110 +1,152 @@
-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 */
-import { TargetType } from "./commands";
+import { TaggedElement, TargetType } from "./types";
 import Parser from "./parser";
 
+const version = process.env.npm_package_version || "0.0.0";
+
 Colors.enable();
 import { ArgumentParser } from "argparse"; /* for parsing clargs */
-const { version } = require("../package.json"); /* package version number */
+import { HTMLElement } from "node-html-parser";
 
 export const argParser = new ArgumentParser({
-    description:
-        "Markdown bundler, with extra options. Extension file is loaded from ./extensions.js, if it exists",
-    prog: "mdparse",
+	description:
+		"Markdown bundler, with extra options. Extension file is loaded from ./extensions.js, if it exists",
+	prog: "mdparse",
 });
 
 //#region command line args
 argParser.add_argument("src", {
-    help: "file to be parsed. If this is a directory, it looks for entry point in the directory, see --entry",
+	help: "file to be parsed. If this is a directory, it looks for entry point in the directory, see --entry",
+});
+argParser.add_argument("--version", {
+	action: "version",
+	version: `v${version}`,
 });
-argParser.add_argument("--version", { action: "version", version });
 argParser.add_argument("-v", "--verbose", {
-    action: "store_true",
-    help: "enable verbose output",
+	action: "store_true",
+	help: "enable verbose output",
 });
 argParser.add_argument("-D", "--debug", {
-    action: "store_true",
-    help: "enable debugging information",
+	action: "store_true",
+	help: "enable debugging information",
 });
 argParser.add_argument("-o", "--output", {
-    help: "destination of bundle, by default is 'dist/bundle.md'",
-    default: "dist/bundle.md",
+	help: "destination of bundle, by default is 'dist/bundle.md'",
+	default: "dist/bundle.md",
 });
 argParser.add_argument("-d", "--max-depth", {
-    help: "maximum recursion depth, by default is 15",
-    default: 15,
-    type: "int",
+	help: "maximum recursion depth, by default is 15",
+	default: 15,
+	type: "int",
 });
 argParser.add_argument("-e", "--entry", {
-    help: "assign entry point in directory, by default is 'main.md'",
-    default: "main.md",
+	help: "assign entry point in directory, by default is 'main.md'",
+	default: "main.md",
 });
 argParser.add_argument("-w", "--watch", {
-    action: "store_true",
-    help: "recompile after a change in target target file or directory.",
+	action: "store_true",
+	help: "recompile after a change in target target file or directory.",
 });
 argParser.add_argument("-u", "--use-underscore", {
-    action: "store_true",
-    help: "set the parser to use '_' as seperator in ids for Table of Content. If the links in the table does not work, this is likely to be the issue.",
+	action: "store_true",
+	help: "set the parser to use '_' as seperator in ids for Table of Content. If the links in the table does not work, this is likely to be the issue.",
 });
 argParser.add_argument("-t", "--toc-level", {
-    help: "the section level of the table of contents, by default is 3",
-    default: 3,
-    type: "int",
+	help: "the section level of the table of contents, by default is 3",
+	default: 3,
+	type: "int",
 });
 argParser.add_argument("-H", "--html", {
-    action: "store_true",
-    help: "compile HTML from the parsed markdown",
+	action: "store_true",
+	help: "compile HTML from the parsed markdown",
 });
 argParser.add_argument("--allow-undefined", "-A", {
-    action: "store_true",
-    help: "allow the use of the \"<thing>\" syntax, without raising an error when 'thing' is not a variable. Mostly useful when writing inline html tags, and other non-strictly markdown related uses",
+	action: "store_true",
+	help: "allow the use of the \"<thing>\" syntax, without raising an error when 'thing' is not a variable. Mostly useful when writing inline html tags, and other non-strictly markdown related uses",
 });
 //#endregion
 
-export type CLArgs = {
-    src: string;
-    output: string;
-    verbose: boolean;
-    debug: boolean;
-    max_depth: number;
-    entry: string;
-    watch: boolean;
-    use_underscore: boolean;
-    toc_level: number;
-    html: boolean;
-    allow_undefined: boolean;
+export type CommandLineArgs = {
+	src: string;
+	output: string;
+	verbose: boolean;
+	debug: boolean;
+	max_depth: number;
+	entry: string;
+	watch: boolean;
+	use_underscore: boolean;
+	toc_level: number;
+	html: boolean;
+	allow_undefined: boolean;
+};
+
+export type IncompleteCommandLineArgs = {
+	src?: string;
+	output?: string;
+	verbose?: boolean;
+	debug?: boolean;
+	max_depth?: number;
+	entry?: string;
+	watch?: boolean;
+	use_underscore?: boolean;
+	toc_level?: number;
+	html?: boolean;
+	allow_undefined?: boolean;
 };
 
 export type ParserOptions = {
-    defs: {
-        [key: string]: string;
-    };
-    secs: {
-        level: number;
-        title: string;
-    }[];
-    args: string[];
-    depth: number;
-    verbose: boolean;
-    debug: boolean;
-    max_depth: number;
-    use_underscore: boolean;
-    toc_level: number;
-    allow_undefined: boolean;
-    html: boolean;
-    watch: boolean;
-    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;
+	defs: {
+		[key: string]: string;
+	};
+	secs: {
+		level: number;
+		title: string;
+	}[];
+	args: string[];
+	depth: number;
+	verbose: boolean;
+	debug: boolean;
+	max_depth: number;
+	use_underscore: boolean;
+	toc_level: number;
+	allow_undefined: boolean;
+	html: boolean;
+	watch: boolean;
+	targetType: TargetType | undefined;
+	only_warn: boolean;
+	parent?: Parser;
+	hooks: {
+		[key: string]: (map: { [tag: string]: TaggedElement }) => void;
+	};
+	isFileCallback: (s: string) => false | string;
+};
+
+export type IncompleteParserOptions = {
+	defs?: {
+		[key: string]: string;
+	};
+	secs?: {
+		level: number;
+		title: string;
+	}[];
+	args?: string[];
+	depth?: number;
+	verbose?: boolean;
+	debug?: boolean;
+	max_depth?: number;
+	use_underscore?: boolean;
+	toc_level?: number;
+	allow_undefined?: boolean;
+	html?: boolean;
+	watch?: boolean;
+	targetType?: TargetType | undefined;
+	only_warn?: boolean;
+	parent?: Parser;
+	hooks?: {
+		[key: string]: (map: { [tag: string]: TaggedElement }) => void;
+	};
+	isFileCallback?: (s: string) => false | string;
 };