npm - @mark1russell7/boundaries - Versions diffs - 0.0.0-stage → 0.2.0 - Mend

@mark1russell7/boundaries 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Mark Russell
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md CHANGED Viewed

@@ -1,3 +1,109 @@
-# Temporary Holding Version
+# @mark1russell7/boundaries
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+This package gives the import boundaries of a pnpm workspace as a [dependency-cruiser](https://github.com/sverweij/dependency-cruiser) configuration. Each package is a unit. Another package imports it only through an entry of its `package.json`.
+## Rules
+| Rule | It fails when |
+|---|---|
+| `relative-import-out-of-<package>` | A relative import (`../../b/src/x.js`) goes into the folder of a different package. |
+| `deep-import-into-<package>` | An import gets to a file of a package that is not an entry of its `package.json` (`exports`, `main`, `module`, `types` or `bin`). |
+| `not-a-declared-export` | An import of a workspace package does not resolve. The path is not in its `exports`, or the package is not built. |
+| `unknown-workspace-package` | An import in a scope of the workspace (for example `@x/typo`) does not resolve, and the name is not a workspace package or a declared dependency. |
+| `import-of-the-app-<package>` | A package imports an app. An app is a leaf of the graph. This rule is only on with the option `apps`. |
+A type-only import is a boundary too. Tests, fixtures and declaration files are not part of a boundary.
+The rule `import-of-the-app-<package>` examines only the path of an import that resolves. When the name of an app does not resolve, `not-a-declared-export` finds the import.
+The scopes of `unknown-workspace-package` are the scopes of the workspace package names. For example, the packages `@x/a` and `@x/b` give the scope `@x`. A declared dependency is a name in a dependency field (`dependencies`, `devDependencies`, `peerDependencies` or `optionalDependencies`) of the root `package.json` or of a workspace package.
+## Use
+Install the package, `dependency-cruiser` and, for TypeScript 7 or for source with no TypeScript compiler, `@swc/core`:
+```sh
+pnpm add -D @mark1russell7/boundaries dependency-cruiser @swc/core
+```
+Since pnpm 11, the install fails with `ERR_PNPM_IGNORED_BUILDS` when a package has an install script that `allowBuilds` does not name. `@swc/core` has an install script. That script only examines the native package, and pnpm installs the native package as an optional dependency. Thus disallow the script in `pnpm-workspace.yaml` before the install:
+```yaml
+allowBuilds:
+  "@swc/core": false
+```
+The option `--allow-build='!@swc/core'` of `pnpm add` writes the same setting.
+Write `.dependency-cruiser.mjs` at the root of the repository:
+```js
+import { boundaries } from "@mark1russell7/boundaries";
+export default boundaries(import.meta.dirname);
+```
+Add the script `"check:boundaries": "depcruise --config .dependency-cruiser.mjs packages"`. The shared CI of the template starts `check:boundaries` after `build` (`CI.md`).
+## Options
+`boundaries(root, options)` reads the packages of `pnpm-workspace.yaml`. These options change it:
+| Option | Default | What it sets |
+|---|---|---|
+| `packages` | the `packages` list of `pnpm-workspace.yaml` | The globs of the package folders. |
+| `apps` | none | The apps. `"private"` makes each private package an app. |
+| `reference` | none | A text before each comment, for example the name of the decision record. The rules of `forbidden` get it too, when their comment does not start with it. |
+| `scopes` | the scopes of the workspace package names | The scopes of `unknown-workspace-package`. A list replaces the scopes. `{ add: ["@y"], remove: ["@x"] }` changes them. `[]` turns off the rule. |
+| `buildFolders` | `["dist", "build"]` | The build folders of each package. The analysis does not follow them. `[]` follows them. |
+| `forbidden` | none | More rules of the repository, after the rules of the boundaries. |
+| `options` | the default options | More options of dependency-cruiser. They replace the default options that have the same key. |
+An example with the rules of a repository:
+```js
+const { boundaries } = require("@mark1russell7/boundaries");
+module.exports = boundaries(__dirname, {
+  apps: "private",
+  reference: "Invariant I9 of ARCHITECTURE.md.",
+  forbidden: [
+    {
+      name: "transport-imports-server",
+      severity: "error",
+      comment: "A transport does not import the server.",
+      from: { path: "^packages/client/src/adapters/" },
+      to: { path: "^packages/server/" },
+    },
+  ],
+});
+```
+## The default options
+- `doNotFollow`: `node_modules` and the build folders of each package (`buildFolders`). An import of a different package stops at its entry, for example `packages/b/dist/index.js`. The analysis does not go into the imports of that built file. It also does not start from the files of a build folder.
+- `enhancedResolveOptions.conditionNames`: `["import", "node", "default"]`, as Node resolves an ESM import. An entry that is only for `require` does not resolve.
+- `exclude`: tests, fixtures, declaration files and `node_modules`.
+To change a default option, give the option in `options`. For example, `options: { enhancedResolveOptions: { exportsFields: ["exports"], conditionNames: ["import", "require", "node", "default"], mainFields: ["module", "main"] } }` also resolves the entries for `require`.
+## The parser
+dependency-cruiser reads TypeScript with the TypeScript compiler of the repository only for TypeScript 2 to 6. With TypeScript 7, or with no TypeScript, `boundaries()` sets the parser `swc` when `@swc/core` is installed. Without `@swc/core`, dependency-cruiser reads only JavaScript. For a check of built JavaScript, set `buildFolders: []`.
+## Changes in 0.2.0
+These changes can give different results than 0.1.0:
+- The analysis does not follow the build folders (`dist/` and `build/`) of the packages.
+- The resolution does not use the condition `require`.
+- The new rule `unknown-workspace-package` finds an import of an unknown name in a scope of the workspace.
+- The rules of `forbidden` get the text of `reference`.
+## Other exports
+- `boundaryRules(packages, options)` gives only the rules, for a list of packages.
+- `workspacePackages(root, globs)` gives the packages of the workspace, their entries and their declared dependencies.
+- `workspaceScopes(packages, scopes)` gives the scopes of `unknown-workspace-package`.
+- `declaredDependencies(manifest)` gives the names in the dependency fields of a `package.json`.
+- `defaultOptions(root, { packages, buildFolders })`, `doNotFollowPaths(packages, buildFolders)` and `parserOptions(root)` give the default options.

package/build/index.cjs ADDED Viewed

@@ -0,0 +1,345 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let node_fs = require("node:fs");
+let node_module = require("node:module");
+let node_path = require("node:path");
+// src/index.ts
+/**
+* The import boundaries of a workspace, as a dependency-cruiser configuration. Each package is a
+* unit. Another package imports it only through an entry of its package.json (`exports`, `main`,
+* `module`, `types`, `bin`). A relative path or a deep path into its folder is not an entry.
+*
+* A repository uses it from its `.dependency-cruiser.cjs`:
+*
+* ```js
+* const { boundaries } = require("@mark1russell7/boundaries");
+* module.exports = boundaries(__dirname, { apps: "private" });
+* ```
+*/
+const escape = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/** The default build folders of a package. */
+const BUILD_FOLDERS = ["dist", "build"];
+const DEPENDENCY_FIELDS = [
+	"dependencies",
+	"devDependencies",
+	"peerDependencies",
+	"optionalDependencies"
+];
+/** The names of the dependencies of a package.json, from each dependency field. */
+function declaredDependencies(manifest) {
+	const names = /* @__PURE__ */ new Set();
+	for (const field of DEPENDENCY_FIELDS) {
+		const value = manifest[field];
+		if (value && typeof value === "object" && !Array.isArray(value)) for (const name of Object.keys(value)) names.add(name);
+	}
+	return [...names].sort();
+}
+/** The scopes of the package names, for example "@x" for "@x/a", changed by the option `scopes`. A name with no scope gives no scope. */
+function workspaceScopes(packages, opts = {}) {
+	const normal = (scope) => (scope.startsWith("@") ? scope : `@${scope}`).replace(/\/$/, "");
+	if (Array.isArray(opts)) return [...new Set(opts.map(normal))].sort();
+	const scopes = new Set(packages.filter((p) => p.name.startsWith("@") && p.name.includes("/")).map((p) => p.name.slice(0, p.name.indexOf("/"))));
+	for (const scope of opts.add ?? []) scopes.add(normal(scope));
+	for (const scope of opts.remove ?? []) scopes.delete(normal(scope));
+	return [...scopes].sort();
+}
+/** The `packages` list of a pnpm-workspace.yaml file. It reads only that list, with no YAML library. */
+function workspaceGlobs(yaml) {
+	const globs = [];
+	let inList = false;
+	for (const raw of yaml.split(/\r?\n/)) {
+		const hash = raw.indexOf(" #");
+		const line = (hash === -1 ? raw : raw.slice(0, hash)).trimEnd();
+		const trimmed = line.trimStart();
+		if (trimmed === "" || trimmed.startsWith("#")) continue;
+		if (/^packages\s*:/.test(line)) {
+			inList = true;
+			continue;
+		}
+		if (!inList) continue;
+		if (trimmed === line) break;
+		if (!trimmed.startsWith("-")) continue;
+		const item = trimmed.slice(1).trim().replace(/^["']/, "").replace(/["']$/, "");
+		if (item) globs.push(item);
+	}
+	return globs;
+}
+function isDir(path) {
+	try {
+		return (0, node_fs.statSync)(path).isDirectory();
+	} catch {
+		return false;
+	}
+}
+/** The folders that a glob of pnpm-workspace.yaml gives: "a/b", "a/*" and "a/**". */
+function expand(root, glob) {
+	const clean = glob.replace(/^\.\//, "").replace(/\/$/, "");
+	const star = clean.indexOf("*");
+	if (star === -1) return isDir((0, node_path.join)(root, clean)) ? [clean] : [];
+	const base = clean.slice(0, star).replace(/\/$/, "");
+	const recursive = clean.slice(star).startsWith("**");
+	const found = [];
+	const walk = (dir, depth) => {
+		let entries;
+		try {
+			entries = (0, node_fs.readdirSync)((0, node_path.join)(root, dir), { withFileTypes: true });
+		} catch {
+			return;
+		}
+		for (const entry of entries) {
+			if (!entry.isDirectory() || entry.name === "node_modules" || entry.name.startsWith(".")) continue;
+			const child = dir === "" ? entry.name : `${dir}/${entry.name}`;
+			found.push(child);
+			if (recursive && depth < 6) walk(child, depth + 1);
+		}
+	};
+	walk(base, 0);
+	return found;
+}
+/** The leaf strings of an `exports` value, with their subpath keys. */
+function exportTargets(value, out = []) {
+	if (typeof value === "string") out.push(value);
+	else if (Array.isArray(value)) for (const item of value) exportTargets(item, out);
+	else if (value && typeof value === "object") for (const item of Object.values(value)) exportTargets(item, out);
+	return out;
+}
+/**
+* The RegExp source of an entry target of a package. The extension can change, because
+* dependency-cruiser resolves "./x.js" to the source file x.ts, and "*" of a subpath pattern matches
+* each path.
+*/
+function entryPattern(dir, target) {
+	return `^${node_path.posix.normalize(node_path.posix.join(dir, target.replace(/^\.\//, ""))).replace(/\.d\.[cm]?ts$|\.[cm]?[jt]sx?$/, "").split("*").map(escape).join(".*")}(${EXTENSIONS})?$`;
+}
+const EXTENSIONS = [
+	".js",
+	".mjs",
+	".cjs",
+	".jsx",
+	".ts",
+	".mts",
+	".cts",
+	".tsx",
+	".d.ts",
+	".d.mts",
+	".d.cts"
+].map(escape).join("|");
+/** The entries of a package.json: the files that other packages can import. */
+function packageEntries(dir, manifest) {
+	const targets = exportTargets(manifest["exports"]);
+	for (const field of [
+		"main",
+		"module",
+		"types",
+		"typings"
+	]) {
+		const value = manifest[field];
+		if (typeof value === "string") targets.push(value);
+	}
+	if (typeof manifest["bin"] === "string") targets.push(manifest["bin"]);
+	else if (manifest["bin"] && typeof manifest["bin"] === "object") targets.push(...exportTargets(manifest["bin"]));
+	if (targets.length === 0 && manifest["exports"] === void 0) targets.push("./index.js");
+	return [...new Set(targets.filter((t) => !t.endsWith(".json") || t === "./package.json").map((t) => entryPattern(dir, t)))];
+}
+/** The packages of the workspace in the folder `root`. */
+function workspacePackages(root, globs) {
+	let list = globs;
+	if (!list) {
+		try {
+			list = workspaceGlobs((0, node_fs.readFileSync)((0, node_path.join)(root, "pnpm-workspace.yaml"), "utf8"));
+		} catch {
+			list = [];
+		}
+		if (list.length === 0) list = ["packages/*"];
+	}
+	const excluded = list.filter((g) => g.startsWith("!")).flatMap((g) => expand(root, g.slice(1)));
+	const dirs = [...new Set(list.filter((g) => !g.startsWith("!")).flatMap((g) => expand(root, g)))].filter((d) => !excluded.includes(d));
+	const found = [];
+	for (const dir of dirs.sort()) {
+		let manifest;
+		try {
+			manifest = JSON.parse((0, node_fs.readFileSync)((0, node_path.join)(root, dir, "package.json"), "utf8"));
+		} catch {
+			continue;
+		}
+		if (typeof manifest["name"] !== "string") continue;
+		found.push({
+			name: manifest["name"],
+			dir,
+			private: manifest["private"] === true,
+			entries: packageEntries(dir, manifest),
+			dependencies: declaredDependencies(manifest)
+		});
+	}
+	return found;
+}
+/** The rules of the boundaries for a list of packages. `boundaries()` reads the list from the workspace. */
+function boundaryRules(packages, opts = {}) {
+	const why = (text) => opts.reference ? `${opts.reference} ${text}` : text;
+	const anyPackage = packages.map((p) => `^${escape(p.dir)}/`);
+	const rules = [];
+	for (const pkg of packages) {
+		const own = `^${escape(pkg.dir)}/`;
+		const others = anyPackage.filter((path) => path !== own);
+		if (others.length > 0) rules.push({
+			name: `relative-import-out-of-${slug(pkg.name)}`,
+			severity: "error",
+			comment: why(`A relative import leaves the package ${pkg.name}. Import the other package by its name, through an entry of its package.json.`),
+			from: { path: own },
+			to: {
+				path: others,
+				pathNot: own,
+				dependencyTypes: ["local"]
+			}
+		});
+		rules.push({
+			name: `deep-import-into-${slug(pkg.name)}`,
+			severity: "error",
+			comment: why(`An import reaches into the folder of ${pkg.name} at a file that is not an entry of its package.json (exports, main, module, types or bin). Import an entry, or add the file to the exports of ${pkg.name}.`),
+			from: { pathNot: own },
+			to: pkg.entries.length > 0 ? {
+				path: own,
+				pathNot: pkg.entries
+			} : { path: own }
+		});
+	}
+	const names = packages.map((p) => escape(p.name));
+	if (names.length > 0) rules.push({
+		name: "not-a-declared-export",
+		severity: "error",
+		comment: why("An import of a package of this workspace does not resolve. The path is not an entry of its exports, or the package is not built."),
+		from: {},
+		to: {
+			path: `^(${names.join("|")})(/|$)`,
+			couldNotResolve: true
+		}
+	});
+	const scopes = workspaceScopes(packages, opts.scopes);
+	if (scopes.length > 0) {
+		const inScope = (name) => scopes.some((scope) => name.startsWith(`${scope}/`));
+		const declared = [...packages.flatMap((p) => p.dependencies ?? []), ...opts.dependencies ?? []];
+		const known = [...new Set([...packages.map((p) => p.name), ...declared].filter(inScope))].sort().map(escape);
+		rules.push({
+			name: "unknown-workspace-package",
+			severity: "error",
+			comment: why(`An import names a package of the scope ${scopes.join(", ")}, but the import does not resolve. The name is not a package of this workspace and not a declared dependency. Correct the name, or add the package.`),
+			from: {},
+			to: {
+				path: `^(${scopes.map(escape).join("|")})/`,
+				...known.length > 0 ? { pathNot: `^(${known.join("|")})(/|$)` } : {},
+				couldNotResolve: true
+			}
+		});
+	}
+	const apps = opts.apps === "private" ? packages.filter((p) => p.private) : packages.filter((p) => (opts.apps ?? []).includes(p.name));
+	for (const app of apps) rules.push({
+		name: `import-of-the-app-${slug(app.name)}`,
+		severity: "error",
+		comment: why(`A package imports the app ${app.name}. An app is a leaf: no other package imports it. Move the shared code to a library package.`),
+		from: { pathNot: `^${escape(app.dir)}/` },
+		to: { path: `^${escape(app.dir)}/` }
+	});
+	return rules;
+}
+const slug = (name) => name.replace(/^@/, "").replace(/[^A-Za-z0-9]+/g, "-");
+/**
+* The parser of the TypeScript source. dependency-cruiser reads TypeScript with the TypeScript
+* compiler of the repository only for TypeScript 2 to 6. With TypeScript 7 or no TypeScript, it reads
+* TypeScript with swc when @swc/core is installed. Else it reads only JavaScript (acorn): that is
+* enough for a check of built JavaScript.
+*/
+function parserOptions(root) {
+	if (!root) return {};
+	const require$1 = (0, node_module.createRequire)((0, node_path.join)(root, "package.json"));
+	try {
+		const { version } = require$1("typescript/package.json");
+		if (Number(version.split(".")[0]) < 7) return { tsPreCompilationDeps: true };
+	} catch {}
+	for (const from of [require$1, (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href)]) try {
+		from.resolve("@swc/core");
+		return { parser: "swc" };
+	} catch {}
+	return {};
+}
+/** The RegExp sources of the paths that the analysis does not follow: node_modules and the build folders of each package. */
+function doNotFollowPaths(packages, buildFolders = BUILD_FOLDERS) {
+	const paths = ["(^|/)node_modules/"];
+	const dirs = packages.map((p) => p.dir).filter((dir) => dir !== "" && dir !== ".");
+	const folders = buildFolders.map((folder) => folder.replace(/^\.\//, "").replace(/\/$/, "")).filter((folder) => folder !== "");
+	if (dirs.length > 0 && folders.length > 0) paths.push(`^(${dirs.map(escape).join("|")})/(${folders.map(escape).join("|")})/`);
+	return paths;
+}
+/**
+* The default options: the source of the packages, with type-only imports, resolved as Node resolves
+* an ESM import. There is no `includeOnly`, because it also removes the imports that do not resolve,
+* and the rule not-a-declared-export needs them. The analysis does not follow node_modules and the
+* build folders of the packages: an import of a package stops at its entry. The "types" condition is
+* not used: it resolves to a declaration file, and the analysis excludes declaration files, so a deep
+* import does not show. The `require` condition is not used: an ESM import does not resolve to an
+* entry that is only for `require`.
+*/
+function defaultOptions(root, input = {}) {
+	const packages = input.packages ?? (root ? workspacePackages(root) : []);
+	return {
+		...parserOptions(root),
+		exclude: { path: [
+			"(^|/)node_modules/",
+			"\\.(test|spec|e2e)\\.[cm]?[jt]sx?$",
+			"\\.d\\.[cm]?ts$",
+			"/(test|tests|e2e|__tests__|fixtures)/"
+		] },
+		doNotFollow: { path: doNotFollowPaths(packages, input.buildFolders) },
+		enhancedResolveOptions: {
+			exportsFields: ["exports"],
+			conditionNames: [
+				"import",
+				"node",
+				"default"
+			],
+			mainFields: ["module", "main"]
+		},
+		skipAnalysisNotInRules: true
+	};
+}
+/** A rule with the reference before its comment, when the comment does not start with it. */
+function withReference(rule, reference) {
+	if (!reference || rule.comment?.startsWith(reference)) return rule;
+	return {
+		...rule,
+		comment: rule.comment ? `${reference} ${rule.comment}` : reference
+	};
+}
+/** The dependency-cruiser configuration of the boundaries for the workspace in the folder `root`. */
+function boundaries(root, opts = {}) {
+	const packages = workspacePackages(root, opts.packages);
+	let rootManifest = {};
+	try {
+		rootManifest = JSON.parse((0, node_fs.readFileSync)((0, node_path.join)(root, "package.json"), "utf8"));
+	} catch {}
+	const options = {
+		...defaultOptions(root, {
+			packages,
+			...opts.buildFolders ? { buildFolders: opts.buildFolders } : {}
+		}),
+		...opts.options
+	};
+	return {
+		forbidden: [...boundaryRules(packages, {
+			...opts,
+			dependencies: declaredDependencies(rootManifest)
+		}), ...(opts.forbidden ?? []).map((rule) => withReference(rule, opts.reference))],
+		options
+	};
+}
+exports.boundaries = boundaries;
+exports.boundaryRules = boundaryRules;
+exports.declaredDependencies = declaredDependencies;
+exports.defaultOptions = defaultOptions;
+exports.doNotFollowPaths = doNotFollowPaths;
+exports.entryPattern = entryPattern;
+exports.packageEntries = packageEntries;
+exports.parserOptions = parserOptions;
+exports.workspaceGlobs = workspaceGlobs;
+exports.workspacePackages = workspacePackages;
+exports.workspaceScopes = workspaceScopes;
+//# sourceMappingURL=index.cjs.map

package/build/index.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.cjs","names":["statSync","join","readdirSync","posix","readFileSync","require","createRequire"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * The import boundaries of a workspace, as a dependency-cruiser configuration. Each package is a\n * unit. Another package imports it only through an entry of its package.json (`exports`, `main`,\n * `module`, `types`, `bin`). A relative path or a deep path into its folder is not an entry.\n *\n * A repository uses it from its `.dependency-cruiser.cjs`:\n *\n * ```js\n * const { boundaries } = require(\"@mark1russell7/boundaries\");\n * module.exports = boundaries(__dirname, { apps: \"private\" });\n * ```\n */\nimport { readdirSync, readFileSync, statSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { join, posix } from \"node:path\";\n\n/** A rule of dependency-cruiser (the `forbidden` list). The package does not depend on the types of dependency-cruiser. */\nexport interface Rule {\n name: string;\n severity: \"error\" | \"warn\" | \"info\" | \"ignore\";\n comment?: string;\n from: Record<string, unknown>;\n to: Record<string, unknown>;\n}\n\n/** A dependency-cruiser configuration. */\nexport interface Config {\n forbidden: Rule[];\n options: Record<string, unknown>;\n}\n\n/** A package of the workspace. */\nexport interface WorkspacePackage {\n /** The name in package.json. */\n name: string;\n /** The folder, relative to the root, with \"/\". */\n dir: string;\n private: boolean;\n /** RegExp sources of the files that other packages can import. */\n entries: string[];\n /** The names of the dependencies in package.json: dependencies, devDependencies, peerDependencies and optionalDependencies. */\n dependencies?: string[];\n}\n\n/**\n * The scopes of the rule unknown-workspace-package. A list replaces the scopes of the workspace\n * packages. `add` and `remove` change that list. An empty list turns off the rule.\n */\nexport type ScopeOptions = string[] | { add?: string[]; remove?: string[] };\n\nexport interface BoundaryOptions {\n /**\n * Globs of the package folders, for example `[\"packages/*\"]`. The default is the `packages` list of\n * pnpm-workspace.yaml, or `[\"packages/*\"]` when the file does not exist.\n */\n packages?: string[];\n /** The apps: the leaves of the graph, which no other package imports. \"private\" means each private package. */\n apps?: \"private\" | string[];\n /** A text before each comment, for example the decision record of the rules. The comments of `forbidden` get it too. */\n reference?: string;\n /**\n * The scopes (for example \"@x\") in which an import that does not resolve must name a workspace\n * package or a declared dependency. The default is the scopes of the workspace package names.\n */\n scopes?: ScopeOptions;\n /**\n * The build folders of each package, for example `[\"dist\", \"build\"]` (the default). The analysis\n * does not follow the imports of their files, and it does not start from them.\n */\n buildFolders?: string[];\n /** More rules, after the rules of the boundaries. */\n forbidden?: Rule[];\n /** More options of dependency-cruiser. They replace the default options with the same key. */\n options?: Record<string, unknown>;\n}\n\nconst escape = (text: string): string => text.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n/** The default build folders of a package. */\nconst BUILD_FOLDERS = [\"dist\", \"build\"];\n\nconst DEPENDENCY_FIELDS = [\"dependencies\", \"devDependencies\", \"peerDependencies\", \"optionalDependencies\"];\n\n/** The names of the dependencies of a package.json, from each dependency field. */\nexport function declaredDependencies(manifest: Record<string, unknown>): string[] {\n const names = new Set<string>();\n for (const field of DEPENDENCY_FIELDS) {\n const value = manifest[field];\n if (value && typeof value === \"object\" && !Array.isArray(value)) for (const name of Object.keys(value)) names.add(name);\n }\n return [...names].sort();\n}\n\n/** The scopes of the package names, for example \"@x\" for \"@x/a\", changed by the option `scopes`. A name with no scope gives no scope. */\nexport function workspaceScopes(packages: Pick<WorkspacePackage, \"name\">[], opts: ScopeOptions = {}): string[] {\n const normal = (scope: string): string => (scope.startsWith(\"@\") ? scope : `@${scope}`).replace(/\\/$/, \"\");\n if (Array.isArray(opts)) return [...new Set(opts.map(normal))].sort();\n const scopes = new Set(packages.filter((p) => p.name.startsWith(\"@\") && p.name.includes(\"/\")).map((p) => p.name.slice(0, p.name.indexOf(\"/\"))));\n for (const scope of opts.add ?? []) scopes.add(normal(scope));\n for (const scope of opts.remove ?? []) scopes.delete(normal(scope));\n return [...scopes].sort();\n}\n\n/** The `packages` list of a pnpm-workspace.yaml file. It reads only that list, with no YAML library. */\nexport function workspaceGlobs(yaml: string): string[] {\n const globs: string[] = [];\n let inList = false;\n // String operations, not one large RegExp: a RegExp with nested whitespace groups can be slow on some input.\n for (const raw of yaml.split(/\\r?\\n/)) {\n const hash = raw.indexOf(\" #\");\n const line = (hash === -1 ? raw : raw.slice(0, hash)).trimEnd();\n const trimmed = line.trimStart();\n if (trimmed === \"\" || trimmed.startsWith(\"#\")) continue;\n if (/^packages\\s*:/.test(line)) {\n inList = true;\n continue;\n }\n if (!inList) continue;\n if (trimmed === line) break;\n if (!trimmed.startsWith(\"-\")) continue;\n const item = trimmed.slice(1).trim().replace(/^[\"']/, \"\").replace(/[\"']$/, \"\");\n if (item) globs.push(item);\n }\n return globs;\n}\n\nfunction isDir(path: string): boolean {\n try {\n return statSync(path).isDirectory();\n } catch {\n return false;\n }\n}\n\n/** The folders that a glob of pnpm-workspace.yaml gives: \"a/b\", \"a/*\" and \"a/**\". */\nfunction expand(root: string, glob: string): string[] {\n const clean = glob.replace(/^\\.\\//, \"\").replace(/\\/$/, \"\");\n const star = clean.indexOf(\"*\");\n if (star === -1) return isDir(join(root, clean)) ? [clean] : [];\n const base = clean.slice(0, star).replace(/\\/$/, \"\");\n const recursive = clean.slice(star).startsWith(\"**\");\n const found: string[] = [];\n const walk = (dir: string, depth: number): void => {\n let entries;\n try {\n entries = readdirSync(join(root, dir), { withFileTypes: true });\n } catch {\n return;\n }\n for (const entry of entries) {\n if (!entry.isDirectory() || entry.name === \"node_modules\" || entry.name.startsWith(\".\")) continue;\n const child = dir === \"\" ? entry.name : `${dir}/${entry.name}`;\n found.push(child);\n if (recursive && depth < 6) walk(child, depth + 1);\n }\n };\n walk(base, 0);\n return found;\n}\n\n/** The leaf strings of an `exports` value, with their subpath keys. */\nfunction exportTargets(value: unknown, out: string[] = []): string[] {\n if (typeof value === \"string\") out.push(value);\n else if (Array.isArray(value)) for (const item of value) exportTargets(item, out);\n else if (value && typeof value === \"object\") for (const item of Object.values(value)) exportTargets(item, out);\n return out;\n}\n\n/**\n * The RegExp source of an entry target of a package. The extension can change, because\n * dependency-cruiser resolves \"./x.js\" to the source file x.ts, and \"*\" of a subpath pattern matches\n * each path.\n */\nexport function entryPattern(dir: string, target: string): string {\n const path = posix.normalize(posix.join(dir, target.replace(/^\\.\\//, \"\")));\n const stem = path.replace(/\\.d\\.[cm]?ts$|\\.[cm]?[jt]sx?$/, \"\");\n const source = stem.split(\"*\").map(escape).join(\".*\");\n // A flat list, because dependency-cruiser refuses a RegExp with nested quantifiers (safe-regex).\n return `^${source}(${EXTENSIONS})?$`;\n}\n\nconst EXTENSIONS = [\".js\", \".mjs\", \".cjs\", \".jsx\", \".ts\", \".mts\", \".cts\", \".tsx\", \".d.ts\", \".d.mts\", \".d.cts\"].map(escape).join(\"|\");\n\n/** The entries of a package.json: the files that other packages can import. */\nexport function packageEntries(dir: string, manifest: Record<string, unknown>): string[] {\n const targets = exportTargets(manifest[\"exports\"]);\n for (const field of [\"main\", \"module\", \"types\", \"typings\"]) {\n const value = manifest[field];\n if (typeof value === \"string\") targets.push(value);\n }\n if (typeof manifest[\"bin\"] === \"string\") targets.push(manifest[\"bin\"]);\n else if (manifest[\"bin\"] && typeof manifest[\"bin\"] === \"object\") targets.push(...exportTargets(manifest[\"bin\"]));\n // With no entry field, Node resolves the package to index.js.\n if (targets.length === 0 && manifest[\"exports\"] === undefined) targets.push(\"./index.js\");\n return [...new Set(targets.filter((t) => !t.endsWith(\".json\") || t === \"./package.json\").map((t) => entryPattern(dir, t)))];\n}\n\n/** The packages of the workspace in the folder `root`. */\nexport function workspacePackages(root: string, globs?: string[]): WorkspacePackage[] {\n let list = globs;\n if (!list) {\n try {\n list = workspaceGlobs(readFileSync(join(root, \"pnpm-workspace.yaml\"), \"utf8\"));\n } catch {\n list = [];\n }\n if (list.length === 0) list = [\"packages/*\"];\n }\n const excluded = list.filter((g) => g.startsWith(\"!\")).flatMap((g) => expand(root, g.slice(1)));\n const dirs = [...new Set(list.filter((g) => !g.startsWith(\"!\")).flatMap((g) => expand(root, g)))].filter((d) => !excluded.includes(d));\n const found: WorkspacePackage[] = [];\n for (const dir of dirs.sort()) {\n let manifest: Record<string, unknown>;\n try {\n manifest = JSON.parse(readFileSync(join(root, dir, \"package.json\"), \"utf8\")) as Record<string, unknown>;\n } catch {\n continue;\n }\n if (typeof manifest[\"name\"] !== \"string\") continue;\n found.push({\n name: manifest[\"name\"],\n dir,\n private: manifest[\"private\"] === true,\n entries: packageEntries(dir, manifest),\n dependencies: declaredDependencies(manifest),\n });\n }\n return found;\n}\n\n/** The options of `boundaryRules()`. */\nexport interface RuleOptions extends Pick<BoundaryOptions, \"apps\" | \"reference\" | \"scopes\"> {\n /** More declared dependencies, for example the dependencies of the root package.json. */\n dependencies?: string[];\n}\n\n/** The rules of the boundaries for a list of packages. `boundaries()` reads the list from the workspace. */\nexport function boundaryRules(packages: WorkspacePackage[], opts: RuleOptions = {}): Rule[] {\n const why = (text: string): string => (opts.reference ? `${opts.reference} ${text}` : text);\n const anyPackage = packages.map((p) => `^${escape(p.dir)}/`);\n const rules: Rule[] = [];\n for (const pkg of packages) {\n const own = `^${escape(pkg.dir)}/`;\n const others = anyPackage.filter((path) => path !== own);\n if (others.length > 0) {\n rules.push({\n name: `relative-import-out-of-${slug(pkg.name)}`,\n severity: \"error\",\n comment: why(`A relative import leaves the package ${pkg.name}. Import the other package by its name, through an entry of its package.json.`),\n from: { path: own },\n to: { path: others, pathNot: own, dependencyTypes: [\"local\"] },\n });\n }\n rules.push({\n name: `deep-import-into-${slug(pkg.name)}`,\n severity: \"error\",\n comment: why(\n `An import reaches into the folder of ${pkg.name} at a file that is not an entry of its package.json (exports, main, module, types or bin). Import an entry, or add the file to the exports of ${pkg.name}.`,\n ),\n from: { pathNot: own },\n to: pkg.entries.length > 0 ? { path: own, pathNot: pkg.entries } : { path: own },\n });\n }\n const names = packages.map((p) => escape(p.name));\n if (names.length > 0) {\n rules.push({\n name: \"not-a-declared-export\",\n severity: \"error\",\n comment: why(\"An import of a package of this workspace does not resolve. The path is not an entry of its exports, or the package is not built.\"),\n from: {},\n to: { path: `^(${names.join(\"|\")})(/|$)`, couldNotResolve: true },\n });\n }\n const scopes = workspaceScopes(packages, opts.scopes);\n if (scopes.length > 0) {\n const inScope = (name: string): boolean => scopes.some((scope) => name.startsWith(`${scope}/`));\n const declared = [...packages.flatMap((p) => p.dependencies ?? []), ...(opts.dependencies ?? [])];\n const known = [...new Set([...packages.map((p) => p.name), ...declared].filter(inScope))].sort().map(escape);\n rules.push({\n name: \"unknown-workspace-package\",\n severity: \"error\",\n comment: why(\n `An import names a package of the scope ${scopes.join(\", \")}, but the import does not resolve. The name is not a package of this workspace and not a declared dependency. Correct the name, or add the package.`,\n ),\n from: {},\n to: { path: `^(${scopes.map(escape).join(\"|\")})/`, ...(known.length > 0 ? { pathNot: `^(${known.join(\"|\")})(/|$)` } : {}), couldNotResolve: true },\n });\n }\n const apps =\n opts.apps === \"private\" ? packages.filter((p) => p.private) : packages.filter((p) => (opts.apps ?? []).includes(p.name));\n for (const app of apps) {\n rules.push({\n name: `import-of-the-app-${slug(app.name)}`,\n severity: \"error\",\n comment: why(`A package imports the app ${app.name}. An app is a leaf: no other package imports it. Move the shared code to a library package.`),\n from: { pathNot: `^${escape(app.dir)}/` },\n to: { path: `^${escape(app.dir)}/` },\n });\n }\n return rules;\n}\n\nconst slug = (name: string): string => name.replace(/^@/, \"\").replace(/[^A-Za-z0-9]+/g, \"-\");\n\n/**\n * The parser of the TypeScript source. dependency-cruiser reads TypeScript with the TypeScript\n * compiler of the repository only for TypeScript 2 to 6. With TypeScript 7 or no TypeScript, it reads\n * TypeScript with swc when @swc/core is installed. Else it reads only JavaScript (acorn): that is\n * enough for a check of built JavaScript.\n */\nexport function parserOptions(root?: string): Record<string, unknown> {\n if (!root) return {};\n const require = createRequire(join(root, \"package.json\"));\n try {\n const { version } = require(\"typescript/package.json\") as { version: string };\n // A type-only import is a boundary too. This option needs the TypeScript compiler.\n if (Number(version.split(\".\")[0]) < 7) return { tsPreCompilationDeps: true };\n } catch {\n // No TypeScript in the repository\n }\n // @swc/core from the repository, or next to this package (a peer dependency)\n for (const from of [require, createRequire(import.meta.url)]) {\n try {\n from.resolve(\"@swc/core\");\n return { parser: \"swc\" };\n } catch {\n // Not there\n }\n }\n return {};\n}\n\n/** The options of `defaultOptions()`. */\nexport interface DefaultOptionsInput {\n /** The packages of the workspace. The default is `workspacePackages(root)`. */\n packages?: WorkspacePackage[];\n /** The build folders of each package. The default is `[\"dist\", \"build\"]`. */\n buildFolders?: string[];\n}\n\n/** The RegExp sources of the paths that the analysis does not follow: node_modules and the build folders of each package. */\nexport function doNotFollowPaths(packages: Pick<WorkspacePackage, \"dir\">[], buildFolders: string[] = BUILD_FOLDERS): string[] {\n const paths = [\"(^|/)node_modules/\"];\n const dirs = packages.map((p) => p.dir).filter((dir) => dir !== \"\" && dir !== \".\");\n const folders = buildFolders.map((folder) => folder.replace(/^\\.\\//, \"\").replace(/\\/$/, \"\")).filter((folder) => folder !== \"\");\n if (dirs.length > 0 && folders.length > 0) paths.push(`^(${dirs.map(escape).join(\"|\")})/(${folders.map(escape).join(\"|\")})/`);\n return paths;\n}\n\n/**\n * The default options: the source of the packages, with type-only imports, resolved as Node resolves\n * an ESM import. There is no `includeOnly`, because it also removes the imports that do not resolve,\n * and the rule not-a-declared-export needs them. The analysis does not follow node_modules and the\n * build folders of the packages: an import of a package stops at its entry. The \"types\" condition is\n * not used: it resolves to a declaration file, and the analysis excludes declaration files, so a deep\n * import does not show. The `require` condition is not used: an ESM import does not resolve to an\n * entry that is only for `require`.\n */\nexport function defaultOptions(root?: string, input: DefaultOptionsInput = {}): Record<string, unknown> {\n const packages = input.packages ?? (root ? workspacePackages(root) : []);\n return {\n ...parserOptions(root),\n exclude: {\n path: [\"(^|/)node_modules/\", \"\\\\.(test|spec|e2e)\\\\.[cm]?[jt]sx?$\", \"\\\\.d\\\\.[cm]?ts$\", \"/(test|tests|e2e|__tests__|fixtures)/\"],\n },\n doNotFollow: { path: doNotFollowPaths(packages, input.buildFolders) },\n enhancedResolveOptions: {\n exportsFields: [\"exports\"],\n conditionNames: [\"import\", \"node\", \"default\"],\n mainFields: [\"module\", \"main\"],\n },\n skipAnalysisNotInRules: true,\n };\n}\n\n/** A rule with the reference before its comment, when the comment does not start with it. */\nfunction withReference(rule: Rule, reference?: string): Rule {\n if (!reference || rule.comment?.startsWith(reference)) return rule;\n return { ...rule, comment: rule.comment ? `${reference} ${rule.comment}` : reference };\n}\n\n/** The dependency-cruiser configuration of the boundaries for the workspace in the folder `root`. */\nexport function boundaries(root: string, opts: BoundaryOptions = {}): Config {\n const packages = workspacePackages(root, opts.packages);\n let rootManifest: Record<string, unknown> = {};\n try {\n rootManifest = JSON.parse(readFileSync(join(root, \"package.json\"), \"utf8\")) as Record<string, unknown>;\n } catch {\n // No package.json at the root\n }\n const options = { ...defaultOptions(root, { packages, ...(opts.buildFolders ? { buildFolders: opts.buildFolders } : {}) }), ...opts.options };\n const rules = boundaryRules(packages, { ...opts, dependencies: declaredDependencies(rootManifest) });\n return {\n forbidden: [...rules, ...(opts.forbidden ?? []).map((rule) => withReference(rule, opts.reference))],\n options,\n };\n}\n"],"mappings":"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"}

package/build/index.d.cts ADDED Viewed

@@ -0,0 +1,110 @@
+/** A rule of dependency-cruiser (the `forbidden` list). The package does not depend on the types of dependency-cruiser. */
+export interface Rule {
+  name: string;
+  severity: "error" | "warn" | "info" | "ignore";
+  comment?: string;
+  from: Record<string, unknown>;
+  to: Record<string, unknown>;
+}
+/** A dependency-cruiser configuration. */
+export interface Config {
+  forbidden: Rule[];
+  options: Record<string, unknown>;
+}
+/** A package of the workspace. */
+export interface WorkspacePackage {
+  /** The name in package.json. */
+  name: string;
+  /** The folder, relative to the root, with "/". */
+  dir: string;
+  private: boolean;
+  /** RegExp sources of the files that other packages can import. */
+  entries: string[];
+  /** The names of the dependencies in package.json: dependencies, devDependencies, peerDependencies and optionalDependencies. */
+  dependencies?: string[];
+}
+/**
+ * The scopes of the rule unknown-workspace-package. A list replaces the scopes of the workspace
+ * packages. `add` and `remove` change that list. An empty list turns off the rule.
+ */
+export type ScopeOptions = string[] | {
+  add?: string[];
+  remove?: string[];
+};
+export interface BoundaryOptions {
+  /**
+   * Globs of the package folders, for example `["packages/*"]`. The default is the `packages` list of
+   * pnpm-workspace.yaml, or `["packages/*"]` when the file does not exist.
+   */
+  packages?: string[];
+  /** The apps: the leaves of the graph, which no other package imports. "private" means each private package. */
+  apps?: "private" | string[];
+  /** A text before each comment, for example the decision record of the rules. The comments of `forbidden` get it too. */
+  reference?: string;
+  /**
+   * The scopes (for example "@x") in which an import that does not resolve must name a workspace
+   * package or a declared dependency. The default is the scopes of the workspace package names.
+   */
+  scopes?: ScopeOptions;
+  /**
+   * The build folders of each package, for example `["dist", "build"]` (the default). The analysis
+   * does not follow the imports of their files, and it does not start from them.
+   */
+  buildFolders?: string[];
+  /** More rules, after the rules of the boundaries. */
+  forbidden?: Rule[];
+  /** More options of dependency-cruiser. They replace the default options with the same key. */
+  options?: Record<string, unknown>;
+}
+/** The names of the dependencies of a package.json, from each dependency field. */
+export declare function declaredDependencies(manifest: Record<string, unknown>): string[];
+/** The scopes of the package names, for example "@x" for "@x/a", changed by the option `scopes`. A name with no scope gives no scope. */
+export declare function workspaceScopes(packages: Pick<WorkspacePackage, "name">[], opts?: ScopeOptions): string[];
+/** The `packages` list of a pnpm-workspace.yaml file. It reads only that list, with no YAML library. */
+export declare function workspaceGlobs(yaml: string): string[];
+/**
+ * The RegExp source of an entry target of a package. The extension can change, because
+ * dependency-cruiser resolves "./x.js" to the source file x.ts, and "*" of a subpath pattern matches
+ * each path.
+ */
+export declare function entryPattern(dir: string, target: string): string;
+/** The entries of a package.json: the files that other packages can import. */
+export declare function packageEntries(dir: string, manifest: Record<string, unknown>): string[];
+/** The packages of the workspace in the folder `root`. */
+export declare function workspacePackages(root: string, globs?: string[]): WorkspacePackage[];
+/** The options of `boundaryRules()`. */
+export interface RuleOptions extends Pick<BoundaryOptions, "apps" | "reference" | "scopes"> {
+  /** More declared dependencies, for example the dependencies of the root package.json. */
+  dependencies?: string[];
+}
+/** The rules of the boundaries for a list of packages. `boundaries()` reads the list from the workspace. */
+export declare function boundaryRules(packages: WorkspacePackage[], opts?: RuleOptions): Rule[];
+/**
+ * The parser of the TypeScript source. dependency-cruiser reads TypeScript with the TypeScript
+ * compiler of the repository only for TypeScript 2 to 6. With TypeScript 7 or no TypeScript, it reads
+ * TypeScript with swc when @swc/core is installed. Else it reads only JavaScript (acorn): that is
+ * enough for a check of built JavaScript.
+ */
+export declare function parserOptions(root?: string): Record<string, unknown>;
+/** The options of `defaultOptions()`. */
+export interface DefaultOptionsInput {
+  /** The packages of the workspace. The default is `workspacePackages(root)`. */
+  packages?: WorkspacePackage[];
+  /** The build folders of each package. The default is `["dist", "build"]`. */
+  buildFolders?: string[];
+}
+/** The RegExp sources of the paths that the analysis does not follow: node_modules and the build folders of each package. */
+export declare function doNotFollowPaths(packages: Pick<WorkspacePackage, "dir">[], buildFolders?: string[]): string[];
+/**
+ * The default options: the source of the packages, with type-only imports, resolved as Node resolves
+ * an ESM import. There is no `includeOnly`, because it also removes the imports that do not resolve,
+ * and the rule not-a-declared-export needs them. The analysis does not follow node_modules and the
+ * build folders of the packages: an import of a package stops at its entry. The "types" condition is
+ * not used: it resolves to a declaration file, and the analysis excludes declaration files, so a deep
+ * import does not show. The `require` condition is not used: an ESM import does not resolve to an
+ * entry that is only for `require`.
+ */
+export declare function defaultOptions(root?: string, input?: DefaultOptionsInput): Record<string, unknown>;
+/** The dependency-cruiser configuration of the boundaries for the workspace in the folder `root`. */
+export declare function boundaries(root: string, opts?: BoundaryOptions): Config;
+//# sourceMappingURL=index.d.cts.map

package/build/index.d.cts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";iBAiBiB;EACf;EACA;EACA;EACA,MAAM;EACN,IAAI;;;iBAIW;EACf,WAAW;EACX,SAAS;;;iBAIM;;EAEf;;EAEA;EACA;;EAEA;;EAEA;;;;;;YAOU;EAA4B;EAAgB;;iBAEvC;;;;;EAKf;;EAEA;;EAEA;;;;;EAKA,SAAS;;;;;EAKT;;EAEA,YAAY;;EAEZ,UAAU;;;wBAWI,qBAAqB,UAAU;;wBAU/B,gBAAgB,UAAU,KAAK,6BAA6B,OAAM;;wBAUlE,eAAe;;;;;;wBAqEf,aAAa,aAAa;;wBAW1B,eAAe,aAAa,UAAU;;wBActC,kBAAkB,cAAc,mBAAmB;;iBAiClD,oBAAoB,KAAK;;EAExC;;;wBAIc,cAAc,UAAU,oBAAoB,OAAM,cAAmB;;;;;;;wBAyErE,cAAc,gBAAgB;;iBAuB7B;;EAEf,WAAW;;EAEX;;;wBAIc,iBAAiB,UAAU,KAAK,4BAA4B;;;;;;;;;;wBAiB5D,eAAe,eAAe,QAAO,sBAA2B;;wBAwBhE,WAAW,cAAc,OAAM,kBAAuB"}

package/build/index.d.ts ADDED Viewed

@@ -0,0 +1,110 @@
+/** A rule of dependency-cruiser (the `forbidden` list). The package does not depend on the types of dependency-cruiser. */
+export interface Rule {
+  name: string;
+  severity: "error" | "warn" | "info" | "ignore";
+  comment?: string;
+  from: Record<string, unknown>;
+  to: Record<string, unknown>;
+}
+/** A dependency-cruiser configuration. */
+export interface Config {
+  forbidden: Rule[];
+  options: Record<string, unknown>;
+}
+/** A package of the workspace. */
+export interface WorkspacePackage {
+  /** The name in package.json. */
+  name: string;
+  /** The folder, relative to the root, with "/". */
+  dir: string;
+  private: boolean;
+  /** RegExp sources of the files that other packages can import. */
+  entries: string[];
+  /** The names of the dependencies in package.json: dependencies, devDependencies, peerDependencies and optionalDependencies. */
+  dependencies?: string[];
+}
+/**
+ * The scopes of the rule unknown-workspace-package. A list replaces the scopes of the workspace
+ * packages. `add` and `remove` change that list. An empty list turns off the rule.
+ */
+export type ScopeOptions = string[] | {
+  add?: string[];
+  remove?: string[];
+};
+export interface BoundaryOptions {
+  /**
+   * Globs of the package folders, for example `["packages/*"]`. The default is the `packages` list of
+   * pnpm-workspace.yaml, or `["packages/*"]` when the file does not exist.
+   */
+  packages?: string[];
+  /** The apps: the leaves of the graph, which no other package imports. "private" means each private package. */
+  apps?: "private" | string[];
+  /** A text before each comment, for example the decision record of the rules. The comments of `forbidden` get it too. */
+  reference?: string;
+  /**
+   * The scopes (for example "@x") in which an import that does not resolve must name a workspace
+   * package or a declared dependency. The default is the scopes of the workspace package names.
+   */
+  scopes?: ScopeOptions;
+  /**
+   * The build folders of each package, for example `["dist", "build"]` (the default). The analysis
+   * does not follow the imports of their files, and it does not start from them.
+   */
+  buildFolders?: string[];
+  /** More rules, after the rules of the boundaries. */
+  forbidden?: Rule[];
+  /** More options of dependency-cruiser. They replace the default options with the same key. */
+  options?: Record<string, unknown>;
+}
+/** The names of the dependencies of a package.json, from each dependency field. */
+export declare function declaredDependencies(manifest: Record<string, unknown>): string[];
+/** The scopes of the package names, for example "@x" for "@x/a", changed by the option `scopes`. A name with no scope gives no scope. */
+export declare function workspaceScopes(packages: Pick<WorkspacePackage, "name">[], opts?: ScopeOptions): string[];
+/** The `packages` list of a pnpm-workspace.yaml file. It reads only that list, with no YAML library. */
+export declare function workspaceGlobs(yaml: string): string[];
+/**
+ * The RegExp source of an entry target of a package. The extension can change, because
+ * dependency-cruiser resolves "./x.js" to the source file x.ts, and "*" of a subpath pattern matches
+ * each path.
+ */
+export declare function entryPattern(dir: string, target: string): string;
+/** The entries of a package.json: the files that other packages can import. */
+export declare function packageEntries(dir: string, manifest: Record<string, unknown>): string[];
+/** The packages of the workspace in the folder `root`. */
+export declare function workspacePackages(root: string, globs?: string[]): WorkspacePackage[];
+/** The options of `boundaryRules()`. */
+export interface RuleOptions extends Pick<BoundaryOptions, "apps" | "reference" | "scopes"> {
+  /** More declared dependencies, for example the dependencies of the root package.json. */
+  dependencies?: string[];
+}
+/** The rules of the boundaries for a list of packages. `boundaries()` reads the list from the workspace. */
+export declare function boundaryRules(packages: WorkspacePackage[], opts?: RuleOptions): Rule[];
+/**
+ * The parser of the TypeScript source. dependency-cruiser reads TypeScript with the TypeScript
+ * compiler of the repository only for TypeScript 2 to 6. With TypeScript 7 or no TypeScript, it reads
+ * TypeScript with swc when @swc/core is installed. Else it reads only JavaScript (acorn): that is
+ * enough for a check of built JavaScript.
+ */
+export declare function parserOptions(root?: string): Record<string, unknown>;
+/** The options of `defaultOptions()`. */
+export interface DefaultOptionsInput {
+  /** The packages of the workspace. The default is `workspacePackages(root)`. */
+  packages?: WorkspacePackage[];
+  /** The build folders of each package. The default is `["dist", "build"]`. */
+  buildFolders?: string[];
+}
+/** The RegExp sources of the paths that the analysis does not follow: node_modules and the build folders of each package. */
+export declare function doNotFollowPaths(packages: Pick<WorkspacePackage, "dir">[], buildFolders?: string[]): string[];
+/**
+ * The default options: the source of the packages, with type-only imports, resolved as Node resolves
+ * an ESM import. There is no `includeOnly`, because it also removes the imports that do not resolve,
+ * and the rule not-a-declared-export needs them. The analysis does not follow node_modules and the
+ * build folders of the packages: an import of a package stops at its entry. The "types" condition is
+ * not used: it resolves to a declaration file, and the analysis excludes declaration files, so a deep
+ * import does not show. The `require` condition is not used: an ESM import does not resolve to an
+ * entry that is only for `require`.
+ */
+export declare function defaultOptions(root?: string, input?: DefaultOptionsInput): Record<string, unknown>;
+/** The dependency-cruiser configuration of the boundaries for the workspace in the folder `root`. */
+export declare function boundaries(root: string, opts?: BoundaryOptions): Config;
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";iBAiBiB;EACf;EACA;EACA;EACA,MAAM;EACN,IAAI;;;iBAIW;EACf,WAAW;EACX,SAAS;;;iBAIM;;EAEf;;EAEA;EACA;;EAEA;;EAEA;;;;;;YAOU;EAA4B;EAAgB;;iBAEvC;;;;;EAKf;;EAEA;;EAEA;;;;;EAKA,SAAS;;;;;EAKT;;EAEA,YAAY;;EAEZ,UAAU;;;wBAWI,qBAAqB,UAAU;;wBAU/B,gBAAgB,UAAU,KAAK,6BAA6B,OAAM;;wBAUlE,eAAe;;;;;;wBAqEf,aAAa,aAAa;;wBAW1B,eAAe,aAAa,UAAU;;wBActC,kBAAkB,cAAc,mBAAmB;;iBAiClD,oBAAoB,KAAK;;EAExC;;;wBAIc,cAAc,UAAU,oBAAoB,OAAM,cAAmB;;;;;;;wBAyErE,cAAc,gBAAgB;;iBAuB7B;;EAEf,WAAW;;EAEX;;;wBAIc,iBAAiB,UAAU,KAAK,4BAA4B;;;;;;;;;;wBAiB5D,eAAe,eAAe,QAAO,sBAA2B;;wBAwBhE,WAAW,cAAc,OAAM,kBAAuB"}

package/build/index.js ADDED Viewed

@@ -0,0 +1,334 @@
+import { createRequire } from "node:module";
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { join, posix } from "node:path";
+// src/index.ts
+/**
+* The import boundaries of a workspace, as a dependency-cruiser configuration. Each package is a
+* unit. Another package imports it only through an entry of its package.json (`exports`, `main`,
+* `module`, `types`, `bin`). A relative path or a deep path into its folder is not an entry.
+*
+* A repository uses it from its `.dependency-cruiser.cjs`:
+*
+* ```js
+* const { boundaries } = require("@mark1russell7/boundaries");
+* module.exports = boundaries(__dirname, { apps: "private" });
+* ```
+*/
+const escape = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/** The default build folders of a package. */
+const BUILD_FOLDERS = ["dist", "build"];
+const DEPENDENCY_FIELDS = [
+	"dependencies",
+	"devDependencies",
+	"peerDependencies",
+	"optionalDependencies"
+];
+/** The names of the dependencies of a package.json, from each dependency field. */
+function declaredDependencies(manifest) {
+	const names = /* @__PURE__ */ new Set();
+	for (const field of DEPENDENCY_FIELDS) {
+		const value = manifest[field];
+		if (value && typeof value === "object" && !Array.isArray(value)) for (const name of Object.keys(value)) names.add(name);
+	}
+	return [...names].sort();
+}
+/** The scopes of the package names, for example "@x" for "@x/a", changed by the option `scopes`. A name with no scope gives no scope. */
+function workspaceScopes(packages, opts = {}) {
+	const normal = (scope) => (scope.startsWith("@") ? scope : `@${scope}`).replace(/\/$/, "");
+	if (Array.isArray(opts)) return [...new Set(opts.map(normal))].sort();
+	const scopes = new Set(packages.filter((p) => p.name.startsWith("@") && p.name.includes("/")).map((p) => p.name.slice(0, p.name.indexOf("/"))));
+	for (const scope of opts.add ?? []) scopes.add(normal(scope));
+	for (const scope of opts.remove ?? []) scopes.delete(normal(scope));
+	return [...scopes].sort();
+}
+/** The `packages` list of a pnpm-workspace.yaml file. It reads only that list, with no YAML library. */
+function workspaceGlobs(yaml) {
+	const globs = [];
+	let inList = false;
+	for (const raw of yaml.split(/\r?\n/)) {
+		const hash = raw.indexOf(" #");
+		const line = (hash === -1 ? raw : raw.slice(0, hash)).trimEnd();
+		const trimmed = line.trimStart();
+		if (trimmed === "" || trimmed.startsWith("#")) continue;
+		if (/^packages\s*:/.test(line)) {
+			inList = true;
+			continue;
+		}
+		if (!inList) continue;
+		if (trimmed === line) break;
+		if (!trimmed.startsWith("-")) continue;
+		const item = trimmed.slice(1).trim().replace(/^["']/, "").replace(/["']$/, "");
+		if (item) globs.push(item);
+	}
+	return globs;
+}
+function isDir(path) {
+	try {
+		return statSync(path).isDirectory();
+	} catch {
+		return false;
+	}
+}
+/** The folders that a glob of pnpm-workspace.yaml gives: "a/b", "a/*" and "a/**". */
+function expand(root, glob) {
+	const clean = glob.replace(/^\.\//, "").replace(/\/$/, "");
+	const star = clean.indexOf("*");
+	if (star === -1) return isDir(join(root, clean)) ? [clean] : [];
+	const base = clean.slice(0, star).replace(/\/$/, "");
+	const recursive = clean.slice(star).startsWith("**");
+	const found = [];
+	const walk = (dir, depth) => {
+		let entries;
+		try {
+			entries = readdirSync(join(root, dir), { withFileTypes: true });
+		} catch {
+			return;
+		}
+		for (const entry of entries) {
+			if (!entry.isDirectory() || entry.name === "node_modules" || entry.name.startsWith(".")) continue;
+			const child = dir === "" ? entry.name : `${dir}/${entry.name}`;
+			found.push(child);
+			if (recursive && depth < 6) walk(child, depth + 1);
+		}
+	};
+	walk(base, 0);
+	return found;
+}
+/** The leaf strings of an `exports` value, with their subpath keys. */
+function exportTargets(value, out = []) {
+	if (typeof value === "string") out.push(value);
+	else if (Array.isArray(value)) for (const item of value) exportTargets(item, out);
+	else if (value && typeof value === "object") for (const item of Object.values(value)) exportTargets(item, out);
+	return out;
+}
+/**
+* The RegExp source of an entry target of a package. The extension can change, because
+* dependency-cruiser resolves "./x.js" to the source file x.ts, and "*" of a subpath pattern matches
+* each path.
+*/
+function entryPattern(dir, target) {
+	return `^${posix.normalize(posix.join(dir, target.replace(/^\.\//, ""))).replace(/\.d\.[cm]?ts$|\.[cm]?[jt]sx?$/, "").split("*").map(escape).join(".*")}(${EXTENSIONS})?$`;
+}
+const EXTENSIONS = [
+	".js",
+	".mjs",
+	".cjs",
+	".jsx",
+	".ts",
+	".mts",
+	".cts",
+	".tsx",
+	".d.ts",
+	".d.mts",
+	".d.cts"
+].map(escape).join("|");
+/** The entries of a package.json: the files that other packages can import. */
+function packageEntries(dir, manifest) {
+	const targets = exportTargets(manifest["exports"]);
+	for (const field of [
+		"main",
+		"module",
+		"types",
+		"typings"
+	]) {
+		const value = manifest[field];
+		if (typeof value === "string") targets.push(value);
+	}
+	if (typeof manifest["bin"] === "string") targets.push(manifest["bin"]);
+	else if (manifest["bin"] && typeof manifest["bin"] === "object") targets.push(...exportTargets(manifest["bin"]));
+	if (targets.length === 0 && manifest["exports"] === void 0) targets.push("./index.js");
+	return [...new Set(targets.filter((t) => !t.endsWith(".json") || t === "./package.json").map((t) => entryPattern(dir, t)))];
+}
+/** The packages of the workspace in the folder `root`. */
+function workspacePackages(root, globs) {
+	let list = globs;
+	if (!list) {
+		try {
+			list = workspaceGlobs(readFileSync(join(root, "pnpm-workspace.yaml"), "utf8"));
+		} catch {
+			list = [];
+		}
+		if (list.length === 0) list = ["packages/*"];
+	}
+	const excluded = list.filter((g) => g.startsWith("!")).flatMap((g) => expand(root, g.slice(1)));
+	const dirs = [...new Set(list.filter((g) => !g.startsWith("!")).flatMap((g) => expand(root, g)))].filter((d) => !excluded.includes(d));
+	const found = [];
+	for (const dir of dirs.sort()) {
+		let manifest;
+		try {
+			manifest = JSON.parse(readFileSync(join(root, dir, "package.json"), "utf8"));
+		} catch {
+			continue;
+		}
+		if (typeof manifest["name"] !== "string") continue;
+		found.push({
+			name: manifest["name"],
+			dir,
+			private: manifest["private"] === true,
+			entries: packageEntries(dir, manifest),
+			dependencies: declaredDependencies(manifest)
+		});
+	}
+	return found;
+}
+/** The rules of the boundaries for a list of packages. `boundaries()` reads the list from the workspace. */
+function boundaryRules(packages, opts = {}) {
+	const why = (text) => opts.reference ? `${opts.reference} ${text}` : text;
+	const anyPackage = packages.map((p) => `^${escape(p.dir)}/`);
+	const rules = [];
+	for (const pkg of packages) {
+		const own = `^${escape(pkg.dir)}/`;
+		const others = anyPackage.filter((path) => path !== own);
+		if (others.length > 0) rules.push({
+			name: `relative-import-out-of-${slug(pkg.name)}`,
+			severity: "error",
+			comment: why(`A relative import leaves the package ${pkg.name}. Import the other package by its name, through an entry of its package.json.`),
+			from: { path: own },
+			to: {
+				path: others,
+				pathNot: own,
+				dependencyTypes: ["local"]
+			}
+		});
+		rules.push({
+			name: `deep-import-into-${slug(pkg.name)}`,
+			severity: "error",
+			comment: why(`An import reaches into the folder of ${pkg.name} at a file that is not an entry of its package.json (exports, main, module, types or bin). Import an entry, or add the file to the exports of ${pkg.name}.`),
+			from: { pathNot: own },
+			to: pkg.entries.length > 0 ? {
+				path: own,
+				pathNot: pkg.entries
+			} : { path: own }
+		});
+	}
+	const names = packages.map((p) => escape(p.name));
+	if (names.length > 0) rules.push({
+		name: "not-a-declared-export",
+		severity: "error",
+		comment: why("An import of a package of this workspace does not resolve. The path is not an entry of its exports, or the package is not built."),
+		from: {},
+		to: {
+			path: `^(${names.join("|")})(/|$)`,
+			couldNotResolve: true
+		}
+	});
+	const scopes = workspaceScopes(packages, opts.scopes);
+	if (scopes.length > 0) {
+		const inScope = (name) => scopes.some((scope) => name.startsWith(`${scope}/`));
+		const declared = [...packages.flatMap((p) => p.dependencies ?? []), ...opts.dependencies ?? []];
+		const known = [...new Set([...packages.map((p) => p.name), ...declared].filter(inScope))].sort().map(escape);
+		rules.push({
+			name: "unknown-workspace-package",
+			severity: "error",
+			comment: why(`An import names a package of the scope ${scopes.join(", ")}, but the import does not resolve. The name is not a package of this workspace and not a declared dependency. Correct the name, or add the package.`),
+			from: {},
+			to: {
+				path: `^(${scopes.map(escape).join("|")})/`,
+				...known.length > 0 ? { pathNot: `^(${known.join("|")})(/|$)` } : {},
+				couldNotResolve: true
+			}
+		});
+	}
+	const apps = opts.apps === "private" ? packages.filter((p) => p.private) : packages.filter((p) => (opts.apps ?? []).includes(p.name));
+	for (const app of apps) rules.push({
+		name: `import-of-the-app-${slug(app.name)}`,
+		severity: "error",
+		comment: why(`A package imports the app ${app.name}. An app is a leaf: no other package imports it. Move the shared code to a library package.`),
+		from: { pathNot: `^${escape(app.dir)}/` },
+		to: { path: `^${escape(app.dir)}/` }
+	});
+	return rules;
+}
+const slug = (name) => name.replace(/^@/, "").replace(/[^A-Za-z0-9]+/g, "-");
+/**
+* The parser of the TypeScript source. dependency-cruiser reads TypeScript with the TypeScript
+* compiler of the repository only for TypeScript 2 to 6. With TypeScript 7 or no TypeScript, it reads
+* TypeScript with swc when @swc/core is installed. Else it reads only JavaScript (acorn): that is
+* enough for a check of built JavaScript.
+*/
+function parserOptions(root) {
+	if (!root) return {};
+	const require = createRequire(join(root, "package.json"));
+	try {
+		const { version } = require("typescript/package.json");
+		if (Number(version.split(".")[0]) < 7) return { tsPreCompilationDeps: true };
+	} catch {}
+	for (const from of [require, createRequire(import.meta.url)]) try {
+		from.resolve("@swc/core");
+		return { parser: "swc" };
+	} catch {}
+	return {};
+}
+/** The RegExp sources of the paths that the analysis does not follow: node_modules and the build folders of each package. */
+function doNotFollowPaths(packages, buildFolders = BUILD_FOLDERS) {
+	const paths = ["(^|/)node_modules/"];
+	const dirs = packages.map((p) => p.dir).filter((dir) => dir !== "" && dir !== ".");
+	const folders = buildFolders.map((folder) => folder.replace(/^\.\//, "").replace(/\/$/, "")).filter((folder) => folder !== "");
+	if (dirs.length > 0 && folders.length > 0) paths.push(`^(${dirs.map(escape).join("|")})/(${folders.map(escape).join("|")})/`);
+	return paths;
+}
+/**
+* The default options: the source of the packages, with type-only imports, resolved as Node resolves
+* an ESM import. There is no `includeOnly`, because it also removes the imports that do not resolve,
+* and the rule not-a-declared-export needs them. The analysis does not follow node_modules and the
+* build folders of the packages: an import of a package stops at its entry. The "types" condition is
+* not used: it resolves to a declaration file, and the analysis excludes declaration files, so a deep
+* import does not show. The `require` condition is not used: an ESM import does not resolve to an
+* entry that is only for `require`.
+*/
+function defaultOptions(root, input = {}) {
+	const packages = input.packages ?? (root ? workspacePackages(root) : []);
+	return {
+		...parserOptions(root),
+		exclude: { path: [
+			"(^|/)node_modules/",
+			"\\.(test|spec|e2e)\\.[cm]?[jt]sx?$",
+			"\\.d\\.[cm]?ts$",
+			"/(test|tests|e2e|__tests__|fixtures)/"
+		] },
+		doNotFollow: { path: doNotFollowPaths(packages, input.buildFolders) },
+		enhancedResolveOptions: {
+			exportsFields: ["exports"],
+			conditionNames: [
+				"import",
+				"node",
+				"default"
+			],
+			mainFields: ["module", "main"]
+		},
+		skipAnalysisNotInRules: true
+	};
+}
+/** A rule with the reference before its comment, when the comment does not start with it. */
+function withReference(rule, reference) {
+	if (!reference || rule.comment?.startsWith(reference)) return rule;
+	return {
+		...rule,
+		comment: rule.comment ? `${reference} ${rule.comment}` : reference
+	};
+}
+/** The dependency-cruiser configuration of the boundaries for the workspace in the folder `root`. */
+function boundaries(root, opts = {}) {
+	const packages = workspacePackages(root, opts.packages);
+	let rootManifest = {};
+	try {
+		rootManifest = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+	} catch {}
+	const options = {
+		...defaultOptions(root, {
+			packages,
+			...opts.buildFolders ? { buildFolders: opts.buildFolders } : {}
+		}),
+		...opts.options
+	};
+	return {
+		forbidden: [...boundaryRules(packages, {
+			...opts,
+			dependencies: declaredDependencies(rootManifest)
+		}), ...(opts.forbidden ?? []).map((rule) => withReference(rule, opts.reference))],
+		options
+	};
+}
+export { boundaries, boundaryRules, declaredDependencies, defaultOptions, doNotFollowPaths, entryPattern, packageEntries, parserOptions, workspaceGlobs, workspacePackages, workspaceScopes };
+//# sourceMappingURL=index.js.map

package/build/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * The import boundaries of a workspace, as a dependency-cruiser configuration. Each package is a\n * unit. Another package imports it only through an entry of its package.json (`exports`, `main`,\n * `module`, `types`, `bin`). A relative path or a deep path into its folder is not an entry.\n *\n * A repository uses it from its `.dependency-cruiser.cjs`:\n *\n * ```js\n * const { boundaries } = require(\"@mark1russell7/boundaries\");\n * module.exports = boundaries(__dirname, { apps: \"private\" });\n * ```\n */\nimport { readdirSync, readFileSync, statSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { join, posix } from \"node:path\";\n\n/** A rule of dependency-cruiser (the `forbidden` list). The package does not depend on the types of dependency-cruiser. */\nexport interface Rule {\n name: string;\n severity: \"error\" | \"warn\" | \"info\" | \"ignore\";\n comment?: string;\n from: Record<string, unknown>;\n to: Record<string, unknown>;\n}\n\n/** A dependency-cruiser configuration. */\nexport interface Config {\n forbidden: Rule[];\n options: Record<string, unknown>;\n}\n\n/** A package of the workspace. */\nexport interface WorkspacePackage {\n /** The name in package.json. */\n name: string;\n /** The folder, relative to the root, with \"/\". */\n dir: string;\n private: boolean;\n /** RegExp sources of the files that other packages can import. */\n entries: string[];\n /** The names of the dependencies in package.json: dependencies, devDependencies, peerDependencies and optionalDependencies. */\n dependencies?: string[];\n}\n\n/**\n * The scopes of the rule unknown-workspace-package. A list replaces the scopes of the workspace\n * packages. `add` and `remove` change that list. An empty list turns off the rule.\n */\nexport type ScopeOptions = string[] | { add?: string[]; remove?: string[] };\n\nexport interface BoundaryOptions {\n /**\n * Globs of the package folders, for example `[\"packages/*\"]`. The default is the `packages` list of\n * pnpm-workspace.yaml, or `[\"packages/*\"]` when the file does not exist.\n */\n packages?: string[];\n /** The apps: the leaves of the graph, which no other package imports. \"private\" means each private package. */\n apps?: \"private\" | string[];\n /** A text before each comment, for example the decision record of the rules. The comments of `forbidden` get it too. */\n reference?: string;\n /**\n * The scopes (for example \"@x\") in which an import that does not resolve must name a workspace\n * package or a declared dependency. The default is the scopes of the workspace package names.\n */\n scopes?: ScopeOptions;\n /**\n * The build folders of each package, for example `[\"dist\", \"build\"]` (the default). The analysis\n * does not follow the imports of their files, and it does not start from them.\n */\n buildFolders?: string[];\n /** More rules, after the rules of the boundaries. */\n forbidden?: Rule[];\n /** More options of dependency-cruiser. They replace the default options with the same key. */\n options?: Record<string, unknown>;\n}\n\nconst escape = (text: string): string => text.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\n/** The default build folders of a package. */\nconst BUILD_FOLDERS = [\"dist\", \"build\"];\n\nconst DEPENDENCY_FIELDS = [\"dependencies\", \"devDependencies\", \"peerDependencies\", \"optionalDependencies\"];\n\n/** The names of the dependencies of a package.json, from each dependency field. */\nexport function declaredDependencies(manifest: Record<string, unknown>): string[] {\n const names = new Set<string>();\n for (const field of DEPENDENCY_FIELDS) {\n const value = manifest[field];\n if (value && typeof value === \"object\" && !Array.isArray(value)) for (const name of Object.keys(value)) names.add(name);\n }\n return [...names].sort();\n}\n\n/** The scopes of the package names, for example \"@x\" for \"@x/a\", changed by the option `scopes`. A name with no scope gives no scope. */\nexport function workspaceScopes(packages: Pick<WorkspacePackage, \"name\">[], opts: ScopeOptions = {}): string[] {\n const normal = (scope: string): string => (scope.startsWith(\"@\") ? scope : `@${scope}`).replace(/\\/$/, \"\");\n if (Array.isArray(opts)) return [...new Set(opts.map(normal))].sort();\n const scopes = new Set(packages.filter((p) => p.name.startsWith(\"@\") && p.name.includes(\"/\")).map((p) => p.name.slice(0, p.name.indexOf(\"/\"))));\n for (const scope of opts.add ?? []) scopes.add(normal(scope));\n for (const scope of opts.remove ?? []) scopes.delete(normal(scope));\n return [...scopes].sort();\n}\n\n/** The `packages` list of a pnpm-workspace.yaml file. It reads only that list, with no YAML library. */\nexport function workspaceGlobs(yaml: string): string[] {\n const globs: string[] = [];\n let inList = false;\n // String operations, not one large RegExp: a RegExp with nested whitespace groups can be slow on some input.\n for (const raw of yaml.split(/\\r?\\n/)) {\n const hash = raw.indexOf(\" #\");\n const line = (hash === -1 ? raw : raw.slice(0, hash)).trimEnd();\n const trimmed = line.trimStart();\n if (trimmed === \"\" || trimmed.startsWith(\"#\")) continue;\n if (/^packages\\s*:/.test(line)) {\n inList = true;\n continue;\n }\n if (!inList) continue;\n if (trimmed === line) break;\n if (!trimmed.startsWith(\"-\")) continue;\n const item = trimmed.slice(1).trim().replace(/^[\"']/, \"\").replace(/[\"']$/, \"\");\n if (item) globs.push(item);\n }\n return globs;\n}\n\nfunction isDir(path: string): boolean {\n try {\n return statSync(path).isDirectory();\n } catch {\n return false;\n }\n}\n\n/** The folders that a glob of pnpm-workspace.yaml gives: \"a/b\", \"a/*\" and \"a/**\". */\nfunction expand(root: string, glob: string): string[] {\n const clean = glob.replace(/^\\.\\//, \"\").replace(/\\/$/, \"\");\n const star = clean.indexOf(\"*\");\n if (star === -1) return isDir(join(root, clean)) ? [clean] : [];\n const base = clean.slice(0, star).replace(/\\/$/, \"\");\n const recursive = clean.slice(star).startsWith(\"**\");\n const found: string[] = [];\n const walk = (dir: string, depth: number): void => {\n let entries;\n try {\n entries = readdirSync(join(root, dir), { withFileTypes: true });\n } catch {\n return;\n }\n for (const entry of entries) {\n if (!entry.isDirectory() || entry.name === \"node_modules\" || entry.name.startsWith(\".\")) continue;\n const child = dir === \"\" ? entry.name : `${dir}/${entry.name}`;\n found.push(child);\n if (recursive && depth < 6) walk(child, depth + 1);\n }\n };\n walk(base, 0);\n return found;\n}\n\n/** The leaf strings of an `exports` value, with their subpath keys. */\nfunction exportTargets(value: unknown, out: string[] = []): string[] {\n if (typeof value === \"string\") out.push(value);\n else if (Array.isArray(value)) for (const item of value) exportTargets(item, out);\n else if (value && typeof value === \"object\") for (const item of Object.values(value)) exportTargets(item, out);\n return out;\n}\n\n/**\n * The RegExp source of an entry target of a package. The extension can change, because\n * dependency-cruiser resolves \"./x.js\" to the source file x.ts, and \"*\" of a subpath pattern matches\n * each path.\n */\nexport function entryPattern(dir: string, target: string): string {\n const path = posix.normalize(posix.join(dir, target.replace(/^\\.\\//, \"\")));\n const stem = path.replace(/\\.d\\.[cm]?ts$|\\.[cm]?[jt]sx?$/, \"\");\n const source = stem.split(\"*\").map(escape).join(\".*\");\n // A flat list, because dependency-cruiser refuses a RegExp with nested quantifiers (safe-regex).\n return `^${source}(${EXTENSIONS})?$`;\n}\n\nconst EXTENSIONS = [\".js\", \".mjs\", \".cjs\", \".jsx\", \".ts\", \".mts\", \".cts\", \".tsx\", \".d.ts\", \".d.mts\", \".d.cts\"].map(escape).join(\"|\");\n\n/** The entries of a package.json: the files that other packages can import. */\nexport function packageEntries(dir: string, manifest: Record<string, unknown>): string[] {\n const targets = exportTargets(manifest[\"exports\"]);\n for (const field of [\"main\", \"module\", \"types\", \"typings\"]) {\n const value = manifest[field];\n if (typeof value === \"string\") targets.push(value);\n }\n if (typeof manifest[\"bin\"] === \"string\") targets.push(manifest[\"bin\"]);\n else if (manifest[\"bin\"] && typeof manifest[\"bin\"] === \"object\") targets.push(...exportTargets(manifest[\"bin\"]));\n // With no entry field, Node resolves the package to index.js.\n if (targets.length === 0 && manifest[\"exports\"] === undefined) targets.push(\"./index.js\");\n return [...new Set(targets.filter((t) => !t.endsWith(\".json\") || t === \"./package.json\").map((t) => entryPattern(dir, t)))];\n}\n\n/** The packages of the workspace in the folder `root`. */\nexport function workspacePackages(root: string, globs?: string[]): WorkspacePackage[] {\n let list = globs;\n if (!list) {\n try {\n list = workspaceGlobs(readFileSync(join(root, \"pnpm-workspace.yaml\"), \"utf8\"));\n } catch {\n list = [];\n }\n if (list.length === 0) list = [\"packages/*\"];\n }\n const excluded = list.filter((g) => g.startsWith(\"!\")).flatMap((g) => expand(root, g.slice(1)));\n const dirs = [...new Set(list.filter((g) => !g.startsWith(\"!\")).flatMap((g) => expand(root, g)))].filter((d) => !excluded.includes(d));\n const found: WorkspacePackage[] = [];\n for (const dir of dirs.sort()) {\n let manifest: Record<string, unknown>;\n try {\n manifest = JSON.parse(readFileSync(join(root, dir, \"package.json\"), \"utf8\")) as Record<string, unknown>;\n } catch {\n continue;\n }\n if (typeof manifest[\"name\"] !== \"string\") continue;\n found.push({\n name: manifest[\"name\"],\n dir,\n private: manifest[\"private\"] === true,\n entries: packageEntries(dir, manifest),\n dependencies: declaredDependencies(manifest),\n });\n }\n return found;\n}\n\n/** The options of `boundaryRules()`. */\nexport interface RuleOptions extends Pick<BoundaryOptions, \"apps\" | \"reference\" | \"scopes\"> {\n /** More declared dependencies, for example the dependencies of the root package.json. */\n dependencies?: string[];\n}\n\n/** The rules of the boundaries for a list of packages. `boundaries()` reads the list from the workspace. */\nexport function boundaryRules(packages: WorkspacePackage[], opts: RuleOptions = {}): Rule[] {\n const why = (text: string): string => (opts.reference ? `${opts.reference} ${text}` : text);\n const anyPackage = packages.map((p) => `^${escape(p.dir)}/`);\n const rules: Rule[] = [];\n for (const pkg of packages) {\n const own = `^${escape(pkg.dir)}/`;\n const others = anyPackage.filter((path) => path !== own);\n if (others.length > 0) {\n rules.push({\n name: `relative-import-out-of-${slug(pkg.name)}`,\n severity: \"error\",\n comment: why(`A relative import leaves the package ${pkg.name}. Import the other package by its name, through an entry of its package.json.`),\n from: { path: own },\n to: { path: others, pathNot: own, dependencyTypes: [\"local\"] },\n });\n }\n rules.push({\n name: `deep-import-into-${slug(pkg.name)}`,\n severity: \"error\",\n comment: why(\n `An import reaches into the folder of ${pkg.name} at a file that is not an entry of its package.json (exports, main, module, types or bin). Import an entry, or add the file to the exports of ${pkg.name}.`,\n ),\n from: { pathNot: own },\n to: pkg.entries.length > 0 ? { path: own, pathNot: pkg.entries } : { path: own },\n });\n }\n const names = packages.map((p) => escape(p.name));\n if (names.length > 0) {\n rules.push({\n name: \"not-a-declared-export\",\n severity: \"error\",\n comment: why(\"An import of a package of this workspace does not resolve. The path is not an entry of its exports, or the package is not built.\"),\n from: {},\n to: { path: `^(${names.join(\"|\")})(/|$)`, couldNotResolve: true },\n });\n }\n const scopes = workspaceScopes(packages, opts.scopes);\n if (scopes.length > 0) {\n const inScope = (name: string): boolean => scopes.some((scope) => name.startsWith(`${scope}/`));\n const declared = [...packages.flatMap((p) => p.dependencies ?? []), ...(opts.dependencies ?? [])];\n const known = [...new Set([...packages.map((p) => p.name), ...declared].filter(inScope))].sort().map(escape);\n rules.push({\n name: \"unknown-workspace-package\",\n severity: \"error\",\n comment: why(\n `An import names a package of the scope ${scopes.join(\", \")}, but the import does not resolve. The name is not a package of this workspace and not a declared dependency. Correct the name, or add the package.`,\n ),\n from: {},\n to: { path: `^(${scopes.map(escape).join(\"|\")})/`, ...(known.length > 0 ? { pathNot: `^(${known.join(\"|\")})(/|$)` } : {}), couldNotResolve: true },\n });\n }\n const apps =\n opts.apps === \"private\" ? packages.filter((p) => p.private) : packages.filter((p) => (opts.apps ?? []).includes(p.name));\n for (const app of apps) {\n rules.push({\n name: `import-of-the-app-${slug(app.name)}`,\n severity: \"error\",\n comment: why(`A package imports the app ${app.name}. An app is a leaf: no other package imports it. Move the shared code to a library package.`),\n from: { pathNot: `^${escape(app.dir)}/` },\n to: { path: `^${escape(app.dir)}/` },\n });\n }\n return rules;\n}\n\nconst slug = (name: string): string => name.replace(/^@/, \"\").replace(/[^A-Za-z0-9]+/g, \"-\");\n\n/**\n * The parser of the TypeScript source. dependency-cruiser reads TypeScript with the TypeScript\n * compiler of the repository only for TypeScript 2 to 6. With TypeScript 7 or no TypeScript, it reads\n * TypeScript with swc when @swc/core is installed. Else it reads only JavaScript (acorn): that is\n * enough for a check of built JavaScript.\n */\nexport function parserOptions(root?: string): Record<string, unknown> {\n if (!root) return {};\n const require = createRequire(join(root, \"package.json\"));\n try {\n const { version } = require(\"typescript/package.json\") as { version: string };\n // A type-only import is a boundary too. This option needs the TypeScript compiler.\n if (Number(version.split(\".\")[0]) < 7) return { tsPreCompilationDeps: true };\n } catch {\n // No TypeScript in the repository\n }\n // @swc/core from the repository, or next to this package (a peer dependency)\n for (const from of [require, createRequire(import.meta.url)]) {\n try {\n from.resolve(\"@swc/core\");\n return { parser: \"swc\" };\n } catch {\n // Not there\n }\n }\n return {};\n}\n\n/** The options of `defaultOptions()`. */\nexport interface DefaultOptionsInput {\n /** The packages of the workspace. The default is `workspacePackages(root)`. */\n packages?: WorkspacePackage[];\n /** The build folders of each package. The default is `[\"dist\", \"build\"]`. */\n buildFolders?: string[];\n}\n\n/** The RegExp sources of the paths that the analysis does not follow: node_modules and the build folders of each package. */\nexport function doNotFollowPaths(packages: Pick<WorkspacePackage, \"dir\">[], buildFolders: string[] = BUILD_FOLDERS): string[] {\n const paths = [\"(^|/)node_modules/\"];\n const dirs = packages.map((p) => p.dir).filter((dir) => dir !== \"\" && dir !== \".\");\n const folders = buildFolders.map((folder) => folder.replace(/^\\.\\//, \"\").replace(/\\/$/, \"\")).filter((folder) => folder !== \"\");\n if (dirs.length > 0 && folders.length > 0) paths.push(`^(${dirs.map(escape).join(\"|\")})/(${folders.map(escape).join(\"|\")})/`);\n return paths;\n}\n\n/**\n * The default options: the source of the packages, with type-only imports, resolved as Node resolves\n * an ESM import. There is no `includeOnly`, because it also removes the imports that do not resolve,\n * and the rule not-a-declared-export needs them. The analysis does not follow node_modules and the\n * build folders of the packages: an import of a package stops at its entry. The \"types\" condition is\n * not used: it resolves to a declaration file, and the analysis excludes declaration files, so a deep\n * import does not show. The `require` condition is not used: an ESM import does not resolve to an\n * entry that is only for `require`.\n */\nexport function defaultOptions(root?: string, input: DefaultOptionsInput = {}): Record<string, unknown> {\n const packages = input.packages ?? (root ? workspacePackages(root) : []);\n return {\n ...parserOptions(root),\n exclude: {\n path: [\"(^|/)node_modules/\", \"\\\\.(test|spec|e2e)\\\\.[cm]?[jt]sx?$\", \"\\\\.d\\\\.[cm]?ts$\", \"/(test|tests|e2e|__tests__|fixtures)/\"],\n },\n doNotFollow: { path: doNotFollowPaths(packages, input.buildFolders) },\n enhancedResolveOptions: {\n exportsFields: [\"exports\"],\n conditionNames: [\"import\", \"node\", \"default\"],\n mainFields: [\"module\", \"main\"],\n },\n skipAnalysisNotInRules: true,\n };\n}\n\n/** A rule with the reference before its comment, when the comment does not start with it. */\nfunction withReference(rule: Rule, reference?: string): Rule {\n if (!reference || rule.comment?.startsWith(reference)) return rule;\n return { ...rule, comment: rule.comment ? `${reference} ${rule.comment}` : reference };\n}\n\n/** The dependency-cruiser configuration of the boundaries for the workspace in the folder `root`. */\nexport function boundaries(root: string, opts: BoundaryOptions = {}): Config {\n const packages = workspacePackages(root, opts.packages);\n let rootManifest: Record<string, unknown> = {};\n try {\n rootManifest = JSON.parse(readFileSync(join(root, \"package.json\"), \"utf8\")) as Record<string, unknown>;\n } catch {\n // No package.json at the root\n }\n const options = { ...defaultOptions(root, { packages, ...(opts.buildFolders ? { buildFolders: opts.buildFolders } : {}) }), ...opts.options };\n const rules = boundaryRules(packages, { ...opts, dependencies: declaredDependencies(rootManifest) });\n return {\n forbidden: [...rules, ...(opts.forbidden ?? []).map((rule) => withReference(rule, opts.reference))],\n options,\n };\n}\n"],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,79 @@
 {
+  "$schema": "https://json.schemastore.org/package",
   "name": "@mark1russell7/boundaries",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "The import boundaries of a pnpm workspace as a dependency-cruiser configuration: each package is imported only through the entries of its package.json.",
+  "keywords": [
+    "dependency-cruiser",
+    "monorepo",
+    "pnpm",
+    "workspace",
+    "architecture",
+    "boundaries",
+    "exports",
+    "lint"
+  ],
+  "homepage": "https://github.com/mark1russell7/template/tree/main/packages/boundaries#readme",
+  "bugs": {
+    "url": "https://github.com/mark1russell7/template/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark1russell7/template.git",
+    "directory": "packages/boundaries"
+  },
+  "license": "MIT",
+  "author": "Mark Russell (https://github.com/mark1russell7)",
+  "type": "module",
+  "main": "./build/index.js",
+  "files": [
+    "build"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "peerDependencies": {
+    "dependency-cruiser": "^17.0.0 || ^18.0.0",
+    "@swc/core": "^1.10.0"
+  },
+  "peerDependenciesMeta": {
+    "dependency-cruiser": {
+      "optional": true
+    },
+    "@swc/core": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@mark1russell7/cue": "^1.0.2",
+    "@types/node": "^26.6.4",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.3",
+    "dependency-cruiser": "^18.7.0",
+    "tsdown": "^0.23.1",
+    "@swc/core": "^1.15.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json && tsc -p tsconfig.test.json"
+  },
+  "types": "./build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./build/index.d.ts",
+        "default": "./build/index.js"
+      },
+      "require": {
+        "types": "./build/index.d.cts",
+        "default": "./build/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  }
 }