@flaid/devmap 0.4.1 → 0.6.0

package/dist/analyzers/graph/dependencyGraph.js

@@ -1,40 +1,77 @@
-import { resolveAlias } from "./aliasResolver.js";
-const IMPORT_RE = /(?:import\s+(?:[^'"]+\s+from\s+)?|export\s+[^'"]+\s+from\s+|require\()\s*['"]([^'"]+)['"]/g;
+import { isDeclaredAlias, resolveAliasCandidates } from "./aliasResolver.js";
+import { matchLocalPath, normalizePath } from "./localPaths.js";
+import { addNuxtAutoImportEdges } from "./nuxtAutoImports.js";
+import { indexPackages, readPackageManifests, resolveSubpathImport, resolveWorkspaceSpecifier } from "./packageManifests.js";
+// Static imports, re-exports, require() and dynamic import() with a literal.
+const IMPORT_RE = /(?:\bimport\s+(?:[^'"]+\s+from\s+)?|\bexport\s+[^'"]+\s+from\s+|\b(?:require|import)\s*\(\s*)['"]([^'"]+)['"]/g;
 export function buildDependencyGraph(files, analyses = {}, aliasMappings = []) {
     const graph = {};
     const localPaths = new Set(files.map((file) => file.path));
+    const packages = indexPackages(readPackageManifests(files));
     const diagnostics = {
         unresolvedAliases: [],
         parserFallbacks: [],
     };
     for (const file of files) {
-        graph[file.path] = [];
+        // A file importing the same module twice (`import type` + value import,
+        // or a static and a dynamic import) is still one dependency edge.
+        const edges = new Set();
         const importSpecifiers = analyses[file.path]?.imports ?? findImportSpecifiers(file.content);
-        for (const specifier of importSpecifiers) {
+        for (const rawSpecifier of importSpecifiers) {
+            // Bundler suffixes (`./icon.svg?react`, `./worker.ts?worker`) are not
+            // part of the file name.
+            const specifier = stripQuery(rawSpecifier);
             if (specifier.startsWith(".")) {
                 const resolved = resolveImport(file.path, specifier, localPaths);
-                if (resolved) {
-                    graph[file.path].push(resolved);
+                if (resolved && resolved !== file.path) {
+                    edges.add(resolved);
                 }
                 continue;
             }
-            // Try alias resolution for non-relative imports
-            const aliasResolved = resolveAlias(specifier, aliasMappings);
-            if (aliasResolved) {
-                const resolved = resolveAliasPath(aliasResolved, localPaths);
+            // package.json "imports": `#internal/db` is local by definition. Other
+            // `#` specifiers (Nuxt's `#shared/...`) are aliases and fall through.
+            if (specifier.startsWith("#")) {
+                const resolved = resolveSubpathImport(specifier, file.path, packages, localPaths);
                 if (resolved) {
-                    graph[file.path].push(resolved);
+                    if (resolved !== file.path)
+                        edges.add(resolved);
+                    continue;
                 }
-                else {
+            }
+            // Try alias resolution for non-relative imports
+            const candidates = resolveAliasCandidates(specifier, aliasMappings, file.path);
+            const aliasResolved = candidates.length > 0 ? firstResolved(candidates, localPaths) : null;
+            if (aliasResolved) {
+                if (aliasResolved !== file.path)
+                    edges.add(aliasResolved);
+                continue;
+            }
+            // A package that lives in this repo (workspace member): import by name.
+            const workspaceResolved = resolveWorkspaceSpecifier(specifier, packages, localPaths);
+            if (workspaceResolved) {
+                if (workspaceResolved !== file.path)
+                    edges.add(workspaceResolved);
+                continue;
+            }
+            if (candidates.length > 0) {
+                if (isDeclaredAlias(specifier, aliasMappings, file.path)) {
                     diagnostics.unresolvedAliases.push({ file: file.path, specifier });
                 }
             }
+            else if (file.path.endsWith(".py")) {
+                const resolved = resolvePythonModule(specifier, localPaths);
+                if (resolved && resolved !== file.path)
+                    edges.add(resolved);
+            }
             // Non-relative, non-alias imports are silently skipped (npm packages etc.)
         }
+        graph[file.path] = [...edges];
         if (!analyses[file.path]) {
             diagnostics.parserFallbacks.push(file.path);
         }
     }
+    // Frameworks that connect files without import statements.
+    addNuxtAutoImportEdges(graph, files, analyses);
     return { graph, diagnostics };
 }
 export function countReferences(graph) {
@@ -46,6 +83,10 @@ export function countReferences(graph) {
     }
     return counts;
 }
+function stripQuery(specifier) {
+    const query = specifier.indexOf("?");
+    return query === -1 ? specifier : specifier.slice(0, query);
+}
 function findImportSpecifiers(content) {
     const matches = [];
     IMPORT_RE.lastIndex = 0;
@@ -60,76 +101,31 @@ function resolveImport(fromPath, specifier, localPaths) {
     const baseParts = fromPath.split("/");
     baseParts.pop();
     const normalized = normalizePath([...baseParts, specifier].join("/"));
-    const candidates = [
-        normalized,
-        `${normalized}.ts`,
-        `${normalized}.tsx`,
-        `${normalized}.js`,
-        `${normalized}.jsx`,
-        `${normalized}.mjs`,
-        `${normalized}.cjs`,
-        `${normalized}.vue`,
-        `${normalized}.svelte`,
-        `${normalized}.astro`,
-        `${normalized}/index.ts`,
-        `${normalized}/index.tsx`,
-        `${normalized}/index.js`,
-        `${normalized}/index.jsx`,
-        `${normalized}/index.vue`,
-        `${normalized}/index.svelte`,
-        `${normalized}/index.astro`
-    ];
-    if (normalized.endsWith(".js")) {
-        const withoutExtension = normalized.slice(0, -3);
-        candidates.push(`${withoutExtension}.ts`, `${withoutExtension}.tsx`);
-    }
-    if (normalized.endsWith(".mjs")) {
-        candidates.push(`${normalized.slice(0, -4)}.mts`);
-    }
-    if (normalized.endsWith(".cjs")) {
-        candidates.push(`${normalized.slice(0, -4)}.cts`);
-    }
-    return candidates.find((candidate) => localPaths.has(candidate)) ?? null;
+    return normalized === null ? null : matchLocalPath(normalized, localPaths);
 }
-function resolveAliasPath(rootRelativePath, localPaths) {
-    const normalized = normalizePath(rootRelativePath);
-    const candidates = [
-        normalized,
-        `${normalized}.ts`,
-        `${normalized}.tsx`,
-        `${normalized}.js`,
-        `${normalized}.jsx`,
-        `${normalized}.mjs`,
-        `${normalized}.cjs`,
-        `${normalized}.vue`,
-        `${normalized}.svelte`,
-        `${normalized}.astro`,
-        `${normalized}/index.ts`,
-        `${normalized}/index.tsx`,
-        `${normalized}/index.js`,
-        `${normalized}/index.jsx`,
-        `${normalized}/index.vue`,
-        `${normalized}/index.svelte`,
-        `${normalized}/index.astro`
-    ];
-    if (normalized.endsWith(".js")) {
-        const withoutExtension = normalized.slice(0, -3);
-        candidates.push(`${withoutExtension}.ts`, `${withoutExtension}.tsx`);
+// `from app.models import User` -> app/models.py or app/models/__init__.py,
+// looked up from the project root and from a conventional src/ layout.
+function resolvePythonModule(specifier, localPaths) {
+    if (!/^[A-Za-z_][\w.]*$/.test(specifier))
+        return null;
+    const modulePath = specifier.replace(/\./g, "/");
+    for (const base of ["", "src/"]) {
+        for (const candidate of [`${base}${modulePath}.py`, `${base}${modulePath}/__init__.py`]) {
+            if (localPaths.has(candidate))
+                return candidate;
+        }
     }
-    return candidates.find((candidate) => localPaths.has(candidate)) ?? null;
+    return null;
 }
-function normalizePath(path) {
-    const parts = [];
-    for (const part of path.split("/")) {
-        if (part === "." || part === "") {
-            continue;
-        }
-        if (part === "..") {
-            parts.pop();
+function firstResolved(rootRelativePaths, localPaths) {
+    for (const rootRelativePath of rootRelativePaths) {
+        const normalized = normalizePath(rootRelativePath);
+        if (normalized === null)
             continue;
-        }
-        parts.push(part);
+        const resolved = matchLocalPath(normalized, localPaths);
+        if (resolved)
+            return resolved;
     }
-    return parts.join("/");
+    return null;
 }
 //# sourceMappingURL=dependencyGraph.js.map

package/dist/analyzers/graph/dependencyGraph.js.map

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

package/dist/analyzers/graph/entryPoints.d.ts

@@ -1,3 +1,10 @@
 import type { FileGraph } from "./dependencyGraph.js";
-export declare function detectEntryPoints(graph: FileGraph): string[];
+import type { ManifestEntry } from "./packageManifests.js";
+/**
+ * `manifestEntries` come from package.json (`bin`, `main`/`exports`, scripts).
+ * A `main` file that another source file imports is just shared plumbing, so
+ * it only counts while nothing imports it; `bin` and script entries are
+ * started from outside and always count.
+ */
+export declare function detectEntryPoints(graph: FileGraph, manifestEntries?: ManifestEntry[]): string[];
 //# sourceMappingURL=entryPoints.d.ts.map

package/dist/analyzers/graph/entryPoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entryPoints.d.ts","sourceRoot":"","sources":["../../../src/analyzers/graph/entryPoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AA2BtD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE,CAS5D"}
+{"version":3,"file":"entryPoints.d.ts","sourceRoot":"","sources":["../../../src/analyzers/graph/entryPoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AA4D3D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,eAAe,GAAE,aAAa,EAAO,GAAG,MAAM,EAAE,CAsCnG"}

package/dist/analyzers/graph/entryPoints.js

@@ -6,11 +6,35 @@ const ENTRY_PATTERNS = [
     /(^|\/)(server|app|index|main)\.[cm]?[jt]sx?$/,
     /(^|\/)route\.[jt]s$/
 ];
+// Files a framework loads by convention. They only count while no source file
+// imports them: a Vue SPA's `pages/Home.vue` pulled in by its router is a
+// component, while a Nuxt page that nothing references is where a route starts.
+const FRAMEWORK_LOADED_PATTERNS = [
+    /(^|\/)app\.vue$/,
+    /(^|\/)\+(?:page|layout)\.svelte$/,
+    /(^|\/)\+server\.[jt]s$/,
+    /(^|\/)hooks\.(?:server|client)\.[jt]s$/,
+    /(^|\/)app\/root\.[jt]sx?$/,
+    /(^|\/)entry\.(?:client|server)\.[jt]sx?$/,
+    /(^|\/)pages\/.+\.(?:vue|astro)$/,
+    /(^|\/)pages\/(?:_app|_document)\.[jt]sx?$/,
+    /(^|\/)server\/(?:api|routes|middleware)\/.+\.[cm]?[jt]s$/
+];
 const ENTRY_PATTERN_SCORES = [
     { pattern: /(^|\/)layout\.[jt]sx?$/, score: 0 },
+    { pattern: /(^|\/)app\/root\.[jt]sx?$/, score: 0 },
+    { pattern: /(^|\/)\+layout\.svelte$/, score: 0 },
+    { pattern: /(^|\/)app\.vue$/, score: 0 },
+    { pattern: /(^|\/)pages\/(?:_app|_document)\.[jt]sx?$/, score: 0 },
+    { pattern: /(^|\/)pages\/.+\.(?:vue|astro)$/, score: 1 },
     { pattern: /(^|\/)page\.[jt]sx?$/, score: 1 },
+    { pattern: /(^|\/)\+page\.svelte$/, score: 1 },
     { pattern: /(^|\/)route\.[jt]s$/, score: 2 },
+    { pattern: /(^|\/)\+server\.[jt]s$/, score: 2 },
+    { pattern: /(^|\/)server\/(?:api|routes|middleware)\/.+\.[cm]?[jt]s$/, score: 2 },
     { pattern: /(^|\/)middleware\.[jt]s$/, score: 3 },
+    { pattern: /(^|\/)hooks\.(?:server|client)\.[jt]s$/, score: 3 },
+    { pattern: /(^|\/)entry\.(?:client|server)\.[jt]sx?$/, score: 3 },
     { pattern: /(^|\/)(app|server)\.[cm]?[jt]sx?$/, score: 4 },
     { pattern: /(^|\/)(index|main)\.[cm]?[jt]sx?$/, score: 5 },
 ];
@@ -21,13 +45,54 @@ function entryPointScore(path) {
     }
     return 10;
 }
-export function detectEntryPoints(graph) {
-    const imported = new Set(Object.values(graph).flat());
+// Declared entries rank above guesses: a CLI's `bin` is the way in, a package's
+// `main` is its public face, and a script runs the file on purpose.
+const MANIFEST_SCORES = {
+    bin: -2,
+    main: -1,
+    script: 6.5
+};
+/**
+ * `manifestEntries` come from package.json (`bin`, `main`/`exports`, scripts).
+ * A `main` file that another source file imports is just shared plumbing, so
+ * it only counts while nothing imports it; `bin` and script entries are
+ * started from outside and always count.
+ */
+export function detectEntryPoints(graph, manifestEntries = []) {
+    // Only production code counts as a consumer: a barrel that nothing but its
+    // own tests imports (or a root index.ts that tests import) is still an
+    // entry, while a barrel re-exported through the app is just plumbing.
+    const imported = new Set(Object.entries(graph)
+        .filter(([path]) => isArchitectureSource(path))
+        .flatMap(([, imports]) => imports));
+    const declared = new Map();
+    for (const entry of manifestEntries) {
+        if (!(entry.path in graph) || !isSourceFile(entry.path) || !isArchitectureSource(entry.path))
+            continue;
+        if (entry.kind === "main" && imported.has(entry.path))
+            continue;
+        const score = MANIFEST_SCORES[entry.kind];
+        declared.set(entry.path, Math.min(score, declared.get(entry.path) ?? score));
+    }
+    const scoreOf = (path) => declared.get(path) ?? entryPointScore(path);
     return Object.keys(graph)
         .filter((path) => isSourceFile(path))
         .filter((path) => isArchitectureSource(path))
-        .filter((path) => ENTRY_PATTERNS.some((pattern) => pattern.test(path)) || (!imported.has(path) && (graph[path]?.length ?? 0) > 0))
-        .sort((a, b) => entryPointScore(a) - entryPointScore(b) || a.localeCompare(b))
+        .filter((path) => {
+        if (declared.has(path))
+            return true;
+        const unimportedWithImports = !imported.has(path) && (graph[path]?.length ?? 0) > 0;
+        // index.* is also the conventional barrel file; it is an entry only when
+        // nothing else imports it. A top-level index (index.ts, src/index.ts) is
+        // the package entry even when it has no imports of its own.
+        if (/(^|\/)index\.[cm]?[jt]sx?$/.test(path)) {
+            return !imported.has(path) && ((graph[path]?.length ?? 0) > 0 || path.split("/").length <= 2);
+        }
+        return ENTRY_PATTERNS.some((pattern) => pattern.test(path))
+            || (!imported.has(path) && FRAMEWORK_LOADED_PATTERNS.some((pattern) => pattern.test(path)))
+            || unimportedWithImports;
+    })
+        .sort((a, b) => scoreOf(a) - scoreOf(b) || a.localeCompare(b))
         .slice(0, 20);
 }
 function isSourceFile(path) {

package/dist/analyzers/graph/entryPoints.js.map

@@ -1 +1 @@
-{"version":3,"file":"entryPoints.js","sourceRoot":"","sources":["../../../src/analyzers/graph/entryPoints.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,cAAc,GAAG;IACrB,sBAAsB;IACtB,wBAAwB;IACxB,0BAA0B;IAC1B,8CAA8C;IAC9C,qBAAqB;CACtB,CAAC;AAEF,MAAM,oBAAoB,GAA8C;IACtE,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE;IAC/C,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,CAAC,EAAE;IAC7C,EAAE,OAAO,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAC,EAAE;IAC5C,EAAE,OAAO,EAAE,0BAA0B,EAAE,KAAK,EAAE,CAAC,EAAE;IACjD,EAAE,OAAO,EAAE,mCAAmC,EAAE,KAAK,EAAE,CAAC,EAAE;IAC1D,EAAE,OAAO,EAAE,mCAAmC,EAAE,KAAK,EAAE,CAAC,EAAE;CAC3D,CAAC;AAEF,SAAS,eAAe,CAAC,IAAY;IACnC,KAAK,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,oBAAoB,EAAE,CAAC;QACtD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAgB;IAChD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAEtD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;SACtB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;SACpC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;SAC5C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;SACjI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SAC7E,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"entryPoints.js","sourceRoot":"","sources":["../../../src/analyzers/graph/entryPoints.ts"],"names":[],"mappings":"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"}

package/dist/analyzers/graph/index.d.ts

@@ -1,9 +1,11 @@
 export { buildDependencyGraph, countReferences, } from "./dependencyGraph.js";
 export type { FileGraph, DependencyGraphDiagnostics, } from "./dependencyGraph.js";
-export { loadAliasMappings, resolveAlias, } from "./aliasResolver.js";
+export { loadAliasMappings, resolveAlias, resolveAliasCandidates, isDeclaredAlias, } from "./aliasResolver.js";
 export type { AliasMapping, } from "./aliasResolver.js";
 export { detectEntryPoints, } from "./entryPoints.js";
-export { isArchitectureSource, } from "./sourceScope.js";
+export { indexPackages, manifestEntryPoints, readPackageManifests, resolveSubpathImport, resolveWorkspaceSpecifier, } from "./packageManifests.js";
+export type { ManifestEntry, PackageIndex, PackageManifest, } from "./packageManifests.js";
+export { isArchitectureSource, isTestPath, } from "./sourceScope.js";
 export { buildReverseGraph, buildBoundedTree, collectNodesWithinDepth, DEFAULT_MAX_CHILDREN, } from "./dependencyMap.js";
 export type { MapTreeNode, } from "./dependencyMap.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/analyzers/graph/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyzers/graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,SAAS,EACT,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,WAAW,GACZ,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyzers/graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,SAAS,EACT,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,oBAAoB,EACpB,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,WAAW,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/analyzers/graph/index.js

@@ -1,6 +1,7 @@
 export { buildDependencyGraph, countReferences, } from "./dependencyGraph.js";
-export { loadAliasMappings, resolveAlias, } from "./aliasResolver.js";
+export { loadAliasMappings, resolveAlias, resolveAliasCandidates, isDeclaredAlias, } from "./aliasResolver.js";
 export { detectEntryPoints, } from "./entryPoints.js";
-export { isArchitectureSource, } from "./sourceScope.js";
+export { indexPackages, manifestEntryPoints, readPackageManifests, resolveSubpathImport, resolveWorkspaceSpecifier, } from "./packageManifests.js";
+export { isArchitectureSource, isTestPath, } from "./sourceScope.js";
 export { buildReverseGraph, buildBoundedTree, collectNodesWithinDepth, DEFAULT_MAX_CHILDREN, } from "./dependencyMap.js";
 //# sourceMappingURL=index.js.map

package/dist/analyzers/graph/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyzers/graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EACL,iBAAiB,EACjB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACL,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyzers/graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACL,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACL,oBAAoB,EACpB,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}

package/dist/analyzers/graph/localPaths.d.ts

@@ -0,0 +1,4 @@
+export declare function matchLocalPath(normalized: string, localPaths: Set<string>): string | null;
+/** Collapse `.` and `..`; null when the path climbs above the project root. */
+export declare function normalizePath(path: string): string | null;
+//# sourceMappingURL=localPaths.d.ts.map

package/dist/analyzers/graph/localPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localPaths.d.ts","sourceRoot":"","sources":["../../../src/analyzers/graph/localPaths.ts"],"names":[],"mappings":"AAoBA,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAgBzF;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBzD"}

package/dist/analyzers/graph/localPaths.js

@@ -0,0 +1,50 @@
+// Shared path matching for graph resolution: turn an import target (no
+// extension, directory, or emitted `.js`) into a scanned source file.
+const SOURCE_EXTENSIONS = [
+    ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".mts", ".cts", ".vue", ".svelte", ".astro",
+    ".py", ".rb", ".php"
+];
+const INDEX_EXTENSIONS = [
+    ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".mts", ".cts", ".vue", ".svelte", ".astro",
+    ".py", ".rb", ".php"
+];
+// TypeScript ESM writes the emitted extension in the specifier.
+const EMITTED_EXTENSION_SOURCES = [
+    [".js", [".ts", ".tsx"]],
+    [".jsx", [".tsx"]],
+    [".mjs", [".mts"]],
+    [".cjs", [".cts"]]
+];
+export function matchLocalPath(normalized, localPaths) {
+    const candidates = [
+        normalized,
+        ...SOURCE_EXTENSIONS.map((extension) => `${normalized}${extension}`),
+        ...INDEX_EXTENSIONS.map((extension) => `${normalized}/index${extension}`),
+        `${normalized}/__init__.py`
+    ];
+    for (const [emitted, sources] of EMITTED_EXTENSION_SOURCES) {
+        if (normalized.endsWith(emitted)) {
+            const withoutExtension = normalized.slice(0, -emitted.length);
+            candidates.push(...sources.map((source) => `${withoutExtension}${source}`));
+        }
+    }
+    return candidates.find((candidate) => localPaths.has(candidate)) ?? null;
+}
+/** Collapse `.` and `..`; null when the path climbs above the project root. */
+export function normalizePath(path) {
+    const parts = [];
+    for (const part of path.split("/")) {
+        if (part === "." || part === "") {
+            continue;
+        }
+        if (part === "..") {
+            if (parts.length === 0)
+                return null;
+            parts.pop();
+            continue;
+        }
+        parts.push(part);
+    }
+    return parts.join("/");
+}
+//# sourceMappingURL=localPaths.js.map

package/dist/analyzers/graph/localPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localPaths.js","sourceRoot":"","sources":["../../../src/analyzers/graph/localPaths.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,sEAAsE;AAEtE,MAAM,iBAAiB,GAAG;IACxB,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ;IACzF,KAAK,EAAE,KAAK,EAAE,MAAM;CACrB,CAAC;AACF,MAAM,gBAAgB,GAAG;IACvB,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ;IACzF,KAAK,EAAE,KAAK,EAAE,MAAM;CACrB,CAAC;AAEF,gEAAgE;AAChE,MAAM,yBAAyB,GAA8B;IAC3D,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACxB,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;CACnB,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,UAAuB;IACxE,MAAM,UAAU,GAAG;QACjB,UAAU;QACV,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,UAAU,GAAG,SAAS,EAAE,CAAC;QACpE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,UAAU,SAAS,SAAS,EAAE,CAAC;QACzE,GAAG,UAAU,cAAc;KAC5B,CAAC;IAEF,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,yBAAyB,EAAE,CAAC;QAC3D,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACjC,MAAM,gBAAgB,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9D,UAAU,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,gBAAgB,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC;AAC3E,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YAChC,SAAS;QACX,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACpC,KAAK,CAAC,GAAG,EAAE,CAAC;YACZ,SAAS;QACX,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/analyzers/graph/nuxtAutoImports.d.ts

@@ -0,0 +1,33 @@
+import type { FileAnalysis, ScannedFile } from "../analysis/index.js";
+import type { FileGraph } from "./dependencyGraph.js";
+/**
+ * Nuxt wires files together without import statements: components, composables
+ * and utils are picked up from their folders, and `~/` points at `app/` (Nuxt
+ * 4) or the project root (Nuxt 3), not at `src/`. Without modelling that, a
+ * Nuxt project looks like a pile of files that never reference each other.
+ */
+export interface NuxtApp {
+    /** Project-root-relative directory holding nuxt.config (`""` for the root). */
+    dir: string;
+    /** Source directory, relative to `dir` (`""` or `"app"`, or a custom srcDir). */
+    srcDir: string;
+    /** `@pinia/nuxt` is installed: `stores/` is auto-imported too. */
+    pinia: boolean;
+}
+/**
+ * The source directory a Nuxt project uses. An explicit `srcDir` in the config
+ * wins; otherwise `app/` when the Nuxt 4 layout is present, else the root.
+ * `hasPath` answers whether a path (or, with a trailing slash, a folder)
+ * exists under the config's directory.
+ */
+export declare function pickNuxtSrcDir(configText: string, hasPath: (relative: string) => boolean): string;
+export declare function detectNuxtApps(files: ScannedFile[]): NuxtApp[];
+/**
+ * Add the edges Nuxt creates implicitly: a file that renders `<AccountAvatar>`
+ * or calls `useUser()` depends on the component / composable file that
+ * provides it. Mutates `graph`; existing explicit imports are untouched.
+ */
+export declare function addNuxtAutoImportEdges(graph: FileGraph, files: ScannedFile[], analyses: Record<string, FileAnalysis>): void;
+/** Nuxt's component name: folder path + file name, overlap dropped. */
+export declare function componentName(relativeToComponents: string): string | null;
+//# sourceMappingURL=nuxtAutoImports.d.ts.map

package/dist/analyzers/graph/nuxtAutoImports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nuxtAutoImports.d.ts","sourceRoot":"","sources":["../../../src/analyzers/graph/nuxtAutoImports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;;;;GAKG;AAEH,MAAM,WAAW,OAAO;IACtB,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,KAAK,EAAE,OAAO,CAAC;CAChB;AAaD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAOjG;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,CAoB9D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,WAAW,EAAE,EACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC,IAAI,CAoGN;AAID,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,oBAAoB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBzE"}