feat: Add task.links, to access links on task line

Co-Authored-By: rhhub <7444613+rhhub@users.noreply.github.com>

Author: claremacrae

src/Task/ListItem.ts

@@ -203,6 +203,16 @@ export class ListItem {
         return this.file.cachedMetadata?.links ?? [];
     }
 
+    /**
+     * Return a list of links in the task or list item's line.
+     *
+     * The data contest is documented here:
+     * https://docs.obsidian.md/Reference/TypeScript+API/LinkCache
+     */
+    public get links(): LinkCache[] {
+        return this.linksInFileBody.filter((link) => link.position.start.line === this.lineNumber);
+    }
+
     /**
      * Return the name of the file containing this object, with the .md extension removed.
      */

tests/Task/ListItem.test.ts

@@ -212,6 +212,13 @@ describe('links', () => {
 
         expect(tasks[0].linksInFileBody.length).toEqual(3);
     });
+
+    it('should return all links in the task line', () => {
+        const tasks = readTasksFromSimulatedFile(links_everywhere);
+
+        expect(tasks[0].links.length).toEqual(1);
+        expect(tasks[0].links[0].original).toEqual('[[link_in_task_wikilink]]');
+    });
 });
 
 describe('identicalTo', () => {