@codependix/nx 0.0.2 → 0.0.4

package/dist/src/index.js

@@ -1,78 +1,214 @@
-import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, p as c, r as l, s as u, t as d, u as f } from "../plugin-context.utilities-Bre57JBa.js";
-import { readFileSync as p, realpathSync as m } from "node:fs";
-import h from "node:path";
-import { createRequire as g } from "node:module";
-//#region packages/ic-suite/codependix/codependix-nx/src/modules/plugin/plugin-inputs.utilities.ts
+import { _ as e, a as t, c as n, d as r, f as i, g as a, h as o, i as s, l as c, m as l, n as u, o as d, p as f, r as p, s as m, t as h, u as g } from "../plugin-context.utilities-Cp-6dCat.js";
+import { existsSync as _, readFileSync as v, realpathSync as y, statSync as b } from "node:fs";
+import x from "node:path";
+import { createRequire as S } from "node:module";
+import { logger as C, readJsonFile as w } from "@nx/devkit";
+//#region projects/ic-suite/codependix/codependix-nx/src/modules/plugin/plugin-inputs.utilities.ts
+function isInsideWorkspace(e) {
+	let t = x.relative(y(e.workspaceRoot), e.directory);
+	return !(t.startsWith("..") || x.isAbsolute(t) || t.split(x.sep).includes("node_modules"));
+}
+function readDependencies(e) {
+	let t = readManifest(e);
+	return Object.entries({
+		...toRecord(t.dependencies),
+		...toRecord(t.devDependencies)
+	});
+}
 function resolveToolInputs(e) {
 	try {
-		let t = locateCommandLine();
-		return toWorkspacePath({
-			directory: t,
-			workspaceRoot: e
-		}) === void 0 ? resolveExternalInputs(t) : resolveWorkspaceInputs({
-			cliDirectory: t,
-			workspaceRoot: e
+		let t = locatePackage({
+			fromFile: e.resolveFrom ?? import.meta.url,
+			name: n
 		});
-	} catch {
-		return [];
+		return t === void 0 ? (warnUnresolved({
+			logger: e.logger,
+			names: [n]
+		}), []) : isInsideWorkspace({
+			directory: t,
+			workspaceRoot: e.workspaceRoot
+		}) ? resolveWorkspaceInputs({
+			...e,
+			cliDirectory: t
+		}) : resolveExternalInputs(t);
+	} catch (t) {
+		return e.logger.warn(`🕸️ Skipped the cache inputs of ${n}, so a change to it will not invalidate a cached codependix gate: ${String(t)}`), [];
 	}
 }
 function collectWorkspacePackages(e) {
-	e.visited.add(e.packageDirectory);
-	let t = readDependencies(e.packageDirectory).filter(([, e]) => String(e).startsWith(c)).map(([t]) => locateDependency({
-		fromDirectory: e.packageDirectory,
-		name: t
-	})).filter((t) => !e.visited.has(t));
-	for (let n of t) collectWorkspacePackages({
-		packageDirectory: n,
-		visited: e.visited
-	});
-	return e.visited;
-}
-function locateCommandLine() {
-	return h.dirname(m(g(import.meta.url).resolve(`${t}/package.json`)));
+	let t = /* @__PURE__ */ new Set([e]), n = /* @__PURE__ */ new Set(), r = [e];
+	for (let e = r.pop(); e !== void 0; e = r.pop()) {
+		let i = readDependencies(e).filter(([, e]) => String(e).startsWith(a)).map(([e]) => e);
+		for (let a of i) {
+			let i = locatePackage({
+				fromFile: x.join(e, "package.json"),
+				name: a
+			});
+			i === void 0 ? n.add(a) : t.has(i) || (t.add(i), r.push(i));
+		}
+	}
+	return {
+		directories: t,
+		unresolved: [...n].toSorted()
+	};
 }
-function locateDependency(e) {
-	return h.dirname(m(g(h.join(e.fromDirectory, "package.json")).resolve(`${e.name}/package.json`)));
+function locatePackage(e) {
+	let t;
+	try {
+		t = x.dirname(y(S(e.fromFile).resolve(e.name)));
+	} catch {
+		return;
+	}
+	for (;; t = x.dirname(t)) {
+		if (readManifest(t).name === e.name) return t;
+		if (x.dirname(t) === t) return;
+	}
 }
-function readDependencies(e) {
-	let t = toRecord(JSON.parse(p(h.join(e, "package.json"), "utf8")));
-	return [...Object.entries(toRecord(t.dependencies)), ...Object.entries(toRecord(t.devDependencies))];
+function readManifest(e) {
+	let t = x.join(e, "package.json");
+	try {
+		let e = _(t) ? JSON.parse(v(t, "utf8")) : void 0;
+		return typeof e == "object" && e ? { ...e } : {};
+	} catch {
+		return {};
+	}
 }
 function resolveExternalInputs(e) {
-	let n = readDependencies(e).map(([e]) => e).filter((e) => e.startsWith("@codependix/"));
-	return [{ externalDependencies: [t, ...n].toSorted() }];
+	let t = readDependencies(e).map(([e]) => e).filter((e) => e.startsWith("@codependix/"));
+	return [{ externalDependencies: [n, ...t].toSorted() }];
 }
 function resolveWorkspaceInputs(e) {
-	let t = m(e.workspaceRoot);
-	return [...collectWorkspacePackages({
-		packageDirectory: e.cliDirectory,
-		visited: /* @__PURE__ */ new Set()
-	})].flatMap((e) => r.map((n) => `{workspaceRoot}/${h.relative(t, e)}/${n}`)).toSorted();
+	let t = y(e.workspaceRoot), { directories: n, unresolved: r } = collectWorkspacePackages(e.cliDirectory);
+	return r.length > 0 && warnUnresolved({
+		logger: e.logger,
+		names: r
+	}), [...n].flatMap((e) => o.map((n) => `{workspaceRoot}/${x.relative(t, e)}/${n}`)).toSorted();
 }
 function toRecord(e) {
 	return typeof e == "object" && e ? { ...e } : {};
 }
-function toWorkspacePath(e) {
-	let t = h.relative(m(e.workspaceRoot), e.directory);
-	return t.startsWith("..") || h.isAbsolute(t) || t.split(h.sep).includes("node_modules") ? void 0 : t;
+function warnUnresolved(e) {
+	e.logger.warn(`🕸️ Skipped the cache inputs of ${e.names.join(", ")}, which could not be resolved, so a change to ${e.names.length === 1 ? "it" : "them"} will not invalidate a cached codependix gate.`);
+}
+//#endregion
+//#region projects/ic-suite/codependix/codependix-nx/src/modules/plugin/plugin-tsconfig.utilities.ts
+function resolveTsconfigInputs(t) {
+	try {
+		let e = y(t.workspaceRoot), { files: n, packages: r } = followExtendsChain({
+			logger: t.logger,
+			workspaceRoot: e
+		}), i = [...n].map((t) => `{workspaceRoot}/${x.relative(e, t).split(x.sep).join("/")}`).toSorted();
+		return r.size === 0 ? i : [...i, { externalDependencies: [...r].toSorted() }];
+	} catch (n) {
+		return t.logger.warn(`🕸️ Skipped following the bases the root tsconfig.json extends, so a change to one will not invalidate a cached codependix gate: ${String(n)}`), [e];
+	}
+}
+function describeSkippedBase(e) {
+	return e.kind === "undeclared" ? `the root package.json does not declare ${e.name} from a registry` : l[e.kind];
+}
+function followExtendsChain(e) {
+	let t = x.join(e.workspaceRoot, "tsconfig.json"), n = readRegistryDependencies(e.workspaceRoot), r = /* @__PURE__ */ new Set([t]), i = /* @__PURE__ */ new Set(), a = _(t) ? [t] : [];
+	for (let t = a.pop(); t !== void 0; t = a.pop()) for (let o of readExtends({
+		...e,
+		file: t
+	})) {
+		let s = resolveExtendedBase({
+			...e,
+			declared: n,
+			file: t,
+			specifier: o
+		});
+		s.kind === "file" ? r.has(s.file) || (r.add(s.file), a.push(s.file)) : s.kind === "package" ? i.add(s.name) : warnSkipped({
+			...e,
+			base: s,
+			file: t,
+			specifier: o
+		});
+	}
+	return {
+		files: r,
+		packages: i
+	};
+}
+function readExtends(e) {
+	try {
+		return [w(e.file, { expectComments: !0 }).extends].flat().filter((e) => typeof e == "string");
+	} catch (t) {
+		return e.logger.warn(`🕸️ Skipped the bases ${x.relative(e.workspaceRoot, e.file)} extends, which could not be read, so a change to one will not invalidate a cached codependix gate: ${String(t)}`), [];
+	}
+}
+function readInstalledPackageName(e) {
+	let t = e.split(x.sep), n = t.lastIndexOf("node_modules") + 1, r = t[n];
+	if (n !== 0 && r !== void 0) return t.slice(n, r.startsWith("@") ? n + 2 : n + 1).join("/");
+}
+function readRegistryDependencies(e) {
+	return new Set(readDependencies(e).filter(([, e]) => !r.some((t) => String(e).startsWith(t))).map(([e]) => e));
+}
+function resolveExtendedBase(e) {
+	let t = e.specifier.replaceAll("\\", "/"), n = x.isAbsolute(t) || t.startsWith("./") || t.startsWith("../") ? resolvePathBase({
+		file: e.file,
+		specifier: t
+	}) : resolvePackageBase({
+		file: e.file,
+		specifier: t
+	});
+	if (n === void 0) return { kind: "unresolved" };
+	if (isInsideWorkspace({
+		directory: n,
+		workspaceRoot: e.workspaceRoot
+	})) return {
+		file: n,
+		kind: "file"
+	};
+	let r = readInstalledPackageName(n);
+	return r === void 0 ? { kind: "outside" } : e.declared.has(r) ? {
+		kind: "package",
+		name: r
+	} : {
+		kind: "undeclared",
+		name: r
+	};
+}
+function resolvePackageBase(e) {
+	let { specifier: t } = e, n = t.split("/").length > (t.startsWith("@") ? 2 : 1) ? [t, `${t}.json`] : [`${t}/${i}`, t], r = S(e.file), [a] = n.flatMap((e) => {
+		try {
+			let t = y(r.resolve(e));
+			return t.endsWith(".json") ? [t] : [];
+		} catch {
+			return [];
+		}
+	});
+	return a;
+}
+function resolvePathBase(e) {
+	let t = x.resolve(x.dirname(e.file), e.specifier), n = b(t, { throwIfNoEntry: !1 })?.isFile() === !0 || t.endsWith(".json") ? t : `${t}.json`;
+	return _(n) ? y(n) : n;
+}
+function warnSkipped(e) {
+	e.logger.warn(`🕸️ Skipped the cache input of ${e.specifier}, which ${x.relative(e.workspaceRoot, e.file)} extends, because ${describeSkippedBase(e.base)}, so a change to it will not invalidate a cached codependix gate.`);
 }
 //#endregion
-//#region packages/ic-suite/codependix/codependix-nx/src/index.ts
-var _ = {
-	createNodes: [n, async (e, t, n) => {
-		let r = (await o()).inferTargets({
+//#region projects/ic-suite/codependix/codependix-nx/src/index.ts
+var T = {
+	createNodes: [f, async (e, t, n) => {
+		let r = (await u()).inferTargets({
 			options: t,
 			projectConfigurationFiles: e,
-			toolInputs: resolveToolInputs(n.workspaceRoot),
+			toolInputs: [...resolveToolInputs({
+				logger: C,
+				workspaceRoot: n.workspaceRoot
+			}), ...resolveTsconfigInputs({
+				logger: C,
+				workspaceRoot: n.workspaceRoot
+			})],
 			workspaceRoot: n.workspaceRoot
 		});
-		return e.map((e) => {
-			let t = h.dirname(e), n = r.get(t);
-			return [e, n === void 0 ? {} : { projects: { [t]: { targets: n } } }];
-		}).filter(([, e]) => Object.keys(e).length > 0);
+		return e.flatMap((e) => {
+			let t = x.dirname(e), n = r.get(t);
+			return n === void 0 ? [] : [[e, { projects: { [t]: { targets: n } } }]];
+		});
 	}],
 	name: "@codependix/nx"
 };
 //#endregion
-export { a as CODEPENDIX_NX_PLUGIN_NAME, f as DEFAULT_GATE_TARGET_NAME, i as GateModule, e as GateService, l as MainModule, s as PluginModule, u as PluginService, _ as default, d as resolveGateService, o as resolvePluginService };
+export { c as CODEPENDIX_NX_PLUGIN_NAME, g as DEFAULT_GATE_TARGET_NAME, s as GateModule, t as GateService, p as MainModule, d as PluginModule, m as PluginService, T as default, h as resolveGateService, u as resolvePluginService };

package/executors.json

@@ -3,7 +3,8 @@
   "executors": {
     "gate": {
       "description": "Fail a project whose dependency graphs break a codependix boundary rule charged to it, built over the project and its Nx dependencies.",
-      "implementation": "./src/executors/gate/executor",
+      "hasher": "@codependix/nx/src/executors/gate/hasher",
+      "implementation": "@codependix/nx/src/executors/gate/executor",
       "schema": "./src/executors/gate/schema.json"
     }
   }

package/package.json

@@ -4,7 +4,7 @@
     "url": "https://github.com/organizzolini/codebase/issues"
   },
   "dependencies": {
-    "@codependix/cli": "0.0.17",
+    "@codependix/cli": "0.0.19",
     "@nestjs/common": "^11.1.21 || ^12.0.1",
     "@nestjs/core": "^11.1.21 || ^12.0.1",
     "@nx/devkit": "^23.0.0",
@@ -30,6 +30,7 @@
       "default": "./dist/src/index.js"
     },
     "./executors.json": "./executors.json",
+    "./loader": "./src/executors/gate/loader.mjs",
     "./package.json": "./package.json",
     "./src/executors/*": "./dist/src/executors/*.js"
   },
@@ -38,9 +39,11 @@
     "dist",
     "executors.json",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "src/executors/*/schema.json",
+    "src/executors/gate/loader.mjs"
   ],
-  "homepage": "https://github.com/organizzolini/codebase/tree/main/packages/ic-suite/codependix/codependix-nx#readme",
+  "homepage": "https://github.com/organizzolini/codebase/tree/main/projects/ic-suite/codependix/codependix-nx#readme",
   "keywords": [
     "architecture-linter",
     "boundaries",
@@ -55,12 +58,15 @@
   "nx": {
     "executors": "./executors.json"
   },
+  "peerDependencies": {
+    "typescript": "^6.0.3"
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
   "repository": {
-    "directory": "packages/ic-suite/codependix/codependix-nx",
+    "directory": "projects/ic-suite/codependix/codependix-nx",
     "type": "git",
     "url": "git+https://github.com/organizzolini/codebase.git"
   },
@@ -70,5 +76,5 @@
     "strict": true
   },
   "types": "./dist/src/index.d.ts",
-  "version": "0.0.2"
+  "version": "0.0.4"
 }

package/src/executors/gate/loader.mjs

@@ -0,0 +1,20 @@
+// Registers the `@swc-node/register` hooks the codependix command line runs
+// under, resolved from this plugin's own dependencies. The gate hands
+// `node --import` this module's file URL.
+
+// The hook's own `@swc-node/register/esm-register` cannot stand in for it:
+// that registers `@swc-node/register/esm` relative to the working directory —
+// the consumer's workspace root, which need not have the hook installed, and
+// under pnpm cannot see this plugin's copy of it. Resolving from this module's
+// URL reaches the copy this plugin depends on wherever it is installed. The
+// hooks still read `tsconfig.json` from the working directory.
+
+// `module.register` is deprecated (DEP0205) in favor of `module.registerHooks`,
+// which runs synchronous hooks in-thread and so cannot run swc's asynchronous
+// ones: there is no replacement to move to. This file is JavaScript, shipped
+// as written, so the type-aware `no-deprecated` lint never reads the call. If
+// a Node release removes `register`, every gate fails loudly rather than
+// passing. Node 26 prints DEP0205 on each gate's child process.
+import { register } from "node:module";
+
+register("@swc-node/register/esm", import.meta.url);

package/src/executors/gate/schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "description": "Fail a project whose dependency graphs break a codependix boundary rule charged to it, built over the project and its Nx dependencies.",
+  "properties": {
+    "configurationPath": {
+      "description": "Path to the codependix configuration file, relative to the workspace root. The path this plugin is registered with in nx.json when omitted.",
+      "type": "string"
+    },
+    "dependencies": {
+      "default": true,
+      "description": "Build the graphs over the judged projects' Nx dependency closure. False builds over the judged projects alone.",
+      "type": "boolean"
+    },
+    "projects": {
+      "description": "Nx project names to judge, replacing the project this target belongs to.",
+      "items": { "type": "string" },
+      "type": "array"
+    },
+    "tags": {
+      "description": "Nx project tags to judge, selecting every project carrying ANY of them.",
+      "items": { "type": "string" },
+      "type": "array"
+    }
+  },
+  "required": [],
+  "title": "Codependix gate",
+  "type": "object"
+}