@mseep/claudian 2.0.25

package/tests/unit/utils/fileLink.dom.test.ts

@@ -0,0 +1,273 @@
+/**
+ * @jest-environment jsdom
+ */
+import { processFileLinks } from '@/utils/fileLink';
+
+function createMockApp(existingFiles: string[]) {
+  const fileSet = new Set(existingFiles.map(f => f.toLowerCase()));
+
+  return {
+    metadataCache: {
+      getFirstLinkpathDest: jest.fn((linkPath: string) => {
+        return fileSet.has(linkPath.toLowerCase()) ? { path: linkPath } : null;
+      }),
+    },
+    vault: {
+      getAbstractFileByPath: jest.fn((filePath: string) => {
+        if (fileSet.has(filePath.toLowerCase())) return { path: filePath, basename: filePath.replace(/\.md$/, '') };
+        if (!filePath.endsWith('.md') && fileSet.has((filePath + '.md').toLowerCase())) {
+          return { path: filePath + '.md', basename: filePath };
+        }
+        return null;
+      }),
+    },
+  } as any;
+}
+
+describe('processFileLinks', () => {
+  describe('null/empty inputs', () => {
+    it('handles null app gracefully', () => {
+      const container = document.createElement('div');
+      expect(() => processFileLinks(null as any, container)).not.toThrow();
+    });
+
+    it('handles null container gracefully', () => {
+      const app = createMockApp([]);
+      expect(() => processFileLinks(app, null as any)).not.toThrow();
+    });
+
+    it('handles empty container', () => {
+      const app = createMockApp([]);
+      const container = document.createElement('div');
+      processFileLinks(app, container);
+      expect(container.innerHTML).toBe('');
+    });
+  });
+
+  describe('text nodes with wikilinks', () => {
+    it('converts valid wikilinks to clickable links', () => {
+      const app = createMockApp(['note.md']);
+      const container = document.createElement('div');
+      const span = document.createElement('span');
+      span.textContent = 'See [[note.md]] for info';
+      container.appendChild(span);
+
+      processFileLinks(app, container);
+
+      const link = container.querySelector('a.claudian-file-link');
+      expect(link).not.toBeNull();
+      expect(link!.textContent).toBe('note.md');
+      expect(link!.getAttribute('data-href')).toBe('note.md');
+    });
+
+    it('does not create links for non-existent files', () => {
+      const app = createMockApp([]);
+      const container = document.createElement('div');
+      const span = document.createElement('span');
+      span.textContent = 'See [[missing.md]] for info';
+      container.appendChild(span);
+
+      processFileLinks(app, container);
+
+      const link = container.querySelector('a.claudian-file-link');
+      expect(link).toBeNull();
+    });
+
+    it('preserves text around links', () => {
+      const app = createMockApp(['note.md']);
+      const container = document.createElement('div');
+      const span = document.createElement('span');
+      span.textContent = 'Before [[note.md]] after';
+      container.appendChild(span);
+
+      processFileLinks(app, container);
+
+      expect(container.textContent).toBe('Before note.md after');
+    });
+
+    it('handles multiple wikilinks in one text node', () => {
+      const app = createMockApp(['a.md', 'b.md']);
+      const container = document.createElement('div');
+      const span = document.createElement('span');
+      span.textContent = '[[a.md]] and [[b.md]]';
+      container.appendChild(span);
+
+      processFileLinks(app, container);
+
+      const links = container.querySelectorAll('a.claudian-file-link');
+      expect(links.length).toBe(2);
+    });
+
+    it('handles display text in wikilinks', () => {
+      const app = createMockApp(['note.md']);
+      const container = document.createElement('div');
+      const span = document.createElement('span');
+      span.textContent = 'See [[note.md|My Note]]';
+      container.appendChild(span);
+
+      processFileLinks(app, container);
+
+      const link = container.querySelector('a.claudian-file-link');
+      expect(link).not.toBeNull();
+      expect(link!.textContent).toBe('My Note');
+    });
+
+    it('resolves files without .md extension using vault fallback', () => {
+      const app = createMockApp(['note.md']);
+      const container = document.createElement('div');
+      const span = document.createElement('span');
+      span.textContent = 'See [[note]] here';
+      container.appendChild(span);
+
+      processFileLinks(app, container);
+
+      const link = container.querySelector('a.claudian-file-link');
+      expect(link).not.toBeNull();
+    });
+  });
+
+  describe('inline code wikilinks', () => {
+    it('processes wikilinks inside inline code elements', () => {
+      const app = createMockApp(['note.md']);
+      const container = document.createElement('div');
+      const code = document.createElement('code');
+      code.textContent = '[[note.md]]';
+      container.appendChild(code);
+
+      processFileLinks(app, container);
+
+      const link = code.querySelector('a.claudian-file-link');
+      expect(link).not.toBeNull();
+      expect(link!.textContent).toBe('note.md');
+    });
+
+    it('skips code inside pre elements', () => {
+      const app = createMockApp(['note.md']);
+      const container = document.createElement('div');
+      const pre = document.createElement('pre');
+      const code = document.createElement('code');
+      code.textContent = '[[note.md]]';
+      pre.appendChild(code);
+      container.appendChild(pre);
+
+      processFileLinks(app, container);
+
+      const link = container.querySelector('a.claudian-file-link');
+      expect(link).toBeNull();
+      expect(code.textContent).toBe('[[note.md]]');
+    });
+  });
+
+  describe('TreeWalker filtering', () => {
+    it('skips text nodes inside pre elements', () => {
+      const app = createMockApp(['note.md']);
+      const container = document.createElement('div');
+      const pre = document.createElement('pre');
+      pre.textContent = '[[note.md]]';
+      container.appendChild(pre);
+
+      processFileLinks(app, container);
+
+      const link = container.querySelector('a.claudian-file-link');
+      expect(link).toBeNull();
+    });
+
+    it('skips text nodes inside a elements', () => {
+      const app = createMockApp(['note.md']);
+      const container = document.createElement('div');
+      const anchor = document.createElement('a');
+      anchor.textContent = '[[note.md]]';
+      container.appendChild(anchor);
+
+      processFileLinks(app, container);
+
+      const links = container.querySelectorAll('a.claudian-file-link');
+      expect(links.length).toBe(0);
+    });
+
+    it('skips text nodes inside elements with .claudian-file-link class', () => {
+      const app = createMockApp(['note.md']);
+      const container = document.createElement('div');
+      const span = document.createElement('span');
+      span.className = 'claudian-file-link';
+      span.textContent = '[[note.md]]';
+      container.appendChild(span);
+
+      processFileLinks(app, container);
+
+      // Should not create nested links
+      const links = container.querySelectorAll('a.claudian-file-link');
+      expect(links.length).toBe(0);
+    });
+
+    it('skips text nodes inside elements with .internal-link class', () => {
+      const app = createMockApp(['note.md']);
+      const container = document.createElement('div');
+      const span = document.createElement('span');
+      span.className = 'internal-link';
+      span.textContent = '[[note.md]]';
+      container.appendChild(span);
+
+      processFileLinks(app, container);
+
+      const links = container.querySelectorAll('a.claudian-file-link');
+      expect(links.length).toBe(0);
+    });
+
+    it('repairs empty resolved internal-link anchors while leaving missing wikilinks visible', () => {
+      const app = createMockApp(['note.md']);
+      const container = document.createElement('div');
+      container.innerHTML = '<a class="internal-link" href="note"></a> and [[missing.md]]';
+
+      processFileLinks(app, container);
+
+      const internalLink = container.querySelector('a.internal-link');
+      expect(internalLink).not.toBeNull();
+      expect(internalLink!.textContent).toBe('note');
+      expect(internalLink!.classList.contains('claudian-file-link')).toBe(true);
+      expect(container.textContent).toBe('note and [[missing.md]]');
+    });
+
+    it('processes text nodes in regular elements', () => {
+      const app = createMockApp(['note.md']);
+      const container = document.createElement('div');
+      const p = document.createElement('p');
+      p.textContent = '[[note.md]]';
+      container.appendChild(p);
+
+      processFileLinks(app, container);
+
+      const link = container.querySelector('a.claudian-file-link');
+      expect(link).not.toBeNull();
+    });
+  });
+
+  describe('image embed exclusion', () => {
+    it('does not convert image embeds to links', () => {
+      const app = createMockApp(['image.png']);
+      const container = document.createElement('div');
+      const span = document.createElement('span');
+      span.textContent = '![[image.png]]';
+      container.appendChild(span);
+
+      processFileLinks(app, container);
+
+      const link = container.querySelector('a.claudian-file-link');
+      expect(link).toBeNull();
+    });
+
+    it('converts file link but not image embed in same text', () => {
+      const app = createMockApp(['note.md', 'image.png']);
+      const container = document.createElement('div');
+      const span = document.createElement('span');
+      span.textContent = '[[note.md]] and ![[image.png]]';
+      container.appendChild(span);
+
+      processFileLinks(app, container);
+
+      const links = container.querySelectorAll('a.claudian-file-link');
+      expect(links.length).toBe(1);
+      expect(links[0].textContent).toBe('note.md');
+    });
+  });
+});

