archprint 0.1.0

package/dist/scanner/file-walker.js

@@ -0,0 +1,279 @@
+import { closeSync, openSync, readFileSync, readSync, readdirSync, statSync } from 'node:fs';
+import * as path from 'node:path';
+import { Project, SyntaxKind } from 'ts-morph';
+import * as ts from 'typescript';
+import { isBarrelFile, resolveToLeafFiles } from './barrel-resolver.js';
+import { classifyFile, classifyFileWithDirective, hasUseServerDirective, } from './role-classifier.js';
+import { buildWorkspaceMap } from './workspace-resolver.js';
+import { buildWorkspacePackageMap, findWorkspaceRoot } from './workspace-packages.js';
+import { createIgnoreFilter } from './ignore-filter.js';
+import { resolveFirstPartyImport } from './resolve-import.js';
+const SKIP_DIRS = new Set(['node_modules', 'dist', 'build', 'coverage']);
+const SOURCE_FILE = /\.(ts|tsx)$/;
+function importHasValueBinding(importDeclaration) {
+    if (importDeclaration.isTypeOnly())
+        return false;
+    const named = importDeclaration.getNamedImports();
+    const hasValueNamed = named.some((namedImport) => !namedImport.isTypeOnly());
+    const hasDefault = importDeclaration.getDefaultImport() !== undefined;
+    const hasNamespace = importDeclaration.getNamespaceImport() !== undefined;
+    const sideEffectOnly = named.length === 0 && !hasDefault && !hasNamespace;
+    return hasValueNamed || hasDefault || hasNamespace || sideEffectOnly;
+}
+function dynamicImportSpecifiers(sourceFile) {
+    const specifiers = [];
+    for (const call of sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+        if (call.getExpression().getKind() !== SyntaxKind.ImportKeyword)
+            continue;
+        const argument = call.getArguments()[0]?.asKind(SyntaxKind.StringLiteral);
+        if (argument !== undefined)
+            specifiers.push(argument.getLiteralValue());
+    }
+    return specifiers;
+}
+export function listSourceFiles(rootDir) {
+    const files = [];
+    const isIgnored = createIgnoreFilter(rootDir);
+    const walk = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!SKIP_DIRS.has(entry.name) &&
+                    !entry.name.startsWith('.') &&
+                    !isIgnored(path.relative(rootDir, full), true)) {
+                    walk(full);
+                }
+            }
+            else if (entry.isFile() && SOURCE_FILE.test(entry.name) && !entry.name.endsWith('.d.ts')) {
+                if (!isIgnored(path.relative(rootDir, full), false))
+                    files.push(full);
+            }
+        }
+    };
+    walk(rootDir);
+    return files;
+}
+function readHead(file, bytes = 512) {
+    const fd = openSync(file, 'r');
+    try {
+        const buf = Buffer.alloc(bytes);
+        const read = readSync(fd, buf, 0, bytes, 0);
+        return buf.toString('utf8', 0, read);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+export function walkRepo(rootDir) {
+    return listSourceFiles(rootDir).map((absolutePath) => {
+        const relativePath = path.relative(rootDir, absolutePath).split(path.sep).join('/');
+        const base = classifyFile(relativePath);
+        if (base.role === 'UNKNOWN' && !relativePath.endsWith('.tsx')) {
+            let head;
+            try {
+                head = readHead(absolutePath);
+            }
+            catch {
+                /* v8 ignore next -- defensive: unreadable file head */
+                head = '';
+            }
+            if (hasUseServerDirective(head)) {
+                return { absolutePath, relativePath, ...classifyFileWithDirective(relativePath, true) };
+            }
+        }
+        return { absolutePath, relativePath, ...base };
+    });
+}
+function nodeHasValueBinding(clause) {
+    if (clause === undefined)
+        return true;
+    if (clause.isTypeOnly)
+        return false;
+    const hasDefault = clause.name !== undefined;
+    const bindings = clause.namedBindings;
+    const hasNamespace = bindings !== undefined && ts.isNamespaceImport(bindings);
+    const named = bindings !== undefined && ts.isNamedImports(bindings) ? bindings.elements : [];
+    const hasValueNamed = named.some((element) => !element.isTypeOnly);
+    const sideEffectOnly = named.length === 0 && !hasDefault && !hasNamespace;
+    return hasValueNamed || hasDefault || hasNamespace || sideEffectOnly;
+}
+// Content-keyed parse cache: the raw import extraction (specifier + value-binding) depends only on the file
+// content, not on the analyzer's alias set, so it is safe to share across every detector that scans the same
+// file within a run. Edge classification stays per-analyzer and is applied on top. Keyed by path + mtime + size
+// so an edit is picked up; capped as a backstop against unbounded growth in long-lived processes.
+const fastParseCache = new Map();
+const FAST_PARSE_CACHE_CAP = 50000;
+function parseFastImports(absoluteFilePath) {
+    const stat = statSync(absoluteFilePath);
+    const cached = fastParseCache.get(absoluteFilePath);
+    if (cached !== undefined && cached.mtimeMs === stat.mtimeMs && cached.size === stat.size) {
+        return cached.raw;
+    }
+    const text = readFileSync(absoluteFilePath, 'utf8');
+    const scriptKind = absoluteFilePath.endsWith('.tsx') ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
+    const sourceFile = ts.createSourceFile(absoluteFilePath, text, ts.ScriptTarget.Latest, false, scriptKind);
+    const raw = [];
+    for (const statement of sourceFile.statements) {
+        if (ts.isImportDeclaration(statement) && ts.isStringLiteral(statement.moduleSpecifier)) {
+            raw.push({
+                specifier: statement.moduleSpecifier.text,
+                hasValueBinding: nodeHasValueBinding(statement.importClause),
+            });
+        }
+    }
+    const visit = (node) => {
+        if (ts.isCallExpression(node) &&
+            node.expression.kind === ts.SyntaxKind.ImportKeyword &&
+            node.arguments.length > 0 &&
+            ts.isStringLiteral(node.arguments[0])) {
+            raw.push({ specifier: node.arguments[0].text, hasValueBinding: true });
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    if (fastParseCache.size >= FAST_PARSE_CACHE_CAP)
+        fastParseCache.clear();
+    fastParseCache.set(absoluteFilePath, { mtimeMs: stat.mtimeMs, size: stat.size, raw });
+    return raw;
+}
+// Fast import extraction with the raw TypeScript parser: same AST fidelity as ts-morph but without its
+// wrapper layer, which dominates fast-mode time. Used when we only need specifiers + value-binding, not
+// cross-file resolution.
+function createFastImportAnalyzer(classifyEdge) {
+    return (absoluteFilePath) => parseFastImports(absoluteFilePath).map((imp) => ({
+        specifier: imp.specifier,
+        edgeKind: classifyEdge(imp.specifier),
+        throughBarrel: false,
+        valueLeafPaths: [],
+        typeLeafPaths: [],
+        hasValueBinding: imp.hasValueBinding,
+    }));
+}
+export function createImportAnalyzer(appDir, options = {}) {
+    const resolve = options.resolve ?? true;
+    const aliases = Object.keys(buildWorkspaceMap(appDir));
+    const workspacePackages = Object.keys(buildWorkspacePackageMap(findWorkspaceRoot(appDir)));
+    const matchesPrefix = (specifier, names) => names.some((name) => specifier === name || specifier.startsWith(name + '/'));
+    const classifyEdge = (specifier, target) => {
+        if (specifier.startsWith('.'))
+            return 'relative';
+        if (matchesPrefix(specifier, aliases))
+            return 'alias';
+        if (matchesPrefix(specifier, workspacePackages))
+            return 'workspace';
+        if (target === undefined)
+            return 'unresolved';
+        return target.getFilePath().includes('/node_modules/') ? 'external' : 'workspace';
+    };
+    if (!resolve) {
+        return createFastImportAnalyzer((specifier) => classifyEdge(specifier, undefined));
+    }
+    const project = new Project({
+        tsConfigFilePath: path.join(appDir, 'tsconfig.json'),
+        skipAddingFilesFromTsConfig: true,
+    });
+    const aliasDirs = Object.entries(buildWorkspaceMap(appDir)).map(([key, value]) => ({
+        prefix: key.replace(/\/?\*$/, ''),
+        dir: path.resolve(appDir, String(value).replace(/\/?\*$/, '')),
+    }));
+    const resolveDynamicFile = (specifier, containingFile) => resolveFirstPartyImport(specifier, containingFile, aliasDirs) ?? undefined;
+    const exportedLeafCache = new Map();
+    const exportedLeaves = (target) => {
+        const key = target.getFilePath();
+        let map = exportedLeafCache.get(key);
+        if (map === undefined) {
+            map = new Map();
+            try {
+                for (const [name, declarations] of target.getExportedDeclarations()) {
+                    map.set(name, new Set(declarations.map((d) => d.getSourceFile().getFilePath())));
+                }
+            }
+            catch { }
+            exportedLeafCache.set(key, map);
+        }
+        return map;
+    };
+    return (absoluteFilePath) => {
+        const sourceFile = project.addSourceFileAtPath(absoluteFilePath);
+        const results = sourceFile
+            .getImportDeclarations()
+            .map((importDeclaration) => {
+            const specifier = importDeclaration.getModuleSpecifierValue();
+            const hasValueBinding = importHasValueBinding(importDeclaration);
+            const target = importDeclaration.getModuleSpecifierSourceFile();
+            const edgeKind = classifyEdge(specifier, target);
+            const throughBarrel = target !== undefined && isBarrelFile(target);
+            const valueLeaves = new Set();
+            const typeLeaves = new Set();
+            if (target !== undefined) {
+                const declarationIsTypeOnly = importDeclaration.isTypeOnly();
+                const named = importDeclaration.getNamedImports();
+                const namespaceImport = importDeclaration.getNamespaceImport();
+                const defaultImport = importDeclaration.getDefaultImport();
+                const exported = throughBarrel ? exportedLeaves(target) : null;
+                const attribute = (name, isTypeOnly) => {
+                    const leaves = exported?.get(name) ?? new Set([target.getFilePath()]);
+                    for (const leaf of leaves)
+                        (isTypeOnly ? typeLeaves : valueLeaves).add(leaf);
+                };
+                for (const namedImport of named) {
+                    attribute(namedImport.getName(), declarationIsTypeOnly || namedImport.isTypeOnly());
+                }
+                if (defaultImport !== undefined) {
+                    attribute('default', declarationIsTypeOnly);
+                }
+                if (namespaceImport !== undefined ||
+                    (named.length === 0 && defaultImport === undefined)) {
+                    const bucket = declarationIsTypeOnly ? typeLeaves : valueLeaves;
+                    if (throughBarrel) {
+                        for (const leaf of resolveToLeafFiles(target))
+                            bucket.add(leaf.getFilePath());
+                    }
+                    else {
+                        bucket.add(target.getFilePath());
+                    }
+                }
+            }
+            return {
+                specifier,
+                edgeKind,
+                throughBarrel,
+                valueLeafPaths: [...valueLeaves],
+                typeLeafPaths: [...typeLeaves],
+                hasValueBinding,
+            };
+        });
+        for (const specifier of dynamicImportSpecifiers(sourceFile)) {
+            let target;
+            if (resolve) {
+                const file = resolveDynamicFile(specifier, absoluteFilePath);
+                target =
+                    file === undefined ? undefined : (project.addSourceFileAtPathIfExists(file) ?? undefined);
+            }
+            const throughBarrel = target !== undefined && isBarrelFile(target);
+            const valueLeaves = new Set();
+            if (target !== undefined) {
+                if (throughBarrel) {
+                    for (const leaf of resolveToLeafFiles(target))
+                        valueLeaves.add(leaf.getFilePath());
+                }
+                else {
+                    valueLeaves.add(target.getFilePath());
+                }
+            }
+            results.push({
+                specifier,
+                edgeKind: classifyEdge(specifier, target),
+                throughBarrel,
+                valueLeafPaths: [...valueLeaves],
+                typeLeafPaths: [],
+                hasValueBinding: true,
+            });
+        }
+        return results;
+    };
+}
+export function analyzeImports(appDir, absoluteFilePath) {
+    return createImportAnalyzer(appDir)(absoluteFilePath);
+}
+//# sourceMappingURL=file-walker.js.map

package/dist/scanner/file-walker.js.map

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

package/dist/scanner/ignore-filter.d.ts

@@ -0,0 +1,3 @@
+export type IgnoreFilter = (relativePath: string, isDirectory: boolean) => boolean;
+export declare function createIgnoreFilter(root: string): IgnoreFilter;
+//# sourceMappingURL=ignore-filter.d.ts.map

package/dist/scanner/ignore-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-filter.d.ts","sourceRoot":"","sources":["../../src/scanner/ignore-filter.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,KAAK,OAAO,CAAC;AAKnF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAe7D"}

package/dist/scanner/ignore-filter.js

@@ -0,0 +1,26 @@
+import { existsSync, readFileSync } from 'node:fs';
+import * as path from 'node:path';
+import ignore from 'ignore';
+const DEFAULT_IGNORES = ['node_modules', 'dist', 'build', 'coverage', '.next', '.git'];
+// Skip anything git ignores, plus the always-noise directories, so a scan never descends into vendored repos,
+// build output, or dependencies. Patterns come from the walk root's .gitignore; paths are tested relative to
+// that root in POSIX form. A directory is tested with a trailing slash so directory-only patterns (`ab/`) match.
+export function createIgnoreFilter(root) {
+    const matcher = ignore().add(DEFAULT_IGNORES);
+    const gitignore = path.join(root, '.gitignore');
+    if (existsSync(gitignore)) {
+        try {
+            matcher.add(readFileSync(gitignore, 'utf8'));
+        }
+        catch {
+            /* v8 ignore next -- unreadable .gitignore contributes only the default ignores */
+        }
+    }
+    return (relativePath, isDirectory) => {
+        if (relativePath === '')
+            return false;
+        const posix = relativePath.split(path.sep).join('/');
+        return matcher.ignores(isDirectory ? `${posix}/` : posix);
+    };
+}
+//# sourceMappingURL=ignore-filter.js.map

package/dist/scanner/ignore-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-filter.js","sourceRoot":"","sources":["../../src/scanner/ignore-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,eAAe,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAIvF,8GAA8G;AAC9G,6GAA6G;AAC7G,iHAAiH;AACjH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAChD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,kFAAkF;QACpF,CAAC;IACH,CAAC;IACD,OAAO,CAAC,YAAoB,EAAE,WAAoB,EAAW,EAAE;QAC7D,IAAI,YAAY,KAAK,EAAE;YAAE,OAAO,KAAK,CAAC;QACtC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC,CAAC;AACJ,CAAC"}

package/dist/scanner/import-graph.d.ts

@@ -0,0 +1,13 @@
+import { type WalkedFile } from './file-walker.js';
+export interface ImportGraph {
+    root: string;
+    files: WalkedFile[];
+    adjacency: Map<string, string[]>;
+}
+export interface ImportGraphOptions {
+    resolve?: boolean;
+    includeTests?: boolean;
+}
+export declare function buildImportGraph(appDir: string, options?: ImportGraphOptions): ImportGraph;
+export declare function stronglyConnectedComponents(nodes: readonly string[], adjacency: Map<string, string[]>): string[][];
+//# sourceMappingURL=import-graph.d.ts.map

package/dist/scanner/import-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-graph.d.ts","sourceRoot":"","sources":["../../src/scanner/import-graph.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAU1B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAuC9F;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC/B,MAAM,EAAE,EAAE,CAkDZ"}

package/dist/scanner/import-graph.js

@@ -0,0 +1,103 @@
+import * as path from 'node:path';
+import { createImportAnalyzer, walkRepo, } from './file-walker.js';
+import { buildWorkspaceMap } from './workspace-resolver.js';
+import { resolveFirstPartyImport } from './resolve-import.js';
+const buildAliasEntries = (appDir) => Object.entries(buildWorkspaceMap(appDir)).map(([key, value]) => ({
+    prefix: key.replace(/\/?\*$/, ''),
+    dir: path.resolve(appDir, String(value).replace(/\/?\*$/, '')),
+}));
+export function buildImportGraph(appDir, options = {}) {
+    const resolve = options.resolve ?? false;
+    const root = path.resolve(appDir);
+    const files = options.includeTests
+        ? walkRepo(root)
+        : walkRepo(root).filter((file) => file.role !== 'TEST');
+    const relByAbs = new Map(files.map((file) => [file.absolutePath, file.relativePath]));
+    const aliases = buildAliasEntries(root);
+    const analyze = createImportAnalyzer(root, { resolve });
+    const adjacency = new Map();
+    for (const file of files) {
+        let imports;
+        try {
+            imports = analyze(file.absolutePath);
+        }
+        catch {
+            /* v8 ignore next -- defensive: analyze throws only on an unreadable/malformed source file */
+            imports = [];
+        }
+        const targets = new Set();
+        for (const imp of imports) {
+            if (!imp.hasValueBinding)
+                continue;
+            if (resolve) {
+                for (const leaf of imp.valueLeafPaths) {
+                    const rel = relByAbs.get(leaf);
+                    if (rel !== undefined)
+                        targets.add(rel);
+                }
+            }
+            else {
+                const abs = resolveFirstPartyImport(imp.specifier, file.absolutePath, aliases);
+                const rel = abs === null ? undefined : relByAbs.get(abs);
+                if (rel !== undefined)
+                    targets.add(rel);
+            }
+        }
+        adjacency.set(file.relativePath, [...targets]);
+    }
+    return { root, files, adjacency };
+}
+export function stronglyConnectedComponents(nodes, adjacency) {
+    const index = new Map();
+    const lowLink = new Map();
+    const onStack = new Set();
+    const componentStack = [];
+    const result = [];
+    let counter = 0;
+    for (const start of nodes) {
+        if (index.has(start))
+            continue;
+        const work = [{ node: start, next: 0 }];
+        while (work.length > 0) {
+            const frame = work[work.length - 1];
+            const node = frame.node;
+            if (frame.next === 0) {
+                index.set(node, counter);
+                lowLink.set(node, counter);
+                counter += 1;
+                componentStack.push(node);
+                onStack.add(node);
+            }
+            const neighbours = adjacency.get(node) ?? [];
+            if (frame.next < neighbours.length) {
+                const neighbour = neighbours[frame.next];
+                frame.next += 1;
+                if (!index.has(neighbour)) {
+                    work.push({ node: neighbour, next: 0 });
+                }
+                else if (onStack.has(neighbour)) {
+                    lowLink.set(node, Math.min(lowLink.get(node), index.get(neighbour)));
+                }
+            }
+            else {
+                if (lowLink.get(node) === index.get(node)) {
+                    const component = [];
+                    let popped;
+                    do {
+                        popped = componentStack.pop();
+                        onStack.delete(popped);
+                        component.push(popped);
+                    } while (popped !== node);
+                    result.push(component);
+                }
+                work.pop();
+                const parent = work[work.length - 1]?.node;
+                if (parent !== undefined) {
+                    lowLink.set(parent, Math.min(lowLink.get(parent), lowLink.get(node)));
+                }
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=import-graph.js.map

package/dist/scanner/import-graph.js.map

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

package/dist/scanner/resolve-import.d.ts

@@ -0,0 +1,6 @@
+export interface AliasEntry {
+    prefix: string;
+    dir: string;
+}
+export declare function resolveFirstPartyImport(specifier: string, fromAbsPath: string, aliases: readonly AliasEntry[]): string | null;
+//# sourceMappingURL=resolve-import.d.ts.map

package/dist/scanner/resolve-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-import.d.ts","sourceRoot":"","sources":["../../src/scanner/resolve-import.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AA4BD,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,SAAS,UAAU,EAAE,GAC7B,MAAM,GAAG,IAAI,CAcf"}

package/dist/scanner/resolve-import.js

@@ -0,0 +1,42 @@
+import { existsSync } from 'node:fs';
+import * as path from 'node:path';
+// ESM/NodeNext rewrites a `.js` import to its `.ts` source; map the JS-ish extensions to the TS ones so those
+// specifiers resolve. Without this, an ESM TypeScript project resolves to zero first-party edges.
+const JS_EXT_TO_TS = {
+    '.js': ['.ts', '.tsx'],
+    '.jsx': ['.tsx'],
+    '.mjs': ['.ts', '.tsx'],
+    '.cjs': ['.ts', '.tsx'],
+};
+const BARE_CANDIDATES = ['', '.ts', '.tsx', '/index.ts', '/index.tsx'];
+function specifierBase(specifier, fromAbsPath, aliases) {
+    if (specifier.startsWith('.')) {
+        return path.resolve(path.dirname(fromAbsPath), specifier);
+    }
+    for (const { prefix, dir } of aliases) {
+        if (specifier === prefix || specifier.startsWith(`${prefix}/`)) {
+            return path.resolve(dir, specifier.slice(prefix.length).replace(/^\//, ''));
+        }
+    }
+    return null;
+}
+export function resolveFirstPartyImport(specifier, fromAbsPath, aliases) {
+    const base = specifierBase(specifier, fromAbsPath, aliases);
+    if (base === null)
+        return null;
+    const candidates = [];
+    const tsExtensions = JS_EXT_TO_TS[path.extname(base)];
+    if (tsExtensions !== undefined) {
+        const stem = base.slice(0, -path.extname(base).length);
+        for (const tsExt of tsExtensions)
+            candidates.push(stem + tsExt);
+    }
+    for (const suffix of BARE_CANDIDATES)
+        candidates.push(base + suffix);
+    for (const candidate of candidates) {
+        if (/\.(ts|tsx)$/.test(candidate) && existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+//# sourceMappingURL=resolve-import.js.map

package/dist/scanner/resolve-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-import.js","sourceRoot":"","sources":["../../src/scanner/resolve-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAOlC,8GAA8G;AAC9G,kGAAkG;AAClG,MAAM,YAAY,GAAsC;IACtD,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,CAAC,MAAM,CAAC;IAChB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AACF,MAAM,eAAe,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AAEvE,SAAS,aAAa,CACpB,SAAiB,EACjB,WAAmB,EACnB,OAA8B;IAE9B,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5D,CAAC;IACD,KAAK,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC;QACtC,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAAiB,EACjB,WAAmB,EACnB,OAA8B;IAE9B,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5D,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;QACvD,KAAK,MAAM,KAAK,IAAI,YAAY;YAAE,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;IAClE,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,eAAe;QAAE,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;IACrE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAC/E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/scanner/role-classifier.d.ts

@@ -0,0 +1,12 @@
+export type Role = 'CONTROLLER' | 'SERVICE' | 'REPOSITORY' | 'ROUTE_HANDLER' | 'ROUTE_ENTRY' | 'SERVER_ACTION' | 'API_HANDLER' | 'TRPC_ROUTER' | 'DATA_ACCESS' | 'DB_MODULE' | 'WORKER' | 'PROMPT_FILE' | 'SHARED' | 'TEST' | 'COMPONENT' | 'UNKNOWN';
+export interface RoleClassification {
+    role: Role;
+    confidence: number;
+    matchedRule: string | null;
+}
+export declare const ROLE_PATTERNS: ReadonlyMap<Role, readonly RegExp[]>;
+export declare function classifyFile(relativePath: string): RoleClassification;
+export declare function hasUseServerDirective(sourceHead: string): boolean;
+export declare function hasUseClientDirective(sourceHead: string): boolean;
+export declare function classifyFileWithDirective(relativePath: string, hasServerDirective: boolean): RoleClassification;
+//# sourceMappingURL=role-classifier.d.ts.map

package/dist/scanner/role-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-classifier.d.ts","sourceRoot":"","sources":["../../src/scanner/role-classifier.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GACZ,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,eAAe,GACf,aAAa,GACb,eAAe,GACf,aAAa,GACb,aAAa,GACb,aAAa,GACb,WAAW,GACX,QAAQ,GACR,aAAa,GACb,QAAQ,GACR,MAAM,GACN,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAgHD,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAO9D,CAAC;AAEF,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB,CAQrE;AA2BD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,kBAAkB,EAAE,OAAO,GAC1B,kBAAkB,CAOpB"}