@groma/scanner-angular 0.1.0 → 0.1.1

package/README.md

@@ -26,7 +26,7 @@ declarations. Consumers do not run a package build or installation script.
 The prototype package name is not a public publication commitment.
 
 Prepare the application's ordinary dependencies using its package manager.
-The scanner reads the root `tsconfig.json`, its configured source entry points,
+The scanner reads each selected project's `tsconfig.json`, its configured source entry points,
 and the Angular resources reachable from that program. It does not install
 dependencies, compile application output, or run application code.
 
@@ -88,3 +88,13 @@ Independent fixture tests load the built package and cover concrete callback
 endpoints, complementary TypeScript evidence, curated ownership, HTML-triggered
 rescan, and failure preservation. See [validation](validation.md) for the
 real-project result and remaining release gates.
+
+## Nested projects
+
+Run Groma from the repository root. The scanner finds package declarations in
+tracked and unignored files, including nested apps and libraries. Dependencies,
+dev dependencies, peer dependencies and optional dependencies identify framework
+projects. Each compiler uses that project's configuration and installed dependencies;
+imported source in sibling repository libraries keeps its original source path.
+Readiness checks all selected projects. A project error fails the complete scan.
+Source and nested package/configuration changes use the shared scanner watch flow.

package/dist/index.js

@@ -170600,8 +170600,8 @@ var require_semver2 = __commonJS(function(exports, module) {
 });
 
 // plugins/scanners/angular/src/scan.ts
-import { existsSync, readFileSync } from "fs";
-import path2 from "path";
+import { existsSync as existsSync2, readFileSync } from "fs";
+import path3 from "path";
 
 // node_modules/@angular/compiler/fesm2022/compiler.mjs
 var _SELECTOR_REGEXP = new RegExp("(\\:not\\()|" + "(([\\.\\#]?)[-\\w]+)|" + `(?:\\[([-.\\w*\\\\$]+)(?:=(["']?)([^\\]"']*)\\5)?\\])|` + "(\\))|" + "(\\s*,\\s*)", "g");
