Fix media links if referenced multiple times

Resolves #2627

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 -   The page navigation sidebar no longer incorrectly includes re-exports if the same member is exported with multiple names #2625.
 -   Page navigation now ensures the current page is visible when the page is first loaded, #2626.
+-   If a relative linked image is referenced multiple times, TypeDoc will no longer sometimes produce invalid links to the image #2627.
 -   Comments on re-exports are now rendered.
 
 ### Thanks!

src/lib/models/FileRegistry.ts

@@ -61,6 +61,10 @@ export class FileRegistry {
         const absolute = this.mediaToPath.get(id);
         if (!absolute) return;
 
+        if (this.names.has(id)) {
+            return this.names.get(id);
+        }
+
         const file = basename(absolute);
         if (!this.nameUsage.has(file)) {
             this.nameUsage.set(file, 1);

src/test/comments.test.ts

@@ -1509,6 +1509,7 @@ describe("Comment Parser", () => {
         ] satisfies CommentDisplayPart[]);
 
         equal(files.getName(1), "&a.png");
+        equal(files.getName(1), "&a.png");
     });
 });