eslint-plugin-function-rule 0.0.3 → 0.0.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 REL1CX
+
+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,15 +1,135 @@
 # eslint-plugin-function-rule
 
-To install dependencies:
+ESLint plugin to write custom rules with JavaScript functions.
 
-```bash
-bun install
+> [!WARNING]
+> This package is a work in progress and is not yet ready for production use.
+
+## Installation
+
+```sh
+# npm
+npm install --save-dev eslint-plugin-function-rule
 ```
 
-To run:
+## Configure ESLint
+
+### Write function rules inline
+
+```js
+// eslint.config.ts
+
+import eslintJs from "@eslint/js";
+import type { RuleListener } from "@typescript-eslint/utils/ts-eslint";
+import functionRule from "eslint-plugin-function-rule";
+import { defineConfig } from "eslint/config";
+import tseslint from "typescript-eslint";
 
-```bash
-bun run index.ts
+export default defineConfig(
+  {
+    files: ["**/*.ts", "**/*.tsx"],
+    extends: [
+      eslintJs.configs.recommended,
+      tseslint.configs.recommended,
+    ],
+    languageOptions: {
+      parser: tseslint.parser,
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+  },
+  {
+    files: ["**/*.ts"],
+    rules: {
+      "function-rule/function-rule": "error",
+    },
+    plugins: {
+      "function-rule": functionRule((context) => {
+        return {
+          DebuggerStatement(node) {
+            context.report({
+              node,
+              message: "Remove 'debugger' from code.",
+
+              fix(fixer) {
+                return fixer.remove(node);
+              },
+            });
+          },
+        } satisfies RuleListener;
+      }),
+    },
+  },
+);
 ```
 
-This project was created using `bun init` in bun v1.3.2. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
+### Import function rules from modules
+
+```js
+// noDebugger.ts
+
+import type { RuleDefinition } from "@eslint/core";
+import type { RuleListener } from "@typescript-eslint/utils/ts-eslint";
+import { defineRuleVisitor } from "eslint-plugin-function-rule";
+
+// Define and document function rule options
+export interface noDebuggerOptions {
+  /**
+   * @deprecated Use bar instead
+   */
+  foo: string
+  bar: string
+}
+
+// Define and document function rule
+/**
+ * Remove debugger from code
+ *
+ * @param options The rule options
+ * @returns RuleFunction
+ */
+export function noDebugger(options?: noDebuggerOptions): RuleDefinition["create"] {
+  return (context) => {
+    return defineRuleVisitor({
+      DebuggerStatement(node) {
+        context.report({
+          node,
+          message: "Remove 'debugger' from code.",
+
+          fix(fixer) {
+            return fixer.remove(node);
+          },
+        });
+      },
+    });
+  };
+}
+```
+
+```js
+// Import and use function rule
+
+// ...
+import { noDebugger } from "./noDebugger.ts";
+
+const noDebuggerRule = noDebugger({ bar: "pass rule options" });
+
+export default defineConfig(
+  // ...
+  {
+    files: ["**/*.ts"],
+    rules: {
+      "function-rule/function-rule": "error",
+    },
+    plugins: {
+      "function-rule": functionRule((context) => {
+        return {
+          ...noDebuggerRule(context)
+        }
+      }),
+    },
+  },
+);
+```

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import * as _eslint_core0 from "@eslint/core";
-import { RuleDefinition } from "@eslint/core";
+import { RuleDefinition, RuleVisitor } from "@eslint/core";
 
 //#region index.d.ts
+declare function defineRuleVisitor(ruleVisitor: RuleVisitor): RuleVisitor;
 declare function functionRule(create: RuleDefinition["create"]): {
   readonly rules: {
     readonly "function-rule": {
@@ -20,9 +21,9 @@ declare function functionRule(create: RuleDefinition["create"]): {
         RuleOptions: unknown[];
         Node: unknown;
         MessageIds: string;
-      }>) => _eslint_core0.RuleVisitor;
+      }>) => RuleVisitor;
     };
   };
 };
 //#endregion
-export { functionRule as default };
+export { functionRule as default, defineRuleVisitor };

package/dist/index.js

@@ -1,4 +1,10 @@
 //#region index.ts
+const id = 0;
+function defineRuleVisitor(ruleVisitor) {
+	const visitor = {};
+	for (const key of Object.keys(ruleVisitor)) visitor[key + `[type!=${id}]`] = ruleVisitor[key];
+	return visitor;
+}
 function functionRule(create) {
 	return { rules: { "function-rule": {
 		meta: {
@@ -10,4 +16,4 @@ function functionRule(create) {
 }
 
 //#endregion
-export { functionRule as default };
+export { functionRule as default, defineRuleVisitor };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-function-rule",
-  "version": "0.0.3",
+  "version": "0.0.6",
   "license": "MIT",
   "sideEffects": false,
   "type": "module",
@@ -15,6 +15,7 @@
     "package.json"
   ],
   "dependencies": {
+    "string-ts": "^2.2.1",
     "@eslint/core": "^0.17.0"
   },
   "devDependencies": {