doc-freshness-checker 1.0.0

package/dist/parsers/extractors/directoryStructureExtractor.test.js

@@ -0,0 +1,121 @@
+import { DirectoryStructureExtractor } from './directoryStructureExtractor.js';
+function makeDoc(content) {
+    return {
+        path: 'docs/test.md',
+        absolutePath: '/project/docs/test.md',
+        content,
+        format: 'markdown',
+        lines: content.split('\n'),
+        references: [],
+    };
+}
+describe('DirectoryStructureExtractor', () => {
+    const extractor = new DirectoryStructureExtractor();
+    it('extracts paths from ASCII tree structures', () => {
+        const tree = ['```', 'src/', '├── index.ts', '├── utils/', '│   └── helper.ts', '└── config/', '    └── defaults.ts', '```'].join('\n');
+        const refs = extractor.extract(makeDoc(tree));
+        const values = refs.map((r) => r.value);
+        expect(values).toContain('src');
+        expect(values).toContain('src/index.ts');
+        expect(values).toContain('src/utils');
+        expect(values).toContain('src/utils/helper.ts');
+        expect(values).toContain('src/config');
+        expect(values).toContain('src/config/defaults.ts');
+    });
+    it('ignores code blocks without tree characters', () => {
+        const doc = makeDoc('```\nconst x = 1;\n```');
+        expect(extractor.extract(doc)).toHaveLength(0);
+    });
+    it('marks illustrative paths', () => {
+        const tree = ['```', 'project/', '├── YourComponent.tsx', '└── real-file.ts', '```'].join('\n');
+        const refs = extractor.extract(makeDoc(tree));
+        const illustrative = refs.filter((r) => r.isIllustrative);
+        expect(illustrative.length).toBeGreaterThan(0);
+    });
+    it('skips comments and ellipsis entries', () => {
+        const tree = ['```', 'src/', '├── ...', '├── # comment', '└── real.ts', '```'].join('\n');
+        const refs = extractor.extract(makeDoc(tree));
+        const values = refs.map((r) => r.value);
+        expect(values).not.toContain('...');
+        expect(values).not.toContain('# comment');
+    });
+    it('handles backtick-dash style trees', () => {
+        const tree = ['```', 'root/', '├── file.ts', '└── nested/', '    └── deep.ts', '```'].join('\n');
+        const refs = extractor.extract(makeDoc(tree));
+        const values = refs.map((r) => r.value);
+        expect(values).toContain('root/file.ts');
+        expect(values).toContain('root/nested');
+        expect(values).toContain('root/nested/deep.ts');
+    });
+    it('skips separator and dash entries', () => {
+        const tree = ['```', 'src/', '├── -', '├── ---', '├── ___', '├── ===', '└── real.ts', '```'].join('\n');
+        const refs = extractor.extract(makeDoc(tree));
+        const values = refs.map((r) => r.value);
+        expect(values).not.toContain('-');
+        expect(values).not.toContain('---');
+        expect(values).toContain('src/real.ts');
+    });
+    it('skips short single-segment paths', () => {
+        const tree = ['```', 'ab', '├── long-name.ts', '```'].join('\n');
+        const refs = extractor.extract(makeDoc(tree));
+        const values = refs.map((r) => r.value);
+        expect(values).not.toContain('ab');
+        expect(values).toContain('ab/long-name.ts');
+    });
+    it('handles backtick-dash connector in trees', () => {
+        const tree = ['```', 'project/', '├── src/', '│   └── index.ts', '`-- config.ts', '```'].join('\n');
+        const refs = extractor.extract(makeDoc(tree));
+        const values = refs.map((r) => r.value);
+        expect(values).toContain('project');
+        expect(values).toContain('project/config.ts');
+    });
+    it('extracts from restructuredtext format', () => {
+        const content = ['.. code-block::', '', '   project/', '   ├── src/', '   │   └── main.ts', '   └── README.md'].join('\n');
+        const doc = {
+            path: 'docs/test.rst',
+            absolutePath: '/project/docs/test.rst',
+            content,
+            format: 'restructuredtext',
+            lines: content.split('\n'),
+            references: [],
+        };
+        const refs = extractor.extract(doc);
+        expect(refs.length).toBeGreaterThan(0);
+    });
+    it('extracts from asciidoc format', () => {
+        const content = ['----', 'project/', '├── src/', '│   └── main.ts', '----'].join('\n');
+        const doc = {
+            path: 'docs/test.adoc',
+            absolutePath: '/project/docs/test.adoc',
+            content,
+            format: 'asciidoc',
+            lines: content.split('\n'),
+            references: [],
+        };
+        const refs = extractor.extract(doc);
+        expect(refs.length).toBeGreaterThan(0);
+    });
+    it('handles plaintext format with fallback to markdown pattern', () => {
+        const tree = ['```', 'app/', '├── main.py', '```'].join('\n');
+        const doc = {
+            path: 'docs/test.txt',
+            absolutePath: '/project/docs/test.txt',
+            content: tree,
+            format: 'plaintext',
+            lines: tree.split('\n'),
+            references: [],
+        };
+        const refs = extractor.extract(doc);
+        expect(refs.length).toBeGreaterThan(0);
+    });
+    it('uses custom illustrative patterns from config', () => {
+        const ext = new DirectoryStructureExtractor({
+            rules: { 'directory-structure': { illustrativePatterns: ['^custom-'] } },
+        });
+        const tree = ['```', 'project/', '├── custom-example.ts', '└── real.ts', '```'].join('\n');
+        const refs = ext.extract(makeDoc(tree));
+        const illustrative = refs.filter((r) => r.isIllustrative);
+        expect(illustrative.some((r) => r.value.includes('custom-example'))).toBe(true);
+    });
+});
+//# sourceMappingURL=directoryStructureExtractor.test.js.map

