feat(html): implement {@debug} parsing (#7969)

Author: ematipico

.changeset/nine-bottles-float.md

@@ -0,0 +1,10 @@
+---
+"@biomejs/biome": patch
+---
+
+Added support for the Svelte syntax `{@debug}`. The Biome HTML parser is now able to parse and format the blocks:
+
+```diff
+-{@debug     foo,bar,    something}
++{@debug foo, bar, something}
+```

AGENTS..md renamed to AGENTS.md

@@ -716,6 +716,78 @@ impl IntoFormat<HtmlFormatContext> for biome_html_syntax::HtmlTextExpression {
         )
     }
 }
+impl FormatRule<biome_html_syntax::SvelteDebugBlock>
+    for crate::svelte::auxiliary::debug_block::FormatSvelteDebugBlock
+{
+    type Context = HtmlFormatContext;
+    #[inline(always)]
+    fn fmt(
+        &self,
+        node: &biome_html_syntax::SvelteDebugBlock,
+        f: &mut HtmlFormatter,
+    ) -> FormatResult<()> {
+        FormatNodeRule::<biome_html_syntax::SvelteDebugBlock>::fmt(self, node, f)
+    }
+}
+impl AsFormat<HtmlFormatContext> for biome_html_syntax::SvelteDebugBlock {
+    type Format<'a> = FormatRefWithRule<
+        'a,
+        biome_html_syntax::SvelteDebugBlock,
+        crate::svelte::auxiliary::debug_block::FormatSvelteDebugBlock,
+    >;
+    fn format(&self) -> Self::Format<'_> {
+        FormatRefWithRule::new(
+            self,
+            crate::svelte::auxiliary::debug_block::FormatSvelteDebugBlock::default(),
+        )
+    }
+}
+impl IntoFormat<HtmlFormatContext> for biome_html_syntax::SvelteDebugBlock {
+    type Format = FormatOwnedWithRule<
+        biome_html_syntax::SvelteDebugBlock,
+        crate::svelte::auxiliary::debug_block::FormatSvelteDebugBlock,
+    >;
+    fn into_format(self) -> Self::Format {
+        FormatOwnedWithRule::new(
+            self,
+            crate::svelte::auxiliary::debug_block::FormatSvelteDebugBlock::default(),
+        )
+    }
+}
+impl FormatRule<biome_html_syntax::SvelteName>
+    for crate::svelte::auxiliary::name::FormatSvelteName
+{
+    type Context = HtmlFormatContext;
+    #[inline(always)]
+    fn fmt(&self, node: &biome_html_syntax::SvelteName, f: &mut HtmlFormatter) -> FormatResult<()> {
+        FormatNodeRule::<biome_html_syntax::SvelteName>::fmt(self, node, f)
+    }
+}
+impl AsFormat<HtmlFormatContext> for biome_html_syntax::SvelteName {
+    type Format<'a> = FormatRefWithRule<
+        'a,
+        biome_html_syntax::SvelteName,
+        crate::svelte::auxiliary::name::FormatSvelteName,
+    >;
+    fn format(&self) -> Self::Format<'_> {
+        FormatRefWithRule::new(
+            self,
+            crate::svelte::auxiliary::name::FormatSvelteName::default(),
+        )
+    }
+}
+impl IntoFormat<HtmlFormatContext> for biome_html_syntax::SvelteName {
+    type Format = FormatOwnedWithRule<
+        biome_html_syntax::SvelteName,
+        crate::svelte::auxiliary::name::FormatSvelteName,
+    >;
+    fn into_format(self) -> Self::Format {
+        FormatOwnedWithRule::new(
+            self,
+            crate::svelte::auxiliary::name::FormatSvelteName::default(),
+        )
+    }
+}
 impl AsFormat<HtmlFormatContext> for biome_html_syntax::HtmlAttributeList {
     type Format<'a> = FormatRefWithRule<
         'a,
@@ -766,6 +838,31 @@ impl IntoFormat<HtmlFormatContext> for biome_html_syntax::HtmlElementList {
         )
     }
 }
+impl AsFormat<HtmlFormatContext> for biome_html_syntax::SvelteBindingList {
+    type Format<'a> = FormatRefWithRule<
+        'a,
+        biome_html_syntax::SvelteBindingList,
+        crate::svelte::lists::binding_list::FormatSvelteBindingList,
+    >;
+    fn format(&self) -> Self::Format<'_> {
+        FormatRefWithRule::new(
+            self,
+            crate::svelte::lists::binding_list::FormatSvelteBindingList::default(),
+        )
+    }
+}
+impl IntoFormat<HtmlFormatContext> for biome_html_syntax::SvelteBindingList {
+    type Format = FormatOwnedWithRule<
+        biome_html_syntax::SvelteBindingList,
+        crate::svelte::lists::binding_list::FormatSvelteBindingList,
+    >;
+    fn into_format(self) -> Self::Format {
+        FormatOwnedWithRule::new(
+            self,
+            crate::svelte::lists::binding_list::FormatSvelteBindingList::default(),
+        )
+    }
+}
 impl FormatRule<biome_html_syntax::AstroBogusFrontmatter>
     for crate::astro::bogus::bogus_frontmatter::FormatAstroBogusFrontmatter
 {
@@ -944,6 +1041,44 @@ impl IntoFormat<HtmlFormatContext> for biome_html_syntax::HtmlBogusTextExpressio
         )
     }
 }
