eslint-plugin-crisp 1.5.12 → 1.6.0

package/tests/rules/header-check.test.js

@@ -0,0 +1,69 @@
+import rule from "../../rules/header-check.js";
+import createRuleTester from "../rule-tester.js";
+
+const ruleTester = createRuleTester();
+
+ruleTester.run("header-check", rule, {
+  valid: [
+    {
+      code:
+        "/*\n * This file is part of Example\n *\n" +
+        " * Copyright (c) 2026 Crisp IM SAS\n" +
+        " * All rights belong to Crisp IM SAS\n */\nconst VALUE = 1;",
+      filename: "/project/example.js"
+    },
+    {
+      code: "/* Custom header */\nconst VALUE = 1;",
+      filename: "/project/example.ts",
+      options: [
+        {
+          patterns: [" Custom header "]
+        }
+      ]
+    },
+    {
+      code: "const VALUE = 1;",
+      filename: "/project/example.txt"
+    }
+  ],
+
+  invalid: [
+    {
+      code: "const VALUE = 1;",
+      filename: "/project/example.js",
+      errors: [
+        {
+          message: "File must start with the proper header."
+        }
+      ]
+    },
+    {
+      code: "/* Wrong header */\nconst VALUE = 1;",
+      filename: "/project/example.ts",
+      options: [
+        {
+          patterns: [" Expected header "]
+        }
+      ],
+      errors: [
+        {
+          message: "File must start with the proper header."
+        }
+      ]
+    },
+    {
+      code: "const VALUE = 1;",
+      filename: "/project/example.js",
+      options: [
+        {
+          patterns: ["["]
+        }
+      ],
+      errors: [
+        {
+          message: "File must start with the proper header."
+        }
+      ]
+    }
+  ]
+});

package/tests/rules/header-comments-check.test.js

@@ -0,0 +1,90 @@
+import rule from "../../rules/header-comments-check.js";
+import createRuleTester from "../rule-tester.js";
+
+const ruleTester = createRuleTester();
+const header = (name) => [
+  "/**************************************************************************",
+  ` * ${name}`,
+  " ***************************************************************************/"
+].join("\n");
+
+ruleTester.run("header-comments-check", rule, {
+  valid: [
+    {
+      filename: "/project/src/example.js",
+      code: `${header("IMPORTS")}\nimport value from "package";`
+    },
+    {
+      filename: "/project/src/example.ts",
+      code: `${header("CONSTANTS")}\nconst MAX_RETRIES = 3;\n\n${header("INSTANCES")}\nconst pattern = /value/;`
+    },
+    {
+      filename: "/project/src/example.js",
+      code:
+        `${header("TYPES")}\n/** @typedef {string} Identifier */\n\n` +
+        `${header("EXPORTS")}\nexport default {};`
+    },
+    {
+      filename: "/project/src/example.js",
+      code:
+        `${header("IMPORTS")}\nimport first from "first";\n` +
+        "import second from \"second\";"
+    },
+    {
+      filename: "/project/src/example.vue",
+      code: "import value from \"package\";\nconst MAX_RETRIES = 3;"
+    },
+    {
+      filename: "/project/src/example.js",
+      code: "function wrapper() {\n  const LOCAL_CONSTANT = 1;\n}"
+    }
+  ],
+
+  invalid: [
+    {
+      filename: "/project/src/example.js",
+      code: "import value from \"package\";",
+      errors: [
+        {
+          message: "Import group must be preceded by a 'IMPORTS' comment block"
+        }
+      ]
+    },
+    {
+      filename: "/project/src/example.ts",
+      code: "const MAX_RETRIES = 3;",
+      errors: [
+        {
+          message: "Variable group must be preceded by a 'CONSTANTS' comment block"
+        }
+      ]
+    },
+    {
+      filename: "/project/src/example.js",
+      code: "const patterns = [/first/, /second/];",
+      errors: [
+        {
+          message: "Regex group must be preceded by a 'INSTANCES' comment block"
+        }
+      ]
+    },
+    {
+      filename: "/project/src/example.js",
+      code: "/** @typedef {string} Identifier */\nconst value = 1;",
+      errors: [
+        {
+          message: "Type comments group must be preceded by a 'TYPES' comment block"
+        }
+      ]
+    },
+    {
+      filename: "/project/src/example.js",
+      code: "export default {};",
+      errors: [
+        {
+          message: "Export group must be preceded by a 'EXPORTS' comment block"
+        }
+      ]
+    }
+  ]
+});

