@bull-js/eslint-plugin 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bull contributors
+
+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

@@ -1,3 +1,22 @@
-# Temporary Holding Version
+# @bull-js/eslint-plugin
 
-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.
+[Bull](https://github.com/nicolasandradedesarrollosit/bull.js)'s file-level MVVM rules, underlined in
+your editor as you type. Same code and same messages as `bull build`.
+
+```bash
+npm install -D @bull-js/eslint-plugin eslint
+```
+
+```js
+// eslint.config.js
+import bull from "@bull-js/eslint-plugin";
+
+export default [...bull.configs.recommended];
+```
+
+Project-wide rules (missing layers, cycles, the composition root, the config itself) need the whole
+project, so they run in `bull check` and `bull build` instead.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import { Rule, Linter } from 'eslint';
+
+declare const rules: Record<string, Rule.RuleModule>;
+declare const plugin: {
+    meta: {
+        name: string;
+        version: string;
+    };
+    rules: Record<string, Rule.RuleModule>;
+    configs: Record<string, Linter.Config[]>;
+};
+
+export { plugin as default, rules };

package/dist/index.js

@@ -0,0 +1,87 @@
+// src/index.ts
+import {
+  extractFacts,
+  RULE_LIST,
+  resolveConfig,
+  runFileRules
+} from "@bull-js/core";
+import tsParser from "@typescript-eslint/parser";
+var configCache = /* @__PURE__ */ new Map();
+var resultCache = /* @__PURE__ */ new WeakMap();
+function configFor(context) {
+  const settings = context.settings?.bull ?? {};
+  const root = settings.root ?? context.cwd;
+  const key = JSON.stringify([root, settings]);
+  let config = configCache.get(key);
+  if (!config) {
+    config = resolveConfig(root, settings).config;
+    configCache.set(key, config);
+  }
+  return config;
+}
+function diagnosticsFor(context) {
+  const ast = context.sourceCode.ast;
+  let diagnostics = resultCache.get(ast);
+  if (!diagnostics) {
+    const facts = extractFacts(ast);
+    diagnostics = runFileRules(context.filename, facts, configFor(context));
+    resultCache.set(ast, diagnostics);
+  }
+  return diagnostics;
+}
+function createRule(meta) {
+  return {
+    meta: {
+      type: "problem",
+      docs: { description: `${meta.code}: ${meta.summary}` },
+      messages: { violation: "{{message}} {{fix}} ({{code}} \xB7 bull explain {{code}})" },
+      schema: []
+    },
+    create(context) {
+      return {
+        "Program:exit"() {
+          for (const d of diagnosticsFor(context)) {
+            if (d.code !== meta.code) continue;
+            const firstStep = meta.fix(d.data)[0] ?? "";
+            context.report({
+              messageId: "violation",
+              data: { message: d.message.replace(/`/g, "'"), fix: `\u2192 ${firstStep.replace(/`/g, "'")}`, code: d.code },
+              loc: d.range ? {
+                start: { line: d.range.start.line, column: d.range.start.column - 1 },
+                end: { line: d.range.end.line, column: d.range.end.column - 1 }
+              } : { line: 1, column: 0 }
+            });
+          }
+        }
+      };
+    }
+  };
+}
+var fileRules = RULE_LIST.filter((meta) => meta.scope === "file" && meta.category !== "config");
+var rules = Object.fromEntries(
+  fileRules.map((meta) => [meta.slug, createRule(meta)])
+);
+var plugin = {
+  meta: { name: "@bull-js/eslint-plugin", version: "0.2.0" },
+  rules,
+  configs: {}
+};
+plugin.configs.recommended = [
+  {
+    name: "bull/recommended",
+    files: ["src/**/*.{ts,tsx,js,jsx}"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: { ecmaFeatures: { jsx: true }, sourceType: "module" }
+    },
+    plugins: { bull: plugin },
+    rules: Object.fromEntries(
+      fileRules.map((meta) => [`bull/${meta.slug}`, meta.severity === "error" ? "error" : "warn"])
+    )
+  }
+];
+var index_default = plugin;
+export {
+  index_default as default,
+  rules
+};

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@bull-js/eslint-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "Bull's MVVM architecture rules, in your editor.",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://github.com/nicolasandradedesarrollosit/bull.js#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nicolasandradedesarrollosit/bull.js.git",
+    "directory": "packages/eslint-plugin"
+  },
+  "bugs": {
+    "url": "https://github.com/nicolasandradedesarrollosit/bull.js/issues"
+  },
+  "keywords": [
+    "eslint",
+    "eslintplugin",
+    "eslint-plugin",
+    "mvvm",
+    "architecture",
+    "react"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean --external @bull-js/core"
+  },
+  "peerDependencies": {
+    "eslint": ">=9"
+  },
+  "dependencies": {
+    "@bull-js/core": "^0.3.0",
+    "@typescript-eslint/parser": "^8.71.1"
+  }
+}