Replace docs scripts with javascript code

Author: leeyi45

.gitignore

@@ -1,6 +1,5 @@
 node_modules
 *.js
-!eslint.config.js
 
 # docs
 !docs/jsdoc/templates/**/*.js

package.json

@@ -58,9 +58,9 @@
     "format:ci": "prettier --list-different \"src/**/*.{ts,tsx}\"",
     "test": "jest",
     "test-coverage": "jest --coverage",
-    "docs": "yarn jsdoc && yarn autocomplete",
-    "jsdoc": "./scripts/jsdoc.sh",
-    "autocomplete": "node ./scripts/updateAutocompleteDocs.js",
+    "docs": "node ./scripts/docs.mjs docs",
+    "jsdoc": "node ./scripts/docs.mjs",
+    "autocomplete": "node ./scripts/docs.mjs autocomplete",
     "build_sicp_package": "./scripts/build_sicp_package.sh",
     "publish_sicp_package": "./scripts/publish_sicp_package.sh",
     "benchmark": "jest --runInBand --testPathPattern='.*benchmark.*' --testPathIgnorePatterns='/dist/'",

scripts/updateAutocompleteDocs.js renamed to scripts/autocomplete.mjs

@@ -1,7 +1,8 @@
-const fs = require('fs');
-const path = require('path');
-const jsdom = require('jsdom');
-const { JSDOM } = jsdom;
+// @ts-check
+
+import fs from 'fs/promises';
+import pathlib from 'path';
+import { JSDOM } from 'jsdom';
 
 const CONST_DECL = "const";
 const FUNC_DECL = "func";
@@ -74,11 +75,11 @@ function processFunction(namespace, element, document) {
   namespace[name] = { title, description: html, meta: FUNC_DECL };
 }
 
-function processDirGlobals(target) {
-  const inFile = path.join(BASE_DIR, target, SRC_FILENAME);
+async function processDirGlobals(target) {
+  const inFile = pathlib.join(BASE_DIR, target, SRC_FILENAME);
   let document;
   try {
-    const contents = fs.readFileSync(inFile);
+    const contents = await fs.readFile(inFile);
     document = new JSDOM(contents.toString()).window.document;
   } catch (err) {
     console.error(inFile, "failed", err);
@@ -93,17 +94,26 @@ function processDirGlobals(target) {
   const functions = document.getElementsByClassName('function-entry')
   Array.prototype.forEach.call(functions, ele => processFunction(names, ele, document));
 
-  fs.mkdirSync(OUT_DIR, { recursive: true })
-
-  const outFile = path.join(OUT_DIR, target + '.json');
-  fs.writeFileSync(outFile, JSON.stringify(names, null, 2), 'utf-8');
+  const outFile = pathlib.join(OUT_DIR, target + '.json');
+  await fs.writeFile(outFile, JSON.stringify(names, null, 2), 'utf-8')
 }
 
-if (fs.existsSync(BASE_DIR)) {
-  TARGETS.forEach(processDirGlobals);
-} else {
-  console.error(`
-  Error: path to jsdoc html is invalid.
-  Ensure that this script is run from the project root and documentation has been generated\
-  `);
+export default async function autocomplete() {
+  try {
+    await fs.access(BASE_DIR, fs.constants.R_OK)
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      console.error(`
+      Error: path to jsdoc html is invalid.
+      Ensure that this script is run from the project root and documentation has been generated\
+      `);
+    } else {
+      console.error(error)
+    }
+  }
+
+  await fs.mkdir(OUT_DIR, { recursive: true })
+  await Promise.all(TARGETS.map(processDirGlobals))
+  console.log('Finished processing autocomplete documentation')
 }
+