package/dist/parsers/extractors/directoryStructureExtractor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directoryStructureExtractor.test.js","sourceRoot":"","sources":["../../../src/parsers/extractors/directoryStructureExtractor.test.ts"],"names":[],"mappings":"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"}

package/dist/parsers/extractors/externalUrlExtractor.d.ts

@@ -0,0 +1,14 @@
+import { BaseExtractor } from './baseExtractor.js';
+import type { Document, Reference } from '../../types.js';
+/**
+ * Extracts external URL references
+ */
+export declare class ExternalUrlExtractor extends BaseExtractor {
+    constructor();
+    extract(document: Document): Reference[];
+    /**
+     * Strip trailing punctuation while preserving balanced parentheses
+     * (handles Wikipedia-style URLs like .../Example_(disambiguation))
+     */
+    private cleanTrailingPunctuation;
+}

package/dist/parsers/extractors/externalUrlExtractor.js

@@ -0,0 +1,53 @@
+import { BaseExtractor } from './baseExtractor.js';
+/**
+ * Extracts external URL references
+ */
+export class ExternalUrlExtractor extends BaseExtractor {
+    constructor() {
+        super('external-url');
+    }
+    extract(document) {
+        const references = [];
+        const pattern = /https?:\/\/[^\s>\]"']+/g;
+        let match;
+        while ((match = pattern.exec(document.content)) !== null) {
+            let url = match[0];
+            url = this.cleanTrailingPunctuation(url);
+            if (url.length > 0) {
+                references.push({
+                    type: this.type,
+                    value: url,
+                    lineNumber: this.findLineNumber(document.content, match.index),
+                    raw: match[0],
+                    sourceFile: document.path,
+                });
+            }
+        }
+        return references;
+    }
+    /**
+     * Strip trailing punctuation while preserving balanced parentheses
+     * (handles Wikipedia-style URLs like .../Example_(disambiguation))
+     */
+    cleanTrailingPunctuation(url) {
+        while (url.length > 0) {
+            const last = url[url.length - 1];
+            if (last === ')') {
+                const opens = (url.match(/\(/g) || []).length;
+                const closes = (url.match(/\)/g) || []).length;
+                if (closes > opens) {
+                    url = url.slice(0, -1);
+                    continue;
+                }
+                break;
+            }
+            if (/[.,;:!?>}\]'"]+$/.test(last)) {
+                url = url.slice(0, -1);
+                continue;
+            }
+            break;
+        }
+        return url;
+    }
+}
+//# sourceMappingURL=externalUrlExtractor.js.map