@@ -226672,8 +226672,82 @@ function sourcePosition(position) {
 
 // plugins/scanners/angular/src/scan.ts
 var import_typescript114 = __toESM(require_typescript(), 1);
+
+// plugins/scanners/projects.ts
+import { execFile } from "child_process";
+import { existsSync } from "fs";
+import { readFile } from "fs/promises";
+import path2 from "path";
+import { promisify } from "util";
+var execute = promisify(execFile);
+var excluded = new Set([
+  ".git",
+  "node_modules",
+  "vendor",
+  "target",
+  "dist",
+  "build",
+  "bin",
+  "obj",
+  ".gradle",
+  ".angular",
+  "coverage",
+  "generated",
+  "groma",
+  ".groma"
+]);
+async function projectFiles(root, matches) {
+  const { stdout } = await execute("git", ["-C", root, "ls-files", "-z", "--cached", "--others", "--exclude-standard"], { maxBuffer: 64 * 1024 * 1024 });
+  return [...new Set(stdout.split("\x00").filter((file) => file && matches(file) && !file.split("/").some((part) => excluded.has(part)) && existsSync(path2.join(root, file))))].sort();
+}
+function hasDependency(manifest, dependency) {
+  return ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"].some((section) => typeof manifest[section]?.[dependency] === "string");
+}
+async function frameworkProjects(root, dependency) {
+  const projects = [];
+  for (const file of await projectFiles(root, (file) => path2.posix.basename(file) === "package.json")) {
+    const manifest = JSON.parse(await readFile(path2.join(root, file), "utf8"));
+    if (hasDependency(manifest, dependency))
+      projects.push(path2.dirname(path2.join(root, file)));
+  }
+  return projects;
+}
+
+// plugins/scanners/observations.ts
+function combineObservations(parts) {
+  if (!parts.length)
+    return;
+  const roots = [];
+  const files = new Map;
+  const operations = [];
+  const invocations = [];
+  const diagnostics = [];
+  for (const { key, observation } of parts) {
+    const id = (value) => JSON.stringify([key, value]);
+    roots.push(...observation.roots.map((root) => ({ ...root, id: id(root.id), ...root.parent ? { parent: id(root.parent) } : {} })));
+    for (const source of observation.files) {
+      const combined = files.get(source.file) ?? { file: source.file, roots: [], symbols: [] };
+      combined.roots.push(...source.roots.map(id));
+      combined.symbols.push(...source.symbols.map((symbol) => ({ ...symbol, id: id(symbol.id) })));
+      files.set(source.file, combined);
+    }
+    operations.push(...(observation.operations ?? []).map((operation) => ({ ...operation, id: id(operation.id) })));
+    invocations.push(...(observation.invocations ?? []).map((call) => ({ ...call, source: id(call.source), targets: call.targets.map(id) })));
+    diagnostics.push(...observation.diagnostics);
+  }
+  return createScanObservation({
+    scanner: parts[0].observation.scanner,
+    roots,
+    files: [...files.values()],
+    operations,
+    invocations,
+    diagnostics
+  });
+}
+
+// plugins/scanners/angular/src/scan.ts
 function relative4(root, file) {
-  return path2.relative(root, file).split(path2.sep).join("/");
+  return path3.relative(root, file).split(path3.sep).join("/");
 }
 function owned(root, source) {
   return !source.isDeclarationFile && !relative4(root, source.fileName).startsWith("../") && !source.fileName.includes("/node_modules/") && !source.fileName.endsWith(".ngtypecheck.ts");
@@ -226796,14 +226870,14 @@ class Evidence {
   }
 }
 function angularProject(root) {
-  const manifestPath = path2.join(root, "package.json");
-  if (!existsSync(manifestPath))
+  const manifestPath = path3.join(root, "package.json");
+  if (!existsSync2(manifestPath))
     return;
   const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
-  if (!manifest.dependencies?.["@angular/core"] && !manifest.devDependencies?.["@angular/core"])
+  if (!hasDependency(manifest, "@angular/core"))
     return;
   try {
-    const config = readConfiguration(path2.join(root, "tsconfig.json"));
+    const config = readConfiguration(path3.join(root, "tsconfig.json"));
     failDiagnostics(config.errors);
     const options = { ...config.options, noEmit: true, _enableTemplateTypeChecker: true };
     const ng = new NgtscProgram(config.rootNames, options, createCompilerHost({ options }));
@@ -226817,11 +226891,23 @@ function angularProject(root) {
   }
 }
 async function checkAngularReadiness(root) {
-  if (!angularProject(root))
-    throw new Error("ANGULAR_PROJECT_REQUIRED: Select a project with @angular/core in its root package.json, or disable the angular scanner.");
+  const projects = await frameworkProjects(root, "@angular/core");
+  if (!projects.length)
+    throw new Error("ANGULAR_PROJECT_REQUIRED: No Angular project declaration was found.");
+  for (const project of projects)
+    angularProject(project);
 }
 async function scanAngular(root) {
-  const project = angularProject(root);
+  const parts = [];
+  for (const project of await frameworkProjects(root, "@angular/core")) {
+    const observation = await scanAngularProject(project, root);
+    if (observation)
+      parts.push({ key: relative4(root, project), observation });
+  }
+  return combineObservations(parts);
+}
+async function scanAngularProject(projectRoot, root) {
+  const project = angularProject(projectRoot);
   if (!project)
     return;
   const { manifest, ng } = project;
@@ -226850,7 +226936,7 @@ async function scanAngular(root) {
   })), ...[...evidence.templates].map((file) => ({ file, symbols: [] }))];
   return createScanObservation({
     scanner: { id: "angular", technology: "typescript/angular", engine: "@angular/compiler-cli", engineVersion: VERSION2.full },
-    roots: [{ id: "angular-project", kind: "package", name: manifest.name, file: "package.json" }],
+    roots: [{ id: "angular-project", kind: "package", name: manifest.name, file: relative4(root, path3.join(projectRoot, "package.json")) }],
     files: files.map((file) => ({ ...file, roots: ["angular-project"] })),
     operations: [...evidence.operations.values()],
     invocations: evidence.invocations,
@@ -226861,7 +226947,7 @@ async function scanAngular(root) {
 // plugins/scanners/angular/src/index.ts
 var src_default = {
   id: "angular",
-  watch: { include: ["**/*.ts", "**/*.html", "tsconfig.json", "package.json"], exclude: [] },
+  watch: { include: ["**/*.ts", "**/*.html", "**/tsconfig*.json", "**/package.json"], exclude: [] },
   checkReadiness: checkAngularReadiness,
   scan: scanAngular
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groma/scanner-angular",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Complementary Angular framework evidence with its own compatible TypeScript tooling.",
   "private": false,
   "type": "module",
@@ -25,10 +25,7 @@
           }
         ],
         "compatibility": {
-          "groma": "^0.3.0",
-          "technologyVersions": {
-            "angular": "21.2.19"
-          }
+          "groma": "^0.3.0"
         }
       }
     }