package/tests/rules/import-group-comment.test.js

@@ -0,0 +1,88 @@
+import rule from "../../rules/import-group-comment.js";
+import createRuleTester from "../rule-tester.js";
+
+const ruleTester = createRuleTester();
+
+ruleTester.run("import-group-comment", rule, {
+  valid: [
+    {
+      filename: "/project/src/example.js",
+      code: "// NPM\nimport lodash from \"lodash\";"
+    },
+    {
+      filename: "/project/src/components/example.js",
+      code: "// PROJECT: COMPONENTS\nimport Button from \"./Button.js\";"
+    },
+    {
+      filename: "/project/src/example.js",
+      code: "// PROJECT: HELPERS\n// @ts-ignore\nimport helper from \"@/helpers/helper.js\";"
+    },
+    {
+      filename: "/project/src/example.js",
+      options: [{ "^virtual:": "GENERATED" }],
+      code: "// PROJECT: GENERATED\nimport value from \"virtual:value\";"
+    },
+    {
+      filename: "/project/src/Component.vue",
+      code: "// TYPES\n/** @typedef {string} Identifier */"
+    },
+    {
+      code: "// PROJECT: MAIN\nimport value from \"./value.js\";"
+    },
+    {
+      code: "// NPM\nimport value from \"package\";",
+      options: [{ "[": "INVALID" }]
+    }
+  ],
+
+  invalid: [
+    {
+      filename: "/project/src/example.js",
+      code: "// PROJECT: HELPERS\nimport lodash from \"lodash\";",
+      errors: [
+        {
+          message: "Import \"lodash\" should be in the \"NPM\" group."
+        }
+      ]
+    },
+    {
+      filename: "/project/src/example.js",
+      code: "// NPM\n\nimport lodash from \"lodash\";",
+      output: "// NPM\nimport lodash from \"lodash\";",
+      errors: [
+        {
+          message: "Import group comment must be immediately followed by an import (no blank line)."
+        }
+      ]
+    },
+    {
+      filename: "/project/src/example.js",
+      options: [{ "^virtual:": "GENERATED" }],
+      code: "// NPM\nimport value from \"virtual:value\";",
+      errors: [
+        {
+          message: "Import \"virtual:value\" should be in the \"PROJECT: GENERATED\" group."
+        }
+      ]
+    },
+    {
+      filename: "/project/src/Component.vue",
+      code: "/** @typedef {string} Identifier */",
+      errors: [
+        {
+          message: "Type comments group must be preceded by a '// TYPES' comment"
+        }
+      ]
+    },
+    {
+      filename: "/project/src/Component.vue",
+      code: "// TYPES\n\n/** @typedef {string} Identifier */",
+      output: "// TYPES\n/** @typedef {string} Identifier */",
+      errors: [
+        {
+          message: "Type group comment must be immediately followed by a type comment (no blank line)."
+        }
+      ]
+    }
+  ]
+});

package/tests/rules/import-group-order.test.js

@@ -0,0 +1,58 @@
+import rule from "../../rules/import-group-order.js";
+import createRuleTester from "../rule-tester.js";
+
+const ruleTester = createRuleTester();
+
+ruleTester.run("import-group-order", rule, {
+  valid: [
+    {
+      code: [
+        "// NPM",
+        "import lodash from \"lodash\";",
+        "// PROJECT: COMPONENTS",
+        "import Button from \"@/components/Button.js\";",
+        "// PROJECT: HELPERS",
+        "import helper from \"@/helpers/helper.js\";",
+        "// TYPES",
+        "import \"./types.js\";"
+      ].join("\n")
+    },
+    {
+      code: "// PROJECT: UNKNOWN\nimport value from \"./value.js\";"
+    },
+    {
+      code: "import first from \"first\";\nimport second from \"second\";"
+    }
+  ],
+
+  invalid: [
+    {
+      code: [
+        "// PROJECT: HELPERS",
+        "import helper from \"@/helpers/helper.js\";",
+        "// NPM",
+        "import lodash from \"lodash\";"
+      ].join("\n"),
+      errors: [
+        {
+          message: "Import group 'NPM' should be before 'PROJECT: HELPERS' group."
+        }
+      ]
+    },
+    {
+      code: [
+        "// NPM",
+        "import lodash from \"lodash\";",
+        "// TYPES",
+        "import \"./types.js\";",
+        "// PROJECT: COMPONENTS",
+        "import Button from \"@/components/Button.js\";"
+      ].join("\n"),
+      errors: [
+        {
+          message: "Import group 'PROJECT: COMPONENTS' should be after 'NPM' group."
+        }
+      ]
+    }
+  ]
+});