package/dist/parsers/extractors/externalUrlExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalUrlExtractor.js","sourceRoot":"","sources":["../../../src/parsers/extractors/externalUrlExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACrD;QACE,KAAK,CAAC,cAAc,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,QAAkB;QACxB,MAAM,UAAU,GAAgB,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,yBAAyB,CAAC;QAE1C,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACzD,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACnB,GAAG,GAAG,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;YAEzC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnB,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,GAAG;oBACV,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC;oBAC9D,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;oBACb,UAAU,EAAE,QAAQ,CAAC,IAAI;iBAC1B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;OAGG;IACK,wBAAwB,CAAC,GAAW;QAC1C,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAEjC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC9C,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC/C,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC;oBACnB,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;oBACvB,SAAS;gBACX,CAAC;gBACD,MAAM;YACR,CAAC;YAED,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBACvB,SAAS;YACX,CAAC;YAED,MAAM;QACR,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/parsers/extractors/externalUrlExtractor.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/extractors/externalUrlExtractor.test.js

@@ -0,0 +1,85 @@
+import { ExternalUrlExtractor } from './externalUrlExtractor.js';
+function makeDoc(content) {
+    return {
+        path: 'docs/test.md',
+        absolutePath: '/project/docs/test.md',
+        content,
+        format: 'markdown',
+        lines: content.split('\n'),
+        references: [],
+    };
+}
+describe('ExternalUrlExtractor', () => {
+    const extractor = new ExternalUrlExtractor();
+    it('extracts HTTP and HTTPS URLs', () => {
+        const doc = makeDoc('Visit https://example.com and http://test.org/path');
+        const refs = extractor.extract(doc);
+        expect(refs).toHaveLength(2);
+        expect(refs[0].value).toBe('https://example.com');
+        expect(refs[1].value).toBe('http://test.org/path');
+    });
+    it('strips trailing punctuation', () => {
+        const doc = makeDoc('See https://example.com. Also https://test.org,');
+        const refs = extractor.extract(doc);
+        expect(refs[0].value).toBe('https://example.com');
+        expect(refs[1].value).toBe('https://test.org');
+    });
+    it('preserves balanced parentheses in Wikipedia-style URLs', () => {
+        const doc = makeDoc('See https://en.wikipedia.org/wiki/Example_(disambiguation)');
+        const refs = extractor.extract(doc);
+        expect(refs[0].value).toBe('https://en.wikipedia.org/wiki/Example_(disambiguation)');
+    });
+    it('strips unbalanced trailing parenthesis', () => {
+        const doc = makeDoc('(visit https://example.com)');
+        const refs = extractor.extract(doc);
+        expect(refs[0].value).toBe('https://example.com');
+    });
+    it('sets correct line numbers', () => {
+        const doc = makeDoc('line1\nhttps://example.com\nline3');
+        const refs = extractor.extract(doc);
+        expect(refs[0].lineNumber).toBe(2);
+    });
+    it('extracts URLs with query params and fragments', () => {
+        const doc = makeDoc('https://example.com/page?foo=bar&baz=1#section');
+        const refs = extractor.extract(doc);
+        expect(refs[0].value).toBe('https://example.com/page?foo=bar&baz=1#section');
+    });
+    it('strips multiple trailing punctuation characters', () => {
+        const doc = makeDoc('See https://example.com/path...');
+        const refs = extractor.extract(doc);
+        expect(refs[0].value).toBe('https://example.com/path');
+    });
+    it('handles URL ending with semicolon and colon', () => {
+        const doc = makeDoc('Visit https://example.com/page; and https://example.com/other:');
+        const refs = extractor.extract(doc);
+        expect(refs[0].value).toBe('https://example.com/page');
+        expect(refs[1].value).toBe('https://example.com/other');
+    });
+    it('handles multiple unbalanced trailing parens', () => {
+        const doc = makeDoc('(see (https://example.com))');
+        const refs = extractor.extract(doc);
+        expect(refs[0].value).toBe('https://example.com');
+    });
+    it('preserves URL with balanced nested parens', () => {
+        const doc = makeDoc('https://en.wikipedia.org/wiki/A_(B_(C))');
+        const refs = extractor.extract(doc);
+        expect(refs[0].value).toBe('https://en.wikipedia.org/wiki/A_(B_(C))');
+    });
+    it('strips trailing bracket characters', () => {
+        const doc = makeDoc('[https://example.com/page]');
+        const refs = extractor.extract(doc);
+        expect(refs[0].value).toBe('https://example.com/page');
+    });
+    it('strips trailing single and double quotes', () => {
+        const doc = makeDoc("see 'https://example.com/page'");
+        const refs = extractor.extract(doc);
+        expect(refs[0].value).toBe('https://example.com/page');
+    });
+    it('strips trailing exclamation and question marks', () => {
+        const doc = makeDoc('Visit https://example.com/page! or https://example.com/other?');
+        const refs = extractor.extract(doc);
+        expect(refs[0].value).toBe('https://example.com/page');
+        expect(refs[1].value).toBe('https://example.com/other');
+    });
+});
+//# sourceMappingURL=externalUrlExtractor.test.js.map

