feat(macros): add `#[mlint(...)]` marker attribute macro

3 files changed, 35 insertions, 0 deletions

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9977b9f..5ed528c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -404,6 +404,19 @@ None
     - Added `mingling_macros/src/extensions/renderify.rs` with `renderify_impl` implementation.
     - Registered `#[proc_macro] pub fn render_route` and `#[proc_macro_attribute] pub fn renderify` in `mingling_macros/src/lib.rs`.
 
+15. **[`macros`]** Added the `#[mlint(...)]` marker attribute macro — a no-op attribute that passes its attached item through unchanged. The attribute content is ignored by `rustc` and reserved for the Mingling lint (`mlint`) tooling system.
+
+    The `#[mlint]` attribute is registered as a `#[proc_macro_attribute]` and re-exported as `mingling::macros::mlint`. It supports three styles of lint configuration:
+
+    ```rust,ignore
+    #[mlint(allow(MLINT_SOME_LINT))]
+    #[mlint(warn(MLINT_SOME_LINT))]
+    #[mlint(deny(MLINT_SOME_LINT))]
+    fn some_item() {}
+    ```
+
+    Since the attribute is a no-op at compile time, it has no effect on code generation, type checking, or runtime behavior. Its purpose is to serve as a structured annotation that `mlint` tooling can parse from the AST. The attribute is feature-gated behind `extra_macros`.
+
 #### **BREAKING CHANGES** (API CHANGES):
 
 1. **[`macros:renderer`]** **[`macros:help`]** Removed `r_println!` and `r_print!` macros from being implicitly injected by `#[renderer]` and `#[help]` macros. These macros still exist, but must now be used **explicitly** — either with an explicit buffer argument, or via the `#[buffer]` extension attribute that re-enables implicit buffer injection.
diff --git a/mingling/src/lib.rs b/mingling/src/lib.rs
index f08e9e4..fd274aa 100644
--- a/mingling/src/lib.rs
+++ b/mingling/src/lib.rs
@@ -75,6 +75,9 @@ pub mod macros {
     pub use mingling_macros::group_structural;
     /// `#[help]` - Used to generate a struct implementing the `HelpRequest` trait via a method
     pub use mingling_macros::help;
+    /// `#[mlint(...)]` - Marker attribute for the Mingling lint system.
+    /// Content is ignored by rustc and reserved for mlint tooling.
+    pub use mingling_macros::mlint;
     /// `node!("remote.rm")` - Used to create a `Node` struct via a literal
     pub use mingling_macros::node;
     /// `pack!(StateGreet = String)` - Used to create a wrapper type for use with `Chain` and `Renderer`
diff --git a/mingling_macros/src/lib.rs b/mingling_macros/src/lib.rs
index da699da..534efa5 100644
--- a/mingling_macros/src/lib.rs
+++ b/mingling_macros/src/lib.rs
@@ -1343,6 +1343,25 @@ pub fn help(attr: TokenStream, item: TokenStream) -> TokenStream {
     help::help_attr(item)
 }
 
+/// Marker attribute for the Mingling lint system.
+///
+/// The content of this attribute is ignored by rustc and reserved for
+/// the mlint tool to interpret. All it does is pass the item through
+/// unchanged.
+///
+/// # Examples
+///
+/// ```rust,ignore
+/// #[mlint(allow(MLINT_SOME_LINT))]
+/// #[mlint(warn(MLINT_SOME_LINT))]
+/// #[mlint(deny(MLINT_SOME_LINT))]
+/// fn some_item() {}
+/// ```
+#[proc_macro_attribute]
+pub fn mlint(_attr: TokenStream, item: TokenStream) -> TokenStream {
+    item
+}
+
 /// Extension attribute macro that transforms `expr?` into `route!(expr)`.
 ///
 /// Designed for use with `#[chain(routeify, ...)]` to enable concise error