package/tests/unit/utils/fileLink.handler.test.ts

@@ -0,0 +1,64 @@
+import { registerFileLinkHandler } from '@/utils/fileLink';
+
+describe('registerFileLinkHandler', () => {
+  it('opens data-href target when present', () => {
+    const app = {
+      workspace: {
+        openLinkText: jest.fn(),
+      },
+    };
+
+    const link: any = {
+      dataset: { href: 'note#section' },
+      getAttribute: jest.fn().mockReturnValue('note'),
+      closest: jest.fn(),
+    };
+    link.closest.mockReturnValue(link);
+
+    const event = {
+      target: link,
+      preventDefault: jest.fn(),
+    } as any;
+
+    const component = {
+      registerDomEvent: (_el: HTMLElement, _event: string, cb: (event: MouseEvent) => void) => {
+        cb(event);
+      },
+    };
+
+    registerFileLinkHandler(app as any, {} as HTMLElement, component as any);
+
+    expect(event.preventDefault).toHaveBeenCalled();
+    expect(app.workspace.openLinkText).toHaveBeenCalledWith('note#section', '', 'tab');
+  });
+
+  it('falls back to href when data-href is missing', () => {
+    const app = {
+      workspace: {
+        openLinkText: jest.fn(),
+      },
+    };
+
+    const link: any = {
+      dataset: {},
+      getAttribute: jest.fn().mockReturnValue('note^block'),
+      closest: jest.fn(),
+    };
+    link.closest.mockReturnValue(link);
+
+    const event = {
+      target: link,
+      preventDefault: jest.fn(),
+    } as any;
+
+    const component = {
+      registerDomEvent: (_el: HTMLElement, _event: string, cb: (event: MouseEvent) => void) => {
+        cb(event);
+      },
+    };
+
+    registerFileLinkHandler(app as any, {} as HTMLElement, component as any);
+
+    expect(app.workspace.openLinkText).toHaveBeenCalledWith('note^block', '', 'tab');
+  });
+});