package/dist/parsers/extractors/externalUrlExtractor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalUrlExtractor.test.js","sourceRoot":"","sources":["../../../src/parsers/extractors/externalUrlExtractor.test.ts"],"names":[],"mappings":"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"}

package/dist/parsers/extractors/filePathExtractor.d.ts

@@ -0,0 +1,18 @@
+import { BaseExtractor } from './baseExtractor.js';
+import type { Document, Reference } from '../../types.js';
+/**
+ * Extracts file/path references from documentation links
+ * Supports: Markdown, RST, AsciiDoc link formats
+ */
+export declare class FilePathExtractor extends BaseExtractor {
+    constructor();
+    extract(document: Document): Reference[];
+    /**
+     * Extract line number reference from a file path and return the clean path
+     * Examples:
+     *   "../src/file.ts:1" -> { path: "../src/file.ts", lineRef: "1" }
+     *   "../src/file.ts:26-38" -> { path: "../src/file.ts", lineRef: "26-38" }
+     *   "../src/file.ts#L123" -> { path: "../src/file.ts", lineRef: "L123" }
+     */
+    private extractLineReference;
+}

package/dist/parsers/extractors/filePathExtractor.js

@@ -0,0 +1,72 @@
+import { BaseExtractor } from './baseExtractor.js';
+/**
+ * Line number suffix patterns that should be stripped from file paths
+ * Supports: :N, :N-M, :N-, #LN, #LN-LM (GitHub-style)
+ */
+const LINE_NUMBER_PATTERNS = [
+    /:[0-9]+(?:-[0-9]*)?$/, // :1, :26-38, :10-
+    /#L[0-9]+(?:-L?[0-9]+)?$/, // #L123, #L123-L456, #L123-456
+];
+/**
+ * Extracts file/path references from documentation links
+ * Supports: Markdown, RST, AsciiDoc link formats
+ */
+export class FilePathExtractor extends BaseExtractor {
+    constructor() {
+        super('file-path');
+    }
+    extract(document) {
+        const references = [];
+        // Format-specific patterns
+        const patterns = {
+            markdown: /\[([^\]]*)\]\((\.\.[/\\][^)]+|\.\/[^)]+|[a-zA-Z0-9_\-/\\]+\.[a-zA-Z]{1,10})\)/g,
+            restructuredtext: /`([^`]+)\s+<([^>]+)>`_/g,
+            asciidoc: /link:([^[]+)\[([^\]]*)\]/g,
+        };
+        const pattern = patterns[document.format] || patterns.markdown;
+        let match;
+        while ((match = pattern.exec(document.content)) !== null) {
+            const refPath = document.format === 'asciidoc' ? match[1] : match[2];
+            // Skip URLs
+            if (refPath.startsWith('http://') || refPath.startsWith('https://')) {
+                continue;
+            }
+            // Skip anchors
+            if (refPath.startsWith('#')) {
+                continue;
+            }
+            // Extract and strip line number suffixes
+            const { path: cleanPath, lineRef } = this.extractLineReference(refPath);
+            references.push({
+                type: this.type,
+                value: cleanPath,
+                linkText: document.format === 'asciidoc' ? match[2] : match[1],
+                lineNumber: this.findLineNumber(document.content, match.index),
+                raw: match[0],
+                sourceFile: document.path,
+                // Store the line reference metadata if present
+                ...(lineRef && { lineRef }),
+            });
+        }
+        return references;
+    }
+    /**
+     * Extract line number reference from a file path and return the clean path
+     * Examples:
+     *   "../src/file.ts:1" -> { path: "../src/file.ts", lineRef: "1" }
+     *   "../src/file.ts:26-38" -> { path: "../src/file.ts", lineRef: "26-38" }
+     *   "../src/file.ts#L123" -> { path: "../src/file.ts", lineRef: "L123" }
+     */
+    extractLineReference(refPath) {
+        for (const pattern of LINE_NUMBER_PATTERNS) {
+            const match = refPath.match(pattern);
+            if (match) {
+                const lineRef = match[0].replace(/^[:#]L?/, ''); // Remove leading :, #, or #L
+                const cleanPath = refPath.replace(pattern, '');
+                return { path: cleanPath, lineRef };
+            }
+        }
+        return { path: refPath };
+    }
+}
+//# sourceMappingURL=filePathExtractor.js.map

package/dist/parsers/extractors/filePathExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filePathExtractor.js","sourceRoot":"","sources":["../../../src/parsers/extractors/filePathExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD;;;GAGG;AACH,MAAM,oBAAoB,GAAG;IAC3B,sBAAsB,EAAE,mBAAmB;IAC3C,yBAAyB,EAAE,+BAA+B;CAC3D,CAAC;AAEF;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD;QACE,KAAK,CAAC,WAAW,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,CAAC,QAAkB;QACxB,MAAM,UAAU,GAAgB,EAAE,CAAC;QAEnC,2BAA2B;QAC3B,MAAM,QAAQ,GAAe;YAC3B,QAAQ,EAAE,gFAAgF;YAC1F,gBAAgB,EAAE,yBAAyB;YAC3C,QAAQ,EAAE,2BAA2B;SACtC,CAAC;QAEF,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC;QAE/D,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACzD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAErE,YAAY;YACZ,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBACpE,SAAS;YACX,CAAC;YAED,eAAe;YACf,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5B,SAAS;YACX,CAAC;YAED,yCAAyC;YACzC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAExE,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,SAAS;gBAChB,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC9D,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC;gBAC9D,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;gBACb,UAAU,EAAE,QAAQ,CAAC,IAAI;gBACzB,+CAA+C;gBAC/C,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;aAC5B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACK,oBAAoB,CAAC,OAAe;QAC1C,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACrC,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,6BAA6B;gBAC9E,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC/C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;YACtC,CAAC;QACH,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/parsers/extractors/filePathExtractor.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/extractors/filePathExtractor.test.js

@@ -0,0 +1,73 @@
+import { FilePathExtractor } from './filePathExtractor.js';
+function makeDoc(content, format = 'markdown') {
+    return {
+        path: 'docs/test.md',
+        absolutePath: '/project/docs/test.md',
+        content,
+        format,
+        lines: content.split('\n'),
+        references: [],
+    };
+}
+describe('FilePathExtractor', () => {
+    const extractor = new FilePathExtractor();
+    it('has type "file-path"', () => {
+        expect(extractor.type).toBe('file-path');
+    });
+    describe('markdown format', () => {
+        it('extracts relative file paths from links', () => {
+            const doc = makeDoc('See [config](./config/loader.ts) and [readme](../README.md)');
+            const refs = extractor.extract(doc);
+            expect(refs).toHaveLength(2);
+            expect(refs[0].value).toBe('./config/loader.ts');
+            expect(refs[1].value).toBe('../README.md');
+        });
+        it('extracts paths with extensions', () => {
+            const doc = makeDoc('Check [file](src/utils/helper.ts)');
+            const refs = extractor.extract(doc);
+            expect(refs).toHaveLength(1);
+            expect(refs[0].value).toBe('src/utils/helper.ts');
+        });
+        it('skips URLs and anchors', () => {
+            const doc = makeDoc('[link](https://example.com) [anchor](#heading)');
+            const refs = extractor.extract(doc);
+            expect(refs).toHaveLength(0);
+        });
+        it('strips line number suffixes and stores lineRef', () => {
+            const doc = makeDoc('[file](../src/file.ts:26-38)');
+            const refs = extractor.extract(doc);
+            expect(refs).toHaveLength(1);
+            expect(refs[0].value).toBe('../src/file.ts');
+            expect(refs[0].lineRef).toBe('26-38');
+        });
+        it('handles GitHub-style line references', () => {
+            const doc = makeDoc('[file](../src/file.ts#L123)');
+            const refs = extractor.extract(doc);
+            expect(refs[0].value).toBe('../src/file.ts');
+            expect(refs[0].lineRef).toBe('123');
+        });
+        it('preserves linkText', () => {
+            const doc = makeDoc('[My Link Text](./file.ts)');
+            const refs = extractor.extract(doc);
+            expect(refs[0].linkText).toBe('My Link Text');
+        });
+    });
+    describe('restructuredtext format', () => {
+        it('extracts RST link references', () => {
+            const doc = makeDoc('`Configuration <../config.rst>`_', 'restructuredtext');
+            const refs = extractor.extract(doc);
+            expect(refs).toHaveLength(1);
+            expect(refs[0].value).toBe('../config.rst');
+        });
+    });
+    describe('asciidoc format', () => {
+        it('extracts AsciiDoc link references', () => {
+            const doc = makeDoc('link:./config.adoc[Configuration]', 'asciidoc');
+            const refs = extractor.extract(doc);
+            expect(refs).toHaveLength(1);
+            expect(refs[0].value).toBe('./config.adoc');
+            expect(refs[0].linkText).toBe('Configuration');
+        });
+    });
+});
+//# sourceMappingURL=filePathExtractor.test.js.map

package/dist/parsers/extractors/filePathExtractor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filePathExtractor.test.js","sourceRoot":"","sources":["../../../src/parsers/extractors/filePathExtractor.test.ts"],"names":[],"mappings":"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"}

package/dist/parsers/extractors/versionExtractor.d.ts

@@ -0,0 +1,11 @@
+import { BaseExtractor } from './baseExtractor.js';
+import type { Document, DocFreshnessConfig, Reference } from '../../types.js';
+/**
+ * Extracts version references
+ * Configurable technology list for any stack
+ */
+export declare class VersionExtractor extends BaseExtractor {
+    private technologies;
+    constructor(config?: Partial<DocFreshnessConfig>);
+    extract(document: Document): Reference[];
+}

package/dist/parsers/extractors/versionExtractor.js

@@ -0,0 +1,74 @@
+import { BaseExtractor } from './baseExtractor.js';
+/**
+ * Extracts version references
+ * Configurable technology list for any stack
+ */
+export class VersionExtractor extends BaseExtractor {
+    technologies;
+    constructor(config = {}) {
+        super('version');
+        // Default technologies - can be extended via config
+        this.technologies = config.technologies || [
+            // JavaScript/TypeScript ecosystem
+            'Node\\.?js?',
+            'npm',
+            'yarn',
+            'pnpm',
+            'React',
+            'Vue',
+            'Angular',
+            'TypeScript',
+            'Express',
+            'Vite',
+            'webpack',
+            'Next\\.?js',
+            'Nuxt',
+            // Python ecosystem
+            'Python',
+            'pip',
+            'Django',
+            'Flask',
+            'FastAPI',
+            // Go ecosystem
+            'Go',
+            'Golang',
+            // Rust ecosystem
+            'Rust',
+            'Cargo',
+            // Java ecosystem
+            'Java',
+            'Maven',
+            'Gradle',
+            'Spring',
+            // Databases
+            'PostgreSQL',
+            'MySQL',
+            'MongoDB',
+            'Redis',
+            // Other
+            'Docker',
+            'Kubernetes',
+            'Terraform',
+        ];
+    }
+    extract(document) {
+        const references = [];
+        const techPattern = this.technologies.join('|');
+        // Pattern: "Technology 19.x" or "Technology 19.2.3"
+        const pattern = new RegExp(`\\b(${techPattern})\\s+v?(\\d+(?:\\.\\d+)?(?:\\.\\d+)?(?:\\.x)?)\\b`, 'gi');
+        let match;
+        while ((match = pattern.exec(document.content)) !== null) {
+            references.push({
+                type: this.type,
+                technology: match[1],
+                version: match[2],
+                value: match[0],
+                lineNumber: this.findLineNumber(document.content, match.index),
+                raw: match[0],
+                sourceFile: document.path,
+            });
+        }
+        return references;
+    }
+}
+//# sourceMappingURL=versionExtractor.js.map

package/dist/parsers/extractors/versionExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionExtractor.js","sourceRoot":"","sources":["../../../src/parsers/extractors/versionExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IACzC,YAAY,CAAW;IAE/B,YAAY,SAAsC,EAAE;QAClD,KAAK,CAAC,SAAS,CAAC,CAAC;QACjB,oDAAoD;QACpD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI;YACzC,kCAAkC;YAClC,aAAa;YACb,KAAK;YACL,MAAM;YACN,MAAM;YACN,OAAO;YACP,KAAK;YACL,SAAS;YACT,YAAY;YACZ,SAAS;YACT,MAAM;YACN,SAAS;YACT,YAAY;YACZ,MAAM;YACN,mBAAmB;YACnB,QAAQ;YACR,KAAK;YACL,QAAQ;YACR,OAAO;YACP,SAAS;YACT,eAAe;YACf,IAAI;YACJ,QAAQ;YACR,iBAAiB;YACjB,MAAM;YACN,OAAO;YACP,iBAAiB;YACjB,MAAM;YACN,OAAO;YACP,QAAQ;YACR,QAAQ;YACR,YAAY;YACZ,YAAY;YACZ,OAAO;YACP,SAAS;YACT,OAAO;YACP,QAAQ;YACR,QAAQ;YACR,YAAY;YACZ,WAAW;SACZ,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,QAAkB;QACxB,MAAM,UAAU,GAAgB,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEhD,oDAAoD;QACpD,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,OAAO,WAAW,mDAAmD,EAAE,IAAI,CAAC,CAAC;QAExG,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACzD,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;gBACpB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;gBACjB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;gBACf,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC;gBAC9D,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;gBACb,UAAU,EAAE,QAAQ,CAAC,IAAI;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/parsers/extractors/versionExtractor.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parsers/extractors/versionExtractor.test.js

@@ -0,0 +1,55 @@
+import { VersionExtractor } from './versionExtractor.js';
+function makeDoc(content) {
+    return {
+        path: 'docs/test.md',
+        absolutePath: '/project/docs/test.md',
+        content,
+        format: 'markdown',
+        lines: content.split('\n'),
+        references: [],
+    };
+}
+describe('VersionExtractor', () => {
+    const extractor = new VersionExtractor();
+    it('extracts technology version references', () => {
+        const doc = makeDoc('Requires Node.js 18.0.0 and TypeScript 5.0');
+        const refs = extractor.extract(doc);
+        expect(refs).toHaveLength(2);
+        expect(refs[0]).toMatchObject({ technology: 'Node.js', version: '18.0.0' });
+        expect(refs[1]).toMatchObject({ technology: 'TypeScript', version: '5.0' });
+    });
+    it('handles v-prefixed versions', () => {
+        const doc = makeDoc('Uses React v18.2.0');
+        const refs = extractor.extract(doc);
+        expect(refs).toHaveLength(1);
+        expect(refs[0].version).toBe('18.2.0');
+    });
+    it('handles .x wildcard versions', () => {
+        const doc = makeDoc('Supports Python 3.x');
+        const refs = extractor.extract(doc);
+        expect(refs).toHaveLength(1);
+        expect(refs[0].version).toBe('3.x');
+    });
+    it('respects custom technologies config', () => {
+        const custom = new VersionExtractor({ technologies: ['CustomTool'] });
+        const doc = makeDoc('Uses CustomTool 2.0 and React 18.0');
+        const refs = custom.extract(doc);
+        expect(refs).toHaveLength(1);
+        expect(refs[0].technology).toBe('CustomTool');
+    });
+    it('does not extract versions without known technology prefix', () => {
+        const doc = makeDoc('Version 1.0.0 of something');
+        const refs = extractor.extract(doc);
+        expect(refs).toHaveLength(0);
+    });
+    it.each([
+        ['Docker 24.0', 'Docker', '24.0'],
+        ['PostgreSQL 16', 'PostgreSQL', '16'],
+        ['Go 1.21', 'Go', '1.21'],
+        ['Redis 7.2.1', 'Redis', '7.2.1'],
+    ])('extracts %s => tech=%s version=%s', (input, tech, version) => {
+        const refs = extractor.extract(makeDoc(input));
+        expect(refs[0]).toMatchObject({ technology: tech, version });
+    });
+});
+//# sourceMappingURL=versionExtractor.test.js.map