deps(typedoc): bump to latest version of theme and package (#16383)

* deps(typedoc): bump to latest version of theme and package

* deps(typedoc): bump to official release versions

* build(typedoc): refactor script to work on windows

Author: simeonoff

package-lock.json

@@ -118,7 +118,7 @@
     "gulp-uglify": "^3.0.1",
     "hammer-simulator": "0.0.1",
     "hammerjs": "^2.0.8",
-    "ig-typedoc-theme": "^6.0.0",
+    "ig-typedoc-theme": "^7.0.0",
     "igniteui-dockmanager": "^1.17.0",
     "igniteui-sassdoc-theme": "^2.1.0",
     "igniteui-webcomponents": "6.2.1",
@@ -146,8 +146,8 @@
     "stylelint-prettier": "^5.0.2",
     "stylelint-scss": "^6.9.0",
     "ts-node": "^10.8.1",
-    "typedoc": "^0.27.0",
-    "typedoc-plugin-localization": "^3.0.6",
+    "typedoc": "^0.28.14",
+    "typedoc-plugin-localization": "^3.1.0",
     "typescript": "5.8.3"
   }
 }

package.json

@@ -146,7 +146,7 @@ export class IgxExcelExporterService extends IgxBaseExporter {
     }
 
     private saveFile(data: Uint8Array, fileName: string): void {
-        const blob = new Blob([data], {
+        const blob = new Blob([data as BlobPart], {
             type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
         });
 

projects/igniteui-angular/src/lib/services/excel/excel-exporter.ts

@@ -1,46 +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 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
-    ? DEST("/typescript-exported/igniteui-angular.json")
-    : DEST("/typescript");
+    ? ROOT("dist", "igniteui-angular", "docs", "typescript-exported", "igniteui-angular.json")
+    : ROOT("dist", "igniteui-angular", "docs", "typescript");
 
 /*
  * The Typedoc configuration object.
@@ -50,19 +39,18 @@ 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,
     excludeProtected: true,
     name: "Ignite UI for Angular",
     readme: "none",
     out: OUT_DIR,
-    tsconfig: path.resolve(__dirname, "../tsconfig.typedoc.json"),
+    router: "structure",
+    logLevel: "Verbose",
+    tsconfig: ROOT("tsconfig.typedoc.json")
 };
 
 async function main() {
@@ -73,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);
     }