+impl FormatRule<biome_html_syntax::SvelteBogusBlock>
+    for crate::svelte::bogus::bogus_block::FormatSvelteBogusBlock
+{
+    type Context = HtmlFormatContext;
+    #[inline(always)]
+    fn fmt(
+        &self,
+        node: &biome_html_syntax::SvelteBogusBlock,
+        f: &mut HtmlFormatter,
+    ) -> FormatResult<()> {
+        FormatBogusNodeRule::<biome_html_syntax::SvelteBogusBlock>::fmt(self, node, f)
+    }
+}
+impl AsFormat<HtmlFormatContext> for biome_html_syntax::SvelteBogusBlock {
+    type Format<'a> = FormatRefWithRule<
+        'a,
+        biome_html_syntax::SvelteBogusBlock,
+        crate::svelte::bogus::bogus_block::FormatSvelteBogusBlock,
+    >;
+    fn format(&self) -> Self::Format<'_> {
+        FormatRefWithRule::new(
+            self,
+            crate::svelte::bogus::bogus_block::FormatSvelteBogusBlock::default(),
+        )
+    }
+}
+impl IntoFormat<HtmlFormatContext> for biome_html_syntax::SvelteBogusBlock {
+    type Format = FormatOwnedWithRule<
+        biome_html_syntax::SvelteBogusBlock,
+        crate::svelte::bogus::bogus_block::FormatSvelteBogusBlock,
+    >;
+    fn into_format(self) -> Self::Format {
+        FormatOwnedWithRule::new(
+            self,
+            crate::svelte::bogus::bogus_block::FormatSvelteBogusBlock::default(),
+        )
+    }
+}
 impl AsFormat<HtmlFormatContext> for biome_html_syntax::AnyAstroFrontmatterElement {
     type Format<'a> = FormatRefWithRule<
         'a,
@@ -1094,3 +1229,28 @@ impl IntoFormat<HtmlFormatContext> for biome_html_syntax::AnyHtmlTextExpression
         )
     }
 }
+impl AsFormat<HtmlFormatContext> for biome_html_syntax::AnySvelteBlock {
+    type Format<'a> = FormatRefWithRule<
+        'a,
+        biome_html_syntax::AnySvelteBlock,
+        crate::svelte::any::block::FormatAnySvelteBlock,
+    >;
+    fn format(&self) -> Self::Format<'_> {
+        FormatRefWithRule::new(
+            self,
+            crate::svelte::any::block::FormatAnySvelteBlock::default(),
+        )
+    }
+}
+impl IntoFormat<HtmlFormatContext> for biome_html_syntax::AnySvelteBlock {
+    type Format = FormatOwnedWithRule<
+        biome_html_syntax::AnySvelteBlock,
+        crate::svelte::any::block::FormatAnySvelteBlock,
+    >;
+    fn into_format(self) -> Self::Format {
+        FormatOwnedWithRule::new(
+            self,
+            crate::svelte::any::block::FormatAnySvelteBlock::default(),
+        )
+    }
+}

crates/biome_html_factory/src/generated/node_factory.rs

@@ -8,6 +8,7 @@ impl FormatRule<AnyHtmlTextExpression> for FormatAnyHtmlTextExpression {
     type Context = HtmlFormatContext;
     fn fmt(&self, node: &AnyHtmlTextExpression, f: &mut HtmlFormatter) -> FormatResult<()> {
         match node {
+            AnyHtmlTextExpression::AnySvelteBlock(node) => node.format().fmt(f),
             AnyHtmlTextExpression::HtmlBogusTextExpression(node) => node.format().fmt(f),
             AnyHtmlTextExpression::HtmlDoubleTextExpression(node) => node.format().fmt(f),
             AnyHtmlTextExpression::HtmlSingleTextExpression(node) => node.format().fmt(f),

crates/biome_html_factory/src/generated/syntax_factory.rs

@@ -20,11 +20,13 @@ mod cst;
 mod generated;
 mod html;
 pub(crate) mod prelude;
+pub(crate) mod separated;
+mod svelte;
 mod trivia;
 pub mod utils;
 mod verbatim;
 
-/// Formats a Html file based on its features.
+/// Formats a HTML file based on its features.
 ///
 /// It returns a [Formatted] result, which the user can use to override a file.
 pub fn format_node(