Initial shape.

.gitignore

@@ -0,0 +1,4 @@
+dist
+.idea
+.DS_Store
+node_modules

README.md

@@ -0,0 +1,2 @@
+# eslint-plugin-allowed-dependencies
+

build.ts

@@ -0,0 +1,11 @@
+await Bun.build({
+  entrypoints: ["src/index.ts"],
+  outdir: "dist",
+  /** @link https://github.com/oven-sh/bun/issues/159 */
+  format: "esm",
+  splitting: false,
+  sourcemap: "none",
+  minify: true,
+  target: "node",
+  external: ["*"],
+});

package.json

@@ -0,0 +1,35 @@
+{
+  "name": "eslint-plugin-allowed-dependencies",
+  "version": "0.0.1",
+  "module": "src/index.ts",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist", "*.md"],
+  "scripts": {
+    "build:cjs": "tsc -p tsconfig.cjs.json && uglifyjs dist/index.js -c -m -o dist/index.cjs",
+    "build": "bun run build:cjs && bun run build.ts"
+  },
+  "dependencies": {
+    "ramda": "^0.30.1"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/ramda": "^0.30.1",
+    "@tsconfig/node18": "^18.2.4",
+    "@tsconfig/bun": "^1.0.7",
+    "typescript": "^5.5.4",
+    "type-fest": "^4.23.0",
+    "uglify-js": "^3.19.1"
+  },
+  "peerDependencies": {
+    "eslint": "^9.0.0",
+    "@typescript-eslint/utils": "^8.0.0"
+  }
+}

src/index.ts

@@ -0,0 +1,76 @@
+import { ESLintUtils, TSESLint } from "@typescript-eslint/utils";
+import { flip, partition, path, reject, startsWith } from "ramda";
+import type { PackageJson } from "type-fest";
+
+const messages = {
+  prohibited: "Importing {{name}} is not allowed.",
+  typeOnly: "Only 'import type' syntax is allowed for {{name}}.",
+};
+
+const createRule = ESLintUtils.RuleCreator.withoutDocs;
+
+const allowedDeps = createRule<
+  [
+    {
+      manifest: PackageJson.PackageJsonStandard;
+      typeOnly?: string[];
+    },
+  ],
+  keyof typeof messages
+>({
+  meta: {
+    messages,
+    type: "problem",
+    fixable: "code",
+    schema: [
+      {
+        type: "object",
+        properties: {
+          manifest: { type: "object" }, // @todo use settings
+          typeOnly: { type: "array", items: { type: "string" } },
+        },
+      },
+    ],
+  },
+  defaultOptions: [{ manifest: {}, typeOnly: [] }],
+  create: (ctx, [{ manifest, typeOnly: userTypeOnly = [] }]) => {
+    const lookup = flip(path)(manifest);
+    const excludeTypes = reject(startsWith("@types/"));
+    const isOptional = (name: string) =>
+      lookup(["peerDependenciesMeta", name, "optional"]) as boolean;
+
+    const allPeers = excludeTypes(Object.keys(manifest.peerDependencies || {}));
+    const [optPeers, reqPeers] = partition(isOptional, allPeers);
+    const production = Object.keys(manifest.dependencies || {});
+
+    const allowed = production.concat(reqPeers);
+    const typeOnly = optPeers.concat(userTypeOnly);
+
+    return {
+      ImportDeclaration: ({ source, importKind }) => {
+        const isTypeImport = importKind === "type";
+        if (
+          !source.value.startsWith(".") &&
+          !source.value.startsWith("node:")
+        ) {
+          const name = source.value
+            .split("/")
+            .slice(0, source.value.startsWith("@") ? 2 : 1)
+            .join("/");
+          const commons = { node: source, data: { name } };
+          if (!allowed.includes(name) && !isTypeImport) {
+            if (isTypeImport && !typeOnly.includes(name)) {
+              ctx.report({ ...commons, messageId: "typeOnly" });
+            } else {
+              ctx.report({ ...commons, messageId: "prohibited" });
+            }
+          }
+        }
+      },
+    };
+  },
+});
+
+export default {
+  rules: { "allowed-dependencies": allowedDeps },
+} satisfies TSESLint.Linter.Plugin;

tsconfig.cjs.json

@@ -0,0 +1,10 @@
+{
+  "extends": "@tsconfig/node18/tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "target": "ES6"
+  },
+  "include": ["src/index.ts"]
+}

tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "@tsconfig/bun/tsconfig.json",
+  "compilerOptions": {},
+  "include": ["src"]
+}