@mf-toolkit/shared-inspector 0.1.0

package/dist/collector/collect-imports.d.ts

@@ -0,0 +1,17 @@
+import type { PackageOccurrence } from '../types.js';
+export declare function scanFiles(dirs: string[], extensions: string[]): Promise<string[]>;
+export interface CollectImportsOptions {
+    sourceDirs: string[];
+    extensions?: string[];
+    ignore?: string[];
+    workspacePackages?: string[];
+}
+/**
+ * Direct mode collector.
+ *
+ * Scans all source files and extracts explicitly imported package names.
+ * Counts only `import` and `require` declarations — re-exports are NOT counted
+ * (they are the domain of traverse-local-modules in local-graph mode).
+ */
+export declare function collectImports(options: CollectImportsOptions): Promise<PackageOccurrence[]>;
+//# sourceMappingURL=collect-imports.d.ts.map

package/dist/collector/collect-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-imports.d.ts","sourceRoot":"","sources":["../../src/collector/collect-imports.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAarD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBvF;AAID,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAID;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA4C9B"}

package/dist/collector/collect-imports.js

@@ -0,0 +1,87 @@
+import { readFile } from 'node:fs/promises';
+import { readdir } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+import { parseDeclarations, isRelativeSpecifier, isNodeBuiltin, normalizePackageName, } from './parse-declarations.js';
+const DEFAULT_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx'];
+const IGNORED_DIRS = ['node_modules', '.git', 'dist', 'build', 'coverage'];
+// ─── File scanner ─────────────────────────────────────────────────────────────
+export async function scanFiles(dirs, extensions) {
+    const files = [];
+    for (const dir of dirs) {
+        try {
+            const entries = await readdir(dir, { recursive: true });
+            for (const entry of entries) {
+                if (typeof entry !== 'string')
+                    continue;
+                if (!extensions.includes(extname(entry)))
+                    continue;
+                if (entry.split('/').some((seg) => IGNORED_DIRS.includes(seg)))
+                    continue;
+                files.push(join(dir, entry));
+            }
+        }
+        catch {
+            // Directory does not exist — skip silently
+        }
+    }
+    return files;
+}
+// ─── Main ─────────────────────────────────────────────────────────────────────
+/**
+ * Direct mode collector.
+ *
+ * Scans all source files and extracts explicitly imported package names.
+ * Counts only `import` and `require` declarations — re-exports are NOT counted
+ * (they are the domain of traverse-local-modules in local-graph mode).
+ */
+export async function collectImports(options) {
+    const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+    const files = await scanFiles(options.sourceDirs, extensions);
+    /** package → Set of files that import it */
+    const pkgFiles = new Map();
+    for (const file of files) {
+        let content;
+        try {
+            content = await readFile(file, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const declarations = parseDeclarations(content);
+        for (const decl of declarations) {
+            // Direct mode: only explicit imports, no re-exports
+            if (decl.kind !== 'import')
+                continue;
+            const { specifier } = decl;
+            if (isRelativeSpecifier(specifier))
+                continue;
+            if (isNodeBuiltin(specifier))
+                continue;
+            const pkg = normalizePackageName(specifier);
+            if (options.ignore?.some((pattern) => matchesIgnorePattern(pkg, pattern)))
+                continue;
+            if (options.workspacePackages?.some((pattern) => matchesIgnorePattern(pkg, pattern)))
+                continue;
+            if (!pkgFiles.has(pkg))
+                pkgFiles.set(pkg, new Set());
+            pkgFiles.get(pkg).add(file);
+        }
+    }
+    // Return one PackageOccurrence per (package, file) pair so callers
+    // can aggregate importCount and files[] accurately.
+    return Array.from(pkgFiles.entries()).flatMap(([pkg, fileSet]) => [...fileSet].map((file) => ({
+        package: pkg,
+        file,
+        via: 'direct',
+    })));
+}
+// ─── Ignore pattern matching ──────────────────────────────────────────────────
+/** Supports exact match and simple glob: '@company/*' */
+function matchesIgnorePattern(pkg, pattern) {
+    if (pattern.endsWith('/*')) {
+        const scope = pattern.slice(0, -2);
+        return pkg.startsWith(scope + '/');
+    }
+    return pkg === pattern;
+}
+//# sourceMappingURL=collect-imports.js.map

package/dist/collector/collect-imports.js.map

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

package/dist/collector/parse-declarations.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared low-level parser: extracts import/export specifiers from JS/TS source.
+ * Used by both collect-imports (direct mode) and traverse-local-modules (local-graph).
+ *
+ * Adapted from packages/sprite-plugin/src/analyzer/parse-imports.ts.
+ */
+export type DeclarationKind = 'import' | 'reexport';
+export interface Declaration {
+    specifier: string;
+    kind: DeclarationKind;
+}
+export declare function isRelativeSpecifier(specifier: string): boolean;
+export declare function isNodeBuiltin(specifier: string): boolean;
+/**
+ * Normalizes a module specifier to its package name.
+ *   lodash/get        → lodash
+ *   @scope/name/deep  → @scope/name
+ *   react             → react
+ */
+export declare function normalizePackageName(specifier: string): string;
+/**
+ * Parse all import/export declarations from JS/TS source text.
+ * Returns one entry per specifier occurrence.
+ */
+export declare function parseDeclarations(fileContent: string): Declaration[];
+//# sourceMappingURL=parse-declarations.d.ts.map

package/dist/collector/parse-declarations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-declarations.d.ts","sourceRoot":"","sources":["../../src/collector/parse-declarations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;CACvB;AAgBD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAM9D;AAmFD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAoBpE"}

package/dist/collector/parse-declarations.js

@@ -0,0 +1,134 @@
+/**
+ * Shared low-level parser: extracts import/export specifiers from JS/TS source.
+ * Used by both collect-imports (direct mode) and traverse-local-modules (local-graph).
+ *
+ * Adapted from packages/sprite-plugin/src/analyzer/parse-imports.ts.
+ */
+// ─── Node.js built-ins ────────────────────────────────────────────────────────
+const NODE_BUILTINS = new Set([
+    'assert', 'async_hooks', 'buffer', 'child_process', 'cluster', 'console',
+    'constants', 'crypto', 'dgram', 'diagnostics_channel', 'dns', 'domain',
+    'events', 'fs', 'http', 'http2', 'https', 'inspector', 'module', 'net',
+    'os', 'path', 'perf_hooks', 'process', 'punycode', 'querystring',
+    'readline', 'repl', 'stream', 'string_decoder', 'sys', 'timers', 'tls',
+    'trace_events', 'tty', 'url', 'util', 'v8', 'vm', 'wasi', 'worker_threads',
+    'zlib',
+]);
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+export function isRelativeSpecifier(specifier) {
+    return specifier.startsWith('./') || specifier.startsWith('../');
+}
+export function isNodeBuiltin(specifier) {
+    if (specifier.startsWith('node:'))
+        return true;
+    return NODE_BUILTINS.has(specifier.split('/')[0]);
+}
+/**
+ * Normalizes a module specifier to its package name.
+ *   lodash/get        → lodash
+ *   @scope/name/deep  → @scope/name
+ *   react             → react
+ */
+export function normalizePackageName(specifier) {
+    if (specifier.startsWith('@')) {
+        const parts = specifier.split('/');
+        return parts.slice(0, 2).join('/');
+    }
+    return specifier.split('/')[0];
+}
+// ─── Source preprocessing ─────────────────────────────────────────────────────
+/** Strips // and block comments while preserving string literals. */
+function stripComments(source) {
+    // Use an array of chunks instead of string concatenation to avoid
+    // O(N²) string allocation behaviour in tight loops over large files.
+    const chunks = [];
+    let i = 0;
+    let segStart = i;
+    const flush = (end) => {
+        if (end > segStart)
+            chunks.push(source.slice(segStart, end));
+    };
+    while (i < source.length) {
+        if (source[i] === '"' || source[i] === "'" || source[i] === '`') {
+            const quote = source[i];
+            i++;
+            while (i < source.length && source[i] !== quote) {
+                if (source[i] === '\\')
+                    i++;
+                if (i < source.length)
+                    i++;
+            }
+            if (i < source.length)
+                i++;
+        }
+        else if (source[i] === '/' && source[i + 1] === '*') {
+            flush(i);
+            i += 2;
+            while (i < source.length && !(source[i] === '*' && source[i + 1] === '/'))
+                i++;
+            i += 2;
+            chunks.push(' ');
+            segStart = i;
+        }
+        else if (source[i] === '/' && source[i + 1] === '/') {
+            flush(i);
+            i += 2;
+            while (i < source.length && source[i] !== '\n')
+                i++;
+            segStart = i;
+        }
+        else {
+            i++;
+        }
+    }
+    flush(i);
+    return chunks.join('');
+}
+/** Collapses multiline import/export statements to single lines. */
+function normalizeMultiline(source) {
+    // [^;{}]* is bounded by statement terminators — avoids catastrophic
+    // backtracking that [\s\S]*? causes on files with many import keywords.
+    return source.replace(/(?:import|export)\s[^;{}]*?from\s+['"][^'"]+['"]/g, (match) => match.replace(/\s+/g, ' '));
+}
+// ─── Regex patterns ───────────────────────────────────────────────────────────
+/**
+ * Static imports — excludes:
+ *   - dynamic import('pkg')  via (?!\s*\()
+ *   - type-only imports      via (?!\s+type[\s{])
+ */
+const STATIC_IMPORT_RE = /\bimport(?!\s*\()(?!\s+type[\s{])\s+(?:[^'"]*?\bfrom\s+)?['"]([^'"]+)['"]/gm;
+/**
+ * Re-exports — matches:
+ *   export { X } from 'pkg'
+ *   export * from 'pkg'
+ * Excludes export type { X } from 'pkg' via (?!type[\s{])
+ */
+const REEXPORT_RE = /\bexport\s+(?!type[\s{])(?:\*|\{[^}]*\})\s+from\s+['"]([^'"]+)['"]/gm;
+/** CommonJS require — require('pkg') */
+const REQUIRE_RE = /\brequire\s*\(\s*['"]([^'"]+)['"]\s*\)/gm;
+/** Dynamic import with a literal string — import('pkg') */
+const DYNAMIC_IMPORT_RE = /\bimport\s*\(\s*['"]([^'"]+)['"]\s*\)/gm;
+// ─── Main parser ──────────────────────────────────────────────────────────────
+/**
+ * Parse all import/export declarations from JS/TS source text.
+ * Returns one entry per specifier occurrence.
+ */
+export function parseDeclarations(fileContent) {
+    const src = normalizeMultiline(stripComments(fileContent));
+    const results = [];
+    const patterns = [
+        [STATIC_IMPORT_RE, 'import'],
+        [REQUIRE_RE, 'import'],
+        [DYNAMIC_IMPORT_RE, 'import'],
+        [REEXPORT_RE, 'reexport'],
+    ];
+    for (const [pattern, kind] of patterns) {
+        pattern.lastIndex = 0;
+        let match;
+        while ((match = pattern.exec(src)) !== null) {
+            results.push({ specifier: match[1], kind });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=parse-declarations.js.map

package/dist/collector/parse-declarations.js.map

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

package/dist/collector/parse-shared-config.d.ts

@@ -0,0 +1,12 @@
+import type { SharedDepConfig } from '../types.js';
+/**
+ * Module Federation accepts shared config in multiple formats:
+ *
+ *   string[]                              → ['react', 'react-dom']
+ *   Record<string, SharedDepConfig>       → { react: { singleton: true } }
+ *   Array<string | Record<...>>           → [{ react: { singleton: true } }, 'lodash']
+ *
+ * This function normalises all formats to Record<string, SharedDepConfig>.
+ */
+export declare function parseSharedConfig(raw: unknown): Record<string, SharedDepConfig>;
+//# sourceMappingURL=parse-shared-config.d.ts.map

package/dist/collector/parse-shared-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-shared-config.d.ts","sourceRoot":"","sources":["../../src/collector/parse-shared-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,GACX,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAsBjC"}

package/dist/collector/parse-shared-config.js

@@ -0,0 +1,56 @@
+/**
+ * Module Federation accepts shared config in multiple formats:
+ *
+ *   string[]                              → ['react', 'react-dom']
+ *   Record<string, SharedDepConfig>       → { react: { singleton: true } }
+ *   Array<string | Record<...>>           → [{ react: { singleton: true } }, 'lodash']
+ *
+ * This function normalises all formats to Record<string, SharedDepConfig>.
+ */
+export function parseSharedConfig(raw) {
+    if (!raw)
+        return {};
+    // Object format: { react: { singleton: true }, lodash: {} }
+    if (isPlainObject(raw)) {
+        return normaliseObjectConfig(raw);
+    }
+    // Array format: string[] | Array<string | Record<...>>
+    if (Array.isArray(raw)) {
+        const result = {};
+        for (const item of raw) {
+            if (typeof item === 'string') {
+                result[item] = {};
+            }
+            else if (isPlainObject(item)) {
+                Object.assign(result, normaliseObjectConfig(item));
+            }
+        }
+        return result;
+    }
+    return {};
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function normaliseObjectConfig(obj) {
+    const result = {};
+    for (const [pkg, config] of Object.entries(obj)) {
+        if (!isPlainObject(config) && config !== undefined) {
+            // Unexpected value — treat package as present with empty config
+            result[pkg] = {};
+            continue;
+        }
+        const cfg = (config ?? {});
+        const normalised = {};
+        if (typeof cfg['singleton'] === 'boolean')
+            normalised.singleton = cfg['singleton'];
+        if (typeof cfg['eager'] === 'boolean')
+            normalised.eager = cfg['eager'];
+        if (typeof cfg['requiredVersion'] === 'string')
+            normalised.requiredVersion = cfg['requiredVersion'];
+        result[pkg] = normalised;
+    }
+    return result;
+}
+//# sourceMappingURL=parse-shared-config.js.map

package/dist/collector/parse-shared-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-shared-config.js","sourceRoot":"","sources":["../../src/collector/parse-shared-config.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAY;IAEZ,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,4DAA4D;IAC5D,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,qBAAqB,CAAC,GAA8B,CAAC,CAAC;IAC/D,CAAC;IAED,uDAAuD;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,MAAM,GAAoC,EAAE,CAAC;QACnD,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;YACvB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACpB,CAAC;iBAAM,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,IAA+B,CAAC,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,iFAAiF;AAEjF,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,qBAAqB,CAC5B,GAA4B;IAE5B,MAAM,MAAM,GAAoC,EAAE,CAAC;IAEnD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACnD,gEAAgE;YAChE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACjB,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAA4B,CAAC;QACtD,MAAM,UAAU,GAAoB,EAAE,CAAC;QAEvC,IAAI,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,SAAS;YAAE,UAAU,CAAC,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;QACnF,IAAI,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,SAAS;YAAE,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;QACvE,IAAI,OAAO,GAAG,CAAC,iBAAiB,CAAC,KAAK,QAAQ;YAAE,UAAU,CAAC,eAAe,GAAG,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAEpG,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/collector/resolve-tsconfig-paths.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Resolved tsconfig path aliases.
+ * Each alias pattern maps to one or more local directory roots.
+ *
+ * Example tsconfig.json:
+ *   { "compilerOptions": { "baseUrl": ".", "paths": { "@app/*": ["src/*"] } } }
+ *
+ * Produces:
+ *   { aliases: [{ pattern: '@app/', roots: ['/project/src/'] }] }
+ */
+export interface ResolvedTsConfigPaths {
+    /** Absolute base directory (compilerOptions.baseUrl resolved against tsconfig location) */
+    baseDir: string;
+    aliases: Array<{
+        /** The alias prefix without the trailing '*', e.g. '@app/' */
+        pattern: string;
+        /** Resolved absolute directory roots (trailing '*' stripped from each mapping) */
+        roots: string[];
+    }>;
+}
+/**
+ * Loads tsconfig.json and extracts path alias mappings.
+ * Returns null when tsconfig is absent, unreadable, or has no paths defined.
+ *
+ * Only handles the common `"alias/*": ["dir/*"]` wildcard pattern.
+ * Exact aliases (no wildcard) are not currently supported.
+ */
+export declare function loadTsConfigPaths(tsconfigPath: string): ResolvedTsConfigPaths | null;
+/**
+ * Resolves a TypeScript path alias specifier to an absolute file path.
+ * Returns null when the specifier does not match any alias or the file
+ * cannot be found on disk.
+ *
+ * @param specifier  - e.g. '@app/components/Button'
+ * @param paths      - result of loadTsConfigPaths
+ * @param contentMap - pre-read file map; used for O(1) existence checks
+ */
+export declare function resolveAliasedSpecifier(specifier: string, paths: ResolvedTsConfigPaths, contentMap: Map<string, string>): string | null;
+//# sourceMappingURL=resolve-tsconfig-paths.d.ts.map

package/dist/collector/resolve-tsconfig-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-tsconfig-paths.d.ts","sourceRoot":"","sources":["../../src/collector/resolve-tsconfig-paths.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QACb,8DAA8D;QAC9D,OAAO,EAAE,MAAM,CAAC;QAChB,kFAAkF;QAClF,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAkDpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,qBAAqB,EAC5B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,GAAG,IAAI,CAsBf"}

package/dist/collector/resolve-tsconfig-paths.js

@@ -0,0 +1,89 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, dirname, join } from 'node:path';
+/**
+ * Loads tsconfig.json and extracts path alias mappings.
+ * Returns null when tsconfig is absent, unreadable, or has no paths defined.
+ *
+ * Only handles the common `"alias/*": ["dir/*"]` wildcard pattern.
+ * Exact aliases (no wildcard) are not currently supported.
+ */
+export function loadTsConfigPaths(tsconfigPath) {
+    if (!existsSync(tsconfigPath))
+        return null;
+    let raw;
+    try {
+        raw = readFileSync(tsconfigPath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    // Strip single-line comments so JSON.parse can handle tsconfig files
+    const stripped = raw.replace(/\/\/[^\n]*/g, '');
+    let config;
+    try {
+        config = JSON.parse(stripped);
+    }
+    catch {
+        return null;
+    }
+    const compilerOptions = config['compilerOptions'];
+    if (!compilerOptions)
+        return null;
+    const tsconfigDir = dirname(resolve(tsconfigPath));
+    const baseUrl = typeof compilerOptions['baseUrl'] === 'string'
+        ? resolve(tsconfigDir, compilerOptions['baseUrl'])
+        : tsconfigDir;
+    const rawPaths = compilerOptions['paths'];
+    if (!rawPaths || typeof rawPaths !== 'object')
+        return null;
+    const aliases = [];
+    for (const [aliasPattern, mappings] of Object.entries(rawPaths)) {
+        // Only handle wildcard aliases: "@alias/*" → ["dir/*"]
+        if (!aliasPattern.endsWith('/*'))
+            continue;
+        if (!Array.isArray(mappings) || mappings.length === 0)
+            continue;
+        const prefix = aliasPattern.slice(0, -1); // "@alias/" (remove trailing *)
+        const roots = mappings
+            .filter((m) => typeof m === 'string' && m.endsWith('/*'))
+            .map((m) => join(baseUrl, m.slice(0, -1))); // resolve to absolute, remove trailing *
+        if (roots.length > 0) {
+            aliases.push({ pattern: prefix, roots });
+        }
+    }
+    if (aliases.length === 0)
+        return null;
+    return { baseDir: baseUrl, aliases };
+}
+/**
+ * Resolves a TypeScript path alias specifier to an absolute file path.
+ * Returns null when the specifier does not match any alias or the file
+ * cannot be found on disk.
+ *
+ * @param specifier  - e.g. '@app/components/Button'
+ * @param paths      - result of loadTsConfigPaths
+ * @param contentMap - pre-read file map; used for O(1) existence checks
+ */
+export function resolveAliasedSpecifier(specifier, paths, contentMap) {
+    for (const alias of paths.aliases) {
+        if (!specifier.startsWith(alias.pattern))
+            continue;
+        const rest = specifier.slice(alias.pattern.length); // 'components/Button'
+        for (const root of alias.roots) {
+            const base = join(root, rest); // '/project/src/components/Button'
+            // Try direct extensions, then index files
+            for (const ext of ['.ts', '.tsx', '.js', '.jsx']) {
+                const candidate = base + ext;
+                if (contentMap.has(candidate))
+                    return candidate;
+            }
+            for (const ext of ['.ts', '.tsx', '.js', '.jsx']) {
+                const candidate = join(base, 'index' + ext);
+                if (contentMap.has(candidate))
+                    return candidate;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=resolve-tsconfig-paths.js.map

package/dist/collector/resolve-tsconfig-paths.js.map

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

package/dist/collector/resolve-versions.d.ts

@@ -0,0 +1,15 @@
+export interface ResolvedVersions {
+    /** Versions from package.json dependencies + devDependencies */
+    declared: Record<string, string>;
+    /**
+     * Versions from node_modules/<pkg>/package.json.
+     * Empty object when node_modules is not accessible —
+     * mismatch checks are skipped for packages absent from this map.
+     */
+    installed: Record<string, string>;
+}
+/**
+ * Reads declared and installed versions for all packages listed in package.json.
+ */
+export declare function resolveVersions(packageJsonPath: string): Promise<ResolvedVersions>;
+//# sourceMappingURL=resolve-versions.d.ts.map

package/dist/collector/resolve-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-versions.d.ts","sourceRoot":"","sources":["../../src/collector/resolve-versions.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAIxF"}

package/dist/collector/resolve-versions.js

@@ -0,0 +1,49 @@
+import { readFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+/**
+ * Reads declared and installed versions for all packages listed in package.json.
+ */
+export async function resolveVersions(packageJsonPath) {
+    const declared = await readDeclaredVersions(packageJsonPath);
+    const installed = await readInstalledVersions(packageJsonPath, Object.keys(declared));
+    return { declared, installed };
+}
+// ─── Internals ────────────────────────────────────────────────────────────────
+async function readDeclaredVersions(packageJsonPath) {
+    let raw;
+    try {
+        raw = await readFile(packageJsonPath, 'utf-8');
+    }
+    catch {
+        return {};
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+    const deps = (pkg['dependencies'] ?? {});
+    const devDeps = (pkg['devDependencies'] ?? {});
+    return { ...deps, ...devDeps };
+}
+async function readInstalledVersions(packageJsonPath, packages) {
+    const nodeModulesDir = join(dirname(packageJsonPath), 'node_modules');
+    const installed = {};
+    await Promise.all(packages.map(async (pkg) => {
+        try {
+            const pkgJsonPath = join(nodeModulesDir, pkg, 'package.json');
+            const raw = await readFile(pkgJsonPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (typeof parsed['version'] === 'string') {
+                installed[pkg] = parsed['version'];
+            }
+        }
+        catch {
+            // Package not found in node_modules — skip silently
+        }
+    }));
+    return installed;
+}
+//# sourceMappingURL=resolve-versions.js.map

package/dist/collector/resolve-versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-versions.js","sourceRoot":"","sources":["../../src/collector/resolve-versions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAa1C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,eAAuB;IAC3D,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,eAAe,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC;AAED,iFAAiF;AAEjF,KAAK,UAAU,oBAAoB,CAAC,eAAuB;IACzD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,GAA4B,CAAC;IACjC,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAA2B,CAAC;IACnE,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAA2B,CAAC;IAEzE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;AACjC,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,eAAuB,EACvB,QAAkB;IAElB,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,cAAc,CAAC,CAAC;IACtE,MAAM,SAAS,GAA2B,EAAE,CAAC;IAE7C,MAAM,OAAO,CAAC,GAAG,CACf,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;YAC9D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;YAC1D,IAAI,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC1C,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;IACH,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/collector/traverse-local-modules.d.ts

@@ -0,0 +1,27 @@
+import type { PackageOccurrence } from '../types.js';
+export interface TraverseLocalModulesOptions {
+    sourceDirs: string[];
+    extensions?: string[];
+    ignore?: string[];
+    /** Path to tsconfig.json for resolving path aliases (e.g. '@app/*'). */
+    tsconfigPath?: string;
+    /** Workspace package names/globs to skip (e.g. '@my-org/*'). */
+    workspacePackages?: string[];
+}
+/**
+ * Local-graph mode collector.
+ *
+ * Scans all files in sourceDirs and follows relative import/export chains
+ * recursively within those directories. Finds external packages reachable
+ * through barrel re-exports and local module wrappers.
+ *
+ * When tsconfigPath is provided, TypeScript path aliases (e.g. '@app/*') are
+ * resolved to local files and followed in the same DFS — packages behind
+ * aliases become visible.
+ *
+ * Uses two-phase approach:
+ *   Phase 1 — parallel async reads of all source files into contentMap
+ *   Phase 2 — synchronous DFS over in-memory content (zero disk I/O)
+ */
+export declare function traverseLocalModules(options: TraverseLocalModulesOptions): Promise<PackageOccurrence[]>;
+//# sourceMappingURL=traverse-local-modules.d.ts.map

package/dist/collector/traverse-local-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse-local-modules.d.ts","sourceRoot":"","sources":["../../src/collector/traverse-local-modules.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAgBrD,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgF9B"}