feat: introduced CLI mode to the parser

bin/cli.mjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+import { argv } from 'node:process';
+import { resolve } from 'node:path';
+
+import { Command, Option } from 'commander';
+
+import createGenerator from '../src/generators.mjs';
+import createLoader from '../src/loader.mjs';
+import createParser from '../src/parser.mjs';
+import { CLI_TARGET_MAPPING } from '../src/constants.mjs';
+
+const program = new Command();
+
+program
+  .requiredOption(
+    '-i, --input <patterns...>',
+    'Specify input file patterns using glob syntax'
+  )
+  .requiredOption('-o, --output <path>', 'Specify the output directory path')
+  .addOption(
+    new Option(
+      '-t, --target [mode...]',
+      'Set the processing target mode'
+    ).choices(Object.keys(CLI_TARGET_MAPPING))
+  )
+  .parse(argv);
+
+/**
+ * Defines the structure for command line options after parsing.
+ *
+ * @typedef {Object} Options
+ * @property {Array<string>|string} input Specifies the glob/path for input files.
+ * @property {string} output Specifies the directory where output files will be saved.
+ * @property {keyof CLI_TARGET_MAPPING} target Specifies the execution target mode.
+ */
+
+/** @type {Options} */
+const { input, output, target } = program.opts();
+
+const { loadFiles } = createLoader();
+const { parseApiDocs } = createParser();
+
+const apiDocFiles = loadFiles(input);
+
+const parsedApiDocs = await parseApiDocs(apiDocFiles);
+
+const { runGenerators } = createGenerator(parsedApiDocs);
+
+await runGenerators({
+  generators: target.map(mode => CLI_TARGET_MAPPING[mode]),
+  output: resolve(output),
+});

package.json

@@ -1,9 +1,13 @@
 {
+  "name": "@node-core/api-docs-tooling",
   "scripts": {
     "lint": "eslint .",
     "format": "prettier --write .",
     "prepare": "husky"
   },
+  "bin": {
+    "api-docs-tooling": "./bin/cli.mjs"
+  },
   "devDependencies": {
     "@eslint/js": "^9.7.0",
     "@types/node": "^20.14.10",
@@ -16,6 +20,7 @@
   },
   "dependencies": {
     "github-slugger": "^2.0.0",
+    "commander": "^12.1.0",
     "glob": "^11.0.0",
     "remark": "^15.0.1",
     "remark-gfm": "^4.0.0",

src/constants.mjs

@@ -328,3 +328,10 @@ export const DOC_TYPES_MAPPING_OTHER = {
   Response: `${DOC_MDN_BASE_URL}/API/Response`,
   Request: `${DOC_MDN_BASE_URL}/API/Request`,
 };
+
+// Mapping that determines which generators are run on the target modes used in the CLI
+export const CLI_TARGET_MAPPING = {
+  mdx: 'mdx',
+  json: 'jsonSimple',
+  html: 'legacyHtml',
+};