build(typedoc): refactor script to work on windows

Author: simeonoff

scripts/build-typedoc.mjs

@@ -1,48 +1,35 @@
 import path from "path";
-import { fileURLToPath } from "url";
+import { fileURLToPath } from "node:url";
 import { Application } from "typedoc";
 import getArgs from "./get-args.mjs";
 
 const product = "ignite-ui-angular";
 const { localize, jsonExport, jsonImport } = getArgs();
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const toPosix = (p) => p.split(path.sep).join(path.posix.sep);
-
-const DEST = path.join.bind(
-    null,
-    path.resolve(__dirname, "../dist/igniteui-angular/docs"),
-);
+const toPosix = (p) => String(p).replace(/\\/g, "/");
+const ROOT = (...segments) => toPosix(path.resolve(__dirname, "..", ...segments));
 
 /*
  * Determines the entry points for the documentation generation.
  */
 function entryPoints() {
     if (localize === "jp") {
-        return path.resolve(
-            __dirname,
-            "../i18nRepo/typedoc/ja/igniteui-angular.json",
-        );
+        return ROOT("i18nRepo", "typedoc", "ja", "igniteui-angular.json");
     }
 
     if (jsonImport) {
-        return path.resolve(
-            __dirname,
-            "../dist/igniteui-angular/docs/typescript-exported/igniteui-angular.json",
-        );
+        return ROOT("dist", "igniteui-angular", "docs", "typescript-exported", "igniteui-angular.json");
     }
 
-    return path.resolve(
-        __dirname,
-        "../projects/igniteui-angular/src/public_api.ts",
-    );
+    return ROOT("projects", "igniteui-angular", "src", "public_api.ts");
 }
 
 /*
  * The output directory for the static site or json generation.
  */
 const OUT_DIR = jsonExport
-    ? toPosix(DEST("/typescript-exported/igniteui-angular.json"))
-    : toPosix(DEST("/typescript"));
+    ? ROOT("dist", "igniteui-angular", "docs", "typescript-exported", "igniteui-angular.json")
+    : ROOT("dist", "igniteui-angular", "docs", "typescript");
 
 /*
  * The Typedoc configuration object.
@@ -52,11 +39,8 @@ const CONFIG = {
     entryPoints: entryPoints(),
     entryPointStrategy: jsonImport || localize === "jp" ? "merge" : "resolve",
     plugin: [
-        path.resolve(
-            __dirname,
-            "../node_modules/typedoc-plugin-localization/dist/index.js",
-        ),
-        path.resolve(__dirname, "../node_modules/ig-typedoc-theme/dist/index.js"),
+        ROOT("node_modules", "typedoc-plugin-localization", "dist", "index.js"),
+        ROOT("node_modules", "ig-typedoc-theme", "dist", "index.js"),
     ],
     theme: "igtheme",
     excludePrivate: true,
@@ -66,7 +50,7 @@ const CONFIG = {
     out: OUT_DIR,
     router: "structure",
     logLevel: "Verbose",
-    tsconfig: path.resolve(__dirname, "../tsconfig.typedoc.json"),
+    tsconfig: ROOT("tsconfig.typedoc.json")
 };
 
 async function main() {
@@ -77,10 +61,7 @@ async function main() {
     app.options.setValue('versioning', true);
 
     if (localize === "jp") {
-        const jpTemplateStrings = path.resolve(
-            __dirname,
-            "../extras/template/strings/shell-strings.json",
-        );
+        const jpTemplateStrings = ROOT("extras", "template", "strings", "shell-strings.json");
         app.options.setValue("templateStrings", jpTemplateStrings);
     }