package/tests/rules/jsdoc-align-params.test.js

@@ -0,0 +1,32 @@
+import rule from "../../rules/jsdoc-align-params.js";
+import createRuleTester, { withoutFixes } from "../rule-tester.js";
+
+const ruleTester = createRuleTester();
+
+ruleTester.run("jsdoc-align-params", withoutFixes(rule), {
+  valid: [
+    "/**\n * Fetch a value.\n * @public\n * @param  {string} value\n * @return {string} Result.\n */\nfunction fetchValue(value) { return value; }",
+    "/**\n * Produce values.\n * @protected\n * @internal\n * @generator\n * @param  {number} count\n * @yields {number} Next value.\n */\nfunction* values(count) { yield count; }",
+    "/** A compact comment. */\nconst value = 1;",
+    "/**\n * Missing scope is ignored.\n * @param {string} value\n */\nfunction ignored(value) { return value; }"
+  ],
+
+  invalid: [
+    {
+      code: "/**\n * Fetch a value.\n * @public\n * @param {string} value\n * @return {string} Result.\n */\nfunction fetchValue(value) { return value; }",
+      errors: [
+        {
+          message: "JSDoc alignment issue"
+        }
+      ]
+    },
+    {
+      code: "/**\n * Produce values.\n * @private\n * @generator\n * @param {number} count\n * @yields {number} Next value.\n */\nfunction* values(count) { yield count; }",
+      errors: [
+        {
+          message: "JSDoc alignment issue"
+        }
+      ]
+    }
+  ]
+});

package/tests/rules/jsdoc-check-indentation.test.js

@@ -0,0 +1,45 @@
+import rule from "../../rules/jsdoc-check-indentation.js";
+import createRuleTester from "../rule-tester.js";
+
+const ruleTester = createRuleTester();
+
+ruleTester.run("jsdoc-check-indentation", rule, {
+  valid: [
+    "/**\n * A description.\n * @returns {boolean} The result.\n */\nfunction check() { return true; }",
+    "/**\n * ```js\n *  const indented = true;\n * ```\n */\nfunction example() {}",
+    "/**\n * @example\n *  const indented = true;\n */\nfunction example() {}",
+    {
+      code: "/**\n * @custom\n *  deliberately indented\n */\nfunction example() {}",
+      options: [
+        {
+          excludeTags: ["custom"]
+        }
+      ]
+    },
+    "/**\n * A continued line \\\n *   remains part of the description.\n */\nfunction example() {}"
+  ],
+
+  invalid: [
+    {
+      code: "/**\n *  Unexpected indentation.\n */\nfunction example() {}",
+      errors: [
+        {
+          message: "There must be no indentation."
+        }
+      ]
+    },
+    {
+      code: "/**\n * @example\n *  const indented = true;\n */\nfunction example() {}",
+      options: [
+        {
+          excludeTags: []
+        }
+      ],
+      errors: [
+        {
+          message: "There must be no indentation."
+        }
+      ]
+    }
+  ]
+});

package/tests/rules/jsdoc-check-optional-params.test.js

@@ -0,0 +1,40 @@
+import rule from "../../rules/jsdoc-check-optional-params.js";
+import createRuleTester from "../rule-tester.js";
+
+const ruleTester = createRuleTester();
+
+ruleTester.run("jsdoc-check-optional-params", rule, {
+  valid: [
+    "/** @param {string} value */\nfunction required(value) {}",
+    "/** @param {string} [value] */\nfunction optional(value = \"default\") {}",
+    "/** @param {number} [count=1] */\nconst optional = function(count = 1) {};",
+    "function undocumented(value) {}"
+  ],
+
+  invalid: [
+    {
+      code: "/** @param {string} value */\nfunction optional(value = \"default\") {}",
+      errors: [
+        {
+          message: "Optional parameters in JSDoc should be surrounded by brackets"
+        }
+      ]
+    },
+    {
+      code: "/** @param {string} [value] */\nfunction required(value) {}",
+      errors: [
+        {
+          message: "Non-optional parameters in JSDoc should not be surrounded by brackets"
+        }
+      ]
+    },
+    {
+      code: "/** @param {Object} options */\nfunction configure({ enabled }) {}",
+      errors: [
+        {
+          message: "No matching JSDoc param found"
+        }
+      ]
+    }
+  ]
+});

