feat: add ignoreFileCommentDirective option

docs/src/SUMMARY.md

@@ -23,3 +23,4 @@
   - [singleLineTopLevelDeclarations](./config/single-line-top-level-declarations.md)
   - [selectorOverrideCommentDirective](./config/selector-override-comment-directive.md)
   - [ignoreCommentDirective](./config/ignore-comment-directive.md)
+  - [ignoreFileCommentDirective](./config/ignore-file-comment-directive.md)

docs/src/config/ignore-file-comment-directive.md

@@ -0,0 +1,17 @@
+# `ignoreFileCommentDirective`
+
+Text directive for ignoring formatting a whole file.
+
+Default is `"malva-ignore-file"`,
+but if you're using as a dprint plugin, it will be `"dprint-ignore-file"`.
+
+## Example
+
+[Playground](https://malva-play.vercel.app/?code=H4sIAAAAAAAAA9PXUshNzClL1M1Mz8svStVNy8xJVdDS50rUSarmUlAoz0wpyVBQsFJQMLDmqgUAonD7wC0AAAA%3D&config=H4sIAAAAAAAAA6vmUlBQykzPyy9KdcvMSXXOz81NzStxySxKTS7JLEtVslJQyk3MKUvUhajRTQMqUuKqBQAUQZPQNwAAAA%3D%3D&syntax=css)
+
+```css
+/* malva-ignore-file */
+a,b{
+  width  :  0;
+}
+```

dprint_plugin/deployment/schema.json

@@ -265,6 +265,11 @@
       "description": "Text directive for ignoring formatting specific statement.",
       "type": "string",
       "default": "malva-ignore"
+    },
+    "ignoreFileCommentDirective": {
+      "description": "Text directive for ignoring formatting a whole file.",
+      "type": "string",
+      "default": "dprint-ignore-file"
     }
   }
 }

dprint_plugin/src/config.rs

@@ -278,6 +278,12 @@ pub(crate) fn resolve_config(
                 "malva-ignore".into(),
                 &mut diagnostics,
             ),
+            ignore_file_comment_directive: get_value(
+                &mut config,
+                "ignoreFileCommentDirective",
+                "dprint-ignore-file".into(),
+                &mut diagnostics,
+            ),
         },
     };
 

malva/src/config.rs

@@ -256,6 +256,10 @@ pub struct LanguageOptions {
     #[cfg_attr(feature = "config_serde", serde(alias = "ignoreCommentDirective"))]
     /// See [`ignoreCommentDirective`](https://malva.netlify.app/config/ignore-comment-directive.html)
     pub ignore_comment_directive: String,
+
+    #[cfg_attr(feature = "config_serde", serde(alias = "ignoreFileCommentDirective"))]
+    /// See [`ignoreFileCommentDirective`](https://malva.netlify.app/config/ignore-file-comment-directive.html)
+    pub ignore_file_comment_directive: String,
 }
 
 impl Default for LanguageOptions {
@@ -289,6 +293,7 @@ impl Default for LanguageOptions {
             single_line_top_level_declarations: false,
             selector_override_comment_directive: "malva-selector-override".into(),
             ignore_comment_directive: "malva-ignore".into(),
+            ignore_file_comment_directive: "malva-ignore-file".into(),
         }
     }
 }

malva/src/lib.rs

@@ -34,14 +34,27 @@ pub fn format_text(input: &str, syntax: Syntax, options: &FormatOptions) -> Resu
         }
     };
 
-    Ok(print_stylesheet(
-        &stylesheet,
-        &comments,
-        Some(input),
-        line_bounds,
-        syntax,
-        options,
-    ))
+    if comments.first().is_some_and(|comment| {
+        comment.span.start == 0
+            && comment
+                .content
+                .trim_start()
+                .strip_prefix(&options.language.ignore_file_comment_directive)
+                .is_some_and(|rest| {
+                    rest.is_empty() || rest.starts_with(|c: char| c.is_ascii_whitespace())
+                })
+    }) {
+        Ok(input.to_owned())
+    } else {
+        Ok(print_stylesheet(
+            &stylesheet,
+            &comments,
+            Some(input),
+            line_bounds,
+            syntax,
+            options,
+        ))
+    }
 }
 
 /// Print the given stylesheet AST.

malva/tests/fmt/css/ignore/ignore-file.css

@@ -0,0 +1,3 @@
+/* malva-ignore-file */
+a,b{}
+a,b{}

malva/tests/fmt/css/ignore/ignore-file.snap

@@ -0,0 +1,6 @@
+---
+source: malva/tests/fmt.rs
+---
+/* malva-ignore-file */
+a,b{}
+a,b{}