doc-freshness-checker 2.0.23 → 2.1.0

package/README.md

@@ -373,6 +373,11 @@ console.log(results.summary);
 
 `run()` and `runWithConfig()` reject when a matched document cannot be read or an extractor or validator throws. `runWithConfig()` also rejects when its configuration file cannot be loaded. Matched paths confirmed to have disappeared between discovery and reading are ignored as a normal filesystem race.
 
+> [!WARNING]
+> `Plugin` is deprecated because it is not consumed by `run()` and is planned for removal in v3.0.0. Use
+> `DocFreshnessConfig.customExtractors` and `DocFreshnessConfig.customValidators` for supported extensions. Reporter and
+> lifecycle hooks have no replacement.
+
 Key exports:
 
 | Export                                                                    | Purpose                                              |

package/dist/index.d.ts

@@ -33,7 +33,12 @@ export { GraphBuilder } from './graph/graphBuilder.js';
 export { GitChangeTracker } from './git/changeTracker.js';
 export { CacheManager } from './cache/cacheManager.js';
 export { FreshnessScorer } from './scoring/freshnessScorer.js';
+/**
+ * @deprecated `Plugin` is not consumed by `run()`. Supported extension points are
+ * `DocFreshnessConfig.customExtractors` and `DocFreshnessConfig.customValidators`.
+ * Planned for removal in v3.0.0.
+ */
 export { Plugin } from './plugins/plugin.js';
 export { IncrementalChecker } from './utils/incremental.js';
 export { VectorSearch } from './semantic/vectorSearch.js';
-export type { DocFreshnessConfig, Document, DocumentFormat, Reference, ValidationResult, ValidationResults, ValidationSummary, DocumentIssues, VectorMismatch, Severity, RuleConfig, VersionRuleConfig, RulesConfig, UrlValidationConfig, GraphConfig, GitConfig, FreshnessScoringConfig, FreshnessScoringWeights, FreshnessScoringThresholds, VectorSearchConfig, CacheConfig, IncrementalConfig, ReporterType, Grade, DocScore, ProjectScores, CommitInfo, ChangeSummaryItem, IndexMetadata, CacheStats, SymbolLocation, SourceFileData, CodeFile, CodeSnippetRuleConfig, BaseExtractor as BaseExtractorType, BaseValidator, } from './types.js';
+export type { DocFreshnessConfig, Document, DocumentFormat, Reference, ValidationResult, ValidationResults, ValidationSummary, DocumentIssues, VectorMismatch, Severity, RuleConfig, VersionRuleConfig, RulesConfig, UrlValidationConfig, GraphConfig, GitConfig, FreshnessScoringConfig, FreshnessScoringWeights, FreshnessScoringThresholds, VectorSearchConfig, CacheConfig, IncrementalConfig, ReporterType, Grade, DocScore, ProjectScores, CommitInfo, ChangeSummaryItem, IndexMetadata, CacheStats, SymbolLocation, SourceFileData, CodeFile, SupportedLanguage, SupportedSnippetLanguage, CodeSnippetRuleConfig, BaseExtractor as BaseExtractorType, Extractor, BaseValidator, } from './types.js';

package/dist/index.js

@@ -33,6 +33,11 @@ export { GraphBuilder } from './graph/graphBuilder.js';
 export { GitChangeTracker } from './git/changeTracker.js';
 export { CacheManager } from './cache/cacheManager.js';
 export { FreshnessScorer } from './scoring/freshnessScorer.js';
+/**
+ * @deprecated `Plugin` is not consumed by `run()`. Supported extension points are
+ * `DocFreshnessConfig.customExtractors` and `DocFreshnessConfig.customValidators`.
+ * Planned for removal in v3.0.0.
+ */
 export { Plugin } from './plugins/plugin.js';
 export { IncrementalChecker } from './utils/incremental.js';
 export { VectorSearch } from './semantic/vectorSearch.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,qDAAqD,CAAC;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,qDAAqD,CAAC;AAClG,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/manifests/manifestInventory.d.ts

