@sarj/eslint-plugin 9.17.0 → 9.17.1

package/dist/index.cjs

@@ -3335,6 +3335,8 @@ var TYPED_TAG_RE = /@(arg|argument|param|return|returns|yield|yields)\b/i;
 var VALUE_TAG_RE = /@(example|deprecated|see|remarks|throws|internal|public|alpha|beta|since|template|fileoverview)\b/i;
 var BOUNDARY_RE = /(?<=[.!?])["'`)\]]*\s+(?=[A-Z0-9`])/;
 var BULLET_RE = /^\s*(?:[-*+] |\d+[.)] )/;
+var HEADING_RE = /^[A-Za-z][A-Za-z ]+:$/;
+var TECHNICAL_ANCHOR_RE = /https?:\/\/|`[^`\n]+`|:[a-z][a-z0-9_-]*:|(["'])[^"'\n]+\1|\d|\b[a-z][a-z0-9]*[A-Z][A-Za-z0-9]*\b|\b[A-Za-z][A-Za-z0-9]*_[A-Za-z0-9_]+\b|(?:^|\s)(?:[\w.-]+\/)+[\w.-]+|\b[\w.-]+\.(?:py|pyi|js|jsx|ts|tsx|json|ya?ml|toml|csv|parquet|md)\b|->|=>|==|!=|<=|>=|\|/mu;
 function body(comment) {
   return comment.value.replace(/^\*/, "").split("\n").map((line) => line.replace(/^\s*\*?\s?/, "")).join("\n").trim();
 }
@@ -3354,6 +3356,17 @@ function sentenceUnits(text) {
   if (prose.length > 0) units += prose.join(" ").split(BOUNDARY_RE).length;
   return units;
 }
+function hasDocumentationStructure(text) {
+  const paragraphs = text.split(/\n\s*\n/u).filter((part) => part.trim().length > 0);
+  if (paragraphs.length >= 2) return true;
+  return text.split("\n").some((raw) => {
+    const line = raw.trim().replace(/^\*\s?/u, "").trim();
+    return line.length > 0 && (BULLET_RE.test(line) || HEADING_RE.test(line) || /(?:->|=>|\|)/u.test(line));
+  });
+}
+function hasTechnicalAnchor(text) {
+  return TECHNICAL_ANCHOR_RE.test(text);
+}
 function proseGroups(filename, sourceCode, includeValueTags = false) {
   if (isGeneratedFile(filename, sourceCode.text) || isStoryFile(filename) || isScriptFile(filename) || isTestFile(filename)) return [];
   const groups = [];
@@ -3420,10 +3433,8 @@ function typedFunction(node) {
 }
 
 // src/rules/no-long-comment.ts
-var LIST_ITEM_RE = /^\s*(?:[-*+] |\d+[.)] )/m;
-var DURABLE_RATIONALE_RE = /\b(?:adapter|algorithm|atomic|auth(?:entication|orization)?|backpressure|billing|cache|callback|cluster|commit|compatib|concurr|contract|credential|cross-node|csrf|definite-assignment|error|exception|external|failure|fallback|handshake|interop|invalid|invariant|legacy|migration|navigation|parse[rsd]?|payload|privacy|protocol|race|reject|reload|renderer|resume|retry|runtime|schema|security|selector|sentinel|serializ|socket|stage|third-party|token|transaction|upstream|wire|workaround)\b|\b(?:must|required|prevent|avoid)\b/iu;
-var VENDORED_BASENAME_RE = /(?:^|\/)(?:jquery(?:-ui)?(?:[.-]\d[^/]*)?|lodash(?:\.min)?|bootstrap(?:\.min)?|react(?:\.min)?)\.js$/iu;
 var EXCESSIVE_SENTENCE_COUNT = 8;
+var VERSIONED_DEPENDENCY_TREE_RE = /(?:^|\/)lib\/[^/]*-?v?\d+\.\d+(?:\.\d+)?[^/]*\//iu;
 function documentsTypeOrMember(sourceCode, comment) {
   const token = sourceCode.getTokenAfter(comment, { includeComments: false });
   if (token === null || token.loc.start.line !== comment.loc.end.line + 1) return false;
@@ -3447,11 +3458,11 @@ var no_long_comment_default = createRule({
   defaultOptions: [],
   create(context) {
     const normalizedFilename = context.filename.replaceAll("\\", "/");
-    if (VENDORED_BASENAME_RE.test(normalizedFilename)) return {};
+    if (VERSIONED_DEPENDENCY_TREE_RE.test(normalizedFilename)) return {};
     return {
       Program() {
         for (const group of proseGroups(context.filename, context.sourceCode)) {
-          if (group.comment.type !== "Block" || group.hasTypedTags || LIST_ITEM_RE.test(group.text) || DURABLE_RATIONALE_RE.test(group.text) || documentsTypedFunction(context.sourceCode, group.comment) || documentsTypeOrMember(context.sourceCode, group.comment) || sentenceUnits(group.text) < EXCESSIVE_SENTENCE_COUNT) continue;
+          if (group.comment.type !== "Block" || !group.comment.value.startsWith("*") || group.hasTypedTags || hasDocumentationStructure(group.text) || hasTechnicalAnchor(group.text) || documentsTypedFunction(context.sourceCode, group.comment) || documentsTypeOrMember(context.sourceCode, group.comment) || sentenceUnits(group.text) < EXCESSIVE_SENTENCE_COUNT) continue;
           context.report({ node: group.comment, messageId: "tooLong" });
         }
       }
@@ -12350,7 +12361,7 @@ var rules = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "9.17.0"
+  version: "9.17.1"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",

package/dist/index.d.cts

@@ -458,7 +458,7 @@ type FlatPreset = {
 declare const plugin: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "9.17.0";
+        readonly version: "9.17.1";
     };
     readonly rules: {
         readonly "duplicate-test-body": _typescript_eslint_utils_ts_eslint.RuleModule<"duplicateTestBody", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {

package/dist/index.d.ts

@@ -458,7 +458,7 @@ type FlatPreset = {
 declare const plugin: {
     readonly meta: {
         readonly name: "@sarj/eslint-plugin";
-        readonly version: "9.17.0";
+        readonly version: "9.17.1";
     };
     readonly rules: {
         readonly "duplicate-test-body": _typescript_eslint_utils_ts_eslint.RuleModule<"duplicateTestBody", readonly [], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {

package/dist/index.js

@@ -3293,6 +3293,8 @@ var TYPED_TAG_RE = /@(arg|argument|param|return|returns|yield|yields)\b/i;
 var VALUE_TAG_RE = /@(example|deprecated|see|remarks|throws|internal|public|alpha|beta|since|template|fileoverview)\b/i;
 var BOUNDARY_RE = /(?<=[.!?])["'`)\]]*\s+(?=[A-Z0-9`])/;
 var BULLET_RE = /^\s*(?:[-*+] |\d+[.)] )/;
+var HEADING_RE = /^[A-Za-z][A-Za-z ]+:$/;
+var TECHNICAL_ANCHOR_RE = /https?:\/\/|`[^`\n]+`|:[a-z][a-z0-9_-]*:|(["'])[^"'\n]+\1|\d|\b[a-z][a-z0-9]*[A-Z][A-Za-z0-9]*\b|\b[A-Za-z][A-Za-z0-9]*_[A-Za-z0-9_]+\b|(?:^|\s)(?:[\w.-]+\/)+[\w.-]+|\b[\w.-]+\.(?:py|pyi|js|jsx|ts|tsx|json|ya?ml|toml|csv|parquet|md)\b|->|=>|==|!=|<=|>=|\|/mu;
 function body(comment) {
   return comment.value.replace(/^\*/, "").split("\n").map((line) => line.replace(/^\s*\*?\s?/, "")).join("\n").trim();
 }
@@ -3312,6 +3314,17 @@ function sentenceUnits(text) {
   if (prose.length > 0) units += prose.join(" ").split(BOUNDARY_RE).length;
   return units;
 }
+function hasDocumentationStructure(text) {
+  const paragraphs = text.split(/\n\s*\n/u).filter((part) => part.trim().length > 0);
+  if (paragraphs.length >= 2) return true;
+  return text.split("\n").some((raw) => {
+    const line = raw.trim().replace(/^\*\s?/u, "").trim();
+    return line.length > 0 && (BULLET_RE.test(line) || HEADING_RE.test(line) || /(?:->|=>|\|)/u.test(line));
+  });
+}
+function hasTechnicalAnchor(text) {
+  return TECHNICAL_ANCHOR_RE.test(text);
+}
 function proseGroups(filename, sourceCode, includeValueTags = false) {
   if (isGeneratedFile(filename, sourceCode.text) || isStoryFile(filename) || isScriptFile(filename) || isTestFile(filename)) return [];
   const groups = [];
@@ -3378,10 +3391,8 @@ function typedFunction(node) {
 }
 
 // src/rules/no-long-comment.ts
-var LIST_ITEM_RE = /^\s*(?:[-*+] |\d+[.)] )/m;
-var DURABLE_RATIONALE_RE = /\b(?:adapter|algorithm|atomic|auth(?:entication|orization)?|backpressure|billing|cache|callback|cluster|commit|compatib|concurr|contract|credential|cross-node|csrf|definite-assignment|error|exception|external|failure|fallback|handshake|interop|invalid|invariant|legacy|migration|navigation|parse[rsd]?|payload|privacy|protocol|race|reject|reload|renderer|resume|retry|runtime|schema|security|selector|sentinel|serializ|socket|stage|third-party|token|transaction|upstream|wire|workaround)\b|\b(?:must|required|prevent|avoid)\b/iu;
-var VENDORED_BASENAME_RE = /(?:^|\/)(?:jquery(?:-ui)?(?:[.-]\d[^/]*)?|lodash(?:\.min)?|bootstrap(?:\.min)?|react(?:\.min)?)\.js$/iu;
 var EXCESSIVE_SENTENCE_COUNT = 8;
+var VERSIONED_DEPENDENCY_TREE_RE = /(?:^|\/)lib\/[^/]*-?v?\d+\.\d+(?:\.\d+)?[^/]*\//iu;
 function documentsTypeOrMember(sourceCode, comment) {
   const token = sourceCode.getTokenAfter(comment, { includeComments: false });
   if (token === null || token.loc.start.line !== comment.loc.end.line + 1) return false;
@@ -3405,11 +3416,11 @@ var no_long_comment_default = createRule({
   defaultOptions: [],
   create(context) {
     const normalizedFilename = context.filename.replaceAll("\\", "/");
-    if (VENDORED_BASENAME_RE.test(normalizedFilename)) return {};
+    if (VERSIONED_DEPENDENCY_TREE_RE.test(normalizedFilename)) return {};
     return {
       Program() {
         for (const group of proseGroups(context.filename, context.sourceCode)) {
-          if (group.comment.type !== "Block" || group.hasTypedTags || LIST_ITEM_RE.test(group.text) || DURABLE_RATIONALE_RE.test(group.text) || documentsTypedFunction(context.sourceCode, group.comment) || documentsTypeOrMember(context.sourceCode, group.comment) || sentenceUnits(group.text) < EXCESSIVE_SENTENCE_COUNT) continue;
+          if (group.comment.type !== "Block" || !group.comment.value.startsWith("*") || group.hasTypedTags || hasDocumentationStructure(group.text) || hasTechnicalAnchor(group.text) || documentsTypedFunction(context.sourceCode, group.comment) || documentsTypeOrMember(context.sourceCode, group.comment) || sentenceUnits(group.text) < EXCESSIVE_SENTENCE_COUNT) continue;
           context.report({ node: group.comment, messageId: "tooLong" });
         }
       }
@@ -12314,7 +12325,7 @@ var rules = {
 };
 var meta = {
   name: "@sarj/eslint-plugin",
-  version: "9.17.0"
+  version: "9.17.1"
 };
 var applicationOnlyRules = [
   "no-restricted-library-load",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sarj/eslint-plugin",
-  "version": "9.17.0",
+  "version": "9.17.1",
   "packageManager": "npm@11.19.0",
   "description": "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   "type": "module",