From 8df8262350aa5f426799087e13113b1dd7c7368f Mon Sep 17 00:00:00 2001
From: Sage Abdullah <laymonage@gmail.com>
Date: Thu, 10 Jul 2025 11:26:08 +0000
Subject: [PATCH] Handle relative links in <source srcset>

---
 src/lib/converter/comments/textParser.ts |  7 +++++-
 src/test/comments.test.ts                | 32 ++++++++++++++++++++++++
 2 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/src/lib/converter/comments/textParser.ts b/src/lib/converter/comments/textParser.ts
index 6277e9aa2..fcaa10857 100644
--- a/src/lib/converter/comments/textParser.ts
+++ b/src/lib/converter/comments/textParser.ts
@@ -297,7 +297,7 @@ function checkReference(data: TextParserData): RelativeLink | undefined {
 }
 
 /**
- * Looks for `<a href="./relative">` and `<img src="./relative">`
+ * Looks for `<a href="./relative">`, `<img src="./relative">`, and `<source srcset="./relative">`
  */
 function checkTagLink(data: TextParserData): RelativeLink | undefined {
     const { pos, token } = data;
@@ -311,6 +311,11 @@ function checkTagLink(data: TextParserData): RelativeLink | undefined {
         data.pos += 3;
         return checkAttribute(data, "href");
     }
+
+    if (token.text.startsWith("<source ", pos)) {
+        data.pos += 8;
+        return checkAttribute(data, "srcset");
+    }
 }
 
 function checkAttribute(
diff --git a/src/test/comments.test.ts b/src/test/comments.test.ts
index 8647b6372..d7366eb8e 100644
--- a/src/test/comments.test.ts
+++ b/src/test/comments.test.ts
@@ -1636,6 +1636,38 @@ describe("Comment Parser", () => {
         );
     });
 
+    it("Recognizes HTML picture source srcset links", () => {
+        const comment = getComment(`/**
+        * <source media="(prefers-color-scheme: light)"  srcset="./test.png" >
+        * <source media="(prefers-color-scheme: dark)"  srcset="./test space.png"/>
+        * <source srcset="https://example.com/favicon.ico">
+        */`);
+
+        equal(
+            comment.summary,
+            [
+                { kind: "text", text: '<source media="(prefers-color-scheme: light)"  srcset="' },
+                {
+                    kind: "relative-link",
+                    text: "./test.png",
+                    target: 1 as FileId,
+                    targetAnchor: undefined,
+                },
+                { kind: "text", text: '" >\n<source media="(prefers-color-scheme: dark)"  srcset="' },
+                {
+                    kind: "relative-link",
+                    text: "./test space.png",
+                    target: 2 as FileId,
+                    targetAnchor: undefined,
+                },
+                {
+                    kind: "text",
+                    text: '"/>\n<source srcset="https://example.com/favicon.ico">',
+                },
+            ] satisfies CommentDisplayPart[],
+        );
+    });
+
     it("Recognizes HTML anchor links", () => {
         const comment = getComment(`/**
         * <a data-foo="./path.txt" href="./test.png" >