package/tests/unit/utils/fileLink.test.ts

@@ -0,0 +1,233 @@
+import { extractLinkTarget } from '@/utils/fileLink';
+
+// Extract the pattern from the module for testing
+// This matches the pattern in src/utils/fileLink.ts
+const WIKILINK_PATTERN = /(?<!!)\[\[([^\]|#^]+)(?:#[^\]|]+)?(?:\^[^\]|]+)?(?:\|[^\]]+)?\]\]/g;
+
+interface WikilinkMatch {
+  fullMatch: string;
+  linkPath: string;
+  index: number;
+}
+
+function findWikilinks(text: string): WikilinkMatch[] {
+  WIKILINK_PATTERN.lastIndex = 0;
+  const matches: WikilinkMatch[] = [];
+
+  let match: RegExpExecArray | null;
+  while ((match = WIKILINK_PATTERN.exec(text)) !== null) {
+    matches.push({
+      fullMatch: match[0],
+      linkPath: match[1],
+      index: match.index,
+    });
+  }
+
+  return matches;
+}
+
+function extractDisplayText(fullMatch: string, linkPath: string): string {
+  const pipeIndex = fullMatch.lastIndexOf('|');
+  return pipeIndex > 0 ? fullMatch.slice(pipeIndex + 1, -2) : linkPath;
+}
+
+describe('wikilink pattern matching', () => {
+  describe('basic wikilinks', () => {
+    it('matches simple wikilink', () => {
+      const matches = findWikilinks('[[note.md]]');
+      expect(matches).toHaveLength(1);
+      expect(matches[0].linkPath).toBe('note.md');
+    });
+
+    it('matches wikilink without extension', () => {
+      const matches = findWikilinks('[[note]]');
+      expect(matches).toHaveLength(1);
+      expect(matches[0].linkPath).toBe('note');
+    });
+
+    it('matches wikilink with folder path', () => {
+      const matches = findWikilinks('[[folder/subfolder/note.md]]');
+      expect(matches).toHaveLength(1);
+      expect(matches[0].linkPath).toBe('folder/subfolder/note.md');
+    });
+
+    it('matches wikilink in surrounding text', () => {
+      const matches = findWikilinks('Check [[note.md]] for info');
+      expect(matches).toHaveLength(1);
+      expect(matches[0].linkPath).toBe('note.md');
+      expect(matches[0].index).toBe(6);
+    });
+  });
+
+  describe('wikilinks with display text', () => {
+    it('matches wikilink with pipe alias', () => {
+      const matches = findWikilinks('[[note.md|My Note]]');
+      expect(matches).toHaveLength(1);
+      expect(matches[0].linkPath).toBe('note.md');
+      expect(matches[0].fullMatch).toBe('[[note.md|My Note]]');
+    });
+
+    it('extracts display text correctly', () => {
+      const fullMatch = '[[note.md|My Display Text]]';
+      const displayText = extractDisplayText(fullMatch, 'note.md');
+      expect(displayText).toBe('My Display Text');
+    });
+
+    it('uses link path when no display text', () => {
+      const fullMatch = '[[note.md]]';
+      const displayText = extractDisplayText(fullMatch, 'note.md');
+      expect(displayText).toBe('note.md');
+    });
+  });
+
+  describe('wikilinks with headings and blocks', () => {
+    it('matches wikilink with heading reference', () => {
+      const matches = findWikilinks('[[note.md#section]]');
+      expect(matches).toHaveLength(1);
+      expect(matches[0].linkPath).toBe('note.md');
+    });
+
+    it('matches wikilink with block reference', () => {
+      const matches = findWikilinks('[[note.md^blockid]]');
+      expect(matches).toHaveLength(1);
+      expect(matches[0].linkPath).toBe('note.md');
+    });
+
+    it('matches wikilink with heading and display text', () => {
+      const matches = findWikilinks('[[note.md#section|Section Link]]');
+      expect(matches).toHaveLength(1);
+      expect(matches[0].linkPath).toBe('note.md');
+    });
+  });
+
+  describe('multiple wikilinks', () => {
+    it('matches multiple wikilinks in text', () => {
+      const matches = findWikilinks('See [[note1.md]] and [[note2.md]]');
+      expect(matches).toHaveLength(2);
+      expect(matches[0].linkPath).toBe('note1.md');
+      expect(matches[1].linkPath).toBe('note2.md');
+    });
+
+    it('matches consecutive wikilinks', () => {
+      const matches = findWikilinks('[[a.md]][[b.md]]');
+      expect(matches).toHaveLength(2);
+    });
+
+    it('captures correct indices for multiple matches', () => {
+      const text = '[[first.md]] middle [[second.md]]';
+      const matches = findWikilinks(text);
+      expect(matches[0].index).toBe(0);
+      expect(matches[1].index).toBe(20);
+    });
+  });
+
+  describe('image embeds (should NOT match)', () => {
+    it('does not match image embed', () => {
+      const matches = findWikilinks('![[image.png]]');
+      expect(matches).toHaveLength(0);
+    });
+
+    it('does not match image embed with alt text', () => {
+      const matches = findWikilinks('![[image.png|alt text]]');
+      expect(matches).toHaveLength(0);
+    });
+
+    it('matches file link but not image embed', () => {
+      const matches = findWikilinks('[[note.md]] and ![[image.png]]');
+      expect(matches).toHaveLength(1);
+      expect(matches[0].linkPath).toBe('note.md');
+    });
+
+    it('handles mixed file links and image embeds', () => {
+      const text = '![[img1.png]] [[file.md]] ![[img2.png]] [[other.md]]';
+      const matches = findWikilinks(text);
+      expect(matches).toHaveLength(2);
+      expect(matches[0].linkPath).toBe('file.md');
+      expect(matches[1].linkPath).toBe('other.md');
+    });
+  });
+
+  describe('edge cases', () => {
+    it('handles empty text', () => {
+      const matches = findWikilinks('');
+      expect(matches).toHaveLength(0);
+    });
+
+    it('handles text without wikilinks', () => {
+      const matches = findWikilinks('Just plain text here');
+      expect(matches).toHaveLength(0);
+    });
+
+    it('handles incomplete wikilink syntax', () => {
+      const matches = findWikilinks('[[incomplete');
+      expect(matches).toHaveLength(0);
+    });
+
+    it('matches wikilink at start of text', () => {
+      const matches = findWikilinks('[[note.md]] is first');
+      expect(matches).toHaveLength(1);
+      expect(matches[0].index).toBe(0);
+    });
+
+    it('matches wikilink at end of text', () => {
+      const matches = findWikilinks('last is [[note.md]]');
+      expect(matches).toHaveLength(1);
+    });
+
+    it('handles special characters in path', () => {
+      const matches = findWikilinks('[[folder/my note (2024).md]]');
+      expect(matches).toHaveLength(1);
+      expect(matches[0].linkPath).toBe('folder/my note (2024).md');
+    });
+
+    it('handles spaces in filename', () => {
+      const matches = findWikilinks('[[my long filename.md]]');
+      expect(matches).toHaveLength(1);
+      expect(matches[0].linkPath).toBe('my long filename.md');
+    });
+
+    it('handles deep folder paths', () => {
+      const matches = findWikilinks('[[a/b/c/d/e/note.md]]');
+      expect(matches).toHaveLength(1);
+      expect(matches[0].linkPath).toBe('a/b/c/d/e/note.md');
+    });
+  });
+
+  describe('real-world examples', () => {
+    it('matches typical vault path from screenshot', () => {
+      const text = 'Found in [[30.areas/a.finance/Investment lessons/2024.Current trading lessons.md]]';
+      const matches = findWikilinks(text);
+      expect(matches).toHaveLength(1);
+      expect(matches[0].linkPath).toBe('30.areas/a.finance/Investment lessons/2024.Current trading lessons.md');
+    });
+
+    it('matches multiple paths in a list', () => {
+      const text = `
+1. [[30.areas/finance/note1.md]] - First
+2. [[30.areas/finance/note2.md]] - Second
+      `;
+      const matches = findWikilinks(text);
+      expect(matches).toHaveLength(2);
+    });
+
+    it('handles markdown formatting around links', () => {
+      const text = 'Check **[[important.md]]** for *[[details.md]]*';
+      const matches = findWikilinks(text);
+      expect(matches).toHaveLength(2);
+    });
+  });
+
+  describe('wikilink target extraction', () => {
+    it('keeps heading references in target', () => {
+      expect(extractLinkTarget('[[note#section]]')).toBe('note#section');
+    });
+
+    it('keeps block references in target', () => {
+      expect(extractLinkTarget('[[note^block]]')).toBe('note^block');
+    });
+
+    it('drops display text while preserving anchors', () => {
+      expect(extractLinkTarget('[[note#section|Alias]]')).toBe('note#section');
+    });
+  });
+});