@sarj/eslint-plugin 17.1.0 → 17.1.1

package/dist/index.cjs

@@ -164,28 +164,21 @@ function hasTypeInformation(services) {
   return services?.program != null && services.esTreeNodeToTSNodeMap != null && services.tsNodeToESTreeNodeMap != null;
 }
 function createNativeRule(config, url) {
-  const input = { ...config };
-  const originalMeta = Object.hasOwn(input, "meta") ? input.meta : config.meta;
+  const name = config.name;
+  const originalMeta = config.meta;
   const metadataSnapshot = { ...originalMeta };
   const declaredMetaDefaults = Object.hasOwn(metadataSnapshot, "defaultOptions") ? metadataSnapshot.defaultOptions : originalMeta.defaultOptions;
-  const declaredLegacyDefaults = Object.hasOwn(input, "defaultOptions") ? input.defaultOptions : config.defaultOptions;
-  const descriptor = {
-    ...input,
-    name: Object.hasOwn(input, "name") ? input.name : config.name,
-    create: Object.hasOwn(input, "create") ? input.create : config.create,
-    meta: metadataSnapshot
-  };
-  if (declaredLegacyDefaults !== void 0) descriptor.defaultOptions = declaredLegacyDefaults;
-  if (declaredMetaDefaults !== void 0) descriptor.meta.defaultOptions = declaredMetaDefaults;
-  const { defaultOptions: metaDefaults, schema, ...metadata } = descriptor.meta;
+  const declaredLegacyDefaults = config.defaultOptions;
+  if (declaredMetaDefaults !== void 0) metadataSnapshot.defaultOptions = declaredMetaDefaults;
+  const { defaultOptions: metaDefaults, schema, ...metadata } = metadataSnapshot;
   const metadataDefaults = metaDefaults === void 0 ? void 0 : ownTuple(metaDefaults);
-  const legacyDefaults = metadataDefaults === void 0 && descriptor.defaultOptions !== void 0 ? ownTuple(descriptor.defaultOptions) : void 0;
+  const legacyDefaults = metadataDefaults === void 0 && declaredLegacyDefaults !== void 0 ? ownTuple(declaredLegacyDefaults) : void 0;
   const ownedMetadata = {
     ...metadata,
-    docs: { ...metadata.docs, url: url(descriptor.name) },
+    docs: { ...metadata.docs, url: url(name) },
     schema: schemaList(schema) ? [...schema] : schema
   };
-  if (metadataDefaults === void 0 && Object.hasOwn(descriptor.meta, "defaultOptions")) {
+  if (metadataDefaults === void 0 && Object.hasOwn(metadataSnapshot, "defaultOptions")) {
     Object.defineProperty(ownedMetadata, "defaultOptions", {
       value: void 0,
       configurable: true,
@@ -195,25 +188,25 @@ function createNativeRule(config, url) {
   }
   const meta2 = metadataDefaults === void 0 ? ownedMetadata : { ...ownedMetadata, defaultOptions: metadataDefaults };
   const base = {
-    name: descriptor.name,
-    defaultOptions: descriptor.defaultOptions,
+    name,
+    defaultOptions: declaredLegacyDefaults,
     meta: meta2
   };
-  if (hasNoDefaultOptions(descriptor)) {
-    const create2 = descriptor.create;
+  if (hasNoDefaultOptions(config, declaredMetaDefaults, declaredLegacyDefaults)) {
+    const create2 = config.create;
     return { ...base, create(context) {
       return create2(context, []);
     } };
   }
   const defaults = metadataDefaults ?? legacyDefaults;
   if (defaults === void 0) throw new TypeError("Declared defaults disappeared while creating the rule.");
-  const create = descriptor.create;
+  const create = config.create;
   return { ...base, create(context) {
     return create(context, import_utils2.ESLintUtils.applyDefault(defaults, context.options));
   } };
 }
-function hasNoDefaultOptions(config) {
-  return config.meta.defaultOptions === void 0 && config.defaultOptions === void 0;
+function hasNoDefaultOptions(_config, metaDefaults, legacyDefaults) {
+  return metaDefaults === void 0 && legacyDefaults === void 0;
 }
 function schemaList(schema) {
   return Array.isArray(schema);
@@ -231,13 +224,12 @@ var KEBAB_CASE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
 var MAX_SUMMARY_LENGTH = 160;
 function createRule(config) {
   const { documentation } = config;
-  const eslintConfig = config;
-  const rule = createNativeRule(eslintConfig, examplesUrl);
+  const rule = createNativeRule(config, examplesUrl);
   if (documentation !== void 0) {
     Object.defineProperty(rule, "documentation", {
       configurable: false,
       enumerable: false,
-      value: nativeSpec(eslintConfig, documentation),
+      value: nativeSpec(rule, documentation),
       writable: false
     });
   }
@@ -1026,19 +1018,22 @@ var NO_FRONTEND_COMMENTS_DOCUMENTATION = {
   defaultLevel: "warning",
   summary: "Express frontend behavior through code instead of prose comments.",
   rationale: "Frontend comments can drift from executable behavior and conceal names, types or structure that should communicate the same information.",
-  remediation: "Use clear names, types, helpers and assertions, then remove the comment. Move tool settings into their owning configuration where supported. Review behavioral directives and legal notices before editing; no automatic deletion changes those contracts.",
+  remediation: "Use clear names, types, helpers and assertions, then remove the comment. Move tool settings into their owning configuration where supported. Whitespace-only single-line comments can be replaced with a space; review all other comments and their contracts manually.",
   category: "maintainability",
-  autofix: "none",
+  autofix: "safe",
   limitations: [
     "Reports every actual line, block, JSDoc and JSX comment in maintained frontend source, including legal notices and executable directives. The existing no-test-comments rule owns maintained test files and applies the same blanket frontend ban, avoiding duplicate diagnostics between these two rules. Strings, template data, rendered JSX text and generated/vendor sources are excluded.",
     "Frontend scope is established by JSX-capable extensions, use client/use server directives, framework imports, or the nearest package manifest declaring a frontend framework dependency. Pure helpers in those packages are included. Set allFiles: true on both this rule and no-test-comments in a frontend ESLint override for dependency-free or unsupported frameworks; file names alone do not infer application ownership.",
-    "This is a blanket policy warning, including comments preserved by narrower comment-hygiene rules. Behavioral annotations, JavaScript type comments, required legal notices and tool directives require manual migration or an explicit policy exception; the rule never automatically deletes them."
+    "This is a blanket policy warning, including comments preserved by narrower comment-hygiene rules. Behavioral annotations, JavaScript type comments, required legal notices and tool directives require manual migration or an explicit policy exception; the rule never automatically deletes them.",
+    "Automatic fixes replace only whitespace-only line or block comment tokens containing no line terminators with one separating space. Every existing line terminator is preserved. Comments overlapping JSX regions, multiline comments, nonempty comments and comments owned by the test rule remain manual."
   ],
   examples: [
     { id: "frontend-prose", title: "Express view behavior in code", outcome: "match", files: [{ path: "src/view.tsx", source: "// Show current status\nexport const View = () => <p>Ready</p>;" }], focusPath: "src/view.tsx", expectedCount: 1, public: true },
     { id: "named-view", title: "The view expresses its behavior", outcome: "no-match", files: [{ path: "src/view.tsx", source: "export const View = () => <p>Ready</p>;" }], focusPath: "src/view.tsx", expectedCount: 0, public: true },
     { id: "package-helper", scenarioId: "package", title: "A plain helper belongs to its frontend package", outcome: "match", files: [{ path: "package.json", source: '{"private":true,"dependencies":{"react":"19.2.0"}}' }, { path: "src/helper.ts", source: "// Frontend helper\nexport const ready = true;" }], focusPath: "src/helper.ts", expectedCount: 1, public: true },
-    { id: "package-helper-code", scenarioId: "package", title: "The helper expresses its behavior in code", outcome: "no-match", files: [{ path: "package.json", source: '{"private":true,"dependencies":{"react":"19.2.0"}}' }, { path: "src/helper.ts", source: "export const ready = true;" }], focusPath: "src/helper.ts", expectedCount: 0, public: true }
+    { id: "package-helper-code", scenarioId: "package", title: "The helper expresses its behavior in code", outcome: "no-match", files: [{ path: "package.json", source: '{"private":true,"dependencies":{"react":"19.2.0"}}' }, { path: "src/helper.ts", source: "export const ready = true;" }], focusPath: "src/helper.ts", expectedCount: 0, public: true },
+    { id: "empty-comment-separator", scenarioId: "empty-comment", title: "Keep a separating space when removing an empty comment", outcome: "match", files: [{ path: "src/helper.tsx", source: "export function identity(value: number) { return/**/value; }" }], fixedFiles: [{ path: "src/helper.tsx", source: "export function identity(value: number) { return value; }" }], focusPath: "src/helper.tsx", expectedCount: 1, public: true },
+    { id: "empty-comment-removed", scenarioId: "empty-comment", title: "Preserve the return expression without a comment", outcome: "no-match", files: [{ path: "src/helper.tsx", source: "export function identity(value: number) { return value; }" }], focusPath: "src/helper.tsx", expectedCount: 0, public: true }
   ]
 };
 var no_frontend_comments_default = createRule({
@@ -1046,6 +1041,7 @@ var no_frontend_comments_default = createRule({
   documentation: NO_FRONTEND_COMMENTS_DOCUMENTATION,
   meta: {
     type: "suggestion",
+    fixable: "code",
     docs: { description: NO_FRONTEND_COMMENTS_DOCUMENTATION.summary },
     schema: [{ type: "object", properties: { allFiles: { type: "boolean" } }, additionalProperties: false }],
     messages: { noFrontendComments: "Frontend comments are prohibited; express the behavior in names, types or code and review any directive or legal contract before removing it." }
@@ -1053,15 +1049,76 @@ var no_frontend_comments_default = createRule({
   defaultOptions: [{}],
   create(context, [options]) {
     if (isGeneratedFile(context, context.sourceCode.text) || ownsTestComments(context)) return {};
+    const jsxRanges = [];
+    let ambiguousJSX = false;
+    function captureJSX(node) {
+      const range = sourceRange(node.range, context.sourceCode.text.length);
+      if (range === null) {
+        ambiguousJSX = true;
+        return;
+      }
+      const previous = jsxRanges.at(-1);
+      if (previous === void 0 || range.start >= previous.end) {
+        jsxRanges.push(range);
+        return;
+      }
+      if (range.start < previous.start || range.end > previous.end) ambiguousJSX = true;
+    }
     return {
-      Program() {
+      JSXElement: captureJSX,
+      JSXFragment: captureJSX,
+      "Program:exit"() {
         const comments = context.sourceCode.getAllComments();
         if (comments.length === 0 || !(options.allFiles === true || isFrontendSource(context))) return;
-        for (const comment of comments) context.report({ node: comment, messageId: "noFrontendComments" });
+        const ranges = ambiguousJSX ? /* @__PURE__ */ new Map() : emptyCommentRanges(context.sourceCode.text, comments, jsxRanges);
+        for (const comment of comments) context.report({
+          node: comment,
+          messageId: "noFrontendComments",
+          fix(fixer) {
+            const range = ranges.get(comment);
+            return range === void 0 ? null : fixer.replaceTextRange([range.start, range.end], " ");
+          }
+        });
       }
     };
   }
 });
+function emptyCommentRanges(text, comments, jsxRanges) {
+  const ranges = /* @__PURE__ */ new Map();
+  let previousEnd = 0;
+  let jsxIndex = 0;
+  for (const comment of comments) {
+    const range = sourceRange(comment.range, text.length);
+    if (range === null || range.start < previousEnd) {
+      ranges.clear();
+      return ranges;
+    }
+    previousEnd = range.end;
+    let jsx = jsxRanges[jsxIndex];
+    while (jsx !== void 0 && jsx.end <= range.start) {
+      jsxIndex += 1;
+      jsx = jsxRanges[jsxIndex];
+    }
+    if (jsx !== void 0 && range.start < jsx.end && range.end > jsx.start) continue;
+    const empty = emptyCommentRange(text, comment);
+    if (empty !== null) ranges.set(comment, empty);
+  }
+  return ranges;
+}
+function sourceRange(range, length) {
+  const [start, end] = range;
+  return Number.isInteger(start) && Number.isInteger(end) && start >= 0 && end > start && end <= length ? { start, end } : null;
+}
+function emptyCommentRange(text, comment) {
+  const range = sourceRange(comment.range, text.length);
+  if (range === null || comment.value.trim() !== "") return null;
+  const { start, end } = range;
+  const raw = text.slice(start, end);
+  if (/[\r\n\u2028\u2029]/u.test(raw)) return null;
+  if (comment.type === "Line" && raw.startsWith("//") && raw.slice(2).trim() === "") return range;
+  if (comment.type === "Block" && raw.startsWith("/*") && raw.endsWith("*/") && raw.slice(2, -2).trim() === "") return range;
+  return null;
+}
 
 // src/rules/prefer-dependency-interface.ts
 var import_utils7 = require("@typescript-eslint/utils");
@@ -4644,7 +4701,7 @@ function isSearchParamReceiver(call, services) {
 // package.json
 var package_default = {
   name: "@sarj/eslint-plugin",
-  version: "17.1.0",
+  version: "17.1.1",
   packageManager: "npm@12.2.1",
   description: "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   type: "module",

package/dist/index.js

@@ -113,28 +113,21 @@ function hasTypeInformation(services) {
   return services?.program != null && services.esTreeNodeToTSNodeMap != null && services.tsNodeToESTreeNodeMap != null;
 }
 function createNativeRule(config, url) {
-  const input = { ...config };
-  const originalMeta = Object.hasOwn(input, "meta") ? input.meta : config.meta;
+  const name = config.name;
+  const originalMeta = config.meta;
   const metadataSnapshot = { ...originalMeta };
   const declaredMetaDefaults = Object.hasOwn(metadataSnapshot, "defaultOptions") ? metadataSnapshot.defaultOptions : originalMeta.defaultOptions;
-  const declaredLegacyDefaults = Object.hasOwn(input, "defaultOptions") ? input.defaultOptions : config.defaultOptions;
-  const descriptor = {
-    ...input,
-    name: Object.hasOwn(input, "name") ? input.name : config.name,
-    create: Object.hasOwn(input, "create") ? input.create : config.create,
-    meta: metadataSnapshot
-  };
-  if (declaredLegacyDefaults !== void 0) descriptor.defaultOptions = declaredLegacyDefaults;
-  if (declaredMetaDefaults !== void 0) descriptor.meta.defaultOptions = declaredMetaDefaults;
-  const { defaultOptions: metaDefaults, schema, ...metadata } = descriptor.meta;
+  const declaredLegacyDefaults = config.defaultOptions;
+  if (declaredMetaDefaults !== void 0) metadataSnapshot.defaultOptions = declaredMetaDefaults;
+  const { defaultOptions: metaDefaults, schema, ...metadata } = metadataSnapshot;
   const metadataDefaults = metaDefaults === void 0 ? void 0 : ownTuple(metaDefaults);
-  const legacyDefaults = metadataDefaults === void 0 && descriptor.defaultOptions !== void 0 ? ownTuple(descriptor.defaultOptions) : void 0;
+  const legacyDefaults = metadataDefaults === void 0 && declaredLegacyDefaults !== void 0 ? ownTuple(declaredLegacyDefaults) : void 0;
   const ownedMetadata = {
     ...metadata,
-    docs: { ...metadata.docs, url: url(descriptor.name) },
+    docs: { ...metadata.docs, url: url(name) },
     schema: schemaList(schema) ? [...schema] : schema
   };
-  if (metadataDefaults === void 0 && Object.hasOwn(descriptor.meta, "defaultOptions")) {
+  if (metadataDefaults === void 0 && Object.hasOwn(metadataSnapshot, "defaultOptions")) {
     Object.defineProperty(ownedMetadata, "defaultOptions", {
       value: void 0,
       configurable: true,
@@ -144,25 +137,25 @@ function createNativeRule(config, url) {
   }
   const meta2 = metadataDefaults === void 0 ? ownedMetadata : { ...ownedMetadata, defaultOptions: metadataDefaults };
   const base = {
-    name: descriptor.name,
-    defaultOptions: descriptor.defaultOptions,
+    name,
+    defaultOptions: declaredLegacyDefaults,
     meta: meta2
   };
-  if (hasNoDefaultOptions(descriptor)) {
-    const create2 = descriptor.create;
+  if (hasNoDefaultOptions(config, declaredMetaDefaults, declaredLegacyDefaults)) {
+    const create2 = config.create;
     return { ...base, create(context) {
       return create2(context, []);
     } };
   }
   const defaults = metadataDefaults ?? legacyDefaults;
   if (defaults === void 0) throw new TypeError("Declared defaults disappeared while creating the rule.");
-  const create = descriptor.create;
+  const create = config.create;
   return { ...base, create(context) {
     return create(context, ESLintUtils.applyDefault(defaults, context.options));
   } };
 }
-function hasNoDefaultOptions(config) {
-  return config.meta.defaultOptions === void 0 && config.defaultOptions === void 0;
+function hasNoDefaultOptions(_config, metaDefaults, legacyDefaults) {
+  return metaDefaults === void 0 && legacyDefaults === void 0;
 }
 function schemaList(schema) {
   return Array.isArray(schema);
@@ -180,13 +173,12 @@ var KEBAB_CASE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
 var MAX_SUMMARY_LENGTH = 160;
 function createRule(config) {
   const { documentation } = config;
-  const eslintConfig = config;
-  const rule = createNativeRule(eslintConfig, examplesUrl);
+  const rule = createNativeRule(config, examplesUrl);
   if (documentation !== void 0) {
     Object.defineProperty(rule, "documentation", {
       configurable: false,
       enumerable: false,
-      value: nativeSpec(eslintConfig, documentation),
+      value: nativeSpec(rule, documentation),
       writable: false
     });
   }
@@ -975,19 +967,22 @@ var NO_FRONTEND_COMMENTS_DOCUMENTATION = {
   defaultLevel: "warning",
   summary: "Express frontend behavior through code instead of prose comments.",
   rationale: "Frontend comments can drift from executable behavior and conceal names, types or structure that should communicate the same information.",
-  remediation: "Use clear names, types, helpers and assertions, then remove the comment. Move tool settings into their owning configuration where supported. Review behavioral directives and legal notices before editing; no automatic deletion changes those contracts.",
+  remediation: "Use clear names, types, helpers and assertions, then remove the comment. Move tool settings into their owning configuration where supported. Whitespace-only single-line comments can be replaced with a space; review all other comments and their contracts manually.",
   category: "maintainability",
-  autofix: "none",
+  autofix: "safe",
   limitations: [
     "Reports every actual line, block, JSDoc and JSX comment in maintained frontend source, including legal notices and executable directives. The existing no-test-comments rule owns maintained test files and applies the same blanket frontend ban, avoiding duplicate diagnostics between these two rules. Strings, template data, rendered JSX text and generated/vendor sources are excluded.",
     "Frontend scope is established by JSX-capable extensions, use client/use server directives, framework imports, or the nearest package manifest declaring a frontend framework dependency. Pure helpers in those packages are included. Set allFiles: true on both this rule and no-test-comments in a frontend ESLint override for dependency-free or unsupported frameworks; file names alone do not infer application ownership.",
-    "This is a blanket policy warning, including comments preserved by narrower comment-hygiene rules. Behavioral annotations, JavaScript type comments, required legal notices and tool directives require manual migration or an explicit policy exception; the rule never automatically deletes them."
+    "This is a blanket policy warning, including comments preserved by narrower comment-hygiene rules. Behavioral annotations, JavaScript type comments, required legal notices and tool directives require manual migration or an explicit policy exception; the rule never automatically deletes them.",
+    "Automatic fixes replace only whitespace-only line or block comment tokens containing no line terminators with one separating space. Every existing line terminator is preserved. Comments overlapping JSX regions, multiline comments, nonempty comments and comments owned by the test rule remain manual."
   ],
   examples: [
     { id: "frontend-prose", title: "Express view behavior in code", outcome: "match", files: [{ path: "src/view.tsx", source: "// Show current status\nexport const View = () => <p>Ready</p>;" }], focusPath: "src/view.tsx", expectedCount: 1, public: true },
     { id: "named-view", title: "The view expresses its behavior", outcome: "no-match", files: [{ path: "src/view.tsx", source: "export const View = () => <p>Ready</p>;" }], focusPath: "src/view.tsx", expectedCount: 0, public: true },
     { id: "package-helper", scenarioId: "package", title: "A plain helper belongs to its frontend package", outcome: "match", files: [{ path: "package.json", source: '{"private":true,"dependencies":{"react":"19.2.0"}}' }, { path: "src/helper.ts", source: "// Frontend helper\nexport const ready = true;" }], focusPath: "src/helper.ts", expectedCount: 1, public: true },
-    { id: "package-helper-code", scenarioId: "package", title: "The helper expresses its behavior in code", outcome: "no-match", files: [{ path: "package.json", source: '{"private":true,"dependencies":{"react":"19.2.0"}}' }, { path: "src/helper.ts", source: "export const ready = true;" }], focusPath: "src/helper.ts", expectedCount: 0, public: true }
+    { id: "package-helper-code", scenarioId: "package", title: "The helper expresses its behavior in code", outcome: "no-match", files: [{ path: "package.json", source: '{"private":true,"dependencies":{"react":"19.2.0"}}' }, { path: "src/helper.ts", source: "export const ready = true;" }], focusPath: "src/helper.ts", expectedCount: 0, public: true },
+    { id: "empty-comment-separator", scenarioId: "empty-comment", title: "Keep a separating space when removing an empty comment", outcome: "match", files: [{ path: "src/helper.tsx", source: "export function identity(value: number) { return/**/value; }" }], fixedFiles: [{ path: "src/helper.tsx", source: "export function identity(value: number) { return value; }" }], focusPath: "src/helper.tsx", expectedCount: 1, public: true },
+    { id: "empty-comment-removed", scenarioId: "empty-comment", title: "Preserve the return expression without a comment", outcome: "no-match", files: [{ path: "src/helper.tsx", source: "export function identity(value: number) { return value; }" }], focusPath: "src/helper.tsx", expectedCount: 0, public: true }
   ]
 };
 var no_frontend_comments_default = createRule({
@@ -995,6 +990,7 @@ var no_frontend_comments_default = createRule({
   documentation: NO_FRONTEND_COMMENTS_DOCUMENTATION,
   meta: {
     type: "suggestion",
+    fixable: "code",
     docs: { description: NO_FRONTEND_COMMENTS_DOCUMENTATION.summary },
     schema: [{ type: "object", properties: { allFiles: { type: "boolean" } }, additionalProperties: false }],
     messages: { noFrontendComments: "Frontend comments are prohibited; express the behavior in names, types or code and review any directive or legal contract before removing it." }
@@ -1002,15 +998,76 @@ var no_frontend_comments_default = createRule({
   defaultOptions: [{}],
   create(context, [options]) {
     if (isGeneratedFile(context, context.sourceCode.text) || ownsTestComments(context)) return {};
+    const jsxRanges = [];
+    let ambiguousJSX = false;
+    function captureJSX(node) {
+      const range = sourceRange(node.range, context.sourceCode.text.length);
+      if (range === null) {
+        ambiguousJSX = true;
+        return;
+      }
+      const previous = jsxRanges.at(-1);
+      if (previous === void 0 || range.start >= previous.end) {
+        jsxRanges.push(range);
+        return;
+      }
+      if (range.start < previous.start || range.end > previous.end) ambiguousJSX = true;
+    }
     return {
-      Program() {
+      JSXElement: captureJSX,
+      JSXFragment: captureJSX,
+      "Program:exit"() {
         const comments = context.sourceCode.getAllComments();
         if (comments.length === 0 || !(options.allFiles === true || isFrontendSource(context))) return;
-        for (const comment of comments) context.report({ node: comment, messageId: "noFrontendComments" });
+        const ranges = ambiguousJSX ? /* @__PURE__ */ new Map() : emptyCommentRanges(context.sourceCode.text, comments, jsxRanges);
+        for (const comment of comments) context.report({
+          node: comment,
+          messageId: "noFrontendComments",
+          fix(fixer) {
+            const range = ranges.get(comment);
+            return range === void 0 ? null : fixer.replaceTextRange([range.start, range.end], " ");
+          }
+        });
       }
     };
   }
 });
+function emptyCommentRanges(text, comments, jsxRanges) {
+  const ranges = /* @__PURE__ */ new Map();
+  let previousEnd = 0;
+  let jsxIndex = 0;
+  for (const comment of comments) {
+    const range = sourceRange(comment.range, text.length);
+    if (range === null || range.start < previousEnd) {
+      ranges.clear();
+      return ranges;
+    }
+    previousEnd = range.end;
+    let jsx = jsxRanges[jsxIndex];
+    while (jsx !== void 0 && jsx.end <= range.start) {
+      jsxIndex += 1;
+      jsx = jsxRanges[jsxIndex];
+    }
+    if (jsx !== void 0 && range.start < jsx.end && range.end > jsx.start) continue;
+    const empty = emptyCommentRange(text, comment);
+    if (empty !== null) ranges.set(comment, empty);
+  }
+  return ranges;
+}
+function sourceRange(range, length) {
+  const [start, end] = range;
+  return Number.isInteger(start) && Number.isInteger(end) && start >= 0 && end > start && end <= length ? { start, end } : null;
+}
+function emptyCommentRange(text, comment) {
+  const range = sourceRange(comment.range, text.length);
+  if (range === null || comment.value.trim() !== "") return null;
+  const { start, end } = range;
+  const raw = text.slice(start, end);
+  if (/[\r\n\u2028\u2029]/u.test(raw)) return null;
+  if (comment.type === "Line" && raw.startsWith("//") && raw.slice(2).trim() === "") return range;
+  if (comment.type === "Block" && raw.startsWith("/*") && raw.endsWith("*/") && raw.slice(2, -2).trim() === "") return range;
+  return null;
+}
 
 // src/rules/prefer-dependency-interface.ts
 import { AST_NODE_TYPES as AST_NODE_TYPES5, ASTUtils } from "@typescript-eslint/utils";
@@ -4593,7 +4650,7 @@ function isSearchParamReceiver(call, services) {
 // package.json
 var package_default = {
   name: "@sarj/eslint-plugin",
-  version: "17.1.0",
+  version: "17.1.1",
   packageManager: "npm@12.2.1",
   description: "Custom ESLint rules for hypermodern TypeScript / React / Next.js projects",
   type: "module",

package/package.json

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