Rebuild specs to remove info dependent on git repo

As mentioned in #1977

Author: Gerrit0

scripts/rebuild_specs.js

@@ -6,6 +6,8 @@ const fs = require("fs");
 const path = require("path");
 const TypeDoc = require("..");
 const { getExpandedEntryPointsForPaths } = require("../dist/lib/utils");
+const { ok } = require("assert");
+const { SourceReference } = require("..");
 
 const base = path.join(__dirname, "../src/test/converter");
 
@@ -21,6 +23,23 @@ app.bootstrap({
     logLevel: TypeDoc.LogLevel.Warn,
     gitRevision: "fake",
 });
+app.serializer.addSerializer({
+    priority: -1,
+    supports(obj) {
+        return obj instanceof SourceReference;
+    },
+    /**
+     * @param {SourceReference} ref
+     */
+    toObject(ref, obj, _serializer) {
+        if (obj.url) {
+            obj.url = `typedoc://${obj.url.substring(
+                obj.url.indexOf(ref.fileName)
+            )}`;
+        }
+        return obj;
+    },
+});
 
 /** @type {[string, () => void, () => void][]} */
 const conversions = [
@@ -68,20 +87,17 @@ function rebuildConverterTests(dirs) {
             if (fs.existsSync(out)) {
                 TypeDoc.resetReflectionID();
                 before();
-                const result = app.converter.convert(
-                    getExpandedEntryPointsForPaths(
-                        app.logger,
-                        [fullPath],
-                        app.options,
-                        [program]
-                    )
+                const entry = getExpandedEntryPointsForPaths(
+                    app.logger,
+                    [fullPath],
+                    app.options,
+                    [program]
                 );
+                ok(entry, "Missing entry point");
+                const result = app.converter.convert(entry);
                 const serialized = app.serializer.toObject(result);
 
-                const data =
-                    JSON.stringify(serialized, null, "  ")
-                        .split(TypeDoc.normalizePath(base))
-                        .join("%BASE%") + "\n";
+                const data = JSON.stringify(serialized, null, "  ") + "\n";
                 after();
                 fs.writeFileSync(out, data);
             }

src/lib/serialization/components.ts

@@ -17,7 +17,12 @@ export interface SerializerComponent<T> {
      */
     readonly priority: number;
 
-    supports(item: unknown): item is T;
+    /**
+     * Technically this should return `item is T`, but that doesn't play nicely
+     * with inference, so allow the looser `boolean` return type.
+     * @param item
+     */
+    supports(item: unknown): boolean;
 
     toObject(
         item: T,

src/test/converter.test.ts

@@ -1,7 +1,7 @@
 import { deepStrictEqual as equal, ok } from "assert";
 import * as FS from "fs";
 import * as Path from "path";
-import { normalizePath, ProjectReflection, resetReflectionID } from "..";
+import { ProjectReflection, resetReflectionID } from "..";
 import { getExpandedEntryPointsForPaths } from "../lib/utils";
 import {
     getConverterApp,
@@ -76,14 +76,12 @@ describe("Converter", function () {
                     const specs = JSON.parse(
                         FS.readFileSync(specsFile, "utf-8")
                     );
-                    let data = JSON.stringify(
-                        result && app.serializer.toObject(result),
-                        null,
-                        "  "
+                    // Pass data through a parse/stringify to get rid of undefined properties
+                    const data = JSON.parse(
+                        JSON.stringify(app.serializer.toObject(result))
                     );
-                    data = data.split(normalizePath(base)).join("%BASE%");
 
-                    equal(JSON.parse(data), specs);
+                    equal(data, specs);
                 });
             }
         });

src/test/converter/alias/specs.json

@@ -24,7 +24,7 @@
           "fileName": "alias.ts",
           "line": 14,
           "character": 12,
-          "url": "https://github.com/TypeStrong/typedoc/blob/fake/src/test/converter/alias/alias.ts#L14"
+          "url": "typedoc://alias.ts#L14"
         }
       ],
       "typeParameters": [
@@ -76,7 +76,7 @@
           "fileName": "alias.ts",
           "line": 19,
           "character": 12,
-          "url": "https://github.com/TypeStrong/typedoc/blob/fake/src/test/converter/alias/alias.ts#L19"
+          "url": "typedoc://alias.ts#L19"
         }
       ],
       "typeParameters": [
@@ -129,7 +129,7 @@
           "fileName": "alias.ts",
           "line": 4,
           "character": 12,
-          "url": "https://github.com/TypeStrong/typedoc/blob/fake/src/test/converter/alias/alias.ts#L4"
+          "url": "typedoc://alias.ts#L4"
         }
       ],
       "typeParameters": [
@@ -154,7 +154,7 @@
               "fileName": "alias.ts",
               "line": 4,
               "character": 34,
-              "url": "https://github.com/TypeStrong/typedoc/blob/fake/src/test/converter/alias/alias.ts#L4"
+              "url": "typedoc://alias.ts#L4"
             }
           ],
           "signatures": [
@@ -226,7 +226,7 @@
           "fileName": "alias.ts",
           "line": 9,
           "character": 12,
-          "url": "https://github.com/TypeStrong/typedoc/blob/fake/src/test/converter/alias/alias.ts#L9"
+          "url": "typedoc://alias.ts#L9"
         }
       ],
       "type": {
@@ -260,7 +260,7 @@
       "fileName": "alias.ts",
       "line": 4,
       "character": 0,
-      "url": "https://github.com/TypeStrong/typedoc/blob/fake/src/test/converter/alias/alias.ts#L4"
+      "url": "typedoc://alias.ts#L4"
     }
   ]
 }