package/tests/rules/jsdoc-description-length.test.js

@@ -0,0 +1,60 @@
+import rule from "../../rules/jsdoc-description-length.js";
+import createRuleTester from "../rule-tester.js";
+
+const ruleTester = createRuleTester();
+
+ruleTester.run("jsdoc-description-length", rule, {
+  valid: [
+    "/**\n * A single-line description.\n */\nfunction example() {}",
+    "/**\n * A description that continues \\\n *   on the next line.\n * @returns {boolean} The result.\n */\nfunction example() { return true; }",
+    {
+      code: "/**\n * First line \\\n *   second line \\\n *   third line.\n */\nfunction example() {}",
+      options: [
+        {
+          maxLines: 3
+        }
+      ]
+    },
+    "/********************\n * Section header\n ********************/\nconst value = true;"
+  ],
+
+  invalid: [
+    {
+      code: "/**\n * First line \\\n *   second line \\\n *   third line.\n */\nfunction example() {}",
+      errors: [
+        {
+          message: "JSDoc description must not exceed 2 line(s)."
+        }
+      ]
+    },
+    {
+      code: "/**\n * First line\n *   second line.\n */\nfunction example() {}",
+      errors: [
+        {
+          message: "Multi-line JSDoc description must end with '\\' before each continuation."
+        }
+      ]
+    },
+    {
+      code: "/**\n * First line \\\n * second line.\n */\nfunction example() {}",
+      errors: [
+        {
+          message: "Continuation lines in JSDoc description must be indented with 3 spaces after '*'."
+        }
+      ]
+    },
+    {
+      code: "/**\n * First line \\\n *   second line.\n */\nfunction example() {}",
+      options: [
+        {
+          maxLines: 1
+        }
+      ],
+      errors: [
+        {
+          message: "JSDoc description must not exceed 1 line(s)."
+        }
+      ]
+    }
+  ]
+});

package/tests/rules/jsdoc-description-multiline.test.js

@@ -0,0 +1,34 @@
+import rule from "../../rules/jsdoc-description-multiline.js";
+import createRuleTester from "../rule-tester.js";
+
+const ruleTester = createRuleTester();
+
+ruleTester.run("jsdoc-description-multiline", rule, {
+  valid: [
+    "/**\n * A multiline description.\n */\nfunction example() {}",
+    "/** */\nfunction empty() {}",
+    "/** @public */\nfunction tagged() {}",
+    "/**\n * @returns {boolean} The result.\n */\nfunction tagged() { return true; }"
+  ],
+
+  invalid: [
+    {
+      code: "/** A compact description. */\nfunction example() {}",
+      output: "/**\n * A compact description.\n */\nfunction example() {}",
+      errors: [
+        {
+          message: "Function JSDoc descriptions must use multiline formatting."
+        }
+      ]
+    },
+    {
+      code: "function outer() {\n  /** An indented description. */\n  function inner() {}\n}",
+      output: "function outer() {\n  /**\n   * An indented description.\n   */\n  function inner() {}\n}",
+      errors: [
+        {
+          message: "Function JSDoc descriptions must use multiline formatting."
+        }
+      ]
+    }
+  ]
+});

package/tests/rules/jsdoc-enforce-access.test.js

