Handle relative links within <source src>

Author: Gerrit0

CHANGELOG.md

@@ -8,9 +8,14 @@ title: Changelog
 
 - Permit `-` within tag names to support `typescript-json-schema`'s `@TJS-type` tag, #2972.
 
+### Bug Fixes
+
+- Relative links in `<source src=x>` and `<source srcset=x>` elements will now be discovered by TypeDoc, #2975.
+
 ### Thanks!
 
 - @jonathanhefner
+- @laymonage
 
 ## v0.28.7 (2025-06-30)
 

src/lib/converter/comments/textParser.ts

@@ -314,7 +314,13 @@ function checkTagLink(data: TextParserData): RelativeLink | undefined {
 
  if (token.text.startsWith("<source ", pos)) {
  data.pos += 8;
- return checkAttribute(data, "srcset");
+ const saveData = { ...data };
+ const attr = checkAttribute(data, "srcset");
+ if (!attr) {
+ Object.assign(data, saveData);
+ return checkAttribute(data, "src");
+ }
+ return attr;
  }
 }
 

src/test/comments.test.ts

@@ -1668,6 +1668,38 @@ describe("Comment Parser", () => {
  );
  });
 
+ it("Recognizes HTML picture source src links", () => {
+ const comment = getComment(`/**
+ * <source src="./test.wav" >
+ * <source media="(prefers-color-scheme: dark)" src="./test_dark.mp4"/>
+ * <source src="https://example.com/favicon.ico">
+ */`);
+
+ equal(
+ comment.summary,
+ [
+ { kind: "text", text: '<source src="' },
+ {
+ kind: "relative-link",
+ text: "./test.wav",
+ target: 1 as FileId,
+ targetAnchor: undefined,
+ },
+ { kind: "text", text: '" >\n<source media="(prefers-color-scheme: dark)" src="' },
+ {
+ kind: "relative-link",
+ text: "./test_dark.mp4",
+ target: 2 as FileId,
+ targetAnchor: undefined,
+ },
+ {
+ kind: "text",
+ text: '"/>\n<source src="https://example.com/favicon.ico">',
+ },
+ ] satisfies CommentDisplayPart[],
+ );
+ });
+
  it("Recognizes HTML anchor links", () => {
  const comment = getComment(`/**
  * <a data-foo="./path.txt" href="./test.png" >