feat(linter): add no-empty-comments rule

Signed-off-by: azjezz <azjezz@protonmail.com>

crates/linter/src/plugin/comment/mod.rs

@@ -1,4 +1,5 @@
 use crate::plugin::comment::rules::docblock_syntax::DocblockSyntaxRule;
+use crate::plugin::comment::rules::no_empty_comments::NoEmptyCommentsRule;
 use crate::plugin::comment::rules::no_shell_style::NoShellStyleRule;
 use crate::plugin::comment::rules::no_trailing_whitespace::NoTrailingWhitespaceRule;
 use crate::plugin::comment::rules::no_untagged_fixme::NoUntaggedFixmeRule;
@@ -24,6 +25,7 @@ impl Plugin for CommentPlugin {
     fn get_rules(&self) -> Vec<Box<dyn Rule>> {
         vec![
             Box::new(NoUntaggedTodoRule),
+            Box::new(NoEmptyCommentsRule),
             Box::new(NoUntaggedFixmeRule),
             Box::new(NoShellStyleRule),
             Box::new(NoTrailingWhitespaceRule),

crates/linter/src/plugin/comment/rules/mod.rs

@@ -1,4 +1,5 @@
 pub mod docblock_syntax;
+pub mod no_empty_comments;
 pub mod no_shell_style;
 pub mod no_trailing_whitespace;
 pub mod no_untagged_fixme;

crates/linter/src/plugin/comment/rules/no_empty_comments.rs

@@ -0,0 +1,44 @@
+use mago_ast::Program;
+use mago_fixer::SafetyClassification;
+use mago_reporting::*;
+use mago_walker::Walker;
+
+use crate::context::LintContext;
+use crate::plugin::comment::rules::utils::comment_content;
+use crate::rule::Rule;
+
+#[derive(Clone, Debug)]
+pub struct NoEmptyCommentsRule;
+
+impl Rule for NoEmptyCommentsRule {
+    #[inline]
+    fn get_name(&self) -> &'static str {
+        "no-empty-comments"
+    }
+
+    #[inline]
+    fn get_default_level(&self) -> Option<Level> {
+        Some(Level::Note)
+    }
+}
+
+impl<'a> Walker<LintContext<'a>> for NoEmptyCommentsRule {
+    fn walk_program<'ast>(&self, program: &'ast Program, context: &mut LintContext<'a>) {
+        for trivia in program.trivia.iter() {
+            if let Some(content) = comment_content(trivia, context) {
+                let content = content.trim();
+                if !content.is_empty() {
+                    continue;
+                }
+
+                let issue = Issue::new(context.level(), "Empty comments are not allowed.")
+                    .with_annotation(Annotation::primary(trivia.span).with_message("This is an empty comment."))
+                    .with_help("Consider removing this comment.");
+
+                context.report_with_fix(issue, |plan| {
+                    plan.delete(trivia.span.to_range(), SafetyClassification::Safe);
+                });
+            }
+        }
+    }
+}