Bring back fileName property on ReflectionSymbolId

Author: Gerrit0

CHANGELOG.md

@@ -26,7 +26,8 @@ title: Changelog
 - `Deserializer.reviveProject(s)` no longer accepts an option to add project documents.
 - `Deserializer.reviveProjects` now requires an `alwaysCreateEntryPointModule` option.
 - `Comment.serializeDisplayParts` no longer requires a serializer argument.
-- `ReflectionSymbolId.fileName` has been removed, TypeDoc now stores a combination of a package name and package relative path instead.
+- `ReflectionSymbolId.fileName` is now optional, TypeDoc now stores a combination of a package name and package relative path instead.
+  The `fileName` property will be present when initially created, but is not serialized.
 - Removed `DeclarationReflection.relevanceBoost` attribute which was added for plugins, but never used.
 - `i18n` proxy is no longer passed to many functions, instead, reference `i18n` exported from the module directly.
 - `ReflectionKind.singularString` and `ReflectionKind.pluralString` now returns translated strings.

src/lib/converter/factories/symbol-id.ts

@@ -46,6 +46,7 @@ export function createSymbolId(symbol: ts.Symbol, declaration?: ts.Declaration)
     });
     id.pos = pos;
     id.transientId = transientId;
+    id.fileName = normalizePath(sourceFileName);
 
     return id;
 }

src/lib/models/ReflectionSymbolId.ts

@@ -55,6 +55,17 @@ export class ReflectionSymbolId {
      */
     transientId: number = NaN;
 
+    /**
+     * Note: This is **not** serialized, only {@link packageName} and {@link packagePath} path
+     * information is preserved when serializing. This is set so that it is available to plugins
+     * when initially converting a project.
+     *
+     * @privateRemarks
+     * This is used by typedoc-plugin-dt-links to determine the path to read to get the source
+     * code of a definitely typed package.
+     */
+    fileName?: NormalizedPath;
+
     constructor(json: JSONOutput.ReflectionSymbolId) {
         this.packageName = json.packageName;
         this.packagePath = json.packagePath;