feat(analyze/html/vue): add a few more simple vue lint rules (#8583)

<!--
  IMPORTANT!!
  If you generated this PR with the help of any AI assistance, please disclose it in the PR.
  https://github.com/biomejs/biome/blob/main/CONTRIBUTING.md#ai-assistance-notice
-->

<!--
	Thanks for submitting a Pull Request! We appreciate you spending the time to work on these changes.
	Please provide enough information so that others can review your PR.
	Once created, your PR will be automatically labeled according to changed files.
	Learn more about contributing: https://github.com/biomejs/biome/blob/main/CONTRIBUTING.md
-->

## Summary

<!-- Explain the **motivation** for making this change. What existing problem does the pull request solve?-->
This adds a few more Vue HTML lint rules. The reason I put them all in one PR is because they are all pretty trivial, logic wise.

Almost completely AI generated, except for some manual tweaking of the diagnostics.

<!-- Link any relevant issues if necessary or include a transcript of any Discord discussion. -->

<!-- If you create a user-facing change, please write a changeset: https://github.com/biomejs/biome/blob/main/CONTRIBUTING.md#writing-a-changeset (your changeset is often a good starting point for this summary as well) -->

## Test Plan

<!-- What demonstrates that your implementation is correct? -->
snapshots

## Docs

<!-- If you're submitting a new rule or action (or an option for them), the documentation is part of the code. Make sure rules and actions have example usages, and that all options are documented. -->

<!-- For other features, please submit a documentation PR to the `next` branch of our website: https://github.com/biomejs/website/. Link the PR here once it's ready. -->

Author: dyc3

.changeset/add-template-root-rule.md

@@ -0,0 +1,27 @@
+---
+"@biomejs/biome": patch
+---
+
+Added the new nursery rule [`useVueValidTemplateRoot`](https://biomejs.dev/linter/rules/use-vue-valid-template-root/).
+
+This rule validates only root-level `<template>` elements in Vue single-file components. If the `<template>` has a `src` attribute, it must be empty. Otherwise, it must contain content.
+
+Invalid examples:
+
+```vue
+<template src="./foo.html">content</template>
+```
+
+```vue
+<template></template>
+```
+
+Valid examples:
+
+```vue
+<template>content</template>
+```
+
+```vue
+<template src="./foo.html"></template>
+```

.changeset/add-v-once-rule.md

@@ -0,0 +1,15 @@
+---
+"@biomejs/biome": patch
+---
+
+Added the new nursery rule [`useVueValidVOnce`](https://biomejs.dev/linter/rules/use-vue-valid-v-once/). Enforces that usages of the `v-once` directive in Vue.js SFC are valid.
+
+```vue
+<!-- Valid -->
+<div v-once />
+
+<!-- Invalid -->
+<div v-once:aaa />
+<div v-once.bbb />
+<div v-once="ccc" />
+```

.changeset/v-cloak-rule.md

@@ -0,0 +1,15 @@
+---
+"@biomejs/biome": patch
+---
+
+Added the new nursery rule [`useVueValidVCloak`](https://biomejs.dev/linter/rules/use-vue-valid-v-cloak/). Enforces that usages of the `v-cloak` directive in Vue.js SFC are valid.
+
+```vue
+<!-- Valid -->
+<div v-cloak />
+
+<!-- Invalid -->
+<div v-cloak:aaa />
+<div v-cloak.bbb />
+<div v-cloak="ccc" />
+```

.changeset/v-pre-rule.md

@@ -0,0 +1,15 @@
+---
+"@biomejs/biome": patch
+---
+
+Added the new nursery rule [`useVueValidVPre`](https://biomejs.dev/linter/rules/use-vue-valid-v-pre/). Enforces that usages of the `v-pre` directive in Vue.js SFC are valid.
+
+```vue
+<!-- Valid -->
+<div v-pre />
+
+<!-- Invalid -->
+<div v-pre:aaa />
+<div v-pre.bbb />
+<div v-pre="ccc" />
+```

crates/biome_configuration/src/analyzer/linter/rules.rs

@@ -8,11 +8,15 @@ pub mod no_script_url;
 pub mod no_sync_scripts;
 pub mod no_vue_v_if_with_v_for;
 pub mod use_vue_hyphenated_attributes;
+pub mod use_vue_valid_template_root;
 pub mod use_vue_valid_v_bind;
+pub mod use_vue_valid_v_cloak;
 pub mod use_vue_valid_v_else;
 pub mod use_vue_valid_v_else_if;
 pub mod use_vue_valid_v_html;
 pub mod use_vue_valid_v_if;
 pub mod use_vue_valid_v_on;
+pub mod use_vue_valid_v_once;
+pub mod use_vue_valid_v_pre;
 pub mod use_vue_valid_v_text;
-declare_lint_group! { pub Nursery { name : "nursery" , rules : [self :: no_ambiguous_anchor_text :: NoAmbiguousAnchorText , self :: no_script_url :: NoScriptUrl , self :: no_sync_scripts :: NoSyncScripts , self :: no_vue_v_if_with_v_for :: NoVueVIfWithVFor , self :: use_vue_hyphenated_attributes :: UseVueHyphenatedAttributes , self :: use_vue_valid_v_bind :: UseVueValidVBind , self :: use_vue_valid_v_else :: UseVueValidVElse , self :: use_vue_valid_v_else_if :: UseVueValidVElseIf , self :: use_vue_valid_v_html :: UseVueValidVHtml , self :: use_vue_valid_v_if :: UseVueValidVIf , self :: use_vue_valid_v_on :: UseVueValidVOn , self :: use_vue_valid_v_text :: UseVueValidVText ,] } }
+declare_lint_group! { pub Nursery { name : "nursery" , rules : [self :: no_ambiguous_anchor_text :: NoAmbiguousAnchorText , self :: no_script_url :: NoScriptUrl , self :: no_sync_scripts :: NoSyncScripts , self :: no_vue_v_if_with_v_for :: NoVueVIfWithVFor , self :: use_vue_hyphenated_attributes :: UseVueHyphenatedAttributes , self :: use_vue_valid_template_root :: UseVueValidTemplateRoot , self :: use_vue_valid_v_bind :: UseVueValidVBind , self :: use_vue_valid_v_cloak :: UseVueValidVCloak , self :: use_vue_valid_v_else :: UseVueValidVElse , self :: use_vue_valid_v_else_if :: UseVueValidVElseIf , self :: use_vue_valid_v_html :: UseVueValidVHtml , self :: use_vue_valid_v_if :: UseVueValidVIf , self :: use_vue_valid_v_on :: UseVueValidVOn , self :: use_vue_valid_v_once :: UseVueValidVOnce , self :: use_vue_valid_v_pre :: UseVueValidVPre , self :: use_vue_valid_v_text :: UseVueValidVText ,] } }

crates/biome_diagnostics_categories/src/categories.rs

@@ -0,0 +1,137 @@
+use biome_analyze::{
+    Ast, FixKind, Rule, RuleDiagnostic, RuleDomain, RuleSource, context::RuleContext,
+    declare_lint_rule,
+};
+use biome_console::markup;
+use biome_html_syntax::{HtmlElement, HtmlRoot};
+use biome_rowan::{AstNode, AstNodeList, BatchMutationExt};
+use biome_rule_options::use_vue_valid_template_root::UseVueValidTemplateRootOptions;
+
+declare_lint_rule! {
+    /// Enforce valid Vue `<template>` root usage.
+    ///
+    /// This rule reports only root-level `<template>` elements. If the
+    /// `<template>` has a `src` attribute, the element must be empty. Otherwise,
+    /// the element must contain content.
+    ///
+    /// ## Examples
+    ///
+    /// ### Invalid
+    ///
+    /// ```vue,expect_diagnostic
+    /// <template src="./foo.html">content</template>
+    /// ```
+    ///
+    /// ```vue,expect_diagnostic
+    /// <template></template>
+    /// ```
+    ///
+    /// ### Valid
+    ///
+    /// ```vue
+    /// <template>content</template>
+    /// ```
+    ///
+    /// ```vue
+    /// <template src="./foo.html"></template>
+    /// ```
+    ///
+    pub UseVueValidTemplateRoot {
+        version: "next",
+        name: "useVueValidTemplateRoot",
+        language: "html",
+        recommended: true,
+        domains: &[RuleDomain::Vue],
+        sources: &[RuleSource::EslintVueJs("valid-template-root").same()],
+        fix_kind: FixKind::Unsafe,
+    }
+}
+
+pub enum ViolationKind {
+    MustBeEmpty(HtmlElement),
+    MustHaveContent(HtmlElement),
+}
+
+impl Rule for UseVueValidTemplateRoot {
+    type Query = Ast<HtmlRoot>;
+    type State = ViolationKind;
+    type Signals = Option<Self::State>;
+    type Options = UseVueValidTemplateRootOptions;
+
+    fn run(ctx: &RuleContext<Self>) -> Option<Self::State> {
+        let root = ctx.query();
+        // Find top-level `<template>` elements only
+        let element = root
+            .html()
+            .into_iter()
+            .filter_map(|el| HtmlElement::cast(el.into_syntax()))
+            .find(|el| {
+                el.opening_element()
+                    .ok()
+                    .and_then(|op| op.name().ok())
+                    .and_then(|name| name.value_token().ok())
+                    .is_some_and(|tok| tok.text_trimmed() == "template")
+            })?;
+
+        let has_src = element.find_attribute_by_name("src").is_some();
+        let has_non_whitespace_content = !element.children().is_empty();
+
+        if has_src {
+            if has_non_whitespace_content {
+                return Some(ViolationKind::MustBeEmpty(element));
+            }
+        } else if !has_non_whitespace_content {
+            return Some(ViolationKind::MustHaveContent(element));
+        }
+
+        None
+    }
+
+    fn diagnostic(_ctx: &RuleContext<Self>, state: &Self::State) -> Option<RuleDiagnostic> {
+        Some(match state {
+            ViolationKind::MustBeEmpty(el) => RuleDiagnostic::new(
+                rule_category!(),
+                el.range(),
+                markup! {
+                    "The root `<template>` with a " <Emphasis>"src"</Emphasis> " attribute must be empty."
+                },
+            )
+            .note(markup! {
+                "The src attribute indicates that the content is loaded from an external file."
+            })
+            .note(markup! {
+                "Remove content when using the " <Emphasis>"src"</Emphasis> " attribute."
+            }),
+            ViolationKind::MustHaveContent(el) => RuleDiagnostic::new(
+                rule_category!(),
+                el.range(),
+                markup! {
+                    "The root `<template>` is empty."
+                },
+            )
+            .note(markup! {
+                "The root `<template>` must contain content when no " <Emphasis>"src"</Emphasis> " attribute is present."
+            })
+            .note(markup! {
+                "Add content inside the `<template>` or use the " <Emphasis>"src"</Emphasis> " attribute."
+            }),
+        })
+    }
+
+    fn action(ctx: &RuleContext<Self>, state: &Self::State) -> Option<crate::HtmlRuleAction> {
+        match state {
+            // Unsafe fix: remove the content when `src` is present
+            ViolationKind::MustBeEmpty(el) => {
+                let mut mutation = BatchMutationExt::begin(ctx.root());
+                mutation.remove_node(el.children());
+                Some(biome_analyze::RuleAction::new(
+                    ctx.metadata().action_category(ctx.category(), ctx.group()),
+                    ctx.metadata().applicability(),
+                    markup! { "Remove inline content from `<template>`." }.to_owned(),
+                    mutation,
+                ))
+            }
+            ViolationKind::MustHaveContent(_el) => None,
+        }
+    }
+}