@@ -0,0 +1,28 @@
+import type { DocFreshnessConfig } from '../types.js';
+export interface VersionCandidate {
+    version: string;
+    sourceIndex: number;
+}
+interface DependencyProjection {
+    all: ReadonlySet<string>;
+    python: ReadonlySet<string>;
+}
+interface VersionProjection {
+    all: ReadonlyMap<string, VersionCandidate>;
+    python: ReadonlyMap<string, VersionCandidate>;
+}
+export declare class ManifestInventory {
+    private contents;
+    private dependencyState;
+    private versionState;
+    private activeKey;
+    dependencyNames(config: DocFreshnessConfig): Promise<DependencyProjection>;
+    packageVersions(config: DocFreshnessConfig): Promise<VersionProjection>;
+    private activate;
+    private loadDependencyNames;
+    private loadPackageVersions;
+    private read;
+}
+export declare function inventoryFor(owner: object): ManifestInventory;
+export declare function attachInventory(owner: object, inventory: ManifestInventory): void;
+export {};

package/dist/manifests/manifestInventory.js

@@ -0,0 +1,225 @@
+import fs from 'fs';
+import path from 'path';
+import semver from 'semver';
+import { parseCargoDependencies, resolveCargoDependencies } from '../utils/cargoDependencies.js';
+import { parseGoModRequirements } from '../utils/goMod.js';
+import { resolveManifestPaths } from '../utils/manifestPaths.js';
+import { canonicalizePythonPackageName, parsePyprojectDependencies, parseRequirementsDependencies } from '../utils/pythonDependencies.js';
+const manifestFormats = {
+    'package.json': {
+        dependency: (content) => {
+            const json = JSON.parse(content);
+            return ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies'].flatMap((key) => Object.keys(json[key] || {}));
+        },
+        version: (content) => {
+            const json = JSON.parse(content);
+            const versions = new Map();
+            for (const [name, version] of Object.entries(json.peerDependencies || {})) {
+                versions.set(name.toLowerCase(), normalizePeerVersion(version));
+            }
+            for (const [name, version] of Object.entries({
+                ...json.dependencies,
+                ...json.devDependencies,
+                ...json.optionalDependencies,
+            })) {
+                versions.set(name.toLowerCase(), normalizeVersion(version));
+            }
+            if (json.engines?.node) {
+                versions.set('node', normalizeVersion(json.engines.node));
+                versions.set('nodejs', normalizeVersion(json.engines.node));
+            }
+            if (json.engines?.npm) {
+                versions.set('npm', normalizeVersion(json.engines.npm));
+            }
+            return versions;
+        },
+    },
+    'requirements.txt': {
+        dependency: (content) => Array.from(parseRequirementsDependencies(content).keys()),
+        version: parseRequirementsDependencies,
+        python: true,
+    },
+    'pyproject.toml': {
+        dependency: (content) => Array.from(parsePyprojectDependencies(content).keys()),
+        version: parsePyprojectDependencies,
+        python: true,
+    },
+    'go.mod': {
+        dependency: (content) => parseGoModRequirements(content).map(([modulePath]) => modulePath),
+        version: (content) => {
+            const versions = new Map();
+            const goVersion = content.match(/^go\s+(\d+\.\d+)/m)?.[1];
+            if (goVersion) {
+                versions.set('go', goVersion);
+                versions.set('golang', goVersion);
+            }
+            for (const [modulePath, version] of parseGoModRequirements(content)) {
+                versions.set(modulePath, normalizeVersion(version));
+            }
+            return versions;
+        },
+    },
+    'Cargo.toml': {
+        dependency: (content) => parseCargoDependencies(content).map(({ name }) => name),
+    },
+    'pom.xml': {
+        dependency: (content) => Array.from(content.matchAll(/<artifactId>([^<]+)<\/artifactId>/g), (match) => match[1]),
+        version: (content) => {
+            const versions = new Map();
+            const javaVersion = content.match(/<java\.version>([^<]+)<\/java\.version>/)?.[1];
+            if (javaVersion) {
+                versions.set('java', javaVersion);
+            }
+            for (const match of content.matchAll(/<dependency>[\s\S]*?<artifactId>([^<]+)<\/artifactId>[\s\S]*?<version>([^<]+)<\/version>[\s\S]*?<\/dependency>/g)) {
+                versions.set(match[1].toLowerCase(), normalizeVersion(match[2]));
+            }
+            return versions;
+        },
+    },
+};
+function normalizeVersion(version) {
+    return version ? version.replace(/^[\^~>=<]+/, '').replace(/\.x$/i, '.0') : 'any';
+}
+function normalizePeerVersion(version) {
+    const range = semver.validRange(version);
+    const minimum = range && semver.minVersion(range);
+    return minimum && semver.subset(range, `${minimum.major}.x`) ? minimum.version : 'any';
+}
+function setCandidate(candidates, name, version, sourceIndex) {
+    const current = candidates.get(name);
+    const equallyConcrete = current && (version === 'any') === (current.version === 'any');
+    if (!current || (version !== 'any' && current.version === 'any') || (equallyConcrete && sourceIndex >= current.sourceIndex)) {
+        candidates.set(name, { version, sourceIndex });
+    }
+}
+export class ManifestInventory {
+    contents = new Map();
+    dependencyState = null;
+    versionState = null;
+    activeKey = null;
+    dependencyNames(config) {
+        const manifestConfig = this.activate(config);
+        if (!this.dependencyState) {
+            const pending = this.loadDependencyNames(manifestConfig);
+            this.dependencyState = pending;
+            void pending.catch(() => {
+                if (this.dependencyState === pending) {
+                    this.dependencyState = null;
+                }
+            });
+        }
+        return this.dependencyState;
+    }
+    packageVersions(config) {
+        const manifestConfig = this.activate(config);
+        if (!this.versionState) {
+            const pending = this.loadPackageVersions(manifestConfig);
+            this.versionState = pending;
+            void pending.catch(() => {
+                if (this.versionState === pending) {
+                    this.versionState = null;
+                }
+            });
+        }
+        return this.versionState;
+    }
+    activate(config) {
+        const paths = resolveManifestPaths(config);
+        const key = JSON.stringify(paths);
+        if (this.activeKey !== key) {
+            this.activeKey = key;
+            this.contents = new Map();
+            this.dependencyState = null;
+            this.versionState = null;
+        }
+        return { paths, contents: this.contents };
+    }
+    async loadDependencyNames(config) {
+        const all = new Set();
+        const python = new Set();
+        for (const manifestPath of config.paths) {
+            const format = manifestFormats[path.basename(manifestPath)];
+            if (!format) {
+                continue;
+            }
+            try {
+                for (const dependency of format.dependency(await this.read(manifestPath, config.contents))) {
+                    const name = dependency.toLowerCase();
+                    all.add(name);
+                    if (format.python) {
+                        python.add(canonicalizePythonPackageName(name));
+                    }
+                }
+            }
+            catch (cause) {
+                config.contents.delete(manifestPath);
+                throw manifestError(manifestPath, cause);
+            }
+        }
+        return { all, python };
+    }
+    async loadPackageVersions(config) {
+        const all = new Map();
+        const python = new Map();
+        const cargoManifests = [];
+        for (const [sourceIndex, manifestPath] of config.paths.entries()) {
+            const fileName = path.basename(manifestPath);
+            if (fileName === 'Cargo.toml') {
+                try {
+                    cargoManifests.push({ entries: parseCargoDependencies(await this.read(manifestPath, config.contents)), sourceIndex });
+                }
+                catch (cause) {
+                    config.contents.delete(manifestPath);
+                    throw manifestError(manifestPath, cause);
+                }
+                continue;
+            }
+            const format = manifestFormats[fileName];
+            if (!format?.version) {
+                continue;
+            }
+            try {
+                const versions = format.version(await this.read(manifestPath, config.contents));
+                for (const [name, version] of versions) {
+                    setCandidate(all, name, version, sourceIndex);
+                    if (format?.python) {
+                        python.set(canonicalizePythonPackageName(name), { version, sourceIndex });
+                    }
+                }
+            }
+            catch (cause) {
+                config.contents.delete(manifestPath);
+                throw manifestError(manifestPath, cause);
+            }
+        }
+        const cargoDependencies = cargoManifests.flatMap(({ entries, sourceIndex }) => entries.map((entry) => ({ ...entry, sourceIndex })));
+        for (const [name, dependency] of resolveCargoDependencies(cargoDependencies)) {
+            setCandidate(all, name, dependency.unresolvedWorkspaceReference ? 'any' : normalizeVersion(dependency.version), dependency.sourceIndex);
+        }
+        return { all, python };
+    }
+    read(filePath, contents) {
+        let content = contents.get(filePath);
+        if (!content) {
+            content = fs.promises.readFile(filePath, 'utf-8');
+            contents.set(filePath, content);
+        }
+        return content;
+    }
+}
+function manifestError(manifestPath, cause) {
+    return new Error(`Failed to load manifest: ${manifestPath}: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+}
+const inventories = new WeakMap();
+export function inventoryFor(owner) {
+    let inventory = inventories.get(owner);
+    if (!inventory) {
+        inventory = new ManifestInventory();
+        inventories.set(owner, inventory);
+    }
+    return inventory;
+}
+export function attachInventory(owner, inventory) {
+    inventories.set(owner, inventory);
+}
+//# sourceMappingURL=manifestInventory.js.map

package/dist/manifests/manifestInventory.js.map

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

package/dist/manifests/manifestInventory.test.d.ts

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

package/dist/manifests/manifestInventory.test.js

@@ -0,0 +1,176 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { ManifestInventory } from './manifestInventory.js';
+import { PEP621_PYPROJECT_FIXTURES } from '../test-utils/manifestFixtures.js';
+async function withManifests(files, run) {
+    const rootDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'doc-freshness-manifests-'));
+    try {
+        for (const [relativePath, content] of Object.entries(files)) {
+            const filePath = path.join(rootDir, relativePath);
+            await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
+            await fs.promises.writeFile(filePath, content, 'utf-8');
+        }
+        await run(rootDir);
+    }
+    finally {
+        await fs.promises.rm(rootDir, { recursive: true, force: true });
+    }
+}
+function candidate(version, sourceIndex = 0) {
+    return { version, sourceIndex };
+}
+describe('ManifestInventory', () => {
+    it('projects npm names and version precedence', async () => {
+        await withManifests({
+            'package.json': JSON.stringify({
+                engines: { node: '>=20.0.0', npm: '^11.0.0' },
+                dependencies: { React: '18.2.0' },
+                devDependencies: { TypeScript: '5.4.5' },
+                peerDependencies: { react: '^17 || ^18', typescript: '>=4.7', peerOnly: '>=16', narrowPeer: '^4.0.0', node: '14.0.0' },
+                optionalDependencies: { optionalOnly: '2.3.0' },
+            }),
+        }, async (rootDir) => {
+            const inventory = new ManifestInventory();
+            const config = { rootDir, manifestFiles: ['package.json'] };
+            const [dependencies, versions] = await Promise.all([inventory.dependencyNames(config), inventory.packageVersions(config)]);
+            expect(dependencies).toEqual({
+                all: new Set(['react', 'typescript', 'peeronly', 'narrowpeer', 'node', 'optionalonly']),
+                python: new Set(),
+            });
+            expect(versions.all).toEqual(new Map([
+                ['react', candidate('18.2.0')],
+                ['typescript', candidate('5.4.5')],
+                ['peeronly', candidate('any')],
+                ['narrowpeer', candidate('4.0.0')],
+                ['node', candidate('20.0.0')],
+                ['optionalonly', candidate('2.3.0')],
+                ['nodejs', candidate('20.0.0')],
+                ['npm', candidate('11.0.0')],
+            ]));
+        });
+    });
+    it('uses the shared Python parsers and keeps canonical candidates separate', async () => {
+        await withManifests({
+            'requirements.txt': 'Requests[security]==2.31\nfoo.bar~=7.1\nDjango>=4.2,<5\ncommented_pkg==4.1 # reason\ndirect_pkg @ https://example.com/archive.whl#sha256=abc\n-r other.txt\n',
+            'pyproject.toml': '[project]\ndependencies = ["requests==2.32", "python_name==3.0"]\n',
+        }, async (rootDir) => {
+            const inventory = new ManifestInventory();
+            const config = { rootDir, manifestFiles: ['requirements.txt', 'pyproject.toml'] };
+            const [dependencies, versions] = await Promise.all([inventory.dependencyNames(config), inventory.packageVersions(config)]);
+            expect(dependencies.all).toEqual(new Set(['requests', 'foo.bar', 'django', 'commented_pkg', 'direct_pkg', 'python_name']));
+            expect(dependencies.python).toEqual(new Set(['requests', 'foo-bar', 'django', 'commented-pkg', 'direct-pkg', 'python-name']));
+            expect(versions.all.get('requests')).toEqual(candidate('2.32', 1));
+            expect(versions.all.get('foo.bar')).toEqual(candidate('7.1'));
+            expect(versions.all.get('django')).toEqual(candidate('any'));
+            expect(versions.all.get('commented_pkg')).toEqual(candidate('4.1'));
+            expect(versions.all.get('direct_pkg')).toEqual(candidate('any'));
+            expect(versions.python.get('python-name')).toEqual(candidate('3.0', 1));
+        });
+    });
+    it.each(PEP621_PYPROJECT_FIXTURES.slice(2))('projects PEP 621 $name', async ({ content, dependencies }) => {
+        await withManifests({ 'pyproject.toml': content }, async (rootDir) => {
+            const versions = await new ManifestInventory().packageVersions({ rootDir, manifestFiles: ['pyproject.toml'] });
+            expect(Object.fromEntries(Array.from(versions.all, ([name, value]) => [name, value.version]))).toEqual(dependencies);
+        });
+    });
+    it('uses the shared Go and Cargo parsers and aggregates Cargo candidates', async () => {
+        await withManifests({
+            'go.mod': 'module example.test/app\ngo 1.22\nrequire example.test/single v9.0.0\nrequire (\n example.test/block v1.2.3\n)\n',
+            'root/Cargo.toml': '[workspace.dependencies]\nshared = "2.0"\n[dependencies]\nserde = "1.0"\n',
+            'member/Cargo.toml': '[dependencies]\nshared = { workspace = true }\nserde = { path = "../serde" }\n',
+        }, async (rootDir) => {
+            const inventory = new ManifestInventory();
+            const config = { rootDir, manifestFiles: ['go.mod', 'root/Cargo.toml', 'member/Cargo.toml'] };
+            const [dependencies, versions] = await Promise.all([inventory.dependencyNames(config), inventory.packageVersions(config)]);
+            expect(dependencies.all).toEqual(new Set(['example.test/single', 'example.test/block', 'shared', 'serde']));
+            expect(versions.all).toEqual(new Map([
+                ['go', candidate('1.22')],
+                ['golang', candidate('1.22')],
+                ['example.test/single', candidate('9.0.0')],
+                ['example.test/block', candidate('1.2.3')],
+                ['shared', candidate('2.0', 2)],
+                ['serde', candidate('1.0', 1)],
+            ]));
+        });
+    });
+    it('projects Maven artifact and Java versions', async () => {
+        await withManifests({
+            'pom.xml': '<project><artifactId>app</artifactId><java.version>21</java.version><dependency><artifactId>junit</artifactId><version>5.9</version></dependency></project>',
+            'no-java/pom.xml': '<project><dependency><artifactId>junit</artifactId><version>5.9</version></dependency></project>',
+        }, async (rootDir) => {
+            const inventory = new ManifestInventory();
+            const config = { rootDir, manifestFiles: ['pom.xml'] };
+            expect((await inventory.dependencyNames(config)).all).toEqual(new Set(['app', 'junit']));
+            expect((await inventory.packageVersions(config)).all).toEqual(new Map([
+                ['java', candidate('21')],
+                ['junit', candidate('5.9')],
+            ]));
+            expect((await new ManifestInventory().packageVersions({ rootDir, manifestFiles: ['no-java/pom.xml'] })).all.has('java')).toBe(false);
+        });
+    });
+    it('shares built-in reads across concurrent projections', async () => {
+        await withManifests({ 'package.json': JSON.stringify({ dependencies: { shared: '1.0.0' } }) }, async (rootDir) => {
+            const readFile = vi.spyOn(fs.promises, 'readFile');
+            try {
+                const inventory = new ManifestInventory();
+                const config = { rootDir, manifestFiles: ['package.json'] };
+                const [dependencies, versions] = await Promise.all([inventory.dependencyNames(config), inventory.packageVersions(config)]);
+                expect(dependencies.all.has('shared')).toBe(true);
+                expect(versions.all.get('shared')).toEqual(candidate('1.0.0'));
+                expect(readFile).toHaveBeenCalledOnce();
+            }
+            finally {
+                readFile.mockRestore();
+            }
+        });
+    });
+    it('retries failed reads and projections after a same-key manifest is repaired', async () => {
+        await withManifests({}, async (rootDir) => {
+            const inventory = new ManifestInventory();
+            const config = { rootDir, manifestFiles: ['package.json'] };
+            const filePath = path.join(rootDir, 'package.json');
+            await expect(inventory.dependencyNames(config)).rejects.toMatchObject({
+                message: expect.stringContaining(`Failed to load manifest: ${filePath}: ENOENT`),
+                cause: expect.objectContaining({ code: 'ENOENT' }),
+            });
+            await fs.promises.writeFile(filePath, '{', 'utf-8');
+            await expect(inventory.packageVersions(config)).rejects.toThrow(`Failed to load manifest: ${filePath}`);
+            await fs.promises.writeFile(filePath, JSON.stringify({ dependencies: { repaired: '3.0.0' } }), 'utf-8');
+            expect((await inventory.dependencyNames(config)).all).toEqual(new Set(['repaired']));
+            expect((await inventory.packageVersions(config)).all.get('repaired')).toEqual(candidate('3.0.0'));
+        });
+    });
+    it('reads neither unknown formats nor an explicitly empty manifest list', async () => {
+        const readFile = vi.spyOn(fs.promises, 'readFile');
+        try {
+            const inventory = new ManifestInventory();
+            await expect(inventory.dependencyNames({ rootDir: '/unused', manifestFiles: ['unknown.lock'] })).resolves.toEqual({
+                all: new Set(),
+                python: new Set(),
+            });
+            await expect(inventory.packageVersions({ rootDir: '/unused', manifestFiles: [] })).resolves.toEqual({
+                all: new Map(),
+                python: new Map(),
+            });
+            expect(readFile).not.toHaveBeenCalled();
+        }
+        finally {
+            readFile.mockRestore();
+        }
+    });
+    it('resets cached projections when the resolved manifest configuration changes', async () => {
+        await withManifests({
+            'a/package.json': JSON.stringify({ dependencies: { first: '1.0.0' } }),
+            'b/package.json': JSON.stringify({ dependencies: { second: '2.0.0' } }),
+        }, async (rootDir) => {
+            const inventory = new ManifestInventory();
+            const firstConfig = { rootDir, manifestFiles: ['a/package.json'] };
+            const first = await inventory.packageVersions(firstConfig);
+            expect(await inventory.packageVersions(firstConfig)).toBe(first);
+            expect((await inventory.packageVersions({ rootDir, manifestFiles: ['b/package.json'] })).all.has('second')).toBe(true);
+            expect((await inventory.packageVersions(firstConfig)).all.has('first')).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=manifestInventory.test.js.map

package/dist/manifests/manifestInventory.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifestInventory.test.js","sourceRoot":"","sources":["../../src/manifests/manifestInventory.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAG9E,KAAK,UAAU,aAAa,CAAC,KAA6B,EAAE,GAAuC;IACjG,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC,CAAC;IAC9F,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAClD,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACrE,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;YACO,CAAC;QACP,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,OAAe,EAAE,WAAW,GAAG,CAAC;IACjD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,aAAa,CACjB;YACE,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC;gBAC7B,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE;gBAC7C,YAAY,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACjC,eAAe,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE;gBACxC,gBAAgB,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACtH,oBAAoB,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE;aAChD,CAAC;SACH,EACD,KAAK,EAAE,OAAO,EAAE,EAAE;YAChB,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5D,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAE3H,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;gBAC3B,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;gBACvF,MAAM,EAAE,IAAI,GAAG,EAAE;aAClB,CAAC,CAAC;YACH,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,CAC1B,IAAI,GAAG,CAAC;gBACN,CAAC,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAC9B,CAAC,YAAY,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;gBAClC,CAAC,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;gBAC9B,CAAC,YAAY,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;gBAClC,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAC7B,CAAC,cAAc,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;gBACpC,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAC/B,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;aAC7B,CAAC,CACH,CAAC;QACJ,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,aAAa,CACjB;YACE,kBAAkB,EAChB,8JAA8J;YAChK,gBAAgB,EAAE,oEAAoE;SACvF,EACD,KAAK,EAAE,OAAO,EAAE,EAAE;YAChB,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,EAAE,CAAC;YAClF,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAE3H,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;YAC3H,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;YAC9H,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;YACnE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9D,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7D,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YACpE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YACjE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1E,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE;QACxG,MAAM,aAAa,CAAC,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACnE,MAAM,QAAQ,GAAG,MAAM,IAAI,iBAAiB,EAAE,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;YAC/G,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACvH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,aAAa,CACjB;YACE,QAAQ,EAAE,kHAAkH;YAC5H,iBAAiB,EAAE,2EAA2E;YAC9F,mBAAmB,EAAE,gFAAgF;SACtG,EACD,KAAK,EAAE,OAAO,EAAE,EAAE;YAChB,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,mBAAmB,CAAC,EAAE,CAAC;YAC9F,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAE3H,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,qBAAqB,EAAE,oBAAoB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YAC5G,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,CAC1B,IAAI,GAAG,CAAC;gBACN,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;gBACzB,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;gBAC7B,CAAC,qBAAqB,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC3C,CAAC,oBAAoB,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC1C,CAAC,QAAQ,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC/B,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;aAC/B,CAAC,CACH,CAAC;QACJ,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,aAAa,CACjB;YACE,SAAS,EACP,6JAA6J;YAC/J,iBAAiB,EAAE,kGAAkG;SACtH,EACD,KAAK,EAAE,OAAO,EAAE,EAAE;YAChB,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;YACvD,MAAM,CAAC,CAAC,MAAM,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YACzF,MAAM,CAAC,CAAC,MAAM,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAC3D,IAAI,GAAG,CAAC;gBACN,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;gBACzB,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;aAC5B,CAAC,CACH,CAAC;YACF,MAAM,CAAC,CAAC,MAAM,IAAI,iBAAiB,EAAE,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAC3H,KAAK,CACN,CAAC;QACJ,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,aAAa,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC/G,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACnD,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;gBAC1C,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC5D,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC3H,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC/D,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,EAAE,CAAC;YAC1C,CAAC;oBACO,CAAC;gBACP,QAAQ,CAAC,WAAW,EAAE,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxC,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAEpD,MAAM,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;gBACpE,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC,4BAA4B,QAAQ,UAAU,CAAC;gBAChF,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;aACnD,CAAC,CAAC;YACH,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;YACpD,MAAM,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;YACxG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAExG,MAAM,CAAC,CAAC,MAAM,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACrF,MAAM,CAAC,CAAC,MAAM,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QACpG,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;YAC1C,MAAM,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAChH,GAAG,EAAE,IAAI,GAAG,EAAE;gBACd,MAAM,EAAE,IAAI,GAAG,EAAE;aAClB,CAAC,CAAC;YACH,MAAM,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAClG,GAAG,EAAE,IAAI,GAAG,EAAE;gBACd,MAAM,EAAE,IAAI,GAAG,EAAE;aAClB,CAAC,CAAC;YACH,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC1C,CAAC;gBACO,CAAC;YACP,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,aAAa,CACjB;YACE,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;YACtE,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;SACxE,EACD,KAAK,EAAE,OAAO,EAAE,EAAE;YAChB,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;YAC1C,MAAM,WAAW,GAAuB,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACvF,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;YAC3D,MAAM,CAAC,MAAM,SAAS,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjE,MAAM,CAAC,CAAC,MAAM,SAAS,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvH,MAAM,CAAC,CAAC,MAAM,SAAS,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrF,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/manifests/validatorConstructors.test.d.ts

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

package/dist/manifests/validatorConstructors.test.js

@@ -0,0 +1,17 @@
+import { DependencyValidator } from '../validators/dependencyValidator.js';
+import { VersionValidator } from '../validators/versionValidator.js';
+import { ManifestInventory } from './manifestInventory.js';
+describe('public manifest validator constructors', () => {
+    it('accept only zero arguments in the public type surface', () => {
+        expectTypeOf(DependencyValidator).toBeConstructibleWith();
+        expectTypeOf(VersionValidator).toBeConstructibleWith();
+        const internalInjectionIsRejected = () => {
+            // @ts-expect-error ManifestInventory injection is internal-only.
+            new DependencyValidator(new ManifestInventory());
+            // @ts-expect-error ManifestInventory injection is internal-only.
+            new VersionValidator(new ManifestInventory());
+        };
+        expectTypeOf(internalInjectionIsRejected).toBeFunction();
+    });
+});
+//# sourceMappingURL=validatorConstructors.test.js.map

package/dist/manifests/validatorConstructors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validatorConstructors.test.js","sourceRoot":"","sources":["../../src/manifests/validatorConstructors.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,YAAY,CAAC,mBAAmB,CAAC,CAAC,qBAAqB,EAAE,CAAC;QAC1D,YAAY,CAAC,gBAAgB,CAAC,CAAC,qBAAqB,EAAE,CAAC;QAEvD,MAAM,2BAA2B,GAAG,GAAS,EAAE;YAC7C,iEAAiE;YACjE,IAAI,mBAAmB,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;YACjD,iEAAiE;YACjE,IAAI,gBAAgB,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;QAChD,CAAC,CAAC;QACF,YAAY,CAAC,2BAA2B,CAAC,CAAC,YAAY,EAAE,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/parsers/documentParser.d.ts

@@ -1,5 +1,4 @@
-import type { DocFreshnessConfig, Document, DocumentFormat } from '../types.js';
-import type { BaseExtractor } from './extractors/baseExtractor.js';
+import type { DocFreshnessConfig, Document, DocumentFormat, Extractor } from '../types.js';
 /**
  * Parses documentation files and extracts references for validation
  */
@@ -10,7 +9,7 @@ export declare class DocumentParser {
     /**
      * Register reference extractors
      */
-    registerExtractor(extractor: BaseExtractor): void;
+    registerExtractor(extractor: Extractor): void;
     /**
      * Scan all documentation files matching the configured patterns
      */

package/dist/parsers/documentParser.js.map

@@ -1 +1 @@
-{"version":3,"file":"documentParser.js","sourceRoot":"","sources":["../../src/parsers/documentParser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"documentParser.js","sourceRoot":"","sources":["../../src/parsers/documentParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B;;GAEG;AACH,MAAM,OAAO,cAAc;IACjB,MAAM,CAAqB;IAC3B,UAAU,CAAc;IAEhC,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,SAAoB;QACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE;YAClD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC3B,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YACxB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,MAAM,SAAS,GAAe,EAAE,CAAC;QAEjC,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,KAAK,EAAE,CAAC;gBACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACvD,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACpC,CAAC;gBACD,OAAO,SAAS,EAAE,CAAC;oBACjB,IAAK,SAAmC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;wBAC3D,SAAS;oBACX,CAAC;oBACD,MAAM,KAAK,CAAC;gBACd,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;YACnF,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAE3C,MAAM,GAAG,GAAa;gBACpB,IAAI,EAAE,YAAY;gBAClB,YAAY,EAAE,QAAQ;gBACtB,OAAO;gBACP,MAAM;gBACN,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC1B,UAAU,EAAE,EAAE;aACf,CAAC;YAEF,8BAA8B;YAC9B,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACxC,IAAI,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrC,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBACpC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YAED,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,QAAgB;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACjD,MAAM,SAAS,GAAmC;YAChD,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,UAAU;YACvB,MAAM,EAAE,kBAAkB;YAC1B,OAAO,EAAE,UAAU;YACnB,WAAW,EAAE,UAAU;YACvB,MAAM,EAAE,WAAW;SACpB,CAAC;QACF,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC;IACvC,CAAC;CACF"}

package/dist/parsers/extractorInterface.test.d.ts

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

package/dist/parsers/extractorInterface.test.js

@@ -0,0 +1,34 @@
+import { BaseExtractor } from './extractors/baseExtractor.js';
+const extract = (_document) => [];
+const supportsFormat = (format) => format === 'markdown';
+function acceptsExtractor(_extractor) { }
+describe('Extractor contract', () => {
+    it('accepts subclasses, the six-member legacy shape, and two-method objects', () => {
+        class CustomExtractor extends BaseExtractor {
+            extract(_document) {
+                return [];
+            }
+        }
+        const sixMemberExtractor = {
+            type: 'custom',
+            supportedFormats: ['markdown'],
+            supportsFormat,
+            extract,
+            findLineNumber: () => 1,
+            getContext: () => '',
+        };
+        const twoMemberExtractor = { supportsFormat, extract };
+        acceptsExtractor(new CustomExtractor('custom'));
+        acceptsExtractor(sixMemberExtractor);
+        acceptsExtractor(twoMemberExtractor);
+    });
+    it('requires both synchronous extractor methods', () => {
+        // @ts-expect-error Extractors must implement extract.
+        acceptsExtractor({ supportsFormat });
+        // @ts-expect-error Extractors must implement supportsFormat.
+        acceptsExtractor({ extract });
+        // @ts-expect-error Asynchronous extraction remains unsupported.
+        acceptsExtractor({ supportsFormat, extract: async () => [] });
+    });
+});
+//# sourceMappingURL=extractorInterface.test.js.map

package/dist/parsers/extractorInterface.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractorInterface.test.js","sourceRoot":"","sources":["../../src/parsers/extractorInterface.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,MAAM,OAAO,GAAyB,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC;AACxD,MAAM,cAAc,GAAgC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,UAAU,CAAC;AAEtF,SAAS,gBAAgB,CAAC,UAAqB,IAAS,CAAC;AAEzD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,eAAgB,SAAQ,aAAa;YAChC,OAAO,CAAC,SAAmB;gBAClC,OAAO,EAAE,CAAC;YACZ,CAAC;SACF;QACD,MAAM,kBAAkB,GAAG;YACzB,IAAI,EAAE,QAAQ;YACd,gBAAgB,EAAE,CAAC,UAAU,CAAC;YAC9B,cAAc;YACd,OAAO;YACP,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;YACvB,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE;SACW,CAAC;QAClC,MAAM,kBAAkB,GAAG,EAAE,cAAc,EAAE,OAAO,EAAsB,CAAC;QAE3E,gBAAgB,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChD,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;QACrC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,sDAAsD;QACtD,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;QACrC,6DAA6D;QAC7D,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9B,gEAAgE;QAChE,gBAAgB,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}