@@ -0,0 +1,66 @@
+import rule from "../../rules/jsdoc-enforce-access.js";
+import createRuleTester from "../rule-tester.js";
+
+const ruleTester = createRuleTester();
+
+ruleTester.run("jsdoc-enforce-access", rule, {
+  valid: [
+    "/** @public */\nfunction publicFunction() {}",
+    "class Example {\n  /** @protected */\n  method() {}\n}",
+    "const object = {\n  /** @private */\n  method: () => {}\n};",
+    "/** @internal */\nconst internal = function() {};",
+    "/** @public */\n// Additional context.\nfunction documented() {}",
+    "function undocumented() {}"
+  ],
+
+  invalid: [
+    {
+      code: "/** A function. */\nfunction example() {}",
+      errors: [
+        {
+          message: "JSDoc comment should contain @public, @protected, @private or @internal"
+        }
+      ]
+    },
+    {
+      code: "class Example {\n  /** A method. */\n  method() {}\n}",
+      errors: [
+        {
+          message: "JSDoc comment should contain @public, @protected, @private or @internal"
+        }
+      ]
+    },
+    {
+      code: "const object = {\n  /** A property method. */\n  method: () => {}\n};",
+      errors: [
+        {
+          message: "JSDoc comment should contain @public, @protected, @private or @internal"
+        }
+      ]
+    },
+    {
+      code: "const expression = /** A function expression. */ function() {};",
+      errors: [
+        {
+          message: "JSDoc comment should contain @public, @protected, @private or @internal"
+        }
+      ]
+    },
+    {
+      code: "/** @publicity */\nfunction example() {}",
+      errors: [
+        {
+          message: "JSDoc comment should contain @public, @protected, @private or @internal"
+        }
+      ]
+    },
+    {
+      code: "/** A function. */\n// Additional context.\nfunction example() {}",
+      errors: [
+        {
+          message: "JSDoc comment should contain @public, @protected, @private or @internal"
+        }
+      ]
+    }
+  ]
+});

package/tests/rules/jsdoc-enforce-classdesc.test.js

@@ -0,0 +1,39 @@
+import rule from "../../rules/jsdoc-enforce-classdesc.js";
+import createRuleTester from "../rule-tester.js";
+
+const ruleTester = createRuleTester();
+
+ruleTester.run("jsdoc-enforce-classdesc", rule, {
+  valid: [
+    "/**\n * @classdesc Represents an example.\n */\nclass Example {}",
+    "class Undocumented {}",
+    "/** A factory function. */\nfunction createExample() {}"
+  ],
+
+  invalid: [
+    {
+      code: "/** Represents an example. */\nclass Example {}",
+      errors: [
+        {
+          message: "JSDoc class header should include @classdesc"
+        }
+      ]
+    },
+    {
+      code: "/**\n * @classdesc\n */\nclass Example {}",
+      errors: [
+        {
+          message: "The @classdesc tag in JSDoc class header should have a non-empty description"
+        }
+      ]
+    },
+    {
+      code: "/**\n * @classdesc   \n */\nclass Example {}",
+      errors: [
+        {
+          message: "The @classdesc tag in JSDoc class header should have a non-empty description"
+        }
+      ]
+    }
+  ]
+});

package/tests/rules/jsdoc-no-param-return.test.js

@@ -0,0 +1,47 @@
+import rule from "../../rules/jsdoc-no-param-return.js";
+import createRuleTester, { withoutFixes } from "../rule-tester.js";
+
+const ruleTester = createRuleTester();
+
+ruleTester.run("jsdoc-no-param-return", withoutFixes(rule), {
+  valid: [
+    "/**\n * Describe a function without signature tags.\n * @public\n */\nfunction example(value) { return value; }",
+    "/**\n * @property {string} value A property.\n * @type {Object}\n */\nconst object = {};",
+    "// @param is ordinary line-comment text.\nfunction example(value) {}"
+  ],
+
+  invalid: [
+    {
+      code: "/**\n * @param {string} value A value.\n */\nfunction example(value) {}",
+      errors: [
+        {
+          message: "@param and @return tags are not permitted in JSDoc, rely on the TypeScript signature instead."
+        }
+      ]
+    },
+    {
+      code: "/**\n * @arg {string} value A value.\n * @argument {number} count A count.\n */\nfunction example(value, count) {}",
+      errors: [
+        {
+          message: "@param and @return tags are not permitted in JSDoc, rely on the TypeScript signature instead."
+        }
+      ]
+    },
+    {
+      code: "/**\n * @return {string} A value.\n * @returns {string} Another value.\n */\nfunction example() { return \"value\"; }",
+      errors: [
+        {
+          message: "@param and @return tags are not permitted in JSDoc, rely on the TypeScript signature instead."
+        }
+      ]
+    },
+    {
+      code: "/**\n * @yield {number} A value.\n * @yields {number} Another value.\n */\nfunction* example() { yield 1; }",
+      errors: [
+        {
+          message: "@param and @return tags are not permitted in JSDoc, rely on the TypeScript signature instead."
+        }
+      ]
+    }
+  ]
+});