@groma/scanner-react 0.1.0 → 0.1.1

package/README.md

@@ -26,7 +26,7 @@ or installation script is required. Public naming and publication are separate
 release decisions.
 
 Install the application's declared dependencies and React types with its
-package manager and lockfile. The scanner reads the root `tsconfig.json` through
+package manager and lockfile. The scanner reads each selected project's `tsconfig.json` through
 the TypeScript compiler and inventories its owned TSX source files. Missing
 React dependencies, invalid configuration, syntax errors, and semantic errors
 in those TSX files fail preparation with instructions. It does not claim to
@@ -71,3 +71,13 @@ establish a callback interaction.
 TSX and TypeScript edits use the existing watch lifecycle. All enabled scanners
 must complete before architecture changes. See [validation](validation.md) for
 the executed artifact checks 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

@@ -169483,9 +169483,9 @@ Additional information: BADCLIENT: Bad error code, ${badCode} not found in range
 });
 
 // plugins/scanners/react/src/scan.ts
-import { existsSync, readFileSync } from "fs";
+import { existsSync as existsSync2, readFileSync } from "fs";
 import { createRequire } from "module";
-import path from "path";
+import path2 from "path";
 
 // packages/scanner/src/index.ts
 function compare(...values) {
@@ -169651,8 +169651,82 @@ function sourcePosition(position) {
 
 // plugins/scanners/react/src/scan.ts
 var import_typescript = __toESM(require_typescript(), 1);
+
+// plugins/scanners/projects.ts
+import { execFile } from "child_process";
+import { existsSync } from "fs";
+import { readFile } from "fs/promises";
+import path 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(path.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) => path.posix.basename(file) === "package.json")) {
+    const manifest = JSON.parse(await readFile(path.join(root, file), "utf8"));
+    if (hasDependency(manifest, dependency))
+      projects.push(path.dirname(path.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/react/src/scan.ts
 function relative(root, file) {
-  return path.relative(root, file).split(path.sep).join("/");
+  return path2.relative(root, file).split(path2.sep).join("/");
 }
 function failDiagnostics(diagnostics) {
   const errors = diagnostics.filter((item) => item.category === import_typescript.default.DiagnosticCategory.Error);
@@ -169661,16 +169735,16 @@ function failDiagnostics(diagnostics) {
 `)}`).join(`
 `));
 }
-function reactProject(root) {
-  const manifestFile = path.join(root, "package.json");
-  if (!existsSync(manifestFile))
+function reactProject(root, repositoryRoot = root) {
+  const manifestFile = path2.join(root, "package.json");
+  if (!existsSync2(manifestFile))
     return;
   const manifest = JSON.parse(readFileSync(manifestFile, "utf8"));
-  if (!manifest.dependencies?.react && !manifest.devDependencies?.react)
+  if (!hasDependency(manifest, "react"))
     return;
   try {
     createRequire(manifestFile).resolve("react");
-    const configFile = path.join(root, "tsconfig.json");
+    const configFile = path2.join(root, "tsconfig.json");
     const config = import_typescript.default.readConfigFile(configFile, import_typescript.default.sys.readFile);
     if (config.error)
       failDiagnostics([config.error]);
@@ -169678,11 +169752,11 @@ function reactProject(root) {
     failDiagnostics(parsed.errors);
     const program = import_typescript.default.createProgram(parsed.fileNames, { ...parsed.options, noEmit: true });
     const sources = program.getSourceFiles().filter((source) => {
-      const file = relative(root, source.fileName);
+      const file = relative(repositoryRoot, source.fileName);
       return file.endsWith(".tsx") && !source.isDeclarationFile && !file.startsWith("../") && !file.includes("node_modules/");
     });
     if (!sources.length)
-      throw new Error("The root tsconfig.json must include React TSX source files.");
+      throw new Error("The project tsconfig.json must include React TSX source files.");
     const react = import_typescript.default.resolveModuleName("react", sources[0].fileName, parsed.options, import_typescript.default.sys).resolvedModule;
     if (!react?.resolvedFileName.endsWith(".d.ts"))
       throw new Error("Install @types/react in the project.");
@@ -169692,7 +169766,7 @@ function reactProject(root) {
       failDiagnostics(program.getSemanticDiagnostics(source));
     return { manifest, program, sources };
   } catch (error) {
-    throw new Error(`REACT_PROJECT_PREPARATION: Install the project dependencies with its declared package manager and lockfile; provide a valid root tsconfig.json and type-correct TSX files. ${error}`);
+    throw new Error(`REACT_PROJECT_PREPARATION: Install the project dependencies with its declared package manager and lockfile; provide a valid project tsconfig.json and type-correct TSX files. ${error}`);
   }
 }
 function executable(node) {
@@ -169844,11 +169918,23 @@ class Evidence {
   }
 }
 async function checkReactReadiness(root) {
-  if (!reactProject(root))
-    throw new Error("REACT_PROJECT_REQUIRED: Select a project with React in its root package.json, or disable the react scanner.");
+  const projects = await frameworkProjects(root, "react");
+  if (!projects.length)
+    throw new Error("REACT_PROJECT_REQUIRED: No React project declaration was found.");
+  for (const project of projects)
+    reactProject(project, root);
 }
 async function scanReact(root) {
-  const project = reactProject(root);
+  const parts = [];
+  for (const project of await frameworkProjects(root, "react")) {
+    const observation = await scanReactProject(project, root);
+    if (observation)
+      parts.push({ key: relative(root, project), observation });
+  }
+  return combineObservations(parts);
+}
+async function scanReactProject(projectRoot, root) {
+  const project = reactProject(projectRoot, root);
   if (!project)
     return;
   const { manifest, program, sources } = project;
@@ -169858,7 +169944,7 @@ async function scanReact(root) {
   const files = sources.map((source) => ({ file: relative(root, source.fileName), symbols: [] }));
   return createScanObservation({
     scanner: { id: "react", technology: "typescript/react", engine: "typescript-sdk", engineVersion: import_typescript.default.version },
-    roots: [{ id: "react-project", kind: "package", name: manifest.name, file: "package.json" }],
+    roots: [{ id: "react-project", kind: "package", name: manifest.name, file: relative(root, path2.join(projectRoot, "package.json")) }],
     files: files.map((file) => ({ ...file, roots: ["react-project"] })),
     operations: [...evidence.operations.values()],
     invocations: evidence.invocations,
@@ -169869,7 +169955,7 @@ async function scanReact(root) {
 // plugins/scanners/react/src/index.ts
 var src_default = {
   id: "react",
-  watch: { include: ["**/*.tsx", "**/*.ts", "tsconfig.json", "package.json"], exclude: [] },
+  watch: { include: ["**/*.tsx", "**/*.ts", "**/tsconfig*.json", "**/package.json"], exclude: [] },
   checkReadiness: checkReactReadiness,
   scan: scanReact
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groma/scanner-react",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Complementary React framework evidence; a dependency declaration does not verify runtime use.",
   "private": false,
   "type": "module",
@@ -25,10 +25,7 @@
           }
         ],
         "compatibility": {
-          "groma": "^0.3.0",
-          "technologyVersions": {
-            "react": "19.2.7"
-          }
+          "groma": "^0.3.0"
         }
       }
     }