codebase-onboarder 0.6.0 → 0.7.0

package/shared/analyzer/languages/java.js

@@ -7,52 +7,43 @@
 // at all — the C# analyzer sitting next to this one cannot, because a C# file
 // carries no path↔namespace correspondence to invert.
 import { blankComments, lineCounter, uniqueBy } from '../util.js';
-
 export const extensions = ['.java'];
-
 const PACKAGE_RE = /^[ \t]*package\s+([a-zA-Z0-9_.]+)\s*;/m;
-
 export function analyze(source, path) {
-  const clean = blankComments(source);
-  const lineAt = lineCounter(clean);
-
-  // The file's own package, captured first because every import in the file is
-  // resolved relative to it: `resolveImport` has to know where the source root
-  // ends and the package begins, and this declaration is the only place that is
-  // written down. A file with no `package` is in the default package, which is a
-  // real (if unfashionable) case rather than an error.
-  const packageName = (clean.match(PACKAGE_RE) || [])[1] || '';
-
-  const imports = [];
-  for (const m of clean.matchAll(/\bimport\s+(static\s+)?([a-zA-Z0-9_.]+)/g)) {
-    // `packageName` rides along on the import so the resolver can do its job
-    // from the import object alone — which is the fifth argument scan.js passes.
-    imports.push({ spec: m[2], static: !!m[1], packageName, line: lineAt(m.index) });
-  }
-
-  const classes = [];
-  for (const m of clean.matchAll(/(@[A-Za-z0-9_]+\s*)*\b(?:public\s+|private\s+|protected\s+)?(?:abstract\s+)?(?:class|interface|enum|record|@interface)\s+([a-zA-Z0-9_]+)/g)) {
-    const annotations = [];
-    if (m[1]) {
-      for (const am of m[1].matchAll(/@([A-Za-z0-9_]+)/g)) {
-        annotations.push(am[1]);
-      }
+    const clean = blankComments(source);
+    const lineAt = lineCounter(clean);
+    // The file's own package, captured first because every import in the file is
+    // resolved relative to it: `resolveImport` has to know where the source root
+    // ends and the package begins, and this declaration is the only place that is
+    // written down. A file with no `package` is in the default package, which is a
+    // real (if unfashionable) case rather than an error.
+    const packageName = (clean.match(PACKAGE_RE) || [])[1] || '';
+    const imports = [];
+    for (const m of clean.matchAll(/\bimport\s+(static\s+)?([a-zA-Z0-9_.]+)/g)) {
+        // `packageName` rides along on the import so the resolver can do its job
+        // from the import object alone — which is the fifth argument scan.js passes.
+        imports.push({ spec: m[2], static: !!m[1], packageName, line: lineAt(m.index) });
     }
-    classes.push({ name: m[2], annotations, line: lineAt(m.index) });
-  }
-
-  const hasMain = /public\s+static\s+void\s+main\s*\(/.test(clean);
-
-  return {
-    imports: uniqueBy(imports, (i) => i.spec + (i.static ? ' static' : '')),
-    exports: classes.map(c => ({ name: c.name, kind: 'class' })),
-    functions: [],
-    classes,
-    hasMain,
-    packageName,
-  };
+    const classes = [];
+    for (const m of clean.matchAll(/(@[A-Za-z0-9_]+\s*)*\b(?:public\s+|private\s+|protected\s+)?(?:abstract\s+)?(?:class|interface|enum|record|@interface)\s+([a-zA-Z0-9_]+)/g)) {
+        const annotations = [];
+        if (m[1]) {
+            for (const am of m[1].matchAll(/@([A-Za-z0-9_]+)/g)) {
+                annotations.push(am[1]);
+            }
+        }
+        classes.push({ name: m[2], annotations, line: lineAt(m.index) });
+    }
+    const hasMain = /public\s+static\s+void\s+main\s*\(/.test(clean);
+    return {
+        imports: uniqueBy(imports, (i) => i.spec + (i.static ? ' static' : '')),
+        exports: classes.map(c => ({ name: c.name, kind: 'class' })),
+        functions: [],
+        classes,
+        hasMain,
+        packageName,
+    };
 }
-
 // The source root: the part of this file's path that sits *above* its package.
 // `src/main/java/com/example/app/AppController.java` with package
 // `com.example.app` gives `src/main/java/` — and that prefix is exactly what
@@ -61,23 +52,25 @@ export function analyze(source, path) {
 // Returns '' when the file declares no package: with nothing to strip there is
 // no way to know where the root is, and guessing would mean inventing files.
 export function sourceRootFor(fromPath, packageName) {
-  if (!packageName) return null;
-  const suffix = packageName.replace(/\./g, '/');
-  const normalized = String(fromPath).replace(/\\/g, '/');
-  // Two shapes, and both are real. With a source root the package segment is
-  // preceded by a directory (`src/main/java/com/acme/…`); in a project with no
-  // root at all the path *begins* with the package (`com/acme/…`) and the root
-  // is the empty string. That is not the same as "no root" — it is the repo top,
-  // which is a perfectly good answer.
-  const nested = normalized.lastIndexOf('/' + suffix + '/');
-  if (nested >= 0) return normalized.slice(0, nested + 1);
-  if (normalized === suffix || normalized.startsWith(suffix + '/')) return '';
-  // The package is not in the path at all (a generated source dir, a file moved
-  // out of its package). No root can be inferred, and inventing one would put a
-  // node in the graph that does not exist.
-  return null;
+    if (!packageName)
+        return null;
+    const suffix = packageName.replace(/\./g, '/');
+    const normalized = String(fromPath).replace(/\\/g, '/');
+    // Two shapes, and both are real. With a source root the package segment is
+    // preceded by a directory (`src/main/java/com/acme/…`); in a project with no
+    // root at all the path *begins* with the package (`com/acme/…`) and the root
+    // is the empty string. That is not the same as "no root" — it is the repo top,
+    // which is a perfectly good answer.
+    const nested = normalized.lastIndexOf('/' + suffix + '/');
+    if (nested >= 0)
+        return normalized.slice(0, nested + 1);
+    if (normalized === suffix || normalized.startsWith(suffix + '/'))
+        return '';
+    // The package is not in the path at all (a generated source dir, a file moved
+    // out of its package). No root can be inferred, and inventing one would put a
+    // node in the graph that does not exist.
+    return null;
 }
-
 // Candidate file paths for an import, longest spec first.
 //
 // The longest is the obvious one (`model.User` → `…/model/User.java`). The
@@ -88,27 +81,29 @@ export function sourceRootFor(fromPath, packageName) {
 // that exists. The static flag only decides where the walk starts, so the
 // common case does not pay for the rare one.
 function candidatesFor(spec, root, { static: isStatic = false } = {}) {
-  const parts = spec.split('.').filter(Boolean);
-  const out = [];
-  const start = isStatic && parts.length > 1 ? 1 : 0;
-  for (let end = parts.length; end > start; end -= 1) {
-    out.push(root + parts.slice(0, end).join('/') + '.java');
-  }
-  return out;
+    const parts = spec.split('.').filter(Boolean);
+    const out = [];
+    const start = isStatic && parts.length > 1 ? 1 : 0;
+    for (let end = parts.length; end > start; end -= 1) {
+        out.push(root + parts.slice(0, end).join('/') + '.java');
+    }
+    return out;
 }
-
 export function resolveImport(spec, fromPath, has, context = {}, meta = {}) {
-  const root = sourceRootFor(fromPath, meta.packageName);
-  // `null` means "no root could be inferred". `''` means the root is the repo
-  // top, which is the correct answer for a project laid out with no source root
-  // at all — treating that as "no root" silently dropped every flat-layout import.
-  if (root === null) return { unresolved: spec };
-  for (const candidate of candidatesFor(spec, root, { static: meta.static })) {
-    if (has(candidate)) return { path: candidate };
-  }
-  // Nothing in the repo matched. The JDK and every third-party library land
-  // here, and staying `unresolved` is the honest answer: inventing a file would
-  // put a node in the graph that does not exist. scan.js reports these by name
-  // so the reader knows exactly what the analyzer could not place.
-  return { unresolved: spec };
+    const root = sourceRootFor(fromPath, meta.packageName);
+    // `null` means "no root could be inferred". `''` means the root is the repo
+    // top, which is the correct answer for a project laid out with no source root
+    // at all — treating that as "no root" silently dropped every flat-layout import.
+    if (root === null)
+        return { unresolved: spec };
+    for (const candidate of candidatesFor(spec, root, { static: meta.static })) {
+        if (has(candidate))
+            return { path: candidate };
+    }
+    // Nothing in the repo matched. The JDK and every third-party library land
+    // here, and staying `unresolved` is the honest answer: inventing a file would
+    // put a node in the graph that does not exist. scan.js reports these by name
+    // so the reader knows exactly what the analyzer could not place.
+    return { unresolved: spec };
 }
+//# sourceMappingURL=java.js.map

package/shared/analyzer/languages/java.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"java.js","sourceRoot":"","sources":["../../../src/shared/analyzer/languages/java.ts"],"names":[],"mappings":"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","sourcesContent":["// Java analyzer\n//\n// Java is package-rooted: a source file's path *is* its package spelled with\n// slashes, under a source root (`src/main/java` in Maven, `src/main/java` in\n// Gradle, or a plain directory in a one-off project). That single fact is what\n// turns an import into a file, and it is why Java can have a real import graph\n// at all — the C# analyzer sitting next to this one cannot, because a C# file\n// carries no path↔namespace correspondence to invert.\nimport { blankComments, lineCounter, uniqueBy } from '../util.js';\n\nexport const extensions = ['.java'];\n\nconst PACKAGE_RE = /^[ \\t]*package\\s+([a-zA-Z0-9_.]+)\\s*;/m;\n\nexport function analyze(source, path) {\n  const clean = blankComments(source);\n  const lineAt = lineCounter(clean);\n\n  // The file's own package, captured first because every import in the file is\n  // resolved relative to it: `resolveImport` has to know where the source root\n  // ends and the package begins, and this declaration is the only place that is\n  // written down. A file with no `package` is in the default package, which is a\n  // real (if unfashionable) case rather than an error.\n  const packageName = (clean.match(PACKAGE_RE) || [])[1] || '';\n\n  const imports = [];\n  for (const m of clean.matchAll(/\\bimport\\s+(static\\s+)?([a-zA-Z0-9_.]+)/g)) {\n    // `packageName` rides along on the import so the resolver can do its job\n    // from the import object alone — which is the fifth argument scan.js passes.\n    imports.push({ spec: m[2], static: !!m[1], packageName, line: lineAt(m.index) });\n  }\n\n  const classes = [];\n  for (const m of clean.matchAll(/(@[A-Za-z0-9_]+\\s*)*\\b(?:public\\s+|private\\s+|protected\\s+)?(?:abstract\\s+)?(?:class|interface|enum|record|@interface)\\s+([a-zA-Z0-9_]+)/g)) {\n    const annotations = [];\n    if (m[1]) {\n      for (const am of m[1].matchAll(/@([A-Za-z0-9_]+)/g)) {\n        annotations.push(am[1]);\n      }\n    }\n    classes.push({ name: m[2], annotations, line: lineAt(m.index) });\n  }\n\n  const hasMain = /public\\s+static\\s+void\\s+main\\s*\\(/.test(clean);\n\n  return {\n    imports: uniqueBy(imports, (i) => i.spec + (i.static ? ' static' : '')),\n    exports: classes.map(c => ({ name: c.name, kind: 'class' })),\n    functions: [],\n    classes,\n    hasMain,\n    packageName,\n  };\n}\n\n// The source root: the part of this file's path that sits *above* its package.\n// `src/main/java/com/example/app/AppController.java` with package\n// `com.example.app` gives `src/main/java/` — and that prefix is exactly what\n// turns `com.example.model.User` into a path worth looking for.\n//\n// Returns '' when the file declares no package: with nothing to strip there is\n// no way to know where the root is, and guessing would mean inventing files.\nexport function sourceRootFor(fromPath, packageName) {\n  if (!packageName) return null;\n  const suffix = packageName.replace(/\\./g, '/');\n  const normalized = String(fromPath).replace(/\\\\/g, '/');\n  // Two shapes, and both are real. With a source root the package segment is\n  // preceded by a directory (`src/main/java/com/acme/…`); in a project with no\n  // root at all the path *begins* with the package (`com/acme/…`) and the root\n  // is the empty string. That is not the same as \"no root\" — it is the repo top,\n  // which is a perfectly good answer.\n  const nested = normalized.lastIndexOf('/' + suffix + '/');\n  if (nested >= 0) return normalized.slice(0, nested + 1);\n  if (normalized === suffix || normalized.startsWith(suffix + '/')) return '';\n  // The package is not in the path at all (a generated source dir, a file moved\n  // out of its package). No root can be inferred, and inventing one would put a\n  // node in the graph that does not exist.\n  return null;\n}\n\n// Candidate file paths for an import, longest spec first.\n//\n// The longest is the obvious one (`model.User` → `…/model/User.java`). The\n// shorter ones exist because Java lets you import a *nested* type\n// (`com.example.Outer.Inner` lives in `Outer.java`) and a *static member*\n// (`com.example.Constants.MAX` lives in `Constants.java`). Rather than\n// special-case the syntax, walk back a segment at a time and take the first\n// that exists. The static flag only decides where the walk starts, so the\n// common case does not pay for the rare one.\nfunction candidatesFor(spec, root, { static: isStatic = false }: Record<string, any> = {}) {\n  const parts = spec.split('.').filter(Boolean);\n  const out = [];\n  const start = isStatic && parts.length > 1 ? 1 : 0;\n  for (let end = parts.length; end > start; end -= 1) {\n    out.push(root + parts.slice(0, end).join('/') + '.java');\n  }\n  return out;\n}\n\nexport function resolveImport(spec, fromPath, has, context: Record<string, any> = {}, meta: Record<string, any> = {}) {\n  const root = sourceRootFor(fromPath, meta.packageName);\n  // `null` means \"no root could be inferred\". `''` means the root is the repo\n  // top, which is the correct answer for a project laid out with no source root\n  // at all — treating that as \"no root\" silently dropped every flat-layout import.\n  if (root === null) return { unresolved: spec };\n  for (const candidate of candidatesFor(spec, root, { static: meta.static })) {\n    if (has(candidate)) return { path: candidate };\n  }\n  // Nothing in the repo matched. The JDK and every third-party library land\n  // here, and staying `unresolved` is the honest answer: inventing a file would\n  // put a node in the graph that does not exist. scan.js reports these by name\n  // so the reader knows exactly what the analyzer could not place.\n  return { unresolved: spec };\n}\n"]}

package/shared/analyzer/languages/javascript.d.ts

@@ -0,0 +1,12 @@
+import type { ResolverContext, ImportResolution } from '../../contracts.js';
+export declare const extensions: string[];
+export declare function analyze(source: any, path: any): {
+    imports: any[];
+    exports: any[];
+    functions: any[];
+    classes: any[];
+    calls: any[];
+    hasMain: boolean;
+};
+export declare function packageNameOf(spec: any): any;
+export declare function resolveImport(spec: string, fromPath: string, has: (path: string) => boolean, context?: ResolverContext): ImportResolution;