From f29f4ad7e22850d2d47d50633c8582d84fd79cb0 Mon Sep 17 00:00:00 2001
From: iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Mon, 20 Apr 2026 12:44:43 +0200
Subject: [PATCH 01/14] refactor: jsx named placeholders, reuse methods, fix
 readability

---
 src/ast_utils.rs                |  17 ++
 src/builder.rs                  |  77 +++-----
 tests/jsx.rs                    | 308 -------------------------------
 tests/jsx_named_placeholders.rs | 312 ++++++++++++++++++++++++++++++++
 4 files changed, 352 insertions(+), 362 deletions(-)
 create mode 100644 tests/jsx_named_placeholders.rs

diff --git a/src/ast_utils.rs b/src/ast_utils.rs
index 08331f8..5efe3e7 100644
--- a/src/ast_utils.rs
+++ b/src/ast_utils.rs
@@ -101,6 +101,23 @@ pub fn pick_jsx_attrs(
     attrs
 }
 
+pub fn omit_jsx_attrs(
+    mut attrs: Vec<JSXAttrOrSpread>,
+    names: HashSet<&str>,
+) -> Vec<JSXAttrOrSpread> {
+    attrs.retain(|attr| {
+        if let JSXAttrOrSpread::JSXAttr(attr) = attr {
+            if let JSXAttrName::Ident(ident) = &attr.name {
+                let name: &str = &ident.sym;
+                return !names.contains(name);
+            }
+        }
+        false
+    });
+
+    attrs
+}
+
 pub fn match_callee_name<F: Fn(&Ident) -> bool>(call: &CallExpr, predicate: F) -> Option<&Ident> {
     if let Callee::Expr(expr) = &call.callee {
         if let Expr::Ident(ident) = expr.as_ref() {
diff --git a/src/builder.rs b/src/builder.rs
index ceefa2d..55328c9 100644
--- a/src/builder.rs
+++ b/src/builder.rs
@@ -1,9 +1,12 @@
-use crate::ast_utils::expand_ts_as_expr;
+use crate::ast_utils::{
+    expand_ts_as_expr, get_jsx_attr, get_jsx_attr_value_as_string, omit_jsx_attrs,
+};
 use crate::options::LinguiOptions;
 use crate::tokens::{CaseOrOffset, IcuChoice, MsgToken};
 use std::collections::HashSet;
+use swc_core::common::EqIgnoreSpan;
 use swc_core::{
-    common::{EqIgnoreSpan, SyntaxContext, DUMMY_SP},
+    common::{SyntaxContext, DUMMY_SP},
     ecma::ast::*,
 };
 
@@ -161,42 +164,31 @@ impl<'a> MessageBuilder<'a> {
         let mut base_name: Option<String> = None;
 
         if let Some(attr_name) = &self.options.jsx_placeholder_attribute {
-            if let Some(idx) = el.attrs.iter().position(|a| {
-                if let JSXAttrOrSpread::JSXAttr(attr) = a {
-                    if let JSXAttrName::Ident(ident) = &attr.name {
-                        return &ident.sym == attr_name;
-                    }
-                }
-                false
-            }) {
-                let attr = el.attrs.remove(idx);
-                if let JSXAttrOrSpread::JSXAttr(attr) = attr {
-                    let mut is_valid = false;
-                    if let Some(JSXAttrValue::Str(s)) = attr.value {
-                        let val = s.value.to_string_lossy().into_owned();
-                        if !val.is_empty() {
-                            base_name = Some(val);
-                            is_valid = true;
-                        }
-                    }
+            let attr = get_jsx_attr(&el, attr_name);
 
-                    if !is_valid {
-                        swc_core::plugin::errors::HANDLER.with(|h| {
-                            h.struct_span_err(
-                                el.span,
-                                &format!("The `{attr_name}` attribute must be a non-empty string literal."),
-                            ).emit();
-                        });
-                    }
-                }
+            let attr_value =
+                attr.and_then(|attr| get_jsx_attr_value_as_string(attr.value.as_ref()?));
+
+            if attr.is_some() && attr_value.is_none() {
+                swc_core::plugin::errors::HANDLER.with(|h| {
+                    h.struct_span_err(
+                        el.span,
+                        &format!("The `{attr_name}` attribute must be a non-empty string literal."),
+                    )
+                    .emit();
+                });
             }
+
+            base_name = attr_value;
+
+            el.attrs = omit_jsx_attrs(el.attrs, HashSet::from([attr_name.as_str()]))
         }
 
         if base_name.is_none() {
             if let Some(defaults) = &self.options.jsx_placeholder_defaults {
                 if let JSXElementName::Ident(ident) = &el.name {
                     if let Some(def) = defaults.get(&ident.sym.to_string()) {
-                        base_name = Some(def.clone());
+                        base_name = Some(def.into());
                     }
                 }
             }
@@ -220,30 +212,7 @@ impl<'a> MessageBuilder<'a> {
             }
 
             if let Some((_, orig_el)) = self.elements_tracking.iter().find(|(k, _)| k == &n) {
-                let has_spreads = orig_el
-                    .attrs
-                    .iter()
-                    .any(|a| matches!(a, JSXAttrOrSpread::SpreadElement(_)));
-                let attrs_equal = if orig_el.attrs.len() == el.attrs.len() {
-                    if has_spreads {
-                        orig_el
-                            .attrs
-                            .iter()
-                            .zip(el.attrs.iter())
-                            .all(|(a, b)| a.eq_ignore_span(b))
-                    } else {
-                        orig_el
-                            .attrs
-                            .iter()
-                            .all(|a| el.attrs.iter().any(|b| a.eq_ignore_span(b)))
-                    }
-                } else {
-                    false
-                };
-
-                let tags_equal = el.name.eq_ignore_span(&orig_el.name);
-
-                if !tags_equal || !attrs_equal {
+                if el.eq_ignore_span(orig_el) {
                     swc_core::plugin::errors::HANDLER.with(|h| {
                         let attr_name = self.options.jsx_placeholder_attribute.as_deref().unwrap_or("_t");
                         let eg = format!("(e.g. `<element {attr_name}=\"newName\" />`)");
diff --git a/tests/jsx.rs b/tests/jsx.rs
index 80db846..cb416df 100644
--- a/tests/jsx.rs
+++ b/tests/jsx.rs
@@ -365,311 +365,3 @@ to!(
 //         <Trans id="msg.hello" />;
 //       `,
 //   },
-
-to!(
-    jsx_named_placeholders_basic,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from "@lingui/react/macro";
-<Trans>
-  Hello <strong _t="em">world</strong>!
-</Trans>;
-     "#
-);
-
-to!(
-    jsx_named_placeholders_stripped_ast,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from "@lingui/react/macro";
-<Trans>
-  <a _t="link" href="/about">About</a>
-</Trans>;
-     "#
-);
-
-to!(
-    jsx_named_placeholders_defaults,
-    LinguiOptions {
-        jsx_placeholder_defaults: Some(std::collections::HashMap::from([
-            ("a".into(), "link".into()),
-            ("em".into(), "em".into()),
-        ])),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from "@lingui/react/macro";
-<Trans>
-  Here's a <a>link</a> and <em>emphasis</em>.
-</Trans>;
-     "#
-);
-
-to!(
-    jsx_named_placeholders_mixed_explicit_and_defaults,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        jsx_placeholder_defaults: Some(std::collections::HashMap::from([(
-            "a".into(),
-            "link".into()
-        ),])),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from "@lingui/react/macro";
-<Trans>Hello <a href="/a">link 1</a>, normal, <a _t="link2" href="/b">link 2</a>.</Trans>;
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_deduplication_different_props,
-    LinguiOptions {
-        jsx_placeholder_defaults: Some(std::collections::HashMap::from(
-            [("a".into(), "a".into()),]
-        )),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from "@lingui/react/macro";
-<Trans>Hello <a href="/a">link 1</a>, normal, <a href="/b">link 2</a>.</Trans>;
-     "#
-);
-
-to!(
-    jsx_named_placeholders_deduplication_identical,
-    LinguiOptions {
-        jsx_placeholder_defaults: Some(std::collections::HashMap::from([(
-            "em".into(),
-            "em".into()
-        ),])),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from "@lingui/react/macro";
-<Trans>Hello <em>emphasis</em>, normal, <em>more emphasis</em>.</Trans>;
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_deduplication_with_stripped_props,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from "@lingui/react/macro";
-<Trans>Hello <a _t="link" href="/a">link 1</a>, normal, <a _t="link" href="/a">link 1 copy</a> and <a _t="link" href="/b">link 2</a>.</Trans>;
-     "#
-);
-
-to!(
-    jsx_named_placeholders_attribute_ignored_when_not_configured,
-    LinguiOptions {
-        ..Default::default()
-    },
-    r#"
-import { Trans } from "@lingui/react/macro";
-<Trans>
-  Hello <strong _t="em">world</strong>!
-</Trans>;
-     "#
-);
-
-to!(
-    jsx_named_placeholders_prop_order,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from "@lingui/react/macro";
-<Trans>Hello <a _t="link" href="/a" class="foo">link 1</a>, normal, <a _t="link" class="foo" href="/a">link 1 copy</a>.</Trans>;
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_prop_order2,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from "@lingui/react/macro";
-<Trans>Hello <a _t="link" href="/a" class="foo">link 1</a>, normal, <a _t="link" href="/b" class="foo">link 1 copy</a>.</Trans>;
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_throws_on_non_string_attribute_value,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-const name = "link";
-<Trans><a _t={name} href="/">click</a></Trans>
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_throws_on_empty_attribute_value,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t="" href="/">click</a></Trans>
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_throws_on_numeric_name,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t="0" href="/">click</a></Trans>
-     "#
-);
-
-to!(
-    jsx_named_placeholders_allows_hyphenated,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t="foo-bar" href="/">click</a></Trans>
-     "#
-);
-
-to!(
-    jsx_named_placeholders_allows_dotted,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t="ns.link" href="/">click</a></Trans>
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_throws_starting_with_hyphen,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t="-foo" href="/">click</a></Trans>
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_throws_ending_with_dot,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t="foo." href="/">click</a></Trans>
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_same_name_different_element_throws,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><em _t="same">A</em> and <strong _t="same">B</strong></Trans>
-     "#
-);
-
-to!(
-    jsx_named_placeholders_identical_spreads_reused,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t="same" {...spread}>A</a> <a _t="same" {...spread}>B</a></Trans>
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_different_spreads_throw,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t="same" {...spread1}>A</a> <a _t="same" {...spread2}>B</a></Trans>
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_same_spread_different_order_throws,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t="same" href="/" {...spread}>A</a> <a _t="same" {...spread} href="/">B</a></Trans>
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_throws_on_empty_string,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t="" href="/">click</a></Trans>
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_throws_on_jsx_expr,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t={"foo"} href="/">click</a></Trans>
-     "#
-);
-
-to_panic!(
-    jsx_named_placeholders_throws_on_boolean_expr,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t href="/">click</a></Trans>
-     "#
-);
diff --git a/tests/jsx_named_placeholders.rs b/tests/jsx_named_placeholders.rs
new file mode 100644
index 0000000..1c0feff
--- /dev/null
+++ b/tests/jsx_named_placeholders.rs
@@ -0,0 +1,312 @@
+use lingui_macro_plugin::LinguiOptions;
+
+#[macro_use]
+mod common;
+
+to!(
+    jsx_named_placeholders_basic,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  Hello <strong _t="em">world</strong>!
+</Trans>;
+     "#
+);
+
+to!(
+    jsx_named_placeholders_stripped_ast,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  <a _t="link" href="/about">About</a>
+</Trans>;
+     "#
+);
+
+to!(
+    jsx_named_placeholders_defaults,
+    LinguiOptions {
+        jsx_placeholder_defaults: Some(std::collections::HashMap::from([
+            ("a".into(), "link".into()),
+            ("em".into(), "em".into()),
+        ])),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  Here's a <a>link</a> and <em>emphasis</em>.
+</Trans>;
+     "#
+);
+
+to!(
+    jsx_named_placeholders_mixed_explicit_and_defaults,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        jsx_placeholder_defaults: Some(std::collections::HashMap::from([(
+            "a".into(),
+            "link".into()
+        ),])),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from "@lingui/react/macro";
+<Trans>Hello <a href="/a">link 1</a>, normal, <a _t="link2" href="/b">link 2</a>.</Trans>;
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_deduplication_different_props,
+    LinguiOptions {
+        jsx_placeholder_defaults: Some(std::collections::HashMap::from(
+            [("a".into(), "a".into()),]
+        )),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from "@lingui/react/macro";
+<Trans>Hello <a href="/a">link 1</a>, normal, <a href="/b">link 2</a>.</Trans>;
+     "#
+);
+
+to!(
+    jsx_named_placeholders_deduplication_identical,
+    LinguiOptions {
+        jsx_placeholder_defaults: Some(std::collections::HashMap::from([(
+            "em".into(),
+            "em".into()
+        ),])),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from "@lingui/react/macro";
+<Trans>Hello <em>emphasis</em>, normal, <em>more emphasis</em>.</Trans>;
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_deduplication_with_stripped_props,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from "@lingui/react/macro";
+<Trans>Hello <a _t="link" href="/a">link 1</a>, normal, <a _t="link" href="/a">link 1 copy</a> and <a _t="link" href="/b">link 2</a>.</Trans>;
+     "#
+);
+
+to!(
+    jsx_named_placeholders_attribute_ignored_when_not_configured,
+    LinguiOptions {
+        ..Default::default()
+    },
+    r#"
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  Hello <strong _t="em">world</strong>!
+</Trans>;
+     "#
+);
+
+to!(
+    jsx_named_placeholders_prop_order,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from "@lingui/react/macro";
+<Trans>Hello <a _t="link" href="/a" class="foo">link 1</a>, normal, <a _t="link" class="foo" href="/a">link 1 copy</a>.</Trans>;
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_prop_order2,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from "@lingui/react/macro";
+<Trans>Hello <a _t="link" href="/a" class="foo">link 1</a>, normal, <a _t="link" href="/b" class="foo">link 1 copy</a>.</Trans>;
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_throws_on_non_string_attribute_value,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+const name = "link";
+<Trans><a _t={name} href="/">click</a></Trans>
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_throws_on_empty_attribute_value,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="" href="/">click</a></Trans>
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_throws_on_numeric_name,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="0" href="/">click</a></Trans>
+     "#
+);
+
+to!(
+    jsx_named_placeholders_allows_hyphenated,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="foo-bar" href="/">click</a></Trans>
+     "#
+);
+
+to!(
+    jsx_named_placeholders_allows_dotted,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="ns.link" href="/">click</a></Trans>
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_throws_starting_with_hyphen,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="-foo" href="/">click</a></Trans>
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_throws_ending_with_dot,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="foo." href="/">click</a></Trans>
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_same_name_different_element_throws,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><em _t="same">A</em> and <strong _t="same">B</strong></Trans>
+     "#
+);
+
+to!(
+    jsx_named_placeholders_identical_spreads_reused,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="same" {...spread}>A</a> <a _t="same" {...spread}>B</a></Trans>
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_different_spreads_throw,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="same" {...spread1}>A</a> <a _t="same" {...spread2}>B</a></Trans>
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_same_spread_different_order_throws,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="same" href="/" {...spread}>A</a> <a _t="same" {...spread} href="/">B</a></Trans>
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_throws_on_empty_string,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="" href="/">click</a></Trans>
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_throws_on_jsx_expr,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t={"foo"} href="/">click</a></Trans>
+     "#
+);
+
+to_panic!(
+    jsx_named_placeholders_throws_on_boolean_expr,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t href="/">click</a></Trans>
+     "#
+);

From 785a8c6b0b2f234b3dded9a0187f75c2c36e2286 Mon Sep 17 00:00:00 2001
From: iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Mon, 20 Apr 2026 12:58:32 +0200
Subject: [PATCH 02/14] readme update

---
 README.md | 52 +++++++++++++++++++++++++---------------------------
 1 file changed, 25 insertions(+), 27 deletions(-)

diff --git a/README.md b/README.md
index c68facc..3380615 100644
--- a/README.md
+++ b/README.md
@@ -53,7 +53,7 @@ https://swc.rs/docs/configuration/swcrc
             //
             // Optional. Controls which descriptor fields are preserved in output.
             // "descriptorFields": "auto" (default) | "all" | "id-only" | "message"
-
+            //
             // Compatibility option allows to use v6.* SWC Plugin release channel with @lingui/cli@5.*
             // Controls the BASE64 alphabet used for generating message IDs.
             // - false (default): Uses URL-safe BASE64 alphabet (Lingui v6 behavior)
@@ -61,9 +61,7 @@ https://swc.rs/docs/configuration/swcrc
             //
             // IMPORTANT: This option is temporal and will be removed in the next major release.
             // "useLinguiV5IdGeneration": true
-            // Lingui strips non-essential fields in production builds for performance.
-            // You can override the default behavior with:
-            // "stripNonEssentialFields": false/true
+            //
             // To configure custom JSX placeholder attribute and its defaults:
             // "jsxPlaceholderAttribute": "_t",
             // "jsxPlaceholderDefaults": {
@@ -121,29 +119,29 @@ Below is a table referencing the `swc_core` version used during the plugin build
 
 To learn more about SWC Plugins compatibility check this issue https://github.com/lingui/swc-plugin/issues/179
 
-| Plugin Version                                    | used `swc_core`                                                                                                                                                       |
-|---------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `0.1.0`, `4.0.0-next.0`                           | `0.52.8`                                                                                                                                                              |
-| `0.2.*`, `4.0.0-next.1` ~ `4.0.0-next.3`          | `0.56.1`                                                                                                                                                              |
-| `4.0.0`                                           | `0.75.33`                                                                                                                                                             |
-| `4.0.1`                                           | `0.76.0`                                                                                                                                                              |
-| `4.0.2`                                           | `0.76.41`                                                                                                                                                             |
-| `4.0.3`                                           | `0.78.28`                                                                                                                                                             |
-| `4.0.4`                                           | `0.79.x`                                                                                                                                                              |
-| `4.0.5`, `4.0.6`                                  | [`0.87.x`](https://plugins.swc.rs/versions/range/10)                                                                                                                  |
-| `4.0.7`, `4.0.8`, `5.0.0-next.0` ~ `5.0.0-next.1` | [`0.90.35`](https://plugins.swc.rs/versions/range/12)                                                                                                                 |
-| `4.0.9`                                           | [`0.96.9`](https://plugins.swc.rs/versions/range/15)                                                                                                                  |
-| `4.0.10`                                          | [`0.101.4`](https://plugins.swc.rs/versions/range/94)                                                                                                                 |
-| `4.1.0`, `5.0.0` ~ `5.2.0`                        | [`0.106.3`](https://plugins.swc.rs/versions/range/95)                                                                                                                 |
-| `5.3.0`                                           | [`5.0.4`](https://plugins.swc.rs/versions/range/116)                                                                                                                  |
-| `5.4.0`                                           | [`14.1.0`](https://plugins.swc.rs/versions/range/138)                                                                                                                 |
-| `5.5.0` ~ `5.5.2`                                 | [`15.0.1`](https://plugins.swc.rs/versions/range/271)                                                                                                                 |
-| `5.6.0` ~ `5.6.1`                                 | [`27.0.6`](https://plugins.swc.rs/versions/range/364)                                                                                                                 |
-| `5.7.0`                                           | [`39.0.3`](https://plugins.swc.rs/versions/range/426)                                                                                                                 |
-| `5.8.0`                                           | [`45.0.2`](https://plugins.swc.rs/versions/range/497)                                                                                                                 |
-| `5.9.0`                                           | [`46.0.3`](https://plugins.swc.rs/versions/range/713)                                                                                                                 |
-| `5.10.0`                                          | [`50.2.3`](https://plugins.swc.rs/versions/range/768)                                                                                                                 |
-| `5.10.1`, `5.11.0`                                | [`50.2.3`](https://plugins.swc.rs/versions/range/768) with [`--cfg=swc_ast_unknown`](https://swc.rs/docs/plugin/ecmascript/compatibility#make-your-plugin-compatible) |
+| Plugin Version                                                                                                                                                                                                                | used `swc_core`                                                                                                                                                       |
+|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `0.1.0`, `4.0.0-next.0`                                                                                                                                                                                                       | `0.52.8`                                                                                                                                                              |
+| `0.2.*`, `4.0.0-next.1` ~ `4.0.0-next.3`                                                                                                                                                                                      | `0.56.1`                                                                                                                                                              |
+| `4.0.0`                                                                                                                                                                                                                       | `0.75.33`                                                                                                                                                             |
+| `4.0.1`                                                                                                                                                                                                                       | `0.76.0`                                                                                                                                                              |
+| `4.0.2`                                                                                                                                                                                                                       | `0.76.41`                                                                                                                                                             |
+| `4.0.3`                                                                                                                                                                                                                       | `0.78.28`                                                                                                                                                             |
+| `4.0.4`                                                                                                                                                                                                                       | `0.79.x`                                                                                                                                                              |
+| `4.0.5`, `4.0.6`                                                                                                                                                                                                              | [`0.87.x`](https://plugins.swc.rs/versions/range/10)                                                                                                                  |
+| `4.0.7`, `4.0.8`, `5.0.0-next.0` ~ `5.0.0-next.1`                                                                                                                                                                             | [`0.90.35`](https://plugins.swc.rs/versions/range/12)                                                                                                                 |
+| `4.0.9`                                                                                                                                                                                                                       | [`0.96.9`](https://plugins.swc.rs/versions/range/15)                                                                                                                  |
+| `4.0.10`                                                                                                                                                                                                                      | [`0.101.4`](https://plugins.swc.rs/versions/range/94)                                                                                                                 |
+| `4.1.0`, `5.0.0` ~ `5.2.0`                                                                                                                                                                                                    | [`0.106.3`](https://plugins.swc.rs/versions/range/95)                                                                                                                 |
+| `5.3.0`                                                                                                                                                                                                                       | [`5.0.4`](https://plugins.swc.rs/versions/range/116)                                                                                                                  |
+| `5.4.0`                                                                                                                                                                                                                       | [`14.1.0`](https://plugins.swc.rs/versions/range/138)                                                                                                                 |
+| `5.5.0` ~ `5.5.2`                                                                                                                                                                                                             | [`15.0.1`](https://plugins.swc.rs/versions/range/271)                                                                                                                 |
+| `5.6.0` ~ `5.6.1`                                                                                                                                                                                                             | [`27.0.6`](https://plugins.swc.rs/versions/range/364)                                                                                                                 |
+| `5.7.0`                                                                                                                                                                                                                       | [`39.0.3`](https://plugins.swc.rs/versions/range/426)                                                                                                                 |
+| `5.8.0`                                                                                                                                                                                                                       | [`45.0.2`](https://plugins.swc.rs/versions/range/497)                                                                                                                 |
+| `5.9.0`                                                                                                                                                                                                                       | [`46.0.3`](https://plugins.swc.rs/versions/range/713)                                                                                                                 |
+| `5.10.0`                                                                                                                                                                                                                      | [`50.2.3`](https://plugins.swc.rs/versions/range/768)                                                                                                                 |
+| `5.10.1` ~ `*`  <br/> Starting from this version Wasm plugins are compatible between `@swc/core` versions to some extent. Read more [here](https://swc.rs/docs/plugin/ecmascript/compatibility#make-your-plugin-compatible). | [`50.2.3`](https://plugins.swc.rs/versions/range/768) with [`--cfg=swc_ast_unknown`](https://swc.rs/docs/plugin/ecmascript/compatibility#make-your-plugin-compatible) |
 
 
 > **Note**

From 30838daa27aaf7a5a19503e360a0a705c9989b94 Mon Sep 17 00:00:00 2001
From: iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Mon, 20 Apr 2026 13:45:47 +0200
Subject: [PATCH 03/14] fixes

---
 src/ast_utils.rs                              | 31 +++++++++++-
 src/builder.rs                                |  6 +--
 ...ceholders_deduplication_different_props.js |  9 ----
 ...lders_deduplication_with_stripped_props.js |  9 ----
 .../jsx_named_placeholders_prop_order2.js     |  9 ----
 .../allows_dotted.js}                         |  0
 .../allows_hyphenated.js}                     |  0
 .../attribute_ignored_when_not_configured.js} |  0
 .../basic.js}                                 |  0
 .../deduplication_identical.js}               |  0
 .../defaults.js}                              |  0
 .../identical_spreads_reused.js}              |  0
 .../mixed_explicit_and_defaults.js}           |  0
 .../prop_order.js}                            |  0
 .../stripped_ast.js}                          |  0
 .../supports_string_in_jsx_expression.js}     |  7 ++-
 tests/jsx_named_placeholders.rs               | 50 +++++++++----------
 17 files changed, 60 insertions(+), 61 deletions(-)
 delete mode 100644 tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_deduplication_different_props.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_deduplication_with_stripped_props.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_prop_order2.js
 rename tests/__swc_snapshots__/tests/{jsx.rs/jsx_named_placeholders_allows_dotted.js => jsx_named_placeholders.rs/allows_dotted.js} (100%)
 rename tests/__swc_snapshots__/tests/{jsx.rs/jsx_named_placeholders_allows_hyphenated.js => jsx_named_placeholders.rs/allows_hyphenated.js} (100%)
 rename tests/__swc_snapshots__/tests/{jsx.rs/jsx_named_placeholders_attribute_ignored_when_not_configured.js => jsx_named_placeholders.rs/attribute_ignored_when_not_configured.js} (100%)
 rename tests/__swc_snapshots__/tests/{jsx.rs/jsx_named_placeholders_basic.js => jsx_named_placeholders.rs/basic.js} (100%)
 rename tests/__swc_snapshots__/tests/{jsx.rs/jsx_named_placeholders_deduplication_identical.js => jsx_named_placeholders.rs/deduplication_identical.js} (100%)
 rename tests/__swc_snapshots__/tests/{jsx.rs/jsx_named_placeholders_defaults.js => jsx_named_placeholders.rs/defaults.js} (100%)
 rename tests/__swc_snapshots__/tests/{jsx.rs/jsx_named_placeholders_identical_spreads_reused.js => jsx_named_placeholders.rs/identical_spreads_reused.js} (100%)
 rename tests/__swc_snapshots__/tests/{jsx.rs/jsx_named_placeholders_mixed_explicit_and_defaults.js => jsx_named_placeholders.rs/mixed_explicit_and_defaults.js} (100%)
 rename tests/__swc_snapshots__/tests/{jsx.rs/jsx_named_placeholders_prop_order.js => jsx_named_placeholders.rs/prop_order.js} (100%)
 rename tests/__swc_snapshots__/tests/{jsx.rs/jsx_named_placeholders_stripped_ast.js => jsx_named_placeholders.rs/stripped_ast.js} (100%)
 rename tests/__swc_snapshots__/tests/{jsx.rs/jsx_named_placeholders_throws_on_non_string_attribute_value.js => jsx_named_placeholders.rs/supports_string_in_jsx_expression.js} (52%)

diff --git a/src/ast_utils.rs b/src/ast_utils.rs
index 5efe3e7..86b9394 100644
--- a/src/ast_utils.rs
+++ b/src/ast_utils.rs
@@ -1,7 +1,7 @@
 use std::collections::HashSet;
 use swc_core::atoms::atom;
 use swc_core::common::comments::{Comment, CommentKind, Comments};
-use swc_core::common::{Span, DUMMY_SP};
+use swc_core::common::{EqIgnoreSpan, Span, DUMMY_SP};
 use swc_core::ecma::ast::*;
 use swc_core::ecma::atoms::Atom;
 use swc_core::ecma::utils::quote_ident;
@@ -112,12 +112,39 @@ pub fn omit_jsx_attrs(
                 return !names.contains(name);
             }
         }
-        false
+        true
     });
 
     attrs
 }
 
+pub fn is_jsx_elements_equal(a: &JSXOpeningElement, b: &JSXOpeningElement) -> bool {
+    let attrs_equal = if a.attrs.len() == b.attrs.len() {
+        let has_spreads = a
+            .attrs
+            .iter()
+            .any(|a| matches!(a, JSXAttrOrSpread::SpreadElement(_)));
+
+        if has_spreads {
+            a.attrs
+                .iter()
+                .zip(b.attrs.iter())
+                .all(|(a, b)| a.eq_ignore_span(b))
+        } else {
+            a.attrs
+                .iter()
+                .all(|a| b.attrs.iter().any(|b| a.eq_ignore_span(b)))
+        }
+    } else {
+        false
+    };
+
+    let tags_equal = a.name.eq_ignore_span(&b.name);
+
+    print!("{tags_equal} {attrs_equal}");
+    tags_equal && attrs_equal
+}
+
 pub fn match_callee_name<F: Fn(&Ident) -> bool>(call: &CallExpr, predicate: F) -> Option<&Ident> {
     if let Callee::Expr(expr) = &call.callee {
         if let Expr::Ident(ident) = expr.as_ref() {
diff --git a/src/builder.rs b/src/builder.rs
index 55328c9..b6cd296 100644
--- a/src/builder.rs
+++ b/src/builder.rs
@@ -1,10 +1,10 @@
 use crate::ast_utils::{
-    expand_ts_as_expr, get_jsx_attr, get_jsx_attr_value_as_string, omit_jsx_attrs,
+    expand_ts_as_expr, get_jsx_attr, get_jsx_attr_value_as_string, is_jsx_elements_equal,
+    omit_jsx_attrs,
 };
 use crate::options::LinguiOptions;
 use crate::tokens::{CaseOrOffset, IcuChoice, MsgToken};
 use std::collections::HashSet;
-use swc_core::common::EqIgnoreSpan;
 use swc_core::{
     common::{SyntaxContext, DUMMY_SP},
     ecma::ast::*,
@@ -212,7 +212,7 @@ impl<'a> MessageBuilder<'a> {
             }
 
             if let Some((_, orig_el)) = self.elements_tracking.iter().find(|(k, _)| k == &n) {
-                if el.eq_ignore_span(orig_el) {
+                if !is_jsx_elements_equal(&el, orig_el) {
                     swc_core::plugin::errors::HANDLER.with(|h| {
                         let attr_name = self.options.jsx_placeholder_attribute.as_deref().unwrap_or("_t");
                         let eg = format!("(e.g. `<element {attr_name}=\"newName\" />`)");
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_deduplication_different_props.js b/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_deduplication_different_props.js
deleted file mode 100644
index c426058..0000000
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_deduplication_different_props.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "Qb0oHL",
-    components: {
-        a: <a href="/a"/>,
-        a2: <a href="/b"/>
-    },
-    message: "Hello <a>link 1</a>, normal, <a2>link 2</a2>."
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_deduplication_with_stripped_props.js b/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_deduplication_with_stripped_props.js
deleted file mode 100644
index f1b496b..0000000
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_deduplication_with_stripped_props.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "gG0lnu",
-    components: {
-        link: <a href="/a"/>,
-        link2: <a href="/b"/>
-    },
-    message: "Hello <link>link 1</link>, normal, <link>link 1 copy</link> and <link2>link 2</link2>."
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_prop_order2.js b/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_prop_order2.js
deleted file mode 100644
index 9caf556..0000000
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_prop_order2.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "jTjLWk",
-    components: {
-        link: <a href="/a" class="foo"/>,
-        link2: <a href="/b" class="foo"/>
-    },
-    message: "Hello <link>link 1</link>, normal, <link2>link 1 copy</link2>."
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_allows_dotted.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/allows_dotted.js
similarity index 100%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_allows_dotted.js
rename to tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/allows_dotted.js
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_allows_hyphenated.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/allows_hyphenated.js
similarity index 100%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_allows_hyphenated.js
rename to tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/allows_hyphenated.js
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_attribute_ignored_when_not_configured.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/attribute_ignored_when_not_configured.js
similarity index 100%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_attribute_ignored_when_not_configured.js
rename to tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/attribute_ignored_when_not_configured.js
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_basic.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/basic.js
similarity index 100%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_basic.js
rename to tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/basic.js
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_deduplication_identical.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/deduplication_identical.js
similarity index 100%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_deduplication_identical.js
rename to tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/deduplication_identical.js
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_defaults.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/defaults.js
similarity index 100%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_defaults.js
rename to tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/defaults.js
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_identical_spreads_reused.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/identical_spreads_reused.js
similarity index 100%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_identical_spreads_reused.js
rename to tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/identical_spreads_reused.js
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_mixed_explicit_and_defaults.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/mixed_explicit_and_defaults.js
similarity index 100%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_mixed_explicit_and_defaults.js
rename to tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/mixed_explicit_and_defaults.js
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_prop_order.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/prop_order.js
similarity index 100%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_prop_order.js
rename to tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/prop_order.js
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_stripped_ast.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/stripped_ast.js
similarity index 100%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_stripped_ast.js
rename to tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/stripped_ast.js
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_throws_on_non_string_attribute_value.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/supports_string_in_jsx_expression.js
similarity index 52%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_throws_on_non_string_attribute_value.js
rename to tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/supports_string_in_jsx_expression.js
index 6610fb6..44cbead 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_named_placeholders_throws_on_non_string_attribute_value.js
+++ b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/supports_string_in_jsx_expression.js
@@ -1,9 +1,8 @@
 import { Trans as Trans_ } from "@lingui/react";
-const name = "link";
 <Trans_ {.../*i18n*/ {
-    id: "ancPIj",
+    id: "CeJE1x",
     components: {
-        0: <a href="/"/>
+        foo: <a href="/"/>
     },
-    message: "<0>click</0>"
+    message: "<foo>click</foo>"
 }}/>;
diff --git a/tests/jsx_named_placeholders.rs b/tests/jsx_named_placeholders.rs
index 1c0feff..e4a7885 100644
--- a/tests/jsx_named_placeholders.rs
+++ b/tests/jsx_named_placeholders.rs
@@ -4,7 +4,7 @@ use lingui_macro_plugin::LinguiOptions;
 mod common;
 
 to!(
-    jsx_named_placeholders_basic,
+    basic,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -18,7 +18,7 @@ import { Trans } from "@lingui/react/macro";
 );
 
 to!(
-    jsx_named_placeholders_stripped_ast,
+    stripped_ast,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -32,7 +32,7 @@ import { Trans } from "@lingui/react/macro";
 );
 
 to!(
-    jsx_named_placeholders_defaults,
+    defaults,
     LinguiOptions {
         jsx_placeholder_defaults: Some(std::collections::HashMap::from([
             ("a".into(), "link".into()),
@@ -49,7 +49,7 @@ import { Trans } from "@lingui/react/macro";
 );
 
 to!(
-    jsx_named_placeholders_mixed_explicit_and_defaults,
+    mixed_explicit_and_defaults,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         jsx_placeholder_defaults: Some(std::collections::HashMap::from([(
@@ -65,7 +65,7 @@ import { Trans } from "@lingui/react/macro";
 );
 
 to_panic!(
-    jsx_named_placeholders_deduplication_different_props,
+    deduplication_different_props,
     LinguiOptions {
         jsx_placeholder_defaults: Some(std::collections::HashMap::from(
             [("a".into(), "a".into()),]
@@ -79,7 +79,7 @@ import { Trans } from "@lingui/react/macro";
 );
 
 to!(
-    jsx_named_placeholders_deduplication_identical,
+    deduplication_identical,
     LinguiOptions {
         jsx_placeholder_defaults: Some(std::collections::HashMap::from([(
             "em".into(),
@@ -94,7 +94,7 @@ import { Trans } from "@lingui/react/macro";
 );
 
 to_panic!(
-    jsx_named_placeholders_deduplication_with_stripped_props,
+    deduplication_with_stripped_props,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -106,7 +106,7 @@ import { Trans } from "@lingui/react/macro";
 );
 
 to!(
-    jsx_named_placeholders_attribute_ignored_when_not_configured,
+    attribute_ignored_when_not_configured,
     LinguiOptions {
         ..Default::default()
     },
@@ -119,7 +119,7 @@ import { Trans } from "@lingui/react/macro";
 );
 
 to!(
-    jsx_named_placeholders_prop_order,
+    prop_order,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -131,7 +131,7 @@ import { Trans } from "@lingui/react/macro";
 );
 
 to_panic!(
-    jsx_named_placeholders_prop_order2,
+    prop_order2,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -143,7 +143,7 @@ import { Trans } from "@lingui/react/macro";
 );
 
 to_panic!(
-    jsx_named_placeholders_throws_on_non_string_attribute_value,
+    throws_on_non_string_attribute_value,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -156,7 +156,7 @@ const name = "link";
 );
 
 to_panic!(
-    jsx_named_placeholders_throws_on_empty_attribute_value,
+    throws_on_empty_attribute_value,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -168,7 +168,7 @@ import { Trans } from '@lingui/react/macro';
 );
 
 to_panic!(
-    jsx_named_placeholders_throws_on_numeric_name,
+    throws_on_numeric_name,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -180,7 +180,7 @@ import { Trans } from '@lingui/react/macro';
 );
 
 to!(
-    jsx_named_placeholders_allows_hyphenated,
+    allows_hyphenated,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -192,7 +192,7 @@ import { Trans } from '@lingui/react/macro';
 );
 
 to!(
-    jsx_named_placeholders_allows_dotted,
+    allows_dotted,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -204,7 +204,7 @@ import { Trans } from '@lingui/react/macro';
 );
 
 to_panic!(
-    jsx_named_placeholders_throws_starting_with_hyphen,
+    throws_starting_with_hyphen,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -216,7 +216,7 @@ import { Trans } from '@lingui/react/macro';
 );
 
 to_panic!(
-    jsx_named_placeholders_throws_ending_with_dot,
+    throws_ending_with_dot,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -228,7 +228,7 @@ import { Trans } from '@lingui/react/macro';
 );
 
 to_panic!(
-    jsx_named_placeholders_same_name_different_element_throws,
+    same_name_different_element_throws,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -240,7 +240,7 @@ import { Trans } from '@lingui/react/macro';
 );
 
 to!(
-    jsx_named_placeholders_identical_spreads_reused,
+    identical_spreads_reused,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -252,7 +252,7 @@ import { Trans } from '@lingui/react/macro';
 );
 
 to_panic!(
-    jsx_named_placeholders_different_spreads_throw,
+    different_spreads_throw,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -264,7 +264,7 @@ import { Trans } from '@lingui/react/macro';
 );
 
 to_panic!(
-    jsx_named_placeholders_same_spread_different_order_throws,
+    same_spread_different_order_throws,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -276,7 +276,7 @@ import { Trans } from '@lingui/react/macro';
 );
 
 to_panic!(
-    jsx_named_placeholders_throws_on_empty_string,
+    throws_on_empty_string,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -287,8 +287,8 @@ import { Trans } from '@lingui/react/macro';
      "#
 );
 
-to_panic!(
-    jsx_named_placeholders_throws_on_jsx_expr,
+to!(
+    supports_string_in_jsx_expression,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()
@@ -300,7 +300,7 @@ import { Trans } from '@lingui/react/macro';
 );
 
 to_panic!(
-    jsx_named_placeholders_throws_on_boolean_expr,
+    throws_on_boolean_expr,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()

From 45a31cee549183dce0ed3e2313212e70cff1d18e Mon Sep 17 00:00:00 2001
From: iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Mon, 20 Apr 2026 13:59:00 +0200
Subject: [PATCH 04/14] simplify flow

---
 src/ast_utils.rs | 43 +++++++++++++++++++++----------------------
 1 file changed, 21 insertions(+), 22 deletions(-)

diff --git a/src/ast_utils.rs b/src/ast_utils.rs
index 86b9394..1a733b1 100644
--- a/src/ast_utils.rs
+++ b/src/ast_utils.rs
@@ -119,30 +119,29 @@ pub fn omit_jsx_attrs(
 }
 
 pub fn is_jsx_elements_equal(a: &JSXOpeningElement, b: &JSXOpeningElement) -> bool {
-    let attrs_equal = if a.attrs.len() == b.attrs.len() {
-        let has_spreads = a
-            .attrs
-            .iter()
-            .any(|a| matches!(a, JSXAttrOrSpread::SpreadElement(_)));
-
-        if has_spreads {
-            a.attrs
-                .iter()
-                .zip(b.attrs.iter())
-                .all(|(a, b)| a.eq_ignore_span(b))
-        } else {
-            a.attrs
-                .iter()
-                .all(|a| b.attrs.iter().any(|b| a.eq_ignore_span(b)))
-        }
-    } else {
-        false
-    };
+    if !a.name.eq_ignore_span(&b.name) {
+        return false;
+    }
+
+    if a.attrs.len() != b.attrs.len() {
+        return false;
+    }
 
-    let tags_equal = a.name.eq_ignore_span(&b.name);
+    let has_spreads = a
+        .attrs
+        .iter()
+        .any(|a| matches!(a, JSXAttrOrSpread::SpreadElement(_)));
 
-    print!("{tags_equal} {attrs_equal}");
-    tags_equal && attrs_equal
+    if has_spreads {
+        a.attrs
+            .iter()
+            .zip(b.attrs.iter())
+            .all(|(a, b)| a.eq_ignore_span(b))
+    } else {
+        a.attrs
+            .iter()
+            .all(|a| b.attrs.iter().any(|b| a.eq_ignore_span(b)))
+    }
 }
 
 pub fn match_callee_name<F: Fn(&Ident) -> bool>(call: &CallExpr, predicate: F) -> Option<&Ident> {

From 0eba12f471af8835e729e23a5a82364327161693 Mon Sep 17 00:00:00 2001
From: iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Mon, 20 Apr 2026 14:02:06 +0200
Subject: [PATCH 05/14] add est case

---
 tests/jsx_named_placeholders.rs | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/tests/jsx_named_placeholders.rs b/tests/jsx_named_placeholders.rs
index e4a7885..d1c4898 100644
--- a/tests/jsx_named_placeholders.rs
+++ b/tests/jsx_named_placeholders.rs
@@ -239,6 +239,18 @@ import { Trans } from '@lingui/react/macro';
      "#
 );
 
+to_panic!(
+    same_element_diffrent_attributes_count_throw,
+    LinguiOptions {
+        jsx_placeholder_attribute: Some("_t".into()),
+        ..Default::default()
+    },
+    r#"
+import { Trans } from '@lingui/react/macro';
+<Trans><em _t="same" class="hello">A</em> and <em _t="same" class="hello" data-testId="bla">B</strong></Trans>
+     "#
+);
+
 to!(
     identical_spreads_reused,
     LinguiOptions {

From fc42db95f70668a0d14108d5da39de02ac641679 Mon Sep 17 00:00:00 2001
From: iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Tue, 21 Apr 2026 12:25:40 +0200
Subject: [PATCH 06/14] add claude md

---
 CLAUDE.md | 64 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..f68aae2
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,64 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+SWC plugin for [LinguiJS](https://lingui.dev) — a Rust-based compile-time macro that transforms `@lingui/macro` and `@lingui/react/macro` calls into optimized i18n runtime code. Compiles to WebAssembly (wasm32-wasip1) and runs inside SWC/Next.js build pipelines.
+
+## Build & Test Commands
+
+```bash
+# Build WASM (primary target)
+cargo build-wasi --release
+
+# Run all tests
+cargo test
+
+# Run a single test by name
+cargo test js_choices_may_contain_expressions
+
+# Run tests matching a prefix
+cargo test jsx_
+
+# Update snapshots after intentional changes
+UPDATE=1 cargo test
+
+# Format / lint
+cargo fmt --check
+cargo clippy --all-targets --all-features -- -D warnings
+
+# E2E tests (requires WASM build + Node v22 + yarn)
+cargo build-wasi --release && yarn test:e2e
+```
+
+## Architecture
+
+The plugin follows SWC's AST visitor pattern using the `Fold` trait for recursive descent transformation.
+
+**Core transformation pipeline:**
+1. `lib.rs` — Entry point (`#[plugin_transform]`). Parses config, creates `LinguiMacroFolder` which implements `Fold`.
+2. `macro_utils.rs` — `MacroCtx` tracks imports from `@lingui/macro` and `@lingui/react/macro`, maps symbol names to local identifiers.
+3. `js_macro_folder.rs` — Transforms JS macro calls (`t()`, `defineMessage()`, `msg()`) into `MsgToken` streams.
+4. `jsx_visitor.rs` — `TransJSXVisitor` transforms JSX elements (`<Trans>`, `<Plural>`, `<Select>`) into `MsgToken` streams.
+5. `builder.rs` — `MessageBuilder` converts token streams into ICU MessageFormat strings, extracts values/components, and builds message descriptors.
+6. `options.rs` — `LinguiOptions` / `DescriptorFields` config. Controls which descriptor fields survive in output ("auto", "all", "id-only", "message").
+7. `generate_id.rs` — Deterministic SHA2-based message ID generation.
+
+**Key types:** `MsgToken` enum (String, Expression, TagOpening, TagClosing, IcuChoice) is the intermediate representation between parsing and message building.
+
+## Testing
+
+Tests use SWC's snapshot testing infrastructure. Test macros are defined in `tests/common/mod.rs`:
+- `to!(test_name, "input code")` — transform with default options
+- `to!(test_name, options, "input code")` — transform with custom options
+- `to_panic!(test_name, "input code")` — expect compilation error
+
+Snapshots live in `tests/__swc_snapshots__/` with subdirectories per test file. Update with `UPDATE=1 cargo test`.
+
+## Toolchain
+
+- Rust 1.85 pinned in `rust-toolchain.toml`
+- WASM target: `wasm32-wasip1` (aliased as `cargo build-wasi` in `.cargo/config.toml`)
+- Node v22 (`.nvmrc`), Yarn v4 with `nodeLinker: node-modules`
+- SWC core v50.2.3 (`swc_core` crate)

From 5117d560832e8a2238802ae58385986c4286378d Mon Sep 17 00:00:00 2001
From: iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Tue, 21 Apr 2026 12:29:16 +0200
Subject: [PATCH 07/14] add skills

---
 .agents/skills/rust-best-practices/SKILL.md   |  94 +++
 .../references/chapter_01.md                  | 552 ++++++++++++++++++
 .../references/chapter_02.md                  | 117 ++++
 .../references/chapter_03.md                  | 209 +++++++
 .../references/chapter_04.md                  | 180 ++++++
 .../references/chapter_05.md                  | 381 ++++++++++++
 .../references/chapter_06.md                  | 161 +++++
 .../references/chapter_07.md                  | 226 +++++++
 .../references/chapter_08.md                  | 254 ++++++++
 .../references/chapter_09.md                  | 256 ++++++++
 .claude/skills/rust-best-practices            |   1 +
 skills-lock.json                              |  10 +
 12 files changed, 2441 insertions(+)
 create mode 100644 .agents/skills/rust-best-practices/SKILL.md
 create mode 100644 .agents/skills/rust-best-practices/references/chapter_01.md
 create mode 100644 .agents/skills/rust-best-practices/references/chapter_02.md
 create mode 100644 .agents/skills/rust-best-practices/references/chapter_03.md
 create mode 100644 .agents/skills/rust-best-practices/references/chapter_04.md
 create mode 100644 .agents/skills/rust-best-practices/references/chapter_05.md
 create mode 100644 .agents/skills/rust-best-practices/references/chapter_06.md
 create mode 100644 .agents/skills/rust-best-practices/references/chapter_07.md
 create mode 100644 .agents/skills/rust-best-practices/references/chapter_08.md
 create mode 100644 .agents/skills/rust-best-practices/references/chapter_09.md
 create mode 120000 .claude/skills/rust-best-practices
 create mode 100644 skills-lock.json

diff --git a/.agents/skills/rust-best-practices/SKILL.md b/.agents/skills/rust-best-practices/SKILL.md
new file mode 100644
index 0000000..f527c7f
--- /dev/null
+++ b/.agents/skills/rust-best-practices/SKILL.md
@@ -0,0 +1,94 @@
+---
+name: rust-best-practices
+description: >
+  Guide for writing idiomatic Rust code based on Apollo GraphQL's best practices handbook. Use this skill when:
+  (1) writing new Rust code or functions,
+  (2) reviewing or refactoring existing Rust code,
+  (3) deciding between borrowing vs cloning or ownership patterns,
+  (4) implementing error handling with Result types,
+  (5) optimizing Rust code for performance,
+  (6) writing tests or documentation for Rust projects.
+license: MIT
+compatibility: Rust 1.70+, Cargo
+metadata:
+  author: apollographql
+  version: "1.1.0"
+allowed-tools: Bash(cargo:*) Bash(rustc:*) Bash(rustfmt:*) Bash(clippy:*) Read Write Edit Glob Grep
+---
+
+# Rust Best Practices
+
+Apply these guidelines when writing or reviewing Rust code. Based on Apollo GraphQL's [Rust Best Practices Handbook](https://github.com/apollographql/rust-best-practices).
+
+## Best Practices Reference
+
+Before reviewing, familiarize yourself with Apollo's Rust best practices. Read ALL relevant chapters in the same turn in parallel. Reference these files when providing feedback:
+
+- [Chapter 1 - Coding Styles and Idioms](references/chapter_01.md): Borrowing vs cloning, Copy trait, Option/Result handling, iterators, comments
+- [Chapter 2 - Clippy and Linting](references/chapter_02.md): Clippy configuration, important lints, workspace lint setup
+- [Chapter 3 - Performance Mindset](references/chapter_03.md): Profiling, avoiding redundant clones, stack vs heap, zero-cost abstractions
+- [Chapter 4 - Error Handling](references/chapter_04.md): Result vs panic, thiserror vs anyhow, error hierarchies
+- [Chapter 5 - Automated Testing](references/chapter_05.md): Test naming, one assertion per test, snapshot testing
+- [Chapter 6 - Generics and Dispatch](references/chapter_06.md): Static vs dynamic dispatch, trait objects
+- [Chapter 7 - Type State Pattern](references/chapter_07.md): Compile-time state safety, when to use it
+- [Chapter 8 - Comments vs Documentation](references/chapter_08.md): When to comment, doc comments, rustdoc
+- [Chapter 9 - Understanding Pointers](references/chapter_09.md): Thread safety, Send/Sync, pointer types
+
+## Quick Reference
+
+### Borrowing & Ownership
+- Prefer `&T` over `.clone()` unless ownership transfer is required
+- Use `&str` over `String`, `&[T]` over `Vec<T>` in function parameters
+- Small `Copy` types (≤24 bytes) can be passed by value
+- Use `Cow<'_, T>` when ownership is ambiguous
+
+### Error Handling
+- Return `Result<T, E>` for fallible operations; avoid `panic!` in production
+- Never use `unwrap()`/`expect()` outside tests
+- Use `thiserror` for library errors, `anyhow` for binaries only
+- Prefer `?` operator over match chains for error propagation
+
+### Performance
+- Always benchmark with `--release` flag
+- Run `cargo clippy -- -D clippy::perf` for performance hints
+- Avoid cloning in loops; use `.iter()` instead of `.into_iter()` for Copy types
+- Prefer iterators over manual loops; avoid intermediate `.collect()` calls
+
+### Linting
+Run regularly: `cargo clippy --all-targets --all-features --locked -- -D warnings`
+
+Key lints to watch:
+- `redundant_clone` - unnecessary cloning
+- `large_enum_variant` - oversized variants (consider boxing)
+- `needless_collect` - premature collection
+
+Use `#[expect(clippy::lint)]` over `#[allow(...)]` with justification comment.
+
+### Testing
+- Name tests descriptively: `process_should_return_error_when_input_empty()`
+- One assertion per test when possible
+- Use doc tests (`///`) for public API examples
+- Consider `cargo insta` for snapshot testing generated output
+
+### Generics & Dispatch
+- Prefer generics (static dispatch) for performance-critical code
+- Use `dyn Trait` only when heterogeneous collections are needed
+- Box at API boundaries, not internally
+
+### Type State Pattern
+Encode valid states in the type system to catch invalid operations at compile time:
+```rust
+struct Connection<State> { /* ... */ _state: PhantomData<State> }
+struct Disconnected;
+struct Connected;
+
+impl Connection<Connected> {
+    fn send(&self, data: &[u8]) { /* only connected can send */ }
+}
+```
+
+### Documentation
+- `//` comments explain *why* (safety, workarounds, design rationale)
+- `///` doc comments explain *what* and *how* for public APIs
+- Every `TODO` needs a linked issue: `// TODO(#42): ...`
+- Enable `#![deny(missing_docs)]` for libraries
diff --git a/.agents/skills/rust-best-practices/references/chapter_01.md b/.agents/skills/rust-best-practices/references/chapter_01.md
new file mode 100644
index 0000000..d41bfd0
--- /dev/null
+++ b/.agents/skills/rust-best-practices/references/chapter_01.md
@@ -0,0 +1,552 @@
+# Chapter 1 - Coding Styles and Idioms
+
+## 1.1 Borrowing Over Cloning
+
+Rust's ownership system encourages **borrow** (`&T`) instead of **cloning** (`T.clone()`). 
+> ❗ Performance recommendation
+
+### ✅ When to `Clone`:
+
+* You need to change the object AND preserve the original object (immutable snapshots).
+* When you have `Arc` or `Rc` pointers.
+* When data is shared across threads, usually `Arc`.
+* Avoid massive refactoring of non performance critical code.
+* When caching results (dummy example below):
+```rust
+fn get_config(&self) -> Config {
+    self.cached_config.clone()
+}
+```
+* When the underlying API expects Owned Data.
+
+### 🚨 `Clone` traps to avoid:
+
+* Auto-cloning inside loops `.map(|x| x.clone)`, prefer to call `.cloned()` or `.copied()` at the end of the iterator.
+* Cloning large data structures like `Vec<T>` or `HashMap<K, V>`.
+* Clone because of bad API design instead of adjusting lifetimes.
+* Prefer `&[T]` instead of `Vec<T>` or `&Vec<T>`.
+* Prefer `&str` or `&String` instead of `String`.
+* Prefer `&T` instead of `T`.
+* Clone a reference argument, if you need ownership, make it explicit in the arguments for the caller. Example:
+```rust
+fn take_a_borrow(thing: &Thing) {
+    let thing_cloned = thing.clone(); // the caller should have passed ownership instead
+}
+```
+
+### ✅ Prefer borrowing:
+```rust
+fn process(name: &str) {
+    println!("Hello {name}");
+}
+
+let user = String::from("foo");
+process(&user);
+```
+
+### ❌ Avoid redundant cloning:
+```rust
+fn process_string(name: String) {
+    println!("Hello {name}");
+}
+
+let user = String::from("foo");
+process(user.clone()); // Unnecessary clone
+```
+
+## 1.2 When to pass by value? (Copy trait)
+
+Not all types should be passed by reference (`&T`). If a type is **small** and it is **cheap to copy**, it is often better to **pass it by value**. Rust makes it explicit via the `Copy` trait.
+
+### ✅ When to pass by value, `Copy`:
+* The type **implements** `Copy` (`u32`, `bool`, `f32`, small structs).
+* The cost of moving the value is negligible.
+
+```rust
+fn increment(x: u32) -> u32 {
+    x + 1
+}
+
+let num = 1;
+let new_num = increment(num); // `num` still usable after this point
+```
+
+### ❓ Which structs should be `Copy`?
+* When to consider declaring `Copy` on your own types:
+* All fields are `Copy` themselves.
+* The struct is `small`, up to 2 (maybe 3) words of memory or 24 bytes (each word is 64 bits/8bytes).
+* The struct **represents a "plain data object"**, without resourcing to ownership (no heap allocations. Example: `Vec` and `Strings`).
+
+❗**Rust Arrays are stack allocated.** Which means they can be copied if their underlying type is `Copy`, but this will be allocated in the program stack which can easily become a stack overflow. More on [Chapter 3 - Stack vs Heap](./chapter_03.md#33-stack-vs-heap-be-size-smart)
+
+For reference, each primitive type size in bytes:
+
+#### Integers:
+
+| Type | Size |
+|------------- |---------- |
+| i8 u8 | 1 byte |
+| i16 u16 | 2 bytes |
+| i32 u32 | 4 bytes |
+| i64 u64 | 8 bytes |
+| isize usize | Arch |
+| i128 u128 | 16 bytes |
+
+#### Floating Point:
+
+| Type | Size |
+|---------- |---------- |
+| f32 | 4 bytes |
+| f64 | 8 bytes |
+
+
+#### Other:
+
+| Type | Size |
+|---------- |---------- |
+| bool | 1 byte |
+| char | 4 bytes |
+
+
+### ✅ Good struct to derive `Copy`:
+```rust
+#[derive(Debug, Copy, Clone)]
+struct Point {
+    x: f32,
+    y: f32,
+    z: f32
+}
+```
+
+### ❌ Bad struct to derive `Copy`:
+```rust
+#[derive(Debug, Clone)]
+struct BadIdea {
+    age: i32,
+    name: String, // String is not `Copy`
+}
+```
+
+### ❓Which Enums should be `Copy`?
+* If your enum acts like tags and atoms.
+* The enum payloads are all `Copy`.
+* **❗Enums size are based on their largest element.**
+
+### ✅ Good Enum to derive
+```rust
+#[derive(Debug, Copy, Clone)]
+enum Direction {
+    North,
+    South,
+    East,
+    West,
+}
+```
+
+## 1.3 Handling `Option<T>` and `Result<T, E>`
+Rust 1.65 introduced a better way to safely unpack Option and Result types with the `let Some(x) = … else { … }` or `let Ok(x) = … else { … }` when you have a default `return` value, `continue` or `break` default else case. It allows early returns when the missing case is **expected and normal**, not exceptional.
+
+### ✅ Cases to use each pattern matching for Option and Return
+* Use `match` when you want to pattern match against the inner types `T` and `E`
+```rust
+match self {
+    Ok(Direction::South) => { … },
+    Ok(Direction::North) => { … },
+    Ok(Direction::East) => { … },
+    Ok(Direction::West) => { … },
+    Err(E::One) => { … },
+    Err(E::Two) => { … },
+}
+
+match self {
+    Some(3|5) => { … }
+    Some(x) if x > 10 => { … }
+    Some(x) => { … }
+    None => { … }
+}
+```
+
+* Use `match` when your type is transformed into something more complex Like `Result<T, E>` becoming `Result<Option<T>, E>`.
+```rust
+match self {
+    Ok(t) => Ok(Some(t)),
+    Err(E::Empty) => Ok(None),
+    Err(err) => Err(err),
+}
+```
+
+* Use `let PATTERN = EXPRESSION else { DIVERGING_CODE; }` when the divergent code doesn't need to know about the failed pattern matches or doesn't need extra computation:
+```rust
+let Some(&Direction::North) = self.direction.as_ref() else {
+    return Err(DirectionNotAvailable(self.direction));
+}
+```
+
+* Use `let PATTERN = EXPRESSION else { DIVERGING_CODE; }` when you want to break or continue a pattern match
+```rust
+for x in self {
+    let Some(x) = x else {
+        continue;
+    }
+}
+```
+
+* Use `if let PATTERN = EXPRESSION else { DIVERGING_CODE; }` when `DIVERGING_CODE` needs extra computation:
+```rust
+if let Some(x) = self.next() {
+    // computation
+} else {
+    // computation when `None/Err` or not matched
+}
+```
+
+❗**If you don't care about the value of the `Err` case, please use `?` to propagate the `Err` to the caller.**
+
+### ❌ Bad Option/Return pattern matching:
+
+* Conversion between Result and Option (prefer `.ok()`,`.ok_or()`, and `ok_or_else()`)
+```rust
+match self {
+    Ok(t) => Some(t),
+    Err(_) => None
+}
+```
+
+* `if let PATTERN = EXPRESSION else { DIVERGING_CODE; }` when divergent code is a default or pre-computed value (prefer `let PATTERN = EXPRESSION else { DIVERGING_CODE; }`):
+```rust
+if let Some(values) = self.next() {
+    // computation
+    (Some(..), values)
+} else {
+    (None, Vec::new())
+}
+```
+
+* Using `unwrap` or `expect` outside tests:
+```rust
+let port = config.port.unwrap();
+```
+
+## 1.4 Prevent Early Allocation
+
+When dealing with functions like `or`, `map_or`, `unwrap_or`, `ok_or`, consider that they have special cases for when memory allocation is required, like creating a new string, creating a collection or even calling functions that manage some state, so they can be replaced with their `_else` counter-part:
+
+### ✅ Good cases
+
+```rust
+let x = None;
+assert_eq!(x.ok_or(ParseError::ValueAbsent), Err(ParseError::ValueAbsent));
+
+let x = None;
+assert_eq!(x.ok_or_else(|| ParseError::ValueAbsent(format!("this is a value {x}"))), Err(ParseError::ValueAbsent));
+
+
+let x: Result<_, &str> = Ok("foo");
+assert_eq!(x.map_or(42, |v| v.len()), 3);
+
+
+let x : Result<_, String> = Ok("foo");
+assert_eq!(x.map_or_else(|e|format!("Error: {e}"), |v| v.len()), 3);
+
+let x = "1,2,3,4";
+assert_eq!(x.parse_to_option_vec.unwrap_or_else(Vec::new), Ok(vec![1, 2, 3, 4]));
+```
+
+### ❌ Bad cases
+
+```rust
+let x : Result<_, String> = Ok("foo");
+assert_eq!(x.map_or(format!("Error with uninformed content"), |v| v.len()), 3);
+
+let x = "1,2,3,4";
+assert_eq!(x.parse_to_option_vec.unwrap_or(Vec::new()), Ok(vec![1, 2, 3, 4])); // could be replaced with `.unwrap_or_default`
+
+let x = None;
+assert_eq!(x.ok_or(ParseError::ValueAbsent(format!("this is a value {x}"))), Err(ParseError::ValueAbsent));
+```
+
+### Mapping Err
+
+When dealing with Result::Err, sometimes is necessary to log and transform the Err into a more abstract or more detailed error, this can be done with `inspect_err` and `map_err`:
+
+```rust
+let x = Err(ParseError::InvalidContent(...));
+
+x
+    .inspect_err(|err| tracing::error!("function_name: {err}"))
+    .map_err(|err| GeneralError::from(("function_name", err)))?;
+```
+
+## 1.5 Iterator, `.iter` vs `for`
+
+First we need to understand a basic loop with each one of them. Let's consider the following problem, we need to sum all even numbers between 0 and 10 incremented by 1:
+
+* `for`:
+```rust
+let mut sum = 0;
+for x in 0..=10 {
+    if x % 2 == 0 {
+        sum += x + 1;
+    }
+}
+```
+
+* `iter`:
+```rust
+let sum: i32 = (0..=10)
+    .filter(|x| x % 2 == 0)
+    .map(|x| x + 1)
+    .sum();
+```
+
+> Both versions do the same thing and are correct and idiomatic, but each shines in different contexts.
+
+### When to prefer `for` loops
+* When you need **early exits** (`break`, `continue`, `return`).
+* **Simple iteration** with side-effects (e.g., logging, IO)
+    * logging can be done correctly in `Iterators` using `inspect` and `inspect_err` functions.
+* When readability matters more than simplicity or chaining.
+
+#### Example:
+```rust
+for value in &mut value {
+    if *value == 0 {
+        break;
+    }
+    *value += fancy_equation();
+}
+```
+
+### When to prefer `iterators` loops (`.iter()` and `.into_iter()`)
+* When you are `transforming collections` or `Option/Results`.
+* You can **compose multiple steps** elegantly.
+* No need for early exits.
+* You need support for indexed values with `.enumerate`.
+```rust
+let values: Vec<_> = vec.into_iter()
+    .enumerate()
+    .filter(|(_index, value)| value % 2 == 0)
+    .map(|(index, value)| value % index)
+    .collect()
+```
+* You need to use collections functions like `.windows` or `chunks`.
+* You need to combine data from multiple sources and don't want to allocate multiple collections.
+* Iterators can be combined with `for` loops:
+```rust
+for value in vec.iter().enumerate()
+    .filter(|(index, value)| value % index == 0) {
+    // ...
+}
+```
+
+> #### ❗REMEMBER: Iterators are Lazy
+>
+> * `.iter`, `.map`, `.filter` don't do anything until you call its consumer, e.g. `.collect`, `.sum`, `.for_each`.
+> * **Lazy Evaluation** means that iterator chains are fused into one loop at compile time.
+
+### 🚨 Anti-patterns to AVOID
+
+* Don't chain without formatting. Prefer each chained function on its own line with the correct indentation (`rustfmt` should take care of this).
+* Don't chain if it makes the code unreadable.
+* Avoid needlessly collect/allocate of a collection (e.g. vector) just to throw it away later by some larger operation or by another iteration.
+* Prefer `iter` over `into_iter` unless you don't need the ownership of the collection.
+* Prefer `iter` over `into_iter` for collections that inner type implements `Copy`, e.g. `Vec<i32>`.
+* For summing numbers prefer `.sum` over `.fold`. `.sum` is specialized for summing values, so the compiler knows it can make optimizations on that front, while fold has a blackbox closure that needs to be applied at every step. If you need to sum by an initial value, just added in the expression `let my_sum = [1, 2, 3].sum() + 3`.
+
+## 1.6 Comments: Context, not Clutter
+
+> "Context are for why, not what or how"
+
+Well-written Rust code, with expressive types and good naming, often speaks for itself. Many high-quality codebases thrive on **few or no comments**. And that's a good thing.
+
+Still, there are **moments where code alone isn't enough** - when there are performance quirks, external constraints, or non-obvious tradeoffs that require a nudge to the reader. In those cases, a concise comment can prevent hours of head-scratching or searching git history.
+
+### ✅ Good comments 
+
+* Safety concerns:
+```rust
+// SAFETY: We have checked that the pointer is valid and non-null. @Function xyz.
+unsafe { std::ptr::copy_nonoverlapping(src, dst, len); }
+```
+
+* Performance quirks:
+```rust
+// This algorithm is a fast square root approximation
+const THREE_HALVES: f32 = 1.5;
+fn q_rsqrt(number: f32 ) -> f32 {
+    let mut i: i32 = number.to_bits() as i32;
+    i = 0x5F375A86_i32.wrapping_sub(i >> 1);
+    let y = f32::from_bits(i as u32);
+    y * (THREE_HALVES - (number * 0.5 * y * y))
+}
+```
+
+* Clear code beats comments. However, when the why isn't obvious, say it plainly - or link to where:
+```rust
+// PERF: Generating the root store per subgraph caused high TLS startup latency on MacOS
+// This works as a caching alternative. See: [ADR-123](link/to/adr-123)
+let subgraph_tls_root_store: RootCertStore = configuration
+    .tls
+    .subgraph
+    .all
+    .create_certificate_store()
+    .transpose()?
+    .unwrap_or_else(crate::services::http::HttpClientService::native_roots_store);
+```
+
+### ❌ Bad comments
+
+* Wall-of-text explanations: long comments and multiline comments
+```rust
+// Lorem Ipsum is simply dummy text of the printing and typesetting industry. 
+// Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, 
+// when an unknown printer took a galley
+fn do_something_odd() {
+    …
+}
+```
+> Prefer `/// doc` comment if it's describing the function.
+
+* Comments that could be better represented as functions or are plain obvious
+```rust
+fn computation() {
+    // increment i by 1
+    i += 1;
+}
+```
+
+### ✅ Breaking up long functions over commenting them
+
+If you find yourself writing a long comment explaining "what", "how" or "each step" in a function, it might be time to split it. So the suggestion is to refactor. This can be beneficial not only for readability, but testability:
+
+#### ❌ Instead of:
+```rust
+fn process_request(request: T) {
+    // We first need to validate request, because of corner case x, y, z
+    // As the payload can only be decoded when they are valid
+    // Then we can perform authorization on the payload
+    // lastly with the authorized payload we can dispatch to handler
+}
+```
+
+#### ✅ Prefer
+```rust
+fn process_request(request: T) -> Result<(), Error> {
+    validate_request_headers(&request)?;
+    let payload = decode_payload(&request);
+    authorize(&payload)?;
+    dispatch_to_handler(payload)
+}
+
+#[cfg(test)]
+mod tests {
+    #[test]
+    fn validate_request_happy_path() { ... }
+
+    #[test]
+    fn validate_request_fails_on_x() { ... }
+
+    #[test]
+    fn validate_request_fails_on_y() { ... }
+
+    #[test]
+    fn decode_validated_request() { ... }
+
+    #[test]
+    fn authorize_payload_xyz() { ... }
+}
+```
+
+Let **structure** and **naming** replace commentary, and enhance its documentation with **tests as living documentation**.
+
+### 📝 TODOs are not comments - track them properly
+
+Avoid leaving lingering `// TODO: Lorem Ipsum` comments in the code. Instead:
+* Turn them into Jira or Github Issues.
+* If needed, to avoid future confusion, reference the issue in the code and the code in the issue.
+
+```rust
+// See issue #123: support hyper 2.0
+```
+
+This helps keeping the code clean and making sure tasks are not forgotten.
+
+### Comments as Living Documentation
+
+There are a few gotchas when calling comments "living documentation":
+* Code evolves.
+* Context changes.
+* Comments get stale.
+* Many large comments make people avoid reading them.
+* Team becomes fearful of delete irrelevant comments.
+
+If you find a comment, **don't trust it blindly**. Read it in context. If it's wrong or outdated, fix or remove it. A misleading comment is worse than no comments at all. 
+
+> Comments should bother you - they demand re-verification, just like stale tests.
+
+When deeper justification is needed, prefer to:
+* **Link to a Design Doc or an ADR**, business logic lives well in design docs while performance tradeoffs live well in ADRs.
+* Move runtime example and usage docs into Rust Docs, `/// doc comment`, where they can be tested and kept up-to-date by tools like `cargo doc`.
+
+> Doc-comments and Doc-testing, `///` and `//!` in [Chapter 8 - Comments vs Documentation](./chapter_08.md)
+
+## 1.7 Use Declarations - "imports"
+
+Different languages have different ways of sorting their imports, in the Rust ecosystem the [standard way](https://github.com/rust-lang/rustfmt/issues/4107) is:
+
+- `std` (`core`, `alloc` would also fit here).
+- External crates (what is in your Cargo.toml `[dependencies]`).
+- Workspace crates (workspace member crates).
+- This module `super::`.
+- This module `crate::`.
+
+```rust
+// std
+use std::sync::Arc;
+
+// external crates
+use chrono::Utc;
+use juniper::{FieldError, FieldResult};
+use uuid::Uuid;
+
+// crate code lives in workspace
+use broker::database::PooledConnection;
+
+// super:: / crate::
+use super::schema::{Context, Payload};
+use super::update::convert_publish_payload;
+use crate::models::Event;
+```
+
+Some enterprise solutions opt to include their core packages after `std`, so all external packages that start with enterprise name are located before the others:
+
+```rust
+// std
+use std::sync::Arc;
+
+// enterprise external crates
+use enterprise_crate_name::some_module::SomeThing;
+
+// external crates
+use chrono::Utc;
+use juniper::{FieldError, FieldResult};
+use uuid::Uuid;
+
+// crate code lives in workspace
+use broker::database::PooledConnection;
+
+// super:: / crate::
+use super::schema::{Context, Payload};
+use super::update::convert_publish_payload;
+use crate::models::Event;
+```
+
+One way of not having to manually control this is using the following arguments in your `rustfmt.toml`:
+
+```toml
+reorder_imports = true
+imports_granularity = "Crate"
+group_imports = "StdExternalCrate"
+```
+
+> As of Rust version 1.88, it is necessary to execute rustfmt in nightly to correctly reorder code `cargo +nightly fmt`.
diff --git a/.agents/skills/rust-best-practices/references/chapter_02.md b/.agents/skills/rust-best-practices/references/chapter_02.md
new file mode 100644
index 0000000..306b583
--- /dev/null
+++ b/.agents/skills/rust-best-practices/references/chapter_02.md
@@ -0,0 +1,117 @@
+# Chapter 2 - Clippy and Linting Discipline
+
+Be sure to have `cargo clippy` installed with your rust compiler, run `cargo clippy -V` in your terminal for a rust project and you should get something like this `clippy 0.1.86 (05f9846f89 2025-03-31)`. If terminal fails to show a clippy version, please run the following code `rustup update && rustup component add clippy`.
+
+Clippy documentation can be found [here](https://doc.rust-lang.org/clippy/usage.html).
+
+## 2.1 Why care about linting?
+
+Rust compiler is a powerful tool that catches many mistakes. However, some more in-depth analysis require extra tools, that is where `cargo clippy` clippy comes into to play. Clippy checks for:
+* Performance pitfalls.
+* Style issues.
+* Redundant code.
+* Potential bugs.
+* Non-idiomatic Rust.
+
+## 2.2 Always run `cargo clippy`
+
+Add the following to your daily workflow:
+
+```shell
+$ cargo clippy --all-targets --all-features --locked -- -D warnings
+```
+
+* `--all-targets`: checks library, tests, benches and examples.
+* `--all-features`: checks code for all features enabled, auto solves conflicting features.
+* `--locked`: Requires `Cargo.lock` to be up-to-date, can be solved with `$ cargo update`.
+* `-D warnings`: treats warnings as errors
+
+Potential additions elements to add:
+
+* `-- -W clippy::pedantic`: lints which are rather strict or have occasional false positives.
+* `-- -W clippy::nursery`: Optionally can be added to check for new lints that are still under development.
+* ❗ Add this to your Makefile, Justfile, xtask or CI Pipeline.
+
+> Example at ApolloGraphQL
+>
+> In the `Router` project there is a `xtask` configured for linting that can be executed with `cargo xtask lint`. 
+
+## 2.3 Important Clippy Lints to Respect
+
+| Lint Name | Why | Link |
+| --------- | ----| -----|
+| `redundant_clone` | Detects unnecessary `clones`, has performance impact | [link (nursery + perf)](https://rust-lang.github.io/rust-clippy/master/#redundant_clone) |
+| `needless_borrow` group | Removes redundant `&` borrowing | [link (style)](https://rust-lang.github.io/rust-clippy/master/#needless_borrow) |
+| `map_unwrap_or` / `map_or` | Simplifies nested `Option/Result` handling | [`map_unwrap_or`](https://rust-lang.github.io/rust-clippy/master/#map_unwrap_or) [`unnecessary_map_or`](https://rust-lang.github.io/rust-clippy/master/#unnecessary_map_or) [`unnecessary_result_map_or_else`](https://rust-lang.github.io/rust-clippy/master/#unnecessary_result_map_or_else) |
+| `manual_ok_or` | Suggest using `.ok_or_else` instead of `match` | [link (style)](https://rust-lang.github.io/rust-clippy/master/#manual_ok_or) |
+| `large_enum_variant` | Warns if an enum has very large variant which is bad for memory. Suggests `Boxing` it | [link (perf)](https://rust-lang.github.io/rust-clippy/master/#large_enum_variant) |
+| `unnecessary_wraps` | If your function always returns `Some` or `Ok`, you don't need `Option`/`Result` | [link (pedantic)](https://rust-lang.github.io/rust-clippy/master/#unnecessary_wraps) |
+| `clone_on_copy` | Catches accidental `.clone()` on `Copy` types like `u32` and `bool` | [link (complexity)](https://rust-lang.github.io/rust-clippy/master/#clone_on_copy) |
+| `needless_collect` | Prevents collecting and allocating an iterator, when allocation is not needed | [link (nursery)](https://rust-lang.github.io/rust-clippy/master/#needless_collect) |
+
+## 2.4 Fix warnings, don't silence them!
+
+**NEVER** just `#[allow(clippy::lint_something)]` unless:
+
+* You **truly understand** why the warning happens and you have a reason why it is better that way.
+* You **document** why it is being ignored.
+* ❗ Don't use `allow`, but `expect`, it will give a warning in case the lint is not true anymore, `#[expect(clippy::lint_something)]`.
+
+### Example:
+
+```rust
+// Faster matching is preferred over size efficiency
+#[expect(clippy::large_enum_variant)]
+enum Message {
+    Code(u8),
+    Content([u8; 1024]),
+}
+```
+
+> The fix would be:
+> 
+> ```rust
+> // Faster matching is preferred over size efficiency
+> #[expect(clippy::large_enum_variant)]
+> enum Message {
+>     Code(u8),
+>     Content(Box<[u8; 1024]>),
+> }
+> ```
+
+### Handling false positives
+
+Sometimes Clippy complains even when your code is correct, in those cases there are two solutions:
+1. Try to refactor the code, so it improves the warning.
+2. **Locally** override the lint with `#[expect(clippy::lint_name)]` and a comment with the reason.
+3. Avoid global overrides, unless it is core crate issue, a good example of this is the Bevy Engine that has a set of lints that should be allowed by default.
+
+## 2.5 Configure workspace/package lints
+
+In your `Cargo.toml` file it is possible to determine which lints and their priorities over each other. In case of 2 or more conflicting lints, the higher priority one will be chosen. Example configuration for a package:
+
+```toml
+[lints.rust]
+future-incompatible = "warn"
+nonstandard_style = "deny"
+
+[lints.clippy]
+all = { level = "deny", priority = 10 }
+redundant_clone = { level = "deny", priority = 9 }
+manual_while_let_some = { level = "deny", priority = 4 }
+pedantic = { level = "warn", priority = 3 }
+```
+
+And for a workspace:
+
+```toml
+[workspace.lints.rust]
+future-incompatible = "warn"
+nonstandard_style = "deny"
+
+[workspace.lints.clippy]
+all = { level = "deny", priority = 10 }
+redundant_clone = { level = "deny", priority = 9 }
+manual_while_let_some = { level = "deny", priority = 4 }
+pedantic = { level = "warn", priority = 3 }
+```
diff --git a/.agents/skills/rust-best-practices/references/chapter_03.md b/.agents/skills/rust-best-practices/references/chapter_03.md
new file mode 100644
index 0000000..074295e
--- /dev/null
+++ b/.agents/skills/rust-best-practices/references/chapter_03.md
@@ -0,0 +1,209 @@
+# Chapter 3 - Performance Mindset
+
+The **golden rule** of performance work:
+
+> Don't guess, measure.
+
+Rust code is often already pretty fast - don't "optimize" without evidence. Optimize only after finding bottlenecks.
+
+### A good first steps
+* Use `--release` flag on you builds (might sound dummy, but it is quite common to hear people complaining that their Rust code is slower than their X language code, and 99% of the time is because they didn't use the `--release` flag).
+* `$ cargo clippy -- -D clippy::perf` gives you important tips on best practices for performance.
+* [`cargo bench`](https://doc.rust-lang.org/cargo/commands/cargo-bench.html) is a cargo tool to create micro-benchmarks and test different code solutions. Write a test scenario and bench you solution against the original code, if your improvement is larger than 5%, might be a good performance improvement.
+* [`cargo flamegraph`](https://github.com/flamegraph-rs/flamegraph) a powerful profiler for Rust code. For MacOS, [samply](https://github.com/mstange/samply) might be a better DX option.
+
+> #### Further reading on Benchmarking:
+> - [How to build a Custom Benchmarking Harness in Rust](https://bencher.dev/learn/benchmarking/rust/custom-harness/)
+
+
+## 3.1 Flamegraph
+
+Flamegraph helps you visualize how much time CPU spent on each task.
+
+```shell
+# Installing flamegraph
+cargo install flamegraph
+
+# cargo support provided through the cargo-flamegraph binary!
+# defaults to profiling cargo run --release
+cargo flamegraph
+
+# by default, `--release` profile is used,
+# but you can override this:
+cargo flamegraph --dev
+
+# if you'd like to profile a specific binary:
+cargo flamegraph --bin=stress2
+
+# Profile unit tests.
+# Note that a separating `--` is necessary if `--unit-test` is the last flag.
+cargo flamegraph --unit-test -- test::in::package::with::single::crate
+cargo flamegraph --unit-test crate_name -- test::in::package::with::multiple:crate
+
+# Profile integration tests.
+cargo flamegraph --test test_name
+
+# Run criterion benchmark
+# Note that the last --bench is required for `criterion 0.3` to run in benchmark mode, instead of test mode.
+cargo flamegraph --bench some_benchmark --features some_features -- --bench
+
+# Run workspace example
+cargo flamegraph --example some_example --features some_features
+```
+
+> ❗ Always run your profiles with `--release` enabled, the `--dev` flag isn't realistic as it doesn't have optimizations enabled.
+
+The result will look like a flame graph where:
+
+* The `y-axis` shows the **stack depth number**. When looking at a flamegraph, the main function of your program will be closer to the bottom, and the called functions will be stacked on top, with the functions that they call stacked on top of them.
+
+* The `width of each box` shows the **total time that that function** is on the CPU or is part of the call stack. If a function's box is wider than others, that means that it consumes more CPU per execution than other functions, or that it is called more than other functions.
+
+> ❗ The **color of each box** isn't significant, and **is chosen at random**.
+
+### 🚨 Remember
+* Thick stacks: heavy CPU usage
+* Thin stacks: low intensity (cheap)
+
+## 3.2 Avoid Redundant Cloning
+
+> Cloning is cheap... **until it isn't**
+
+In sections [Borrowing over Cloning](./chapter_01.md#11-borrowing-over-cloning) and [Important Clippy lints to respect](./chapter_02.md#23-important-clippy-lints-to-respect) we mentioned the impacts of cloning and the relevant clippy lint [`redundant_clone`](https://rust-lang.github.io/rust-clippy/master/#redundant_clone), so in this section we will explore a bit "when to pass ownership".
+
+* 🚨 If you really need to clone, leave it to the last moment.
+
+### When to pass ownership?
+
+* Only `.clone()` if you truly need a new owned copy. A few examples:
+    * Crate API Design requires owned data.
+    * Have overloaded `std::ops` but still need ownership to the old data:
+    ```rust
+    use std::ops::Add;
+
+    #[derive(Debug, Copy, Clone, PartialEq)]
+    struct Point {
+        x: i32,
+        y: i32,
+    }
+
+    impl Add for Point {
+        type Output = Self;
+
+        fn add(self, other: Self) -> Self {
+            Self {
+                x: self.x + other.x,
+                y: self.y + other.y,
+            }
+        }
+    }
+
+    assert_eq!(Point { x: 1, y: 0 } + Point { x: 2, y: 3 },
+               Point { x: 3, y: 3 });
+    ```
+    * Need to do comparison snapshots or due to API you need multiple owned instances of the data.
+    ```rust
+    fn snapshot(a: &MyValue, b:&MyValue) -> MyValueDiff {
+        a - b
+    }
+
+    impl Sub for MyValue {
+        type Output = MyValueDiff;
+
+        fn sub(self, other: Self) -> MyValue {
+            ...
+        }
+    }
+
+    fn main() {
+        let mut a = MyValue::default();
+        let b = a.clone();
+
+        a.magical_update();
+        println!("{:?}", snapshot(&a, &b));
+    }
+    ```
+* You have reference counted pointers (`Arc, Rc`).
+* You have small structs that are to big to `Copy` but as costly as `std::collections`. An example is HTTP client like `hyper_util::client::legacy::Client` that cloning allows you to share the connection pool.
+* You have a chained struct modifier that needs owned mutation, some **builders** require owned mutation, but most custom builders can be done with `pub fn with_xyz(&mut self, value: Xyz) -> &mut Self`.
+```rust
+// Inline `HashMap` insertion extension
+
+fn insert_owned(mut self, key: K, value: V) -> Self {
+    self.insert(key, value);
+    self
+}
+```
+* Ownership can also be a good way to model business logic / state. For example:
+```rust
+let not_validated: String = ...;// some user source
+let validated = Validate::try_from(not_validated)?;
+// Technically that `try_from` maybe didn't need ownership, but taking it lets us model intent
+```
+
+### When **NOT** to pass ownership?
+
+* Prefer API designs that take reference (`fn process(values: &[T])`), instead of ownership (`fn process(values: Vec<T>)`).
+* If you only need read access to elements, prefer `.iter` or slices:
+```rust
+for item in &some_vec {
+    ...
+}
+```
+* You need to mutate data that is owned by another thread, use `&mut MyStruct`.
+
+### Use `Cow` for `Maybe Owned` data
+
+Sometimes you don't actually need owned data, but that is not clear from the API perspective, so using [`std::borrow::Cow`](https://doc.rust-lang.org/std/borrow/enum.Cow.html) is a way to efficiently address this case:
+
+```rust
+use std::borrow::Cow;
+
+fn hello_greet(name: Cow<'_, str>) {
+    println!("Hello {name}");
+}
+
+hello_greet(Cow::Borrowed("Julia"));
+hello_greet(Cow::Owned("Naomi".to_string()));
+```
+
+## 3.3 Stack vs Heap: Be size-smart!
+
+### ✅ Good Practices 
+
+* Keep small types (`impl Copy`, `usize`, `bool`, etc) **on the stack**.
+* Avoid passing huge types (`> 512 bytes`) by value or transferring ownership. Prefer pass by reference (e.g. `&T` and `&mut T`).
+* Heap allocate recursive data structures:
+```rust
+enum OctreeNode<T> {
+    Node(T),
+    Children(Box<[Node<T>; 8]>),
+}
+```
+* Return small types by value, types that implement `Copy` or a cheaply Cloned are efficient to return by value (e.g. `struct Vector2 {x: f32, y: f32}`).
+
+### ❗ Be Mindful
+
+* Only use `#[inline]` when benchmark proves beneficial, Rust is already pretty good at inlining **without** hints.
+* Avoid massive stack allocations, box them. Example `let buffer: Box<[u8; 65536]> = Box::new(..)` would first allocate `[u8; 65536]` on the stack then box it, a non-const solution to this would be `let buffer: Box<[u8]> = vec![0; 65536].into_boxed_slice()`.
+* For large `const` arrays, considering using [crate smallvec](https://docs.rs/smallvec/latest/smallvec/) as it behaves like an array, but is smart enough to allocate large arrays on the heap.
+
+## 3.4 Iterators and Zero-Cost Abstractions
+
+Rust iterators are lazy, but eventually compiled away into very efficient tight loops that are only called when consumed. Chaining `.filter()`, `.map()`, `.rev()`, `.skip()`, `.take()`, `.collect()` usually doesn't cost extra and the compiler can reason well enough how to optimize them.
+* Prefer `iterators` over manual `for` loops when working with collections, the compiler can optimize them better than manually doing it.
+* Calling `.iter()` only creates a **reference** to the original collection, this allows you to hold multiple iterators of the same collection.
+
+#### ❗ Avoid creating intermediate collections unless it is really needed:
+
+* Consider that `process` accepts an `iterator`.
+* ❌ BAD - useless intermediate collection:
+```rust
+let doubled: Vec<_> = items.iter().map(|x| x * 2).collect();
+process(doubled);
+```
+* ✅ GOOD - pass the iterator (`fn process(arg: impl Iterator<Item = T>)`):
+```rust
+let doubled_iter = items.iter().map(|x| x * 2);
+process(doubled_iter);
+```
diff --git a/.agents/skills/rust-best-practices/references/chapter_04.md b/.agents/skills/rust-best-practices/references/chapter_04.md
new file mode 100644
index 0000000..ebca711
--- /dev/null
+++ b/.agents/skills/rust-best-practices/references/chapter_04.md
@@ -0,0 +1,180 @@
+# Chapter 4 - Errors Handling
+
+Rust enforces a strict error handling approach, but *how* you handle them defines where your code feels ergonomic, consistent and safe - as opposing cryptic and painful. This chapter dives into best practices for modeling and managing fallible operations across libraries and binaries.
+
+> Even if you decide to crash you application with `unwrap` or `expect`, Rust forces you to declare that intentionally.
+
+## 4.1 Prefer `Result`, avoid panic 🫨
+
+Rust has a powerful type that wraps fallible data, [`Result<T, E>`](https://doc.rust-lang.org/std/result/), this allows us to handle Error cases according to our needs and manage the state of the application based on that.
+
+* If your function can fail, prefer to return a `Result`:
+```rust
+fn divide(x: f64, y: f64) -> Result<f64, DivisionError> {
+    if y == 0.0 {
+        Err(DivisionError::DividedByZero)
+    } else {
+        Ok(x / y)
+    }
+}
+```
+
+* Use `panic!` only in unrecoverable conditions - typically tests, assertions, bugs or a need to crash the application for some explicit reason.
+* There are 3 relevant macros that can replace `panic!` in appropriate conditions:
+    * `todo!`, similar to panic, but alerts the compiler that you are aware that there is code missing.
+    * `unreachable!`, you have reasoned about the code block and are sure that condition `xyz` is not possible and if ever becomes possible you want to be alerted.
+    * `unimplemented!`, specially useful for alerting that a block is not yet implement with a reason.
+
+## 4.2 Avoid `unwrap`/`expect` in Production
+
+Although `expect` is preferred to `unwrap`, as it can have context, they should be avoided in production code as there are smarter alternatives to them. Considering that, they should be used in the following scenarios:
+- In tests, assertions or test helper functions.
+- When failure is impossible.
+- When the smarter options can't handle the specific case.
+
+### 🚨 Alternative ways of handling `unwrap`/`expect`:
+
+* If your `Result` (or `Option`) can have a predefined early return value in case of `Result::Err`, that doesn't need to know the `Err` value, use `let Ok(..) = else { return ... }` pattern, as it helps with flatten functions:
+```rust
+let Ok(json) = serde_json::from_str(&input) else {
+    return Err(MyError::InvalidJson);
+}
+```
+* If your `Result` (or `Option`) needs error recovery in case of `Result::Err`, that doesn't need to know the `Err` value, use `if let Ok(..) else { ... }` pattern:
+```rust
+if let Ok(json) = serde_json::from_str(&input) else {
+    ...
+} else {
+    Err(do_something_with_input(&input))
+}
+```
+* Functions that can have to handle `Option::None` values are recommended to return `Result<T, E>`, where `E` is a crate or module level error, like the examples above.
+* Lastly `unwrap_or`, `unwrap_or_else` or `unwrap_or_default`, these functions help you create alternative exits to unwrap that manage the uninitialized values.
+
+## 4.3 `thiserror` for Crate level errors
+
+Deriving Error manually is verbose and error prone, the rust ecosystem has a really good crate to help with this, `thiserror`. It allows you to create error types that easily implement `From` trait as well as easy error message (`Display`), improving developer experience while working seamlessly with `?` and integrating with `std::error::Error`:
+
+```rust
+#[derive(Debug, thiserror::Error)]
+pub enum MyError {
+    #[error("Network Timeout")]
+    Timeout,
+    #[error("Invalid data: {0}")]
+    InvalidData(String),
+    #[error(transparent)]
+    Serialization(#[from] serde_json::Error),
+    #[error("Invalid request information. Header: {headers}, Metadata: {metadata}")]
+    InvalidRequest {
+        headers: Headers,
+        metadata: Metadata
+    }
+}
+```
+
+### Error Hierarchies and Wrapping
+
+For layered systems the best practice is to use nested `enum/struct` errors with `#[from]`:
+
+```rust
+use crate::database::DbError;
+use crate::external_services::ExternalHttpError;
+
+#[derive(Debug, thiserror::Error)]
+pub enum ServiceError {
+    #[error("Database handler error: {0}")]
+    Db(#[from] DbError),
+    #[error("External services error: {0}")]
+    ExternalServices(#[from] ExternalHttpError)
+}
+```
+
+## 4.4 Reserve `anyhow` for Binaries
+
+`anyhow` is an amazing crate, and quite useful for projects that are beginning and need accelerated speed. However, there is a turning point where it just painfully propagates through your code, considering this, `anyhow` is recommended only for **binaries**, where ergonomic error handling is needed and there is no need for precise error types:
+
+```rust
+use anyhow::{Context, Result, anyhow};
+
+fn main() -> Result<()> {
+    let content = std::fs::read_to_string("config.json")
+        .context("Failed to read config file")?;
+    Config::from_str(&content)
+        .map_err(|err| anyhow!("Config parsing error: {err}"))
+}
+```
+
+### 🚨 `Anyhow` Gotchas
+
+* Keeping the `context` and `anyhow` strings up-to-date in all code base is harder than keeping `thiserror` messages as you don't have a single point of entry.
+* `anyhow::Result` erases context that a caller might need, so avoid using it in a library.
+* test helper functions can use `anyhow` with little to no issues.
+
+## 4.5 Use `?` to Bubble Errors
+
+Prefer using `?` over verbose alternatives like `match` chains:
+```rust
+fn handle_request(req: &Request) -> Result<ValidatedRequest, MyError> {
+    validate_headers(req)?;
+    validate_body_format(req)?;
+    validate_credentials(req)?;
+    let body = Body::try_from(req)?;
+
+    Ok(ValidatedRequest::try_from((req, body))?)
+}
+```
+
+> In case error recovery is needed, use `or_else`, `map_err`, `if let Ok(..) else`. To **inspect or log your error**, use `inspect_err`.
+
+## 4.6 Unit Test should exercise errors
+
+While many errors don't implement PartialEq and Eq, making it hard to do direct assertions between them, it is possible to check the error messages with `format!` or `to_string()`, making the errors meaningful and test validated:
+
+```rust
+#[test]
+fn error_does_not_implement_partial_eq() {
+    let err = divide(10., 0.0).unwrap_err();
+    assert_eq!(err.to_string(), "division by zero");
+}
+
+#[test]
+fn error_implements_partial_eq() {
+    let err = process(my_value).unwrap_err();
+
+    assert_eq!(
+        err,
+        MyError {
+            ..
+        }
+    )
+}
+```
+
+## 4.7 Important Topics
+
+### Custom Error Structs
+
+Sometimes you don't need an enum to handle your errors, as there is only one type of error that your module can have. This can be solved with `struct Errors`:
+
+```rust
+#[derive(Debug, thiserror::Error, PartialEq)]
+#[error("Request failed with code `{code}`: {message}")]
+struct HttpError {
+    code: u16,
+    message: String
+}
+```
+
+### Async Errors
+
+When using async runtimes, like Tokio, make sure that your errors implement `Send + Sync + 'static` where needed, specially in tasks or across `.await` boundaries:
+
+```rust
+#[tokio::main]
+async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
+    ...
+    Ok(())
+}
+```
+
+> Avoid `Box<dyn std::error::Error>` in libraries unless it is really needed
diff --git a/.agents/skills/rust-best-practices/references/chapter_05.md b/.agents/skills/rust-best-practices/references/chapter_05.md
new file mode 100644
index 0000000..397fef5
--- /dev/null
+++ b/.agents/skills/rust-best-practices/references/chapter_05.md
@@ -0,0 +1,381 @@
+# Chapter 5 - Automated Testing
+
+> Tests are not just for correctness. They are the first place people look to understand how your code works.
+
+* Tests in rust are declared with the attribute macro `#[test]`. Most code editors can compile and run the functions declared under the macro individually or blocks of them.
+* Test can have special compilation flags with `#[cfg(test)]`. Also executable in code editors if it contained `#[test]`, it is a good way to mock complicated functions or override traits.
+
+## 5.1 Tests as Living Documentation
+
+In Rust, as in many other languages, tests often show how the functions are meant to be used. If a test is clear and targeted, it's often more helpful than reading the function body, when combined with other tests, they serve as living documentation.
+
+### Use descriptive names
+
+> In the unit test name we should see the following:
+> * `unit_of_work`: which *function* we are calling. The **action** that will be executed. This is often be the name of the the test `mod` where the function is being tested.
+```rust
+#[cfg(test)] 
+mod test { 
+    mod function_name { 
+        #[test] 
+        fn returns_y_when_x() { ... } 
+    } 
+}
+```
+> * `expected_behavior`: the set of **assertions** that we need to verify that the test works.
+> * `state_that_the_test_will_check`: the general **arrangement**, or setup, of the specific test case.
+
+#### ❌ Don't use a generic name for a test
+```rust
+#[test]
+fn test_add_happy_path() {
+    assert_eq!(add(2, 2), 4);
+}
+```
+#### ✅ Use a name which reads like a sentence, describing the desired behavior
+> Alternatively, if you function has too many tests, you can blob them together in a `mod`, it makes it easier to read and navigate.
+
+```rust
+// OPTION 1
+#[test]
+fn process_should_return_blob_when_larger_than_b() {
+    let a = setup_a_to_be_xyz();
+    let b = Some(2);
+    let expected = MyExpectedStruct { ... };
+
+    let result = process(a, b).unwrap();
+
+    assert_eq!(result, expected);
+}
+
+// OPTION 2
+mod process {
+    #[test]
+    fn should_return_blob_when_larger_than_b() {
+        let a = setup_a_to_be_xyz();
+        let b = Some(2);
+        let expected = MyExpectedStruct { ... };
+
+        let result = process(a, b).unwrap();
+
+        assert_eq!(result, expected);
+    }
+}
+```
+
+> When executing `cargo test` the test output for each option will look like:
+> Option 1: `process_should_return_blob_when_larger_than_b`.
+> Option 2: `process::should_return_blob_when_larger_than_b`.
+
+### Use modules for organization
+
+Most IDEs can run a single module of tests all together.
+The test name in the output will also contain the name of the module.
+Together, that means you can use the module name to group related tests together:
+
+```rust
+#[cfg(test)]
+mod test { // IDEs will provide a ▶️ button here
+
+    mod process {
+        #[test] // IDEs will provide a ▶️ button here
+        fn returns_error_xyz_when_b_is_negative() {
+            let a = setup_a_to_be_xyz();
+            let b = Some(-5);
+            let expected = MyError::Xyz;
+            
+            let result = process(a, b).unwrap_err();
+            
+            assert_eq!(result, expected);
+        }
+
+        #[test] // IDEs will provide a ▶️ button here
+        fn returns_invalid_input_error_when_a_and_b_not_present() {
+            let a = None;
+            let b = None;
+            let expected = MyError::InvalidInput;
+
+            let result = process(a, b).unwrap_err();
+
+            assert_eq!(result, expected);
+        }
+    }
+}
+```
+
+### Only test one behavior per function
+
+To keep tests clear, they should describe _one_ thing that the unit does.
+This makes it easier to understand why a test is failing.
+
+#### ❌ Don't test multiple things in the same test
+```rust
+fn test_thing_parser(...) {
+    assert!(Thing::parse("abcd").is_ok());
+    assert!(Thing::parse("ABCD").is_err());
+}
+```
+
+#### ✅ Test one thing per test
+```rust
+#[cfg(test)]
+mod test_thing_parser {
+    #[test]
+    fn lowercase_letters_are_valid() {
+        assert!(
+            Thing::parse("abcd").is_ok(),
+            // Works like `eprintln`, `format` and `println` macros
+            "Thing parse error: {:?}", 
+            Thing::parse("abcd").unwrap_err()
+        );
+    }
+
+    #[test]
+    fn capital_letters_are_invalid() {
+        assert!(Thing::parse("ABCD").is_err());
+    }
+}
+```
+
+> `Ok` scenarios should have an `eprintln` of the `Err` case.
+
+### Use very few, ideally one, assertion per test
+
+When there are multiple assertions per test, it's both harder to understand the intended behavior and 
+often requires many iterations to fix a broken test, as you work through assertions one by one.
+
+❌ Don't include many assertions in one test:
+
+```rust
+#[test]
+fn test_valid_inputs() {
+    assert!(the_function("a").is_ok());
+    assert!(the_function("ab").is_ok());
+    assert!(the_function("ba").is_ok());
+    assert!(the_function("bab").is_ok());
+}
+```
+
+If you are testing separate behaviors, make multiple tests each with descriptive names.
+To avoid boilerplate, either use a shared setup function or [rstest](https://crates.io/crates/rstest) cases *with descriptive test names*:
+```rust
+#[rstest]
+#[case::single("a")]
+#[case::first_letter("ab")]
+#[case::last_letter("ba")]
+#[case::in_the_middle("bab")]
+fn the_function_accepts_all_strings_with_a(#[case] input: &str) {
+    assert!(the_function(input).is_ok());
+}
+```
+
+> Considerations when using `rstest`
+>
+> * It's harder for both IDEs and humans to run/locate specific tests.
+> * Expectation vs condition naming is now visually inverted (expectation first).
+
+## 5.2 Add Test Examples to your Docs
+
+We will deep dive into docs at a later stage, so in this section we will just briefly go over how to add tests to you docs. Rustdoc can turn examples into executable tests using `///` with a few advantages:
+
+* These tests run with `cargo test` **BUT NOT** `cargo nextest run`. If using `nextest`, make sure to run `cargo t --doc` separately.
+* They serve both as documentation and correctness checks, and are kept up to date by changes, due to the fact that the compiler checks them.
+* No extra testing boilerplate. You can easily hide test sections by prefixing the line with `#`.
+* ❗ There is no issue if you have test duplication between doc-tests and other non-public facing tests.
+
+```rust
+/// Helper function that adds any two numeric values together.
+/// This function reasons about which would be the correct type to parse based on the type
+/// and the size of the numeric value.
+/// 
+/// # Examples
+/// 
+/// ```rust
+/// # use crate_name::generic_add;
+/// use num::numeric;
+/// 
+/// # assert_eq!(
+/// generic_add(5.2, 4) // => 9.2
+/// # , 9.2)
+/// 
+/// # assert_eq!(
+/// generic_add(2, 2.0) // => 4
+/// # , 4)
+/// ```
+```
+
+This documentation code would look like:
+```rust
+use num::numeric;
+
+generic_add(5.2, 4) // => 9.2
+generic_add(2, 2.0) // => 4
+```
+
+## 5.3 Unit Test vs Integration Tests vs Doc tests
+
+As a general rule, without delving into *test pyramid naming*, rust has 3 sets of tests:
+
+### Unit Test
+
+Tests that go in the **same module** as the **tested unit** was declared, this allows the test runner to have visibility over private functions and parent `use` declarations. They can also consume `pub(crate)` functions from other modules if needed. Unit tests can be more focused on **implementation and edge-cases checks**.
+
+* They should be as simple as possible, testing one state and one behavior of the unit. KISS.
+* They should test for errors and edge cases.
+* Different tests of the same unit can be combined under a single `#[cfg(test)] mod test_unit_of_work {...}`, allowing multiple submodules for different `units_of_work`.
+* Try to keep external states/side effects to your API to minimum and focus those tests on the `mod.rs` files.
+* Tests that are not yet fully implemented can be ignored with the `#[ignore = "optional message"]` attribute.
+* Tests that intentionally panic should be annotated with the attribute `#[should_panic]`.
+
+```rust
+#[cfg(test)]
+mod unit_of_work_tests {
+    use super::*;
+
+    #[test]
+    fn unit_state_behavior() {
+        let expected = ...;
+        let result = ...;
+        assert_eq!(result, expected, "Failed because {}", result - expected);
+    }
+}
+```
+
+### Integration Tests
+
+Tests that go under the `tests/` directory, they are entirely external to your library and use the same code as any other code would use, not have access to private and crate level functions, which means they can **only test** functions on your **public API**. 
+
+> Their purpose is to test whether many parts of the code work together correctly, units of code that work correctly on their own could have problems when integrated.
+
+* Test for happy paths and common use cases.
+* Allow external states and side effects, [testcontainers](https://rust.testcontainers.org/) might help.
+* if testing binaries, try to break **executable** and **functions** into `src/main.rs` and `src/lib.rs`, respectively.
+
+```
+├── Cargo.lock 
+├── Cargo.toml 
+├── src 
+│   └── lib.rs 
+└── tests 
+    ├── mod.rs 
+    ├── common 
+    │   └── mod.rs 
+    └── integration_test.rs
+```
+
+### Doc Testing
+
+As mentioned in section [5.2](#52-add-test-examples-to-your-docs), doc tests should have happy paths, general public API usage and more powerful attributes that improve documentation, like custom CSS for the code blocks.
+
+### Attributes:
+
+* `ignore`: tells rust to ignore the code, usually not recommended, if you want just a code formatted text, use `text`.
+* `should_panic`: tells the rust compiler that this example block will panic.
+* `no_run`: compiles but doesn't execute the code, similar to `cargo check`. Very useful when dealing with side-effects for documentation.
+* `compile_fail`: Test rustdoc that this block should cause a compilation fail, important when you want to demonstrate wrong use cases.
+
+## 5.4 How to `assert!`
+
+Rust comes with 2 macros to make assertions:
+* `assert!` for asserting boolean values like `assert!(value.is_ok(), "'value' is not Ok: {value:?}")`
+* `assert_eq!` for checking equality between two different values, `assert_eq!(result, expected, "'result' differs from 'expected': {}", result.diff(expected))`.
+
+### 🚨 `assert!` reminders
+* Rust asserts support formatted strings, like the previous examples, those strings will be printed in case of failure, so it is a good practice to add what the actual state was and how it differs from the expected.
+* If you don't care about the exact pattern matching value, using `matches!` combined with `assert!` might be a good alternative.
+```rust
+assert!(matches!(error, MyError::BadInput(_), "Expected `BadInput`, found {error}"));
+```
+* Use `#[should_panic]` wisely. It should only be used when panic is the desired behavior, prefer result instead of panic.
+* There are some other that can enhance your testing experience like:
+    * [`rstest`](https://crates.io/crates/rstest): fixture based test framework with procedural macros.
+    * [`pretty_assertions`](https://crates.io/crates/pretty_assertions): overrides `assert_eq` and `assert_ne`, and creates colorful diffs between them.
+
+## 5.5 Snapshot Testing with `cargo insta`
+
+> When correctness is visual or structural, snapshots tell the story better than asserts.
+
+1. Add to your dependencies:
+```toml
+insta = { version = "1.42.2", features = ["yaml"] }
+```
+> For most real world applications the recommendation is to use YAML snapshots of serializable values. This is because they look best under version control and the diff viewer and support redaction. To use this enable the yaml feature of insta.
+
+2. For a better review experience, add the CLI `cargo install cargo-insta`.
+
+3. Writing a simple test:
+```rust
+fn split_words(s: &str) -> Vec<&str> {
+    s.split_whitespace().collect()
+}
+
+#[test]
+fn test_split_words() {
+    let words = split_words("hello from the other side");
+    insta::assert_yaml_snapshot!(words);
+}
+```
+
+4. Run `cargo insta test` to execute, and `cargo insta review` to review conflicts.
+
+To learn more about `cargo insta` check out its [documentation](https://insta.rs/docs/quickstart/) as it is a very complete and well documented tool.
+
+### What is snapshot testing?
+
+Snapshot testing compares your output (text, Json, HTML, YAML, etc) against a saved "golden" version. On future runs, the test fails if the output changes, unless humanly approved. It is perfect for:
+* Generate code.
+* Serializing complex data.
+* Rendered HTML.
+* CLI output.
+
+#### ❌ What not to test with snapshot
+* Very stable, numeric-only or small structured data associated logic (prefer `assert_eq!`).
+* Critical path logic (prefer precise unit tests).
+* Flaky tests, randomly generated output, unless redacted.
+* Snapshots of external resources, use mocks and stubs.
+
+## 5.6 ✅ Snapshot Best Practices
+
+* Named snapshots, it gives meaningful snapshot files names, e.g. `snapshots/this_is_a_named_snapshot.snap`
+```rust
+assert_snapshot!("this_is_a_named_snapshot", output);
+```
+
+* Keep snapshots small and clear. 
+```rust
+// ✅ Best case:
+assert_snapshot!("app_config/http", whole_app_config.http);
+
+// ❌ Worst case:
+assert_snapshot!("app_config", whole_app_config); // Huge object
+```
+
+> #### 🚨 Avoid snapshotting huge objects 
+> Huge objects become hard to review and reason about.
+
+* Avoid snapshotting simple types (primitives, flat enums, small structs):
+```rust
+// ✅ Better:
+assert_eq!(meaning_of_life, 42);
+
+// ❌ OVERKILL:
+assert_snapshot!("the_meaning_of_life", meaning_of_life); // meaning_of_life == 42
+```
+
+* Use [redactions](https://insta.rs/docs/redactions/) for unstable fields (randomly generated, timestamps, uuid, etc):
+```rust
+use insta::assert_json_snapshot;
+
+#[test]
+fn endpoint_get_user_data() {
+    let data = http::client.get_user_data();
+    assert_json_snapshot!(
+        "endpoints/subroute/get_user_data",
+        data,
+        ".created_at" => "[timestamp]",
+        ".id" => "[uuid]"
+    );
+}
+```
+* Commit your snapshots into git. They will be stored in `snapshots/` alongside your tests.
+* Review changes carefully before accepting.
diff --git a/.agents/skills/rust-best-practices/references/chapter_06.md b/.agents/skills/rust-best-practices/references/chapter_06.md
new file mode 100644
index 0000000..2467e51
--- /dev/null
+++ b/.agents/skills/rust-best-practices/references/chapter_06.md
@@ -0,0 +1,161 @@
+# Chapter 6 - Generics, Dynamic Dispatch and Static Dispatch
+
+> Static where you can, dynamic where you must
+
+Rust allows you to handle polymorphic code in two ways:
+* **Generics / Static Dispatch**: compile-time, monomorphized per use.
+* **Trait Objects / Dynamic Dispatch**: runtime vtable, single implementation.
+
+Understanding the trade-offs lets you write faster, smaller and more flexible code.
+
+## 6.1 [Generics](https://doc.rust-lang.org/book/ch10-00-generics.html)
+
+Every programming language has tools for effectively handling the duplication of concepts. In Rust, one such tool is generics: abstract stand-ins for concrete types or other properties. We can express the behavior of generics or how they relate to other generics without knowing what will be in their place when compiling and running the code. 
+
+We use generics to create definitions for items like function signatures or structs, which we can then use with many different concrete data types. Let's first look at how to define functions, structs, enums, and methods using generics. Generics can also be used to implement Type State Pattern and constrain a struct functionality to certain expected types, more on type state on [Chapter 7](./chapter_07.md).
+
+[Generics by Examples](https://doc.rust-lang.org/rust-by-example/generics.html).
+
+### Generics Performance
+
+You might be wondering whether there is a runtime cost when using generic type parameters. The good news is that using generic types won't make your program run any slower than it would with concrete types. Rust accomplishes this by performing monomorphization of the code using generics at compile time. Monomorphization is the process of turning generic code into specific code by filling in the concrete types that are used when compiled. The compiler checks for all occurrences of the generic parameter and generates code for the concrete types the generic code is called with.
+
+## 6.2 Static Dispatch: `impl Trait` or `<T: Trait>`
+
+A static dispatch is basically a constrained version of a generics, a trait bounded generic, at compile-time it is able to check if your generic satisfies the declared traits.
+
+### ✅ Best when:
+* You want **zero runtime cost**, by paying the compile time cost.
+* You need **tight loops or performance**.
+* Your types are **known at compile time**.
+* Your are working with **single-use implementations** (monomorphized).
+
+### 🏎️ Example: High-performance function with generic
+```rust
+fn specialized_sum<T: MyTrait, U: Iterator<Item = T>>(iter: U) -> T {
+    iter.map(|x| x.random_mapping()).sum()
+}
+
+// or, equivalent, more modern
+fn specialized_sum<T: MyTrait>(iter: impl Iterator<Item = T>) -> T {
+    iter.map(|x| x.random_mapping()).sum()
+}
+```
+
+This is compiled into **specialized machine code** for each usage, fast and inlined.
+
+## 6.3 Dynamic Dispatch: `dyn Trait`
+
+Usually dynamic dispatch is used with some kind of pointer or a reference, like `Box<dyn Trait>`, `Arc<dyn Trait>` or `&dyn trait`.
+
+### ✅ Best when:
+* You absolutely need runtime polymorphism.
+* You need to **store different implementations** in one collection.
+* You want to **abstract internals behind a stable interface**.
+* You are writing a **plugin-style architecture**.
+
+> ❗ Closer to what you would get in an object oriented language and can have some heavy costs associated to it. Can avoid generic entirely and let you mix types that implement the same traits.
+
+### 🚚 Example: Heterogeneous collection
+
+```rust
+trait Animal {
+    fn greet(&self) -> String;
+}
+
+struct Dog;
+impl Animal for Dog {
+    fn greet(&self) -> String {
+        "woof".to_string()
+    }
+}
+
+struct Cat;
+impl Animal for Cat {
+    fn greet(&self) -> String {
+        "meow".to_string()
+    }
+}
+
+fn all_animals_greeting(animals: Vec<Box<dyn Animal>>) {
+    for animal in animals {
+        println!("{}", animal.greet())
+    }
+}
+```
+
+## 6.4 Trade-off summary
+
+| | Static Dispatch (impl Trait) | Dynamic Dispatch (dyn Trait) |
+|------------------- |------------------------------ |---------------------------------- |
+| Performance | ✅ Faster, inlined | ❌ Slower: vtable indirection |
+| Compile time | ❌ Slower: monomorphization | ✅ Faster: shared code |
+| Binary size | ❌ Larger: per-type codegen | ✅ Smaller |
+| Flexibility | ❌ Rigid, one type at a time | ✅ Can mix types in collections |
+| Use in trait fn() | ❌ Traits must be object-safe | ✅ Works with trait objects |
+| Errors | ✅ Clearer | ❌ Erased types can confuse errors |
+
+* Prefer generics/static dispatch when you control the call site and want performance.
+* Use dynamic dispatch when you need abstraction, plugins or mixed types. 🚨 Runtime cost.
+* If you are not sure, start with generics, trait bound them - then use `Box<dyn Trait>` when flexibility outweighs speed.
+
+> Favor static dispatch until your trait needs to live behind a pointer.
+
+## 6.5 Best Practices for Dynamic Dispatch
+
+Dynamic dispatch `Ptr<dyn Trait>` is a powerful tool, but it also has significant performance trade-offs. You should only reach for it when **type erasure or runtime polymorphism** are essential. It is important to know when you need Trait Objects:
+
+### ✅ Use Dynamic Dispatch When:
+
+* You need heterogeneous types in a collection:
+```rust
+fn all_animals_greeting(animals: Vec<Box<dyn Animal>>) {
+    for animal in animals {
+        println!("{}", animal.greet())
+    }
+}
+```
+
+* You want runtime plugins or hot-swappable components.
+* You want to abstract internals from the caller (library design).
+
+
+### ❌ Avoid Dynamic Dispatch When:
+
+* You control the concrete types.
+* You are writing code in performance critical paths.
+* You can express the same logic in other ways while keeping simplicity, e.g. generics.
+
+## 6.6 🚨 Trait Objects Ergonomics
+
+* Prefer `&dyn Trait` over `Box<dyn Trait>` when you don't need ownership.
+* Use `Arc<dyn Trait>` for shared access across threads.
+* Don't use `dyn Trait` if the trait has methods that return `Self`.
+* **Avoid boxing too early**. Don't box inside structs unless you are sure it'll be beneficial or is required (recursive).
+```rust
+// ✅ Use generics when possible
+struct Renderer<B: Backend> {
+    backend: B
+}
+
+// ❌ Premature Boxing
+struct Renderer {
+    backend: Box<dyn Backend> // Boxing too early
+}
+```
+* If you must expose a `dyn trait` in a public API, `Box` at the boundary, not internally.
+* **Object Safety**: You can only create `dyn Traits` from object-safe traits:
+    * It has **no generic methods**.
+    * It doesn't require `Self: Sized`.
+    * All method signatures use `&self`, `&mut self` or `self`.
+    ```rust
+    // ✅ Object Safe
+    trait Runnable {
+        fn run(&self);
+    }
+
+    // ❌ Not Object Safe
+    trait Factory {
+        fn create<T>() -> T; // generic methods are not allowed
+    }
+    ```
diff --git a/.agents/skills/rust-best-practices/references/chapter_07.md b/.agents/skills/rust-best-practices/references/chapter_07.md
new file mode 100644
index 0000000..f7eab2c
--- /dev/null
+++ b/.agents/skills/rust-best-practices/references/chapter_07.md
@@ -0,0 +1,226 @@
+# Chapter 7 - Type State Pattern
+
+Models state at compile time, preventing bugs by making illegal states unrepresentable. It takes advantage of the Rust generics and type system to create sub-types that can only be reached if a certain condition is achieved, making some operations illegal at compile time. 
+
+> Recently it became the standard design pattern of Rust programming. However, it is not exclusive to Rust, as it is achievable and has inspired other languages to do the same [swift](https://swiftology.io/articles/typestate/) and [typescript](https://catchts.com/type-state).
+
+## 7.1 What is Type State Pattern?
+
+**Type State Pattern** is a design pattern where you encode different **states** of the system as **types**, not as runtime flags or enums. This allows the compiler to enforce state transitions and prevent illegal actions at compile time. It also improves the developer experience, as developers only have access to certain functions based on the state of the type.
+
+> Invalid states become compile errors instead of runtime bugs.
+
+## 7.2 Why use it?
+
+* Avoids runtime checks for state validity. If you reach certain states, you can make certain assumptions of the data you have.
+* Models state transitions as type transitions. This is similar to a state machine, but in compile time.
+* Prevents data misuse, e.g. using uninitialized objects.
+* Improves API safety and correctness.
+* The phantom data field is removed after compilation so no extra memory is allocated.
+
+## 7.3 Simple Example: File State
+
+[Github Example](https://github.com/apollographql/rust-best-practices/tree/main/examples/simple-type-state)
+```rust
+use std::{io, path::{Path, PathBuf}};
+
+struct FileNotOpened;
+struct FileOpened;
+
+#[derive(Debug)]
+struct File<State> {
+    /// Path to the opened file
+    path: PathBuf,
+    /// Open `File` handler
+    handle: Option<std::fs::File>,
+    /// Type state manager
+    _state: std::marker::PhantomData<State>
+}
+
+impl File<FileNotOpened> {
+    /// `open` is the only entry point for this struct.
+    /// * When called with a valid path, it will return a `File<FileOpened>` with a valid `handler` and `path`
+    /// * `open` serves as an alternative to `new` and `defaults` methods (usable when your struct needs valid data to exist).
+    fn open(path: &Path) -> io::Result<File<FileOpened>> {
+        // If file is invalid, it will return `std::io::Error`
+        let file = std::fs::File::open(path)?;
+        Ok(
+            File {
+                path: path.to_path_buf(),
+                // Always valid
+                handle: Some(file),
+                _state: std::marker::PhantomData::<FileOpened>
+            }
+        )
+    }
+}
+
+impl File<FileOpened> {
+    /// Reads the content of the `File` as a `String`.
+    /// `read` can only be called by state `File<FileOpened>`
+    fn read(&mut self) -> io::Result<String> {
+        use io::Read;
+
+        let mut content = String::new();
+        let Some(handle)= self.handle.as_mut() else {
+            unreachable!("Safe to unwrap as state can only be reached when file is open");
+        };
+        handle.read_to_string(&mut content)?;
+        Ok(content)
+    }
+
+    /// Returns the valid path buffer.
+    fn path(&self) -> &PathBuf {
+        &self.path
+    }
+}
+```
+
+## 7.4 Real-World Examples
+
+### Builder Pattern with Compile-Time Guarantees
+
+> Forces the user to **set required fields** before calling `.build()`.
+
+[Github Example](https://github.com/apollographql/rust-best-practices/tree/main/examples/type-state-builder)
+
+A type-state pattern can have more than one associated states:
+
+```rust
+use std::marker::PhantomData;
+
+struct MissingName;
+struct NameSet;
+struct MissingAge;
+struct AgeSet;
+
+#[derive(Debug)]
+struct Person {
+    name: String,
+    age: u8,
+    email: Option<String>,
+}
+
+struct Builder<NameState, AgeState> {
+    name: Option<String>,
+    age: u8,
+    email: Option<String>,
+    _name_marker: PhantomData<NameState>,
+    _age_marker: PhantomData<AgeState>,
+}
+
+impl Builder<MissingName, MissingAge> {
+    fn new() -> Self {
+        Builder { name: None, age: 0, _name_marker: PhantomData, _age_marker: PhantomData, email: None }
+    }
+
+    fn name(self, name: String) -> Builder<NameSet, MissingAge> {
+        Builder { name: Some(name), _name_marker: PhantomData::<NameSet>, age: self.age, _age_marker: PhantomData, email: None }
+    }
+
+    fn age(self, age: u8) -> Builder<MissingName, AgeSet> {
+        Builder { age, _age_marker: PhantomData::<AgeSet>, name: None, _name_marker: PhantomData, email: None }
+    }
+}
+
+impl Builder<NameSet, MissingAge> {
+    fn age(self, age: u8) -> Builder<NameSet, AgeSet> {
+        Builder { age, _age_marker: PhantomData::<AgeSet>, name: self.name, _name_marker: PhantomData::<NameSet>, email: None }
+    }
+}
+
+impl Builder<MissingName, AgeSet> {
+    fn email(self, email: String) -> Self {
+        Self { name: self.name , age: self.age , email: Some(email) , _name_marker: self._name_marker , _age_marker: self._age_marker }
+    }
+
+    fn name(self, name: String) -> Builder<NameSet, AgeSet> {
+        Builder { name: Some(name), _name_marker: PhantomData::<NameSet>, age: self.age, _age_marker: PhantomData::<AgeSet>, email: self.email }
+    }
+}
+
+impl Builder<NameSet, AgeSet> {
+    fn build(self) -> Person {
+        Person { 
+            name: self.name.unwrap_or_else(|| unreachable!("Name is guarantee to be set")), 
+            age: self.age,
+            email: self.email,
+        }
+    }
+}
+```
+
+Although a bit more verbose than a usual builder, this guarantees that all necessary fields are present (note that e-mail is optional field only present in the final builder).
+
+#### Usage:
+```rust
+// ✅ Valid cases
+let person: Person = Builder::new().name("name".to_string()).age(30).build();
+let person: Person = Builder::new().age(30).name("name".to_string()).build();
+let person: Person = Builder::new().age(30).name("name".to_string()).email("myself@email.com".to_string()).build();
+
+// ❌ Invalid cases
+let person: Person = Builder::new().name("name".to_string()).build(); // ❌ Compile error: Age required to `build`
+let person: Person = Builder::new().age(30).build(); // ❌ Compile error: Name required to `build`
+let person: Person = Builder::new().age(30).email("myself@email.com".to_string()).build(); // ❌ Compile error: Name required to `build`
+let person: Person = Builder::new().build();// ❌ Compile error: Name and Age required to `build`
+```
+
+### Network Protocol State Machine
+
+Illegal transitions like sending a message before connecting **simply don't compile**:
+
+```rust
+// Mock example
+struct Disconnected;
+struct Connected;
+
+struct Client<State> {
+    stream: Option<std::net::TcpStream>,
+    _state: std::marker::PhantomData<State>
+}
+
+impl Client<Disconnected> {
+    fn connect(addr: &str) -> std::io::Result<Client<Connected>> {
+        let stream = std::net::TcpStream::connect(addr)?;
+        Ok(Client {
+            stream: Some(stream),
+            _state: std::marker::PhantomData::<Connected>
+        })
+    }
+}
+
+impl Client<Connected> {
+    fn send(&mut self, msg: &str) {
+        use std::io::Write;
+        let Some(stream) = self.stream.as_mut() else {
+            unreachable!("Stream is guarantee to be set");
+        };
+        stream.write_all(msg.as_bytes())
+    }
+}
+```
+
+## 7.5 Pros and Cons
+
+### ✅ Use Type-State Pattern When:
+* Your want **compile-time state safety**.
+* You need to enforce **API constraints**.
+* You are writing a library/crate that is heavy dependent on variants.
+* Your want to replace runtime booleans or enums with **type-safe code paths**.
+* You need compile time correctness.
+
+### ❌ Avoid it when:
+* Writing trivial states like enums.
+* Don't need type-safety.
+* When it leads to overcomplicated generics.
+* When runtime flexibility is required.
+
+### 🚨 Downsides and Cautions
+* Can lead to more **verbose solutions**.
+* Can lead to **complex type signatures**.
+* May require **unsafe** to return **variant outputs** based on different states.
+* May required a bunch of duplication (e.g. same struct field reused).
+* PhantomData is not intuitive for beginners and can feel a bit hacky.
+
+> Use this pattern when it **saves bugs, increases safety or simplifies logic**, not just for cleverness.
diff --git a/.agents/skills/rust-best-practices/references/chapter_08.md b/.agents/skills/rust-best-practices/references/chapter_08.md
new file mode 100644
index 0000000..1915340
--- /dev/null
+++ b/.agents/skills/rust-best-practices/references/chapter_08.md
@@ -0,0 +1,254 @@
+# Chapter 8 - Comments vs Documentation
+
+> Clear code beats clear comments. However, when the why isn't obvious, comment it plainly - or link to where you can read more context.
+
+## 8.1 Comments vs Documentation: Know the Difference
+
+| Purpose | Use `// comment` | Use `/// doc` or `//! crate doc` |
+|-------------- |------------------------------------------- |---------------------------------------------------------------- |
+| Describe Why | ✅ Yes - explains tricky reasoning | ❌ Not for documentation |
+| Describe API | ❌ Not useful | ✅ Yes - public interfaces, usage, details, errors, panics |
+| Maintainable | 🚨 Often becomes obsolete and hard to reason | ✅ Tied to code, appears in generated docs and can run test cases |
+| Visibility | Local development only | Exported to users and tools like `cargo doc` |
+
+## 8.2 When to use comments
+
+Use `//` comments (double slashed) when something can't be expressed clearly in code, like:
+* **Safety Guarantees**, some of which can be better expressed with code conditionals.
+* Workarounds or **Optimizations**.
+* Legacy or **platform-specific** behaviors. Some of them can be expressed with `#[cfg(..)]`.
+* Links to **Design Docs** or **ADRs**.
+* Assumptions or **gotchas** that aren't obvious.
+
+> Name your comments! For example, a comment regarding a safety guarantee should start with `// SAFETY: ...`.
+
+### ✅ Good comment:
+```rust
+// SAFETY: `ptr` is guaranteed to be non-null and aligned by caller
+unsafe { std::ptr::copy_nonoverlapping(src, dst, len); }
+```
+
+### ✅ Design context comment:
+```rust
+// CONTEXT: Reuse root cert store across subgraphs to avoid duplicate OS calls:
+// [ADR-12](link/to/adr-12): TLS Performance on MacOS
+```
+
+## 8.3 When comments get in the way
+
+Avoid comments that:
+* Restate obvious things (`// increment i by 1 for the next loop`).
+* Can grow stale over time.
+* `TODO`s without actions (links to some versioned issue).
+* Could be replaced by better naming or smaller functions.
+
+### ❌ Bad comment:
+```rust
+fn compute(counter: &mut usize) {
+    // increment by 1
+    *counter += 1;
+}
+```
+
+### ❌ Too long or outdated
+```rust
+// Originally written in 2028 for some now-defunct platform
+```
+
+## 8.4 Don't Write Living Documentation (living comments)
+
+Comments as a "living documentation" is a **dangerous myth**, as comments are **not free**:
+* They **rot** - nobody compiles comments.
+* They **mislead** - readers usually assume they are true with no critique, e.g. "the other developer knows this code better than I do".
+* They **go stale** - unless maintained with the code, they become irrelevant.
+* They are **noisy** - comments can clutter your code with multiple unnecessary lines.
+
+If something deserves to live beyond a PR, put it in:
+* An **ADR** (Architectural Design Record).
+* A Design Document.
+* Document it **in code** by using types, doc comments, examples, renaming code blocks into cleaner functions.
+* Add tests to cover and explain the change.
+
+> ### 🚨 If you find a comment, **read it in context**. Does it still make sense? If not, remove or update it, or ask for help. Comments should bother you.
+
+## 8.5 Replace Comments with Code
+
+Instead of long commented blocks, break logic into named helper functions:
+
+#### ❌ Commented code block:
+```rust
+fn save_user(&self) -> Result<(), MyError> {
+    // check if the user is authenticated
+    if self.is_authenticated() {
+        // serialize user data
+        let data = serde_json::to_string(self)?;
+        // write to file
+        std::fs::write(self.path(), data)?;
+    }
+}
+```
+**✅ Extract for clarity**:
+
+```rust
+fn save_auth_user(&self) -> Result<PathBuf, MyError> {
+    if self.is_authenticated() {
+        let path = self.path();
+        let serialized_user = serde_json::to_string(self)?;
+        std::fs::write(path, serialized_user)?;
+        Ok(path)
+    } else {
+        Err(MyError::UserNotAuthenticated)
+    }
+}
+```
+
+## 8.6 `TODO` should become issues
+
+Don't leave `// TODO:` scattered around the codebase with no owner. Instead:
+1. File Github Issue or Jira Ticket. (Prefer github issues on public repositories).
+2. Reference the issue in the code:
+
+```rust
+// TODO(issue #42): Remove workaround after bugfix
+```
+
+This makes `TODO`s trackable, actionable and visible to everyone.
+
+## 8.7 When to use doc comments
+
+Use `///` doc comments to document:
+* All **public functions, structs, traits, enums**.
+* Their purpose, their usage and their behaviors.
+* Anything developers need to understand how to use it correctly.
+* Add context that related to `Errors` and `Panics`.
+* Plenty of examples.
+
+### ✅ Good doc comment:
+
+```rust
+/// Loads [`User`] profile from disk
+/// 
+/// # Error
+/// - Returns [`MyError`] if the file is missing [`MyError::FileNotFound`].
+/// - Returns [`MyError`] if the content is an invalid Json, [`MyError::InvalidJson`].
+fn load_user(path: &Path) -> Result<User, MyError> {...}
+```
+
+**Doc comments can also include examples, links and even tests:**
+
+```rust
+/// Returns the square of the integer part of any number.
+/// Square is limited to `u128`.
+/// 
+/// # Examples
+/// 
+/// ```rust
+/// assert_eq!(square(4.3), 16)
+/// ```
+fn square(x: impl ToInt) -> u128 { ... }
+```
+
+## 8.8 Documentation in Rust: How, When and Why
+
+Rust provides **first-class documentation tooling** via rustdoc, which makes documenting your code a key part of writing idiomatic and maintainable rust. There are doc specific lints to help with documentation, like:
+
+| Lint | Description |
+|-------------- |------------------------------------------- |
+| [missing_docs](https://doc.rust-lang.org/rustdoc/lints.html#missing_docs) | Warns that a public functions, struct, const, enum has missing documentation |
+| [broken_intra_doc_links](https://doc.rust-lang.org/rustdoc/lints.html#broken_intra_doc_links) | Detects if an internal documentation link is broken. Specially useful when things are renamed. |
+| [empty_docs](https://rust-lang.github.io/rust-clippy/master/#empty_docs) | Disallow empty docs - preventing bypass of `missing_docs` |
+| [missing_panics_doc](https://rust-lang.github.io/rust-clippy/master/#missing_panics_doc) | Warns that documentation should have a `# Panics` section if function can panic |
+| [missing_errors_doc](https://rust-lang.github.io/rust-clippy/master/#missing_errors_doc) | Warns that documentation should have a `# Errors` section if function returns a `Result` explaining `Err` conditions |
+| [missing_safety_doc](https://rust-lang.github.io/rust-clippy/master/#missing_safety_doc) | Warns that documentation should have a `# Safety` section if public facing functions have visible unsafe blocks |
+
+
+### Difference between `///` and `//!`
+
+| Style | Used for | Scope |Example |
+|---------- |------------------------------ |------------------------------------------- |---------------------------------------------------------------- |
+| `///` | Line doc comment | Public items like struct, fn, enum, consts | Documenting, giving context and usage to `fn`, `struct`, `enum`, etc |
+| `//!` | Module level doc comment | Modules or entire crates | Explaining crate/module purpose with common use cases and quickstart |
+
+### `///` Item level documentation
+
+Use `///` for functions, structs, traits, enums, const, etc:
+
+```rust
+/// Adds two numbers together.
+///
+/// # Examples
+///
+/// ```
+/// let result = my_crate::add(2, 3);
+/// assert_eq!(result, 5);
+/// ```
+pub fn add(a: i32, b: i32) -> i32 {
+    a + b
+}
+```
+* ✅ Write clear and descriptive **What it does** and **how to use it**.
+* ✅ Use `# Examples` section to better explain **how to use it**.
+* ✅ Prefer writing examples that can be tested via `cargo test`, even if you have to hide their output with starting `#`:
+```rust
+/// ```
+/// let result = my_crate::add(2, 3);
+/// # assert_eq!(result, 5);
+/// ```
+```
+* ✅ Use `# Panics`, `# Errors` and `# Safety` sections when relevant.
+* Add relevant context to the type.
+
+### `//!` Module/Crate level Documentation
+
+Use `//!` when you want to document the **purpose of a module or a crate**. It is places at the top of a `lib.rs` or `mod.rs` file, for example `engine/mod.rs`:
+```rust
+//! This module implements a custom chess engine.
+//! 
+//! It handles board state, move generation and check detection.
+//! 
+//! # Example
+//! ```
+//! let board = chess::engine::Board::default();
+//! assert!(board.is_valid());
+//! ```
+```
+
+## 8.9 Checklist for Documentation coverage
+
+📦 Crate-Level (lib.rs)
+- [ ] `//!` doc at top explains **what the crate does**, and **what problems it solves**.
+- [ ] Includes crate-level `# Examples` or pointers to modules.
+
+📁 Modules (mod.rs or inline)
+- [ ] `//!` doc explains **what this module is for**, its **exports**, and **invariants**.
+- [ ] Avoid repeating doc comments on re-exported items unless clarification is needed.
+
+🧱 Structs, Enums, Traits
+- `///` doc explains:
+    - [ ] The role this type plays.
+    - [ ] Invariants or expectations.
+    - [ ] Example construction or usage.
+- [ ] Consider using [`#[non_exhaustive]`](https://doc.rust-lang.org/reference/attributes/type_system.html#the-non_exhaustive-attribute) if external users may match on it.
+
+🔧 Functions and Methods
+- `///` doc covers:
+    - [ ] What it does.
+    - [ ] Parameters and their meaning.
+    - [ ] Return value behavior.
+    - [ ] Edge cases (`# Panics`, `# Errors`).
+    - [ ] Usage example, `# Examples`.
+
+📑 Traits
+- [ ] Explain the **purpose** of the trait (marker? dynamic dispatch?).
+- [ ] Doc for each method — include **when/why** to implement it.
+- [ ] Document clearly default implemented methods and when to override.
+
+📦 Public Constants
+- [ ] Document what they configure and when you'd want to use them.
+
+### 📌 Best Practices
+* ✅ Use examples generously — they double as test cases.
+* ✅ Prefer clarity over formality — it's for humans, not machines.
+* ✅ Prefer doc comments to explain usage, and leave implementation details to code comments if needed.
+* ✅ Use `cargo doc --open` to check your output often.
+* ✅ Add `#![deny(missing_docs)]` and other relevant doc lints in top-level modules if you want to enforce full doc coverage.
diff --git a/.agents/skills/rust-best-practices/references/chapter_09.md b/.agents/skills/rust-best-practices/references/chapter_09.md
new file mode 100644
index 0000000..bbef404
--- /dev/null
+++ b/.agents/skills/rust-best-practices/references/chapter_09.md
@@ -0,0 +1,256 @@
+# Chapter 9 - Understanding Pointers
+
+Many higher level languages hide memory management, typically **passing by value** (copy data) or **passing by reference** (reference to shared data) without worrying about allocation, heap, stack, ownership and lifetimes, it is all delegated to the garbage collector or VM. Here is a comparison on this topic between a few languages:
+
+### 📌 Language Comparison 
+
+| Language | Value Types | Reference/Pointer Types | Async Model & Types | Manual Memory |
+|------------ |------------------------------------- |----------------------------------------------------------- |---------------------------------------------------------------------------- |------------------------------ |
+| Python | None | Everything is a reference | async def, await, Task, coroutines and asyncio.Future | ❌ Not Allowed |
+| Javascript | Primitives | Objects | `async/await`, `Promise`, `setTimeout`. single threaded event loop | ❌ Not Allowed |
+| Java | Primitives | Objects | `Future<T>`, threads, Loom (green threads) | ❌ Almost none & not recommended |
+| Go | Values are copied unless using `&T` | Pointers (`*T`, `&T`), escape analysis | goroutines, `channels`, `sync.Mutex`, `context.Context` | ⚠️ Limited |
+| C | Primitives and structs supported | Raw pointers `T*` and `*void` | Threads, event loops (`libuv`, `libevent`) | ✅ Fully |
+| C++ | Primitives and references | Raw `T*` and smart pointers `shared_ptr` and `unique_ptr` | threads, `std::future`, `std::async`, (since c++ 20 `co_await/coroutines`) | ✅ Mostly |
+| Rust | Primitives, Arrays, `impl Copy` | `&T`, `&mut T`, `Box<T>`, `Arc<T>` | `async/await`, `tokio`, `Future`, `JoinHandle`, `Send + Sync` | ✅🔒 Safe and Explicit |
+
+## 9.1 Thread Safety
+
+Rust tracks pointers using `Send` and `Sync` traits:
+- `Send` means data can move across threads.
+- `Sync` means data can be referenced from multiple threads.
+
+> A pointer is thread-safe only if the data behind it is.
+
+| Pointer Type | Short Description | Send + Sync? | Main Use |
+|---------------- |--------------------------------------------------------------------------- |-------------------------------------- |------------ |
+| `&T` | Shared reference | Yes | Shared access |
+| `&mut T` | Exclusive mutable reference | No, not Send | Exclusive mutation |
+| `Box<T>` | Heap-allocated owning pointer | Yes, if T: Send + Sync | Heap allocation |
+| `Rc<T>` | Single-threaded ref counted pointer | No, neither | Multiple owners (single-thread) |
+| `Arc<T>` | Atomic ref counter pointer | Yes | Multiple owners (multi-thread) |
+| `Cell<T>` | Interior mutability for copy types | No, not Sync | Shared mutable, non-threaded |
+| `RefCell<T>` | Interior mutability (dynamic borrow checker) | No, not Sync | Shared mutable, non-threaded |
+| `Mutex<T>` | Thread-safe interior mutability with exclusive access | Yes | Shared mutable, threaded |
+| `RwLock<T>` | Thread-safe shared readonly access OR exclusive mutable access | Yes | Shared mutable, threaded |
+| `OnceCell<T>` | Single-thread one-time initialization container (interior mutability ONCE) | No, not Sync | Simple lazy value initialization |
+| `LazyCell<T>` | A lazy version of `OnceCell<T>` that calls function closure to initialize | No, not Sync | Complex lazy value initialization |
+| `OnceLock<T>` | Thread-safe version of `OnceCell<T>` | Yes | Multi-thread single init |
+| `LazyLock<T>` | Thread-safe version of `LazyCell<T>` | Yes | Multi-thread complex init |
+| `*const T/*mut T` | Raw Pointers | No, user must ensure safety manually | Raw memory / FFI |
+
+## 9.2 When to use pointers:
+
+### `&T` - Shared Borrow:
+
+Probably the most common type in a Rust code base, it is **Safe, with no mutation** and allows **multiple readers**.
+
+```rust
+let data: String = String::from_str("this a string").unwrap();
+
+print_len(&data);
+print_capacity(&data);
+print_bytes(&data);
+
+fn print_len(s: &str) {
+    println!("{}", s.len())
+}
+
+fn print_capacity(s: &String) {
+    println!("{}", s.capacity())
+}
+
+fn print_bytes(s: &String) {
+    println!("{:?}", s.as_bytes())
+}
+```
+### `&mut T` - Exclusive Borrow:
+
+Probably the most common *mutable* type in a Rust code base, it is **Safe, but only allows one mutable borrow at a time**.
+
+```rust
+let mut data: String = String::from_str("this a string").unwrap();
+mark_update(&mut data);
+
+fn mark_update(s: &mut String) {
+    s.push_str("_update");
+}
+```
+
+### [`Box<T>`](https://doc.rust-lang.org/std/boxed/struct.Box.html) - Heap Allocated
+
+Single-owner heap-allocated data, great for recursive types and large structs.
+
+```rust
+pub enum MySubBoxedEnum<T> {
+    Single(T),
+    Double(Box<MySubBoxedEnum<T>>, Box<MySubBoxedEnum<T>>),
+    Multi(Vec<T>), // Note that Vec is already a boxed value
+}
+```
+
+### [`Rc<T>`](https://doc.rust-lang.org/std/rc/struct.Rc.html) - Reference Counter (single-thread)
+
+You need multiple references to data in a single thread. Most common example is linked-list implementation.
+
+### [`Arc<T>`](https://doc.rust-lang.org/std/sync/struct.Arc.html) - Atomic Reference Counter (multi-thread)
+
+You need multiple references to data in multiple threads. Most common use cases is sharing readonly Vec across thread with `Arc<[T]>` and wrapping a `Mutex` so it can be easily shared across threads, `Arc<Mutex<T>>`.
+
+### [`RefCell<T>`](https://doc.rust-lang.org/std/cell/struct.RefCell.html) - Runtime checked interior mutability
+
+Used when you need shared access and the ability to mutate date, borrow rules are enforced at runtime. **It may panic!**.
+
+```rust
+use std::cell::RefCell;
+let x = RefCell::new(42);
+*x.borrow_mut() += 1;
+
+assert_eq!(&*x.borrow(), 42, "Not meaning of life");
+```
+
+Panic example:
+```rust
+use std::cell::RefCell;
+let x = RefCell::new(42);
+
+let borrow = x.borrow();
+
+let mutable = x.borrow_mut();
+```
+
+### [`Cell<T>`](https://doc.rust-lang.org/std/cell/struct.Cell.html) - Copy-only interior mutability
+
+Somewhat the fast and safe version of `RefCell`, but it is limited to types that implement the `Copy` trait:
+
+```rust
+use std::cell::Cell;
+
+struct SomeStruct {
+    regular_field: u8,
+    special_field: Cell<u8>,
+}
+
+let my_struct = SomeStruct {
+    regular_field: 0,
+    special_field: Cell::new(1),
+};
+
+let new_value = 100;
+
+// ERROR: `my_struct` is immutable
+// my_struct.regular_field = new_value;
+
+// WORKS: although `my_struct` is immutable, `special_field` is a `Cell`,
+// which can always be mutated with copy values
+my_struct.special_field.set(new_value);
+assert_eq!(my_struct.special_field.get(), new_value);
+```
+
+### [`Mutex<T>`](https://doc.rust-lang.org/std/sync/struct.Mutex.html) - Thread-safe mutability
+
+An exclusive access pointer that allows a thread to read/write the data contained inside. It is usually wrapped in an `Arc` to allow shared access to the Mutex.
+
+### [`RwLock<T>`](https://doc.rust-lang.org/std/sync/struct.RwLock.html) - Thread-safe mutability
+
+Similar to a `Mutex`, but it allows multiple threads to read it OR a single thread to write. It is usually wrapped in an `Arc` to allow shared access to the RwLock.
+
+
+### [`*const T/*mut T`](https://doc.rust-lang.org/std/primitive.pointer.html) - Raw pointers
+
+Inherently **unsafe** and necessary for FFI. Rust makes their usage explicit to avoid accidental misuse and unwilling manual memory management.
+
+```rust
+let x = 5;
+let ptr = &x as *const i32;
+unsafe {
+    println!("PTR is {}", *ptr)
+}
+```
+
+### [`OnceCell`](https://doc.rust-lang.org/std/cell/struct.OnceCell.html) - Single-thread single initialization container
+
+Most useful when you need to share a configuration between multiple data structures.
+
+```rust
+use std::{cell::OnceCell, rc::Rc};
+
+#[derive(Debug, Default)]
+struct MyStruct {
+    distance: usize,
+    root: Option<Rc<OnceCell<MyStruct>>>, 
+}
+
+fn main() {
+    let root = MyStruct::default();
+    let root_cell = Rc::new(OnceCell::new());
+    if let Err(previous) = root_cell.set(root) {
+        eprintln!("Previous Root {previous:?}");
+    }
+    let child_1 = MyStruct{
+        distance: 1,
+        root: Some(root_cell.clone())
+    };
+
+    let child_2 = MyStruct{
+        distance: 2,
+        root: Some(root_cell.clone())
+    };
+
+
+    println!("Child 1: {child_1:?}");
+    println!("Child 2: {child_2:?}");
+}
+```
+
+### [`LazyCell`](https://doc.rust-lang.org/std/cell/struct.LazyCell.html) - Lazy initialization of `OnceCell`
+
+Useful when the initialized data can be delayed to when it is actually being called.
+
+### [`OnceLock`](https://doc.rust-lang.org/std/sync/struct.OnceLock.html) - thread-safe `OnceCell`
+
+Useful when you need a `static` value.
+
+```rust
+use std::sync::OnceLock;
+
+static CELL: OnceLock<u32> = OnceLock::new();
+
+// `OnceLock` has not been written to yet.
+assert!(CELL.get().is_none());
+
+// Spawn a thread and write to `OnceLock`.
+std::thread::spawn(|| {
+    let value = CELL.get_or_init(|| 12345);
+    assert_eq!(value, &12345);
+})
+.join()
+.unwrap();
+
+// `OnceLock` now contains the value.
+assert_eq!(
+    CELL.get(),
+    Some(&12345),
+);
+```
+
+### [`LazyLock`](https://doc.rust-lang.org/std/sync/struct.LazyLock.html) - thread-safe `LazyCell`
+
+Similar to `OnceLock`, but the static value is a bit more complex to initialize.
+
+```rust
+use std::sync::LazyLock;
+
+static CONFIG: LazyLock<HashMap<&str, T>> = LazyLock::new(|| {
+    let data = read_config();
+    let mut config: HashMap<&str, T> = data.into();
+    config.insert("special_case", T::default());
+    config
+});
+
+let _ = &*CONFIG;
+```
+
+## References
+- [Mara Bos - Rust Atomics and Locks](https://marabos.nl/atomics/)
+- [Semicolon video on pointers](https://www.youtube.com/watch?v=Ag_6Q44PBNs)
diff --git a/.claude/skills/rust-best-practices b/.claude/skills/rust-best-practices
new file mode 120000
index 0000000..a8ca833
--- /dev/null
+++ b/.claude/skills/rust-best-practices
@@ -0,0 +1 @@
+../../.agents/skills/rust-best-practices
\ No newline at end of file
diff --git a/skills-lock.json b/skills-lock.json
new file mode 100644
index 0000000..e3011c5
--- /dev/null
+++ b/skills-lock.json
@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "skills": {
+    "rust-best-practices": {
+      "source": "apollographql/skills",
+      "sourceType": "github",
+      "computedHash": "fd336f2f772eb46ddf8658de5f9dd8faa1f35615b316665307fc82eeb4b2e658"
+    }
+  }
+}

From c2225753b27638e3cd6ce0721e8059ade36a73a9 Mon Sep 17 00:00:00 2001
From: iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Tue, 21 Apr 2026 14:17:43 +0200
Subject: [PATCH 08/14] fix

---
 tests/jsx_named_placeholders.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/jsx_named_placeholders.rs b/tests/jsx_named_placeholders.rs
index d1c4898..972b138 100644
--- a/tests/jsx_named_placeholders.rs
+++ b/tests/jsx_named_placeholders.rs
@@ -247,7 +247,7 @@ to_panic!(
     },
     r#"
 import { Trans } from '@lingui/react/macro';
-<Trans><em _t="same" class="hello">A</em> and <em _t="same" class="hello" data-testId="bla">B</strong></Trans>
+<Trans><em _t="same" class="hello">A</em> and <em _t="same" class="hello" data-testId="bla">B</em></Trans>
      "#
 );
 

From c8c1532845ee54b152893751cd186d424352d82c Mon Sep 17 00:00:00 2001
From: iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Tue, 21 Apr 2026 15:01:06 +0200
Subject: [PATCH 09/14] use insta fro snapshots + add claude docs

---
 CLAUDE.md                                     |  15 +-
 CONTRIBUTING.md                               |  18 +-
 Cargo.lock                                    |  53 +++++
 Cargo.toml                                    |   5 +-
 src/options.rs                                |  70 +++---
 ...message_should_support_template_literal.js |   8 -
 .../id_only_should_keep_only_id.js            |   9 -
 ...message_should_keep_message_and_context.js |  12 -
 .../should_expand_macros.js                   |   8 -
 .../should_expand_values.js                   |   7 -
 .../should_preserve_custom_id.js              |   5 -
 .../should_transform_define_message.js        |  10 -
 .../js_should_not_touch_non_lungui_fns.js     |   4 -
 .../js_t.rs/js_continuation_character.js      |   5 -
 .../js_t.rs/js_id_only_should_keep_only_id.js |  10 -
 ...message_should_keep_message_and_context.js |  13 -
 .../js_t.rs/js_newlines_are_preserved.js      |   5 -
 ...hould_not_touch_code_if_no_macro_import.js |   1 -
 ...hould_not_touch_not_related_tagget_tpls.js |   2 -
 ..._produce_all_fields_when_no_message_set.js |   6 -
 ...hould_use_v5_generate_id_with_parameter.js |   6 -
 ...macro_message_with_custom_i18n_instance.js |   8 -
 .../js_t.rs/js_t_fn_wrapped_in_call_expr.js   |   5 -
 .../js_t.rs/support_id_in_template_literal.js |   4 -
 .../id_only_essential_props_are_kept.js       |  10 -
 .../jsx.rs/ignore_jsx_empty_expression.js     |   5 -
 .../tests/jsx.rs/jsx_with_custom_id.js        |   5 -
 .../jsx.rs/keep_multiple_forced_newlines.js   |   5 -
 .../tests/jsx.rs/use_decoded_html_entities.js |   5 -
 .../id_only_essential_props_are_kept.js       |  10 -
 .../tests/jsx_icu.rs/jsx_icu_nested.js        |   8 -
 .../jsx_icu.rs/jsx_multivelel_nesting.js      |  13 -
 .../jsx_icu.rs/jsx_trans_inside_plural.js     |  12 -
 .../message_keeps_message_and_context.js      |  12 -
 .../allows_dotted.js                          |   8 -
 .../allows_hyphenated.js                      |   8 -
 .../attribute_ignored_when_not_configured.js  |   8 -
 .../tests/jsx_named_placeholders.rs/basic.js  |   8 -
 .../deduplication_identical.js                |   8 -
 .../jsx_named_placeholders.rs/defaults.js     |   9 -
 .../identical_spreads_reused.js               |   8 -
 .../mixed_explicit_and_defaults.js            |   9 -
 .../jsx_named_placeholders.rs/prop_order.js   |   8 -
 .../jsx_named_placeholders.rs/stripped_ast.js |   8 -
 .../supports_string_in_jsx_expression.js      |   8 -
 .../should_use_provided_runtime_modules.js    |  10 -
 .../use_lingui.rs/support_nested_macro.js     |  11 -
 ...macro_when_in_arrow_function_issue_2095.js |  11 -
 .../use_lingui.rs/work_when_t_is_not_used.js  |   5 -
 tests/common/mod.rs                           | 222 ++++++++++++++----
 ...ss_only_elements_imported_from_macro.snap} |  11 +
 ...s_only_elements_imported_from_macro2.snap} |  11 +
 ...s__js_should_support_renamed_imports.snap} |  10 +
 ...ss_only_elements_imported_from_macro.snap} |  16 ++
 ...s_only_elements_imported_from_macro2.snap} |  16 ++
 ...__jsx_should_support_renamed_imports.snap} |  15 ++
 ...dd_imports_after_directive_prologues.snap} |  10 +
 ...rts__should_add_not_clashing_imports.snap} |  14 ++
 ...ssage_should_support_template_literal.snap |  17 ++
 ..._message__id_only_should_keep_only_id.snap |  25 ++
 ...ssage_should_keep_message_and_context.snap |  28 +++
 ..._define_message__should_expand_macros.snap |  19 ++
 ..._define_message__should_expand_values.snap |  17 ++
 ...ne_message__should_preserve_custom_id.snap |  17 ++
 ...sage__should_transform_define_message.snap |  25 ++
 ...__js_choices_may_contain_expressions.snap} |  17 ++
 .../js_icu__js_dedup_values_in_icu.snap}      |  12 +
 ...s_icu_diffrent_object_literal_syntax.snap} |  13 +
 .../js_icu__js_icu_macro.snap}                |  22 ++
 .../js_icu__js_icu_nested_in_choices.snap}    |  17 ++
 .../js_icu__js_icu_nested_in_t.snap}          |  13 +
 ...plural_with_offset_and_exact_matches.snap} |  13 +
 .../js_icu__js_plural_with_placeholders.snap} |  12 +
 ...u__js_should_not_touch_non_lungui_fns.snap |  15 ++
 ...js_should_not_treat_offset_in_select.snap} |  12 +
 ...s_t__js_choice_labels_in_tpl_literal.snap} |  11 +
 .../js_t__js_continuation_character.snap      |  14 ++
 .../js_t__js_custom_i18n_passed.snap}         |  14 ++
 ...js_t__js_dedup_values_in_tpl_literal.snap} |   8 +
 ...t__js_explicit_labels_in_tpl_literal.snap} |  14 ++
 .../js_t__js_id_only_should_keep_only_id.snap |  26 ++
 ...ssage_should_keep_message_and_context.snap |  29 +++
 .../js_t__js_newlines_are_preserved.snap      |  14 ++
 .../js_t__js_ph_labels_in_tpl_literal.snap}   |  14 ++
 ...uld_not_touch_code_if_no_macro_import.snap |   8 +
 ...uld_not_touch_not_related_tagget_tpls.snap |  12 +
 ...roduce_all_fields_when_no_message_set.snap |  18 ++
 ...roduce_all_fields_without_strip_flag.snap} |  13 +
 ...uld_use_v5_generate_id_with_parameter.snap |  19 ++
 ...t__js_should_work_with_legacy_import.snap} |   9 +
 ...js_t__js_substitution_in_tpl_literal.snap} |  12 +
 ...s_support_message_descriptor_in_t_fn.snap} |   8 +
 ...cro_message_with_custom_i18n_instance.snap |  17 ++
 .../js_t__js_t_fn_wrapped_in_call_expr.snap   |  13 +
 ...te_diffrent_id_when_context_provided.snap} |  10 +
 ...omment_in_t_macro_as_call_expression.snap} |   8 +
 .../js_t__support_id_in_template_literal.snap |  12 +
 ...js_t__unicode_characters_interpreted.snap} |   9 +
 ...elements_inside_expression_container.snap} |   8 +
 .../jsx__elements_without_children.snap}      |   8 +
 .../jsx__html_attributes_are_handled.snap}    |  10 +
 ...jsx__id_only_essential_props_are_kept.snap |  25 ++
 .../jsx__ignore_jsx_empty_expression.snap     |  13 +
 ...s_should_not_affect_expression_index.snap} |  22 ++
 .../jsx__jsx_components_interpolation.snap}   |  14 ++
 .../jsx__jsx_explicit_labels.snap}            |  14 ++
 ...sx_explicit_labels_with_as_statement.snap} |   8 +
 ...re_converted_to_positional_arguments.snap} |  15 ++
 .../jsx__jsx_nested_labels.snap}              |  10 +
 .../jsx__jsx_ph_labels.snap}                  |  14 ++
 .../jsx__jsx_preserve_reserved_attrs.snap}    |   8 +
 ...jsx__jsx_should_suppor_legacy_import.snap} |   8 +
 .../jsx__jsx_simple_jsx.snap}                 |  10 +
 ...sx__jsx_template_literal_in_children.snap} |   8 +
 .../jsx__jsx_values_dedup.snap}               |  11 +
 .../jsx__jsx_with_context.snap}               |   9 +
 tests/snapshots/jsx__jsx_with_custom_id.snap  |  13 +
 .../jsx__keep_multiple_forced_newlines.snap   |  17 ++
 ...x__message_keeps_message_and_context.snap} |  15 ++
 ...on_breaking_whitespace_handling_2226.snap} |  13 +
 .../jsx__normalize_crlf_lf_cr.snap}           |  14 ++
 ...x__quoted_jsx_attributes_are_handled.snap} |   9 +
 ...x__strip_whitespace_around_arguments.snap} |  12 +
 ...e_around_tags_but_keep_forced_spaces.snap} |  12 +
 ...ut_keep_in_jsx_expression_containers.snap} |  14 ++
 .../jsx__use_decoded_html_entities.snap       |  13 +
 .../jsx__use_js_macro_in_jsx_attrs.snap}      |   9 +
 .../jsx__use_js_plural_in_jsx_attrs.snap}     |  11 +
 ...icu__id_only_essential_props_are_kept.snap |  31 +++
 .../jsx_icu__jsx_icu.snap}                    |  19 ++
 .../jsx_icu__jsx_icu_explicit_id.snap}        |  14 ++
 tests/snapshots/jsx_icu__jsx_icu_nested.snap  |  24 ++
 ...x_icu__jsx_icu_with_template_literal.snap} |  13 +
 .../jsx_icu__jsx_multivelel_nesting.snap      |  48 ++++
 ...__jsx_plural_preserve_reserved_attrs.snap} |  16 ++
 ...plural_with_offset_and_exact_matches.snap} |  14 ++
 ...rdinal_with_offset_and_exact_matches.snap} |  15 ++
 .../jsx_icu__jsx_select_simple.snap}          |  13 +
 ...jsx_select_with_expressions_in_cases.snap} |  14 ++
 ..._icu__jsx_select_with_reserved_attrs.snap} |  17 ++
 .../jsx_icu__jsx_trans_inside_plural.snap     |  32 +++
 ...cu__message_keeps_message_and_context.snap |  33 +++
 ..._multiple_new_lines_with_nbsp_endind.snap} |  11 +
 ...jsx_named_placeholders__allows_dotted.snap |  18 ++
 ...named_placeholders__allows_hyphenated.snap |  18 ++
 ...attribute_ignored_when_not_configured.snap |  19 ++
 .../jsx_named_placeholders__basic.snap        |  20 ++
 ...olders__deduplication_different_props.snap |  16 ++
 ...placeholders__deduplication_identical.snap |  19 ++
 ...rs__deduplication_with_stripped_props.snap |  15 ++
 .../jsx_named_placeholders__defaults.snap     |  23 ++
 ...placeholders__different_spreads_throw.snap |  15 ++
 ...laceholders__identical_spreads_reused.snap |  18 ++
 ...eholders__mixed_explicit_and_defaults.snap |  21 ++
 .../jsx_named_placeholders__prop_order.snap   |  18 ++
 .../jsx_named_placeholders__prop_order2.snap  |  15 ++
 ...ement_diffrent_attributes_count_throw.snap |  15 ++
 ...s__same_name_different_element_throws.snap |  15 ++
 ...s__same_spread_different_order_throws.snap |  15 ++
 .../jsx_named_placeholders__stripped_ast.snap |  20 ++
 ...rs__supports_string_in_jsx_expression.snap |  18 ++
 ..._placeholders__throws_ending_with_dot.snap |  15 ++
 ..._placeholders__throws_on_boolean_expr.snap |  15 ++
 ...ders__throws_on_empty_attribute_value.snap |  15 ++
 ..._placeholders__throws_on_empty_string.snap |  15 ++
 ..._throws_on_non_string_attribute_value.snap |  16 ++
 ..._placeholders__throws_on_numeric_name.snap |  15 ++
 ...eholders__throws_starting_with_hyphen.snap |  15 ++
 ...__should_use_provided_runtime_modules.snap |  32 +++
 .../use_lingui__js_use_lingui_hook.snap}      |  16 ++
 ...with_matching_name_in_correct_scopes.snap} |  22 ++
 .../use_lingui__support_nested_macro.snap     |  29 +++
 ...cro_when_in_arrow_function_issue_2095.snap |  29 +++
 ...ort_passing_t_variable_as_dependency.snap} |  12 +
 ...ingui__support_renamed_destructuring.snap} |  12 +
 .../use_lingui__work_when_t_is_not_used.snap  |  17 ++
 ...components_defined_as_arrow_function.snap} |  12 +
 ...k_with_existing_use_lingui_statement.snap} |  16 ++
 ..._work_with_multiple_react_components.snap} |  17 ++
 179 files changed, 2313 insertions(+), 438 deletions(-)
 delete mode 100644 tests/__swc_snapshots__/tests/js_define_message.rs/define_message_should_support_template_literal.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_define_message.rs/id_only_should_keep_only_id.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_define_message.rs/message_should_keep_message_and_context.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_define_message.rs/should_expand_macros.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_define_message.rs/should_expand_values.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_define_message.rs/should_preserve_custom_id.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_define_message.rs/should_transform_define_message.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_icu.rs/js_should_not_touch_non_lungui_fns.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_t.rs/js_continuation_character.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_t.rs/js_id_only_should_keep_only_id.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_t.rs/js_message_should_keep_message_and_context.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_t.rs/js_newlines_are_preserved.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_t.rs/js_should_not_touch_code_if_no_macro_import.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_t.rs/js_should_not_touch_not_related_tagget_tpls.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_t.rs/js_should_produce_all_fields_when_no_message_set.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_t.rs/js_should_use_v5_generate_id_with_parameter.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_t.rs/js_support_template_strings_in_t_macro_message_with_custom_i18n_instance.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_t.rs/js_t_fn_wrapped_in_call_expr.js
 delete mode 100644 tests/__swc_snapshots__/tests/js_t.rs/support_id_in_template_literal.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx.rs/id_only_essential_props_are_kept.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx.rs/ignore_jsx_empty_expression.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx.rs/jsx_with_custom_id.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx.rs/keep_multiple_forced_newlines.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx.rs/use_decoded_html_entities.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_icu.rs/id_only_essential_props_are_kept.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_icu_nested.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_multivelel_nesting.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_trans_inside_plural.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_icu.rs/message_keeps_message_and_context.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/allows_dotted.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/allows_hyphenated.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/attribute_ignored_when_not_configured.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/basic.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/deduplication_identical.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/defaults.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/identical_spreads_reused.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/mixed_explicit_and_defaults.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/prop_order.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/stripped_ast.js
 delete mode 100644 tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/supports_string_in_jsx_expression.js
 delete mode 100644 tests/__swc_snapshots__/tests/runtime_config.rs/should_use_provided_runtime_modules.js
 delete mode 100644 tests/__swc_snapshots__/tests/use_lingui.rs/support_nested_macro.js
 delete mode 100644 tests/__swc_snapshots__/tests/use_lingui.rs/support_nested_macro_when_in_arrow_function_issue_2095.js
 delete mode 100644 tests/__swc_snapshots__/tests/use_lingui.rs/work_when_t_is_not_used.js
 rename tests/{__swc_snapshots__/tests/imports.rs/js_should_process_only_elements_imported_from_macro.js => snapshots/imports__js_should_process_only_elements_imported_from_macro.snap} (54%)
 rename tests/{__swc_snapshots__/tests/imports.rs/js_should_process_only_elements_imported_from_macro2.js => snapshots/imports__js_should_process_only_elements_imported_from_macro2.snap} (50%)
 rename tests/{__swc_snapshots__/tests/imports.rs/js_should_support_renamed_imports.js => snapshots/imports__js_should_support_renamed_imports.snap} (55%)
 rename tests/{__swc_snapshots__/tests/imports.rs/jsx_should_process_only_elements_imported_from_macro.js => snapshots/imports__jsx_should_process_only_elements_imported_from_macro.snap} (53%)
 rename tests/{__swc_snapshots__/tests/imports.rs/jsx_should_process_only_elements_imported_from_macro2.js => snapshots/imports__jsx_should_process_only_elements_imported_from_macro2.snap} (53%)
 rename tests/{__swc_snapshots__/tests/imports.rs/jsx_should_support_renamed_imports.js => snapshots/imports__jsx_should_support_renamed_imports.snap} (53%)
 rename tests/{__swc_snapshots__/tests/imports.rs/should_add_imports_after_directive_prologues.js => snapshots/imports__should_add_imports_after_directive_prologues.snap} (50%)
 rename tests/{__swc_snapshots__/tests/imports.rs/should_add_not_clashing_imports.js => snapshots/imports__should_add_not_clashing_imports.snap} (57%)
 create mode 100644 tests/snapshots/js_define_message__define_message_should_support_template_literal.snap
 create mode 100644 tests/snapshots/js_define_message__id_only_should_keep_only_id.snap
 create mode 100644 tests/snapshots/js_define_message__message_should_keep_message_and_context.snap
 create mode 100644 tests/snapshots/js_define_message__should_expand_macros.snap
 create mode 100644 tests/snapshots/js_define_message__should_expand_values.snap
 create mode 100644 tests/snapshots/js_define_message__should_preserve_custom_id.snap
 create mode 100644 tests/snapshots/js_define_message__should_transform_define_message.snap
 rename tests/{__swc_snapshots__/tests/js_icu.rs/js_choices_may_contain_expressions.js => snapshots/js_icu__js_choices_may_contain_expressions.snap} (62%)
 rename tests/{__swc_snapshots__/tests/js_icu.rs/js_dedup_values_in_icu.js => snapshots/js_icu__js_dedup_values_in_icu.snap} (54%)
 rename tests/{__swc_snapshots__/tests/js_icu.rs/js_icu_diffrent_object_literal_syntax.js => snapshots/js_icu__js_icu_diffrent_object_literal_syntax.snap} (52%)
 rename tests/{__swc_snapshots__/tests/js_icu.rs/js_icu_macro.js => snapshots/js_icu__js_icu_macro.snap} (58%)
 rename tests/{__swc_snapshots__/tests/js_icu.rs/js_icu_nested_in_choices.js => snapshots/js_icu__js_icu_nested_in_choices.snap} (51%)
 rename tests/{__swc_snapshots__/tests/js_icu.rs/js_icu_nested_in_t.js => snapshots/js_icu__js_icu_nested_in_t.snap} (52%)
 rename tests/{__swc_snapshots__/tests/js_icu.rs/js_plural_with_offset_and_exact_matches.js => snapshots/js_icu__js_plural_with_offset_and_exact_matches.snap} (52%)
 rename tests/{__swc_snapshots__/tests/js_icu.rs/js_plural_with_placeholders.js => snapshots/js_icu__js_plural_with_placeholders.snap} (54%)
 create mode 100644 tests/snapshots/js_icu__js_should_not_touch_non_lungui_fns.snap
 rename tests/{__swc_snapshots__/tests/js_icu.rs/js_should_not_treat_offset_in_select.js => snapshots/js_icu__js_should_not_treat_offset_in_select.snap} (54%)
 rename tests/{__swc_snapshots__/tests/js_t.rs/js_choice_labels_in_tpl_literal.js => snapshots/js_t__js_choice_labels_in_tpl_literal.snap} (59%)
 create mode 100644 tests/snapshots/js_t__js_continuation_character.snap
 rename tests/{__swc_snapshots__/tests/js_t.rs/js_custom_i18n_passed.js => snapshots/js_t__js_custom_i18n_passed.snap} (65%)
 rename tests/{__swc_snapshots__/tests/js_t.rs/js_dedup_values_in_tpl_literal.js => snapshots/js_t__js_dedup_values_in_tpl_literal.snap} (56%)
 rename tests/{__swc_snapshots__/tests/js_t.rs/js_ph_labels_in_tpl_literal.js => snapshots/js_t__js_explicit_labels_in_tpl_literal.snap} (72%)
 create mode 100644 tests/snapshots/js_t__js_id_only_should_keep_only_id.snap
 create mode 100644 tests/snapshots/js_t__js_message_should_keep_message_and_context.snap
 create mode 100644 tests/snapshots/js_t__js_newlines_are_preserved.snap
 rename tests/{__swc_snapshots__/tests/js_t.rs/js_explicit_labels_in_tpl_literal.js => snapshots/js_t__js_ph_labels_in_tpl_literal.snap} (70%)
 create mode 100644 tests/snapshots/js_t__js_should_not_touch_code_if_no_macro_import.snap
 create mode 100644 tests/snapshots/js_t__js_should_not_touch_not_related_tagget_tpls.snap
 create mode 100644 tests/snapshots/js_t__js_should_produce_all_fields_when_no_message_set.snap
 rename tests/{__swc_snapshots__/tests/js_t.rs/js_should_produce_all_fields_without_strip_flag.js => snapshots/js_t__js_should_produce_all_fields_without_strip_flag.snap} (50%)
 create mode 100644 tests/snapshots/js_t__js_should_use_v5_generate_id_with_parameter.snap
 rename tests/{__swc_snapshots__/tests/js_t.rs/js_should_work_with_legacy_import.js => snapshots/js_t__js_should_work_with_legacy_import.snap} (51%)
 rename tests/{__swc_snapshots__/tests/js_t.rs/js_substitution_in_tpl_literal.js => snapshots/js_t__js_substitution_in_tpl_literal.snap} (71%)
 rename tests/{__swc_snapshots__/tests/js_t.rs/js_support_message_descriptor_in_t_fn.js => snapshots/js_t__js_support_message_descriptor_in_t_fn.snap} (52%)
 create mode 100644 tests/snapshots/js_t__js_support_template_strings_in_t_macro_message_with_custom_i18n_instance.snap
 create mode 100644 tests/snapshots/js_t__js_t_fn_wrapped_in_call_expr.snap
 rename tests/{__swc_snapshots__/tests/js_t.rs/should_generate_diffrent_id_when_context_provided.js => snapshots/js_t__should_generate_diffrent_id_when_context_provided.snap} (58%)
 rename tests/{__swc_snapshots__/tests/js_t.rs/support_id_and_comment_in_t_macro_as_call_expression.js => snapshots/js_t__support_id_and_comment_in_t_macro_as_call_expression.snap} (50%)
 create mode 100644 tests/snapshots/js_t__support_id_in_template_literal.snap
 rename tests/{__swc_snapshots__/tests/js_t.rs/unicode_characters_interpreted.js => snapshots/js_t__unicode_characters_interpreted.snap} (58%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/elements_inside_expression_container.js => snapshots/jsx__elements_inside_expression_container.snap} (54%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/elements_without_children.js => snapshots/jsx__elements_without_children.snap} (55%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/html_attributes_are_handled.js => snapshots/jsx__html_attributes_are_handled.snap} (53%)
 create mode 100644 tests/snapshots/jsx__id_only_essential_props_are_kept.snap
 create mode 100644 tests/snapshots/jsx__ignore_jsx_empty_expression.snap
 rename tests/{__swc_snapshots__/tests/jsx.rs/jsx_comments_should_not_affect_expression_index.js => snapshots/jsx__jsx_comments_should_not_affect_expression_index.snap} (57%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/jsx_components_interpolation.js => snapshots/jsx__jsx_components_interpolation.snap} (59%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/jsx_explicit_labels.js => snapshots/jsx__jsx_explicit_labels.snap} (68%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/jsx_explicit_labels_with_as_statement.js => snapshots/jsx__jsx_explicit_labels_with_as_statement.snap} (51%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/jsx_expressions_are_converted_to_positional_arguments.js => snapshots/jsx__jsx_expressions_are_converted_to_positional_arguments.snap} (56%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/jsx_nested_labels.js => snapshots/jsx__jsx_nested_labels.snap} (64%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/jsx_ph_labels.js => snapshots/jsx__jsx_ph_labels.snap} (67%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/jsx_preserve_reserved_attrs.js => snapshots/jsx__jsx_preserve_reserved_attrs.snap} (50%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/jsx_should_suppor_legacy_import.js => snapshots/jsx__jsx_should_suppor_legacy_import.snap} (50%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/jsx_simple_jsx.js => snapshots/jsx__jsx_simple_jsx.snap} (53%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/jsx_template_literal_in_children.js => snapshots/jsx__jsx_template_literal_in_children.snap} (56%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/jsx_values_dedup.js => snapshots/jsx__jsx_values_dedup.snap} (55%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/jsx_with_context.js => snapshots/jsx__jsx_with_context.snap} (55%)
 create mode 100644 tests/snapshots/jsx__jsx_with_custom_id.snap
 create mode 100644 tests/snapshots/jsx__keep_multiple_forced_newlines.snap
 rename tests/{__swc_snapshots__/tests/jsx.rs/message_keeps_message_and_context.js => snapshots/jsx__message_keeps_message_and_context.snap} (50%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/non_breaking_whitespace_handling_2226.js => snapshots/jsx__non_breaking_whitespace_handling_2226.snap} (54%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/normalize_crlf_lf_cr.js => snapshots/jsx__normalize_crlf_lf_cr.snap} (59%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/quoted_jsx_attributes_are_handled.js => snapshots/jsx__quoted_jsx_attributes_are_handled.snap} (53%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/strip_whitespace_around_arguments.js => snapshots/jsx__strip_whitespace_around_arguments.snap} (53%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/strip_whitespace_around_tags_but_keep_forced_spaces.js => snapshots/jsx__strip_whitespace_around_tags_but_keep_forced_spaces.snap} (52%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/strip_whitespaces_in_jsxtext_but_keep_in_jsx_expression_containers.js => snapshots/jsx__strip_whitespaces_in_jsxtext_but_keep_in_jsx_expression_containers.snap} (52%)
 create mode 100644 tests/snapshots/jsx__use_decoded_html_entities.snap
 rename tests/{__swc_snapshots__/tests/jsx.rs/use_js_macro_in_jsx_attrs.js => snapshots/jsx__use_js_macro_in_jsx_attrs.snap} (65%)
 rename tests/{__swc_snapshots__/tests/jsx.rs/use_js_plural_in_jsx_attrs.js => snapshots/jsx__use_js_plural_in_jsx_attrs.snap} (54%)
 create mode 100644 tests/snapshots/jsx_icu__id_only_essential_props_are_kept.snap
 rename tests/{__swc_snapshots__/tests/jsx_icu.rs/jsx_icu.js => snapshots/jsx_icu__jsx_icu.snap} (60%)
 rename tests/{__swc_snapshots__/tests/jsx_icu.rs/jsx_icu_explicit_id.js => snapshots/jsx_icu__jsx_icu_explicit_id.snap} (52%)
 create mode 100644 tests/snapshots/jsx_icu__jsx_icu_nested.snap
 rename tests/{__swc_snapshots__/tests/jsx_icu.rs/jsx_icu_with_template_literal.js => snapshots/jsx_icu__jsx_icu_with_template_literal.snap} (53%)
 create mode 100644 tests/snapshots/jsx_icu__jsx_multivelel_nesting.snap
 rename tests/{__swc_snapshots__/tests/jsx_icu.rs/jsx_plural_preserve_reserved_attrs.js => snapshots/jsx_icu__jsx_plural_preserve_reserved_attrs.snap} (54%)
 rename tests/{__swc_snapshots__/tests/jsx_icu.rs/jsx_plural_with_offset_and_exact_matches.js => snapshots/jsx_icu__jsx_plural_with_offset_and_exact_matches.snap} (56%)
 rename tests/{__swc_snapshots__/tests/jsx_icu.rs/jsx_select_ordinal_with_offset_and_exact_matches.js => snapshots/jsx_icu__jsx_select_ordinal_with_offset_and_exact_matches.snap} (51%)
 rename tests/{__swc_snapshots__/tests/jsx_icu.rs/jsx_select_simple.js => snapshots/jsx_icu__jsx_select_simple.snap} (57%)
 rename tests/{__swc_snapshots__/tests/jsx_icu.rs/jsx_select_with_expressions_in_cases.js => snapshots/jsx_icu__jsx_select_with_expressions_in_cases.snap} (60%)
 rename tests/{__swc_snapshots__/tests/jsx_icu.rs/jsx_select_with_reserved_attrs.js => snapshots/jsx_icu__jsx_select_with_reserved_attrs.snap} (55%)
 create mode 100644 tests/snapshots/jsx_icu__jsx_trans_inside_plural.snap
 create mode 100644 tests/snapshots/jsx_icu__message_keeps_message_and_context.snap
 rename tests/{__swc_snapshots__/tests/jsx_icu.rs/multiple_new_lines_with_nbsp_endind.js => snapshots/jsx_icu__multiple_new_lines_with_nbsp_endind.snap} (51%)
 create mode 100644 tests/snapshots/jsx_named_placeholders__allows_dotted.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__allows_hyphenated.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__attribute_ignored_when_not_configured.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__basic.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__deduplication_different_props.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__deduplication_identical.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__deduplication_with_stripped_props.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__defaults.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__different_spreads_throw.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__identical_spreads_reused.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__mixed_explicit_and_defaults.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__prop_order.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__prop_order2.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__same_element_diffrent_attributes_count_throw.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__same_name_different_element_throws.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__same_spread_different_order_throws.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__stripped_ast.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__supports_string_in_jsx_expression.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__throws_ending_with_dot.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__throws_on_boolean_expr.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__throws_on_empty_attribute_value.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__throws_on_empty_string.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__throws_on_non_string_attribute_value.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__throws_on_numeric_name.snap
 create mode 100644 tests/snapshots/jsx_named_placeholders__throws_starting_with_hyphen.snap
 create mode 100644 tests/snapshots/runtime_config__should_use_provided_runtime_modules.snap
 rename tests/{__swc_snapshots__/tests/use_lingui.rs/js_use_lingui_hook.js => snapshots/use_lingui__js_use_lingui_hook.snap} (53%)
 rename tests/{__swc_snapshots__/tests/use_lingui.rs/should_process_macro_with_matching_name_in_correct_scopes.js => snapshots/use_lingui__should_process_macro_with_matching_name_in_correct_scopes.snap} (57%)
 create mode 100644 tests/snapshots/use_lingui__support_nested_macro.snap
 create mode 100644 tests/snapshots/use_lingui__support_nested_macro_when_in_arrow_function_issue_2095.snap
 rename tests/{__swc_snapshots__/tests/use_lingui.rs/support_passing_t_variable_as_dependency.js => snapshots/use_lingui__support_passing_t_variable_as_dependency.snap} (56%)
 rename tests/{__swc_snapshots__/tests/use_lingui.rs/support_renamed_destructuring.js => snapshots/use_lingui__support_renamed_destructuring.snap} (54%)
 create mode 100644 tests/snapshots/use_lingui__work_when_t_is_not_used.snap
 rename tests/{__swc_snapshots__/tests/use_lingui.rs/work_with_components_defined_as_arrow_function.js => snapshots/use_lingui__work_with_components_defined_as_arrow_function.snap} (54%)
 rename tests/{__swc_snapshots__/tests/use_lingui.rs/work_with_existing_use_lingui_statement.js => snapshots/use_lingui__work_with_existing_use_lingui_statement.snap} (51%)
 rename tests/{__swc_snapshots__/tests/use_lingui.rs/work_with_multiple_react_components.js => snapshots/use_lingui__work_with_multiple_react_components.snap} (59%)

diff --git a/CLAUDE.md b/CLAUDE.md
index f68aae2..8388383 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -21,8 +21,11 @@ cargo test js_choices_may_contain_expressions
 # Run tests matching a prefix
 cargo test jsx_
 
-# Update snapshots after intentional changes
-UPDATE=1 cargo test
+# Update snapshots interactively (requires: cargo install cargo-insta)
+cargo insta test --review
+
+# Bulk-accept all snapshot changes
+INSTA_UPDATE=always cargo test
 
 # Format / lint
 cargo fmt --check
@@ -49,12 +52,14 @@ The plugin follows SWC's AST visitor pattern using the `Fold` trait for recursiv
 
 ## Testing
 
-Tests use SWC's snapshot testing infrastructure. Test macros are defined in `tests/common/mod.rs`:
+Tests use [insta](https://insta.rs) snapshot testing. Test macros are defined in `tests/common/mod.rs`:
 - `to!(test_name, "input code")` — transform with default options
 - `to!(test_name, options, "input code")` — transform with custom options
-- `to_panic!(test_name, "input code")` — expect compilation error
+- `to_panic!(test_name, options, "input code")` — expect compilation error (error message captured in snapshot)
+
+Snapshots live in `tests/snapshots/` and contain input + `↓ ↓ ↓ ↓ ↓ ↓` separator + output (or error text for `to_panic!` tests).
 
-Snapshots live in `tests/__swc_snapshots__/` with subdirectories per test file. Update with `UPDATE=1 cargo test`.
+To update snapshots use `INSTA_UPDATE=always cargo test` command or `cargo insta test --review` to review them interactively
 
 ## Toolchain
 
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 349ca1e..a476bb6 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -8,7 +8,13 @@ You can follow instructions at ['Install Rust' page from the official rust websi
 rustup target add wasm32-wasip1
 ```
 
-## Running tests
+## Testing
+
+Tests use [insta](https://insta.rs) snapshot testing. Test macros are defined in `tests/common/mod.rs`:
+- `to!(test_name, "input code")` — transform with default options
+- `to!(test_name, options, "input code")` — transform with custom options
+- `to_panic!(test_name, options, "input code")` — expect compilation error (error message captured in snapshot)
+
 ```bash
 # run all test suite
 cargo test
@@ -19,8 +25,14 @@ cargo test js_choices_may_contain_expressions
 # you may specify only prefix of test name to target more cases
 cargo test jsx_
 
-# update snapshots
-UPDATE=1 cargo test
+# run the whole file from the /tests folder (omit .rs extension)
+cargo test --test js_icu
+
+# Update snapshots interactively (requires: cargo install cargo-insta)
+cargo insta test --review
+
+# Bulk-accept all snapshot changes
+INSTA_UPDATE=always cargo test
 ```
 
 ## Code Quality Checks
diff --git a/Cargo.lock b/Cargo.lock
index aec6f24..cd46d07 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -249,6 +249,17 @@ dependencies = [
  "static_assertions",
 ]
 
+[[package]]
+name = "console"
+version = "0.16.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d64e8af5551369d19cf50138de61f1c42074ab970f74e99be916646777f8fc87"
+dependencies = [
+ "encode_unicode",
+ "libc",
+ "windows-sys 0.61.2",
+]
+
 [[package]]
 name = "cpufeatures"
 version = "0.2.14"
@@ -389,6 +400,12 @@ version = "1.13.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "60b1af1c220855b6ceac025d3f6ecdd2b7c4894bfe9cd9bda4fbb4bc7c0d4cf0"
 
+[[package]]
+name = "encode_unicode"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "34aa73646ffb006b8f5147f3dc182bd4bcb190227ce861fc4a4844bf8e3cb2c0"
+
 [[package]]
 name = "equivalent"
 version = "1.0.1"
@@ -661,6 +678,19 @@ dependencies = [
  "hashbrown 0.15.0",
 ]
 
+[[package]]
+name = "insta"
+version = "1.47.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7b4a6248eb93a4401ed2f37dfe8ea592d3cf05b7cf4f8efa867b6895af7e094e"
+dependencies = [
+ "console",
+ "once_cell",
+ "serde",
+ "similar",
+ "tempfile",
+]
+
 [[package]]
 name = "is-macro"
 version = "0.3.6"
@@ -696,6 +726,7 @@ name = "lingui_macro_plugin"
 version = "6.0.0-next.3"
 dependencies = [
  "data-encoding",
+ "insta",
  "once_cell",
  "regex",
  "serde",
@@ -1258,6 +1289,12 @@ version = "0.1.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "e3a9fe34e3e7a50316060351f37187a3f546bce95496156754b601a5fa71b76e"
 
+[[package]]
+name = "similar"
+version = "2.7.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bbbb5d9659141646ae647b42fe094daf6c6192d1620870b449d9557f748b2daa"
+
 [[package]]
 name = "siphasher"
 version = "0.3.11"
@@ -1392,6 +1429,7 @@ dependencies = [
  "swc_atoms",
  "swc_common",
  "swc_ecma_ast",
+ "swc_ecma_codegen",
  "swc_ecma_parser",
  "swc_ecma_transforms_base",
  "swc_ecma_transforms_testing",
@@ -2058,6 +2096,12 @@ version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
 
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+
 [[package]]
 name = "windows-sys"
 version = "0.52.0"
@@ -2076,6 +2120,15 @@ dependencies = [
  "windows-targets",
 ]
 
+[[package]]
+name = "windows-sys"
+version = "0.61.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
+dependencies = [
+ "windows-link",
+]
+
 [[package]]
 name = "windows-targets"
 version = "0.52.6"
diff --git a/Cargo.toml b/Cargo.toml
index 145b297..54f57ca 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -28,9 +28,12 @@ swc_core = { version = "50.2.3", features = [
   "ecma_visit",
   "ecma_ast",
   "ecma_parser",
+  "ecma_codegen",
   "common",
-  "testing_transform",
 ] }
 # .cargo/config defines few alias to build plugin.
 # cargo build-wasi generates wasm-wasi32 binary
 # cargo build-wasm32 generates wasm32-unknown-unknown binary.
+
+[dev-dependencies]
+insta = { version = "1", features = ["serde"] }
diff --git a/src/options.rs b/src/options.rs
index 23acd30..4bdd370 100644
--- a/src/options.rs
+++ b/src/options.rs
@@ -1,7 +1,11 @@
-use serde::Deserialize;
+use serde::{Deserialize, Serialize};
 use std::collections::HashMap;
 
-#[derive(Deserialize, Debug, PartialEq, Clone)]
+fn is_default<T: Default + PartialEq>(t: &T) -> bool {
+    t == &T::default()
+}
+
+#[derive(Deserialize, Serialize, Debug, PartialEq, Clone)]
 #[serde(rename_all = "kebab-case")]
 pub enum DescriptorFields {
     Auto,
@@ -24,6 +28,12 @@ impl DescriptorFields {
     }
 }
 
+impl Default for DescriptorFields {
+    fn default() -> Self {
+        DescriptorFields::All
+    }
+}
+
 #[derive(Deserialize, Debug, PartialEq)]
 #[serde(rename_all = "camelCase")]
 pub struct LinguiJsOptions {
@@ -32,7 +42,6 @@ pub struct LinguiJsOptions {
     descriptor_fields: Option<DescriptorFields>,
     #[serde(default)]
     use_lingui_v5_id_generation: Option<bool>,
-    strip_non_essential_fields: Option<bool>,
     #[serde(default)]
     jsx_placeholder_attribute: Option<String>,
     #[serde(default)]
@@ -50,13 +59,23 @@ pub struct RuntimeModulesConfigMap {
     use_lingui: Option<RuntimeModulesConfig>,
 }
 
-#[derive(Debug, Clone)]
+#[derive(Debug, Clone, PartialEq, Serialize)]
 pub struct RuntimeModulesConfigMapNormalized {
     pub i18n: (String, String),
     pub trans: (String, String),
     pub use_lingui: (String, String),
 }
 
+impl Default for RuntimeModulesConfigMapNormalized {
+    fn default() -> Self {
+        Self {
+            i18n: ("@lingui/core".into(), "i18n".into()),
+            trans: ("@lingui/react".into(), "Trans".into()),
+            use_lingui: ("@lingui/react".into(), "useLingui".into()),
+        }
+    }
+}
+
 impl LinguiJsOptions {
     pub fn into_options(self, env_name: &str) -> LinguiOptions {
         let descriptor_fields = match self.descriptor_fields.unwrap_or(DescriptorFields::Auto) {
@@ -73,9 +92,6 @@ impl LinguiJsOptions {
         LinguiOptions {
             descriptor_fields,
             use_lingui_v5_id_generation: self.use_lingui_v5_id_generation.unwrap_or(false),
-            strip_non_essential_fields: self
-                .strip_non_essential_fields
-                .unwrap_or(matches!(env_name, "production")),
             jsx_placeholder_attribute: self.jsx_placeholder_attribute.clone(),
             jsx_placeholder_defaults: self.jsx_placeholder_defaults.clone(),
             runtime_modules: RuntimeModulesConfigMapNormalized {
@@ -120,13 +136,17 @@ impl LinguiJsOptions {
     }
 }
 
-#[derive(Debug, Clone)]
+#[derive(Debug, Clone, Serialize)]
 pub struct LinguiOptions {
+    #[serde(skip_serializing_if = "is_default")]
     pub descriptor_fields: DescriptorFields,
-    pub strip_non_essential_fields: bool,
+    #[serde(skip_serializing_if = "is_default")]
     pub jsx_placeholder_attribute: Option<String>,
+    #[serde(skip_serializing_if = "is_default")]
     pub jsx_placeholder_defaults: Option<HashMap<String, String>>,
+    #[serde(skip_serializing_if = "is_default")]
     pub runtime_modules: RuntimeModulesConfigMapNormalized,
+    #[serde(skip_serializing_if = "is_default")]
     pub use_lingui_v5_id_generation: bool,
 }
 
@@ -135,14 +155,9 @@ impl Default for LinguiOptions {
         LinguiOptions {
             descriptor_fields: DescriptorFields::All,
             use_lingui_v5_id_generation: false,
-            strip_non_essential_fields: false,
             jsx_placeholder_attribute: None,
             jsx_placeholder_defaults: None,
-            runtime_modules: RuntimeModulesConfigMapNormalized {
-                i18n: ("@lingui/core".into(), "i18n".into()),
-                trans: ("@lingui/react".into(), "Trans".into()),
-                use_lingui: ("@lingui/react".into(), "useLingui".into()),
-            },
+            runtime_modules: Default::default(),
         }
     }
 }
@@ -183,7 +198,6 @@ mod lib_tests {
                 }),
                 descriptor_fields: None,
                 use_lingui_v5_id_generation: None,
-                strip_non_essential_fields: None,
                 jsx_placeholder_attribute: None,
                 jsx_placeholder_defaults: None,
             }
@@ -211,7 +225,6 @@ mod lib_tests {
                 }),
                 descriptor_fields: None,
                 use_lingui_v5_id_generation: None,
-                strip_non_essential_fields: None,
                 jsx_placeholder_attribute: None,
                 jsx_placeholder_defaults: None,
             }
@@ -307,29 +320,6 @@ mod lib_tests {
         assert_eq!(defaults.get("em").unwrap(), "emphasis");
     }
 
-    #[test]
-    fn test_strip_non_essential_fields_default() {
-        let config = serde_json::from_str::<LinguiJsOptions>(
-            r#"{
-                "runtimeModules": {}
-               }"#,
-        )
-        .unwrap();
-
-        let options = config.into_options("development");
-        assert!(!options.strip_non_essential_fields);
-
-        let config = serde_json::from_str::<LinguiJsOptions>(
-            r#"{
-                "runtimeModules": {}
-               }"#,
-        )
-        .unwrap();
-
-        let options = config.into_options("production");
-        assert!(options.strip_non_essential_fields);
-    }
-
     #[test]
     fn test_descriptor_fields_explicit_auto() {
         let config = serde_json::from_str::<LinguiJsOptions>(
diff --git a/tests/__swc_snapshots__/tests/js_define_message.rs/define_message_should_support_template_literal.js b/tests/__swc_snapshots__/tests/js_define_message.rs/define_message_should_support_template_literal.js
deleted file mode 100644
index 18e5304..0000000
--- a/tests/__swc_snapshots__/tests/js_define_message.rs/define_message_should_support_template_literal.js
+++ /dev/null
@@ -1,8 +0,0 @@
-const message1 = /*i18n*/ {
-    id: "xDAtGP",
-    message: "Message"
-};
-const message2 = /*i18n*/ {
-    id: "xDAtGP",
-    message: "Message"
-};
diff --git a/tests/__swc_snapshots__/tests/js_define_message.rs/id_only_should_keep_only_id.js b/tests/__swc_snapshots__/tests/js_define_message.rs/id_only_should_keep_only_id.js
deleted file mode 100644
index 9901b00..0000000
--- a/tests/__swc_snapshots__/tests/js_define_message.rs/id_only_should_keep_only_id.js
+++ /dev/null
@@ -1,9 +0,0 @@
-const message1 = /*i18n*/ {
-    id: "xDAtGP"
-};
-const message2 = /*i18n*/ {
-    id: "msgId",
-    values: {
-        name: name
-    }
-};
diff --git a/tests/__swc_snapshots__/tests/js_define_message.rs/message_should_keep_message_and_context.js b/tests/__swc_snapshots__/tests/js_define_message.rs/message_should_keep_message_and_context.js
deleted file mode 100644
index 58417c9..0000000
--- a/tests/__swc_snapshots__/tests/js_define_message.rs/message_should_keep_message_and_context.js
+++ /dev/null
@@ -1,12 +0,0 @@
-const message1 = /*i18n*/ {
-    id: "xDAtGP",
-    message: "Message"
-};
-const message2 = /*i18n*/ {
-    id: "msgId",
-    message: "Hello {name}",
-    values: {
-        name: name
-    },
-    context: "My Context"
-};
diff --git a/tests/__swc_snapshots__/tests/js_define_message.rs/should_expand_macros.js b/tests/__swc_snapshots__/tests/js_define_message.rs/should_expand_macros.js
deleted file mode 100644
index f1c4fa9..0000000
--- a/tests/__swc_snapshots__/tests/js_define_message.rs/should_expand_macros.js
+++ /dev/null
@@ -1,8 +0,0 @@
-const message = /*i18n*/ {
-    id: "AJdPPy",
-    message: "{count, plural, one {book} other {books}}",
-    values: {
-        count: count
-    },
-    comment: "Description"
-};
diff --git a/tests/__swc_snapshots__/tests/js_define_message.rs/should_expand_values.js b/tests/__swc_snapshots__/tests/js_define_message.rs/should_expand_values.js
deleted file mode 100644
index 44af2af..0000000
--- a/tests/__swc_snapshots__/tests/js_define_message.rs/should_expand_values.js
+++ /dev/null
@@ -1,7 +0,0 @@
-const message = /*i18n*/ {
-    id: "OVaF9k",
-    message: "Hello {name}",
-    values: {
-        name: name
-    }
-};
diff --git a/tests/__swc_snapshots__/tests/js_define_message.rs/should_preserve_custom_id.js b/tests/__swc_snapshots__/tests/js_define_message.rs/should_preserve_custom_id.js
deleted file mode 100644
index 2b2333e..0000000
--- a/tests/__swc_snapshots__/tests/js_define_message.rs/should_preserve_custom_id.js
+++ /dev/null
@@ -1,5 +0,0 @@
-const message = /*i18n*/ {
-    id: "custom.id",
-    message: "Message",
-    comment: "Description"
-};
diff --git a/tests/__swc_snapshots__/tests/js_define_message.rs/should_transform_define_message.js b/tests/__swc_snapshots__/tests/js_define_message.rs/should_transform_define_message.js
deleted file mode 100644
index 53f1fe9..0000000
--- a/tests/__swc_snapshots__/tests/js_define_message.rs/should_transform_define_message.js
+++ /dev/null
@@ -1,10 +0,0 @@
-const message1 = /*i18n*/ {
-    id: "xDAtGP",
-    message: "Message",
-    comment: "Description"
-};
-const message2 = /*i18n*/ {
-    id: "xDAtGP",
-    message: "Message",
-    comment: "Description"
-};
diff --git a/tests/__swc_snapshots__/tests/js_icu.rs/js_should_not_touch_non_lungui_fns.js b/tests/__swc_snapshots__/tests/js_icu.rs/js_should_not_touch_non_lungui_fns.js
deleted file mode 100644
index 24a28c2..0000000
--- a/tests/__swc_snapshots__/tests/js_icu.rs/js_should_not_touch_non_lungui_fns.js
+++ /dev/null
@@ -1,4 +0,0 @@
-const messagePlural = customName(count, {
-    one: '# Book',
-    other: '# Books'
-});
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_continuation_character.js b/tests/__swc_snapshots__/tests/js_t.rs/js_continuation_character.js
deleted file mode 100644
index a3f2454..0000000
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_continuation_character.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import { i18n as $_i18n } from "@lingui/core";
-$_i18n._(/*i18n*/ {
-    id: "d1nA7b",
-    message: "Multiline           string"
-});
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_id_only_should_keep_only_id.js b/tests/__swc_snapshots__/tests/js_t.rs/js_id_only_should_keep_only_id.js
deleted file mode 100644
index f19d727..0000000
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_id_only_should_keep_only_id.js
+++ /dev/null
@@ -1,10 +0,0 @@
-import { i18n as $_i18n } from "@lingui/core";
-const msg1 = $_i18n._(/*i18n*/ {
-    id: "xDAtGP"
-});
-const msg2 = $_i18n._(/*i18n*/ {
-    id: "msgId",
-    values: {
-        name: name
-    }
-});
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_message_should_keep_message_and_context.js b/tests/__swc_snapshots__/tests/js_t.rs/js_message_should_keep_message_and_context.js
deleted file mode 100644
index f143b93..0000000
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_message_should_keep_message_and_context.js
+++ /dev/null
@@ -1,13 +0,0 @@
-import { i18n as $_i18n } from "@lingui/core";
-const msg1 = $_i18n._(/*i18n*/ {
-    id: "xDAtGP",
-    message: "Message"
-});
-const msg2 = $_i18n._(/*i18n*/ {
-    id: "msgId",
-    message: "Hello {name}",
-    values: {
-        name: name
-    },
-    context: "My Context"
-});
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_newlines_are_preserved.js b/tests/__swc_snapshots__/tests/js_t.rs/js_newlines_are_preserved.js
deleted file mode 100644
index 252b314..0000000
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_newlines_are_preserved.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import { i18n as $_i18n } from "@lingui/core";
-$_i18n._(/*i18n*/ {
-    id: "amQF7O",
-    message: "Multiline\n           string"
-});
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_should_not_touch_code_if_no_macro_import.js b/tests/__swc_snapshots__/tests/js_t.rs/js_should_not_touch_code_if_no_macro_import.js
deleted file mode 100644
index dc9b825..0000000
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_should_not_touch_code_if_no_macro_import.js
+++ /dev/null
@@ -1 +0,0 @@
-t`Refresh inbox`;
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_should_not_touch_not_related_tagget_tpls.js b/tests/__swc_snapshots__/tests/js_t.rs/js_should_not_touch_not_related_tagget_tpls.js
deleted file mode 100644
index c6077e3..0000000
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_should_not_touch_not_related_tagget_tpls.js
+++ /dev/null
@@ -1,2 +0,0 @@
-b`Refresh inbox`;
-b(i18n)`Refresh inbox`;
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_should_produce_all_fields_when_no_message_set.js b/tests/__swc_snapshots__/tests/js_t.rs/js_should_produce_all_fields_when_no_message_set.js
deleted file mode 100644
index ffb8690..0000000
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_should_produce_all_fields_when_no_message_set.js
+++ /dev/null
@@ -1,6 +0,0 @@
-import { i18n as $_i18n } from "@lingui/core";
-const msg2 = $_i18n._(/*i18n*/ {
-    id: "msgId",
-    context: "My Context",
-    comment: "description for translators"
-});
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_should_use_v5_generate_id_with_parameter.js b/tests/__swc_snapshots__/tests/js_t.rs/js_should_use_v5_generate_id_with_parameter.js
deleted file mode 100644
index d80eea9..0000000
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_should_use_v5_generate_id_with_parameter.js
+++ /dev/null
@@ -1,6 +0,0 @@
-import { i18n as $_i18n } from "@lingui/core";
-$_i18n._(/*i18n*/ {
-    id: "SO/WB8",
-    message: "Hello World",
-    context: "my context"
-});
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_support_template_strings_in_t_macro_message_with_custom_i18n_instance.js b/tests/__swc_snapshots__/tests/js_t.rs/js_support_template_strings_in_t_macro_message_with_custom_i18n_instance.js
deleted file mode 100644
index 94e68d3..0000000
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_support_template_strings_in_t_macro_message_with_custom_i18n_instance.js
+++ /dev/null
@@ -1,8 +0,0 @@
-import { i18n_custom } from './lingui';
-const msg = i18n_custom._(/*i18n*/ {
-    id: "OVaF9k",
-    message: "Hello {name}",
-    values: {
-        name: name
-    }
-});
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_t_fn_wrapped_in_call_expr.js b/tests/__swc_snapshots__/tests/js_t.rs/js_t_fn_wrapped_in_call_expr.js
deleted file mode 100644
index 4b172a7..0000000
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_t_fn_wrapped_in_call_expr.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import { i18n as $_i18n } from "@lingui/core";
-const msg = message.error($_i18n._(/*i18n*/ {
-    id: "9ZMZjU",
-    message: "dasd"
-}));
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/support_id_in_template_literal.js b/tests/__swc_snapshots__/tests/js_t.rs/support_id_in_template_literal.js
deleted file mode 100644
index 586e62b..0000000
--- a/tests/__swc_snapshots__/tests/js_t.rs/support_id_in_template_literal.js
+++ /dev/null
@@ -1,4 +0,0 @@
-import { i18n as $_i18n } from "@lingui/core";
-const msg = $_i18n._(/*i18n*/ {
-    id: "msgId"
-});
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/id_only_essential_props_are_kept.js b/tests/__swc_snapshots__/tests/jsx.rs/id_only_essential_props_are_kept.js
deleted file mode 100644
index f41798d..0000000
--- a/tests/__swc_snapshots__/tests/jsx.rs/id_only_essential_props_are_kept.js
+++ /dev/null
@@ -1,10 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "msg.hello",
-    values: {
-        name: name
-    },
-    components: {
-        0: <strong/>
-    }
-}} render="render" i18n="i18n"/>;
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/ignore_jsx_empty_expression.js b/tests/__swc_snapshots__/tests/jsx.rs/ignore_jsx_empty_expression.js
deleted file mode 100644
index 69e73da..0000000
--- a/tests/__swc_snapshots__/tests/jsx.rs/ignore_jsx_empty_expression.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "i0M2R8",
-    message: "Hello  World"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_with_custom_id.js b/tests/__swc_snapshots__/tests/jsx.rs/jsx_with_custom_id.js
deleted file mode 100644
index fccb72c..0000000
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_with_custom_id.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-const exp2 = <Trans_ {.../*i18n*/ {
-    id: "custom.id",
-    message: "Refresh inbox"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/keep_multiple_forced_newlines.js b/tests/__swc_snapshots__/tests/jsx.rs/keep_multiple_forced_newlines.js
deleted file mode 100644
index b559b3e..0000000
--- a/tests/__swc_snapshots__/tests/jsx.rs/keep_multiple_forced_newlines.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "9xE5pD",
-    message: "Keep multiple\nforced\nnewlines!"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/use_decoded_html_entities.js b/tests/__swc_snapshots__/tests/jsx.rs/use_decoded_html_entities.js
deleted file mode 100644
index 29f0d39..0000000
--- a/tests/__swc_snapshots__/tests/jsx.rs/use_decoded_html_entities.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "EwTON7",
-    message: "&"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/id_only_essential_props_are_kept.js b/tests/__swc_snapshots__/tests/jsx_icu.rs/id_only_essential_props_are_kept.js
deleted file mode 100644
index 2c2e318..0000000
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/id_only_essential_props_are_kept.js
+++ /dev/null
@@ -1,10 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "custom.id",
-    values: {
-        count: count
-    },
-    components: {
-        0: <a href="/more"/>
-    }
-}} render="render" i18n="i18n"/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_icu_nested.js b/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_icu_nested.js
deleted file mode 100644
index ce8b473..0000000
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_icu_nested.js
+++ /dev/null
@@ -1,8 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "dzhU0t",
-    values: {
-        count: count
-    },
-    message: "You have {count, plural, one {Message} other {Messages}}"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_multivelel_nesting.js b/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_multivelel_nesting.js
deleted file mode 100644
index 00923f9..0000000
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_multivelel_nesting.js
+++ /dev/null
@@ -1,13 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "bDgQmM",
-    values: {
-        count: count,
-        count2: count2
-    },
-    components: {
-        0: <strong/>,
-        1: <strong/>
-    },
-    message: "{count, plural, one {{count2, plural, one {second level one} other {second level other}}<0>#</0> slot added} other {<1>#</1> slots added}}"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_trans_inside_plural.js b/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_trans_inside_plural.js
deleted file mode 100644
index fe32fbe..0000000
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_trans_inside_plural.js
+++ /dev/null
@@ -1,12 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "X8eyr1",
-    values: {
-        count: count
-    },
-    components: {
-        0: <strong/>,
-        1: <strong/>
-    },
-    message: "{count, plural, one {<0>#</0> slot added} other {<1>#</1> slots added}}"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/message_keeps_message_and_context.js b/tests/__swc_snapshots__/tests/jsx_icu.rs/message_keeps_message_and_context.js
deleted file mode 100644
index 8f51431..0000000
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/message_keeps_message_and_context.js
+++ /dev/null
@@ -1,12 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "custom.id",
-    values: {
-        count: count
-    },
-    components: {
-        0: <a href="/more"/>
-    },
-    message: "{count, plural, offset:1 =0 {Zero items} other {<0>A lot of them</0>}}",
-    context: "My Context"
-}} render="render" i18n="i18n"/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/allows_dotted.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/allows_dotted.js
deleted file mode 100644
index 8890c01..0000000
--- a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/allows_dotted.js
+++ /dev/null
@@ -1,8 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "_0hJpt",
-    components: {
-        ["ns.link"]: <a href="/"/>
-    },
-    message: "<ns.link>click</ns.link>"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/allows_hyphenated.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/allows_hyphenated.js
deleted file mode 100644
index 7b075bf..0000000
--- a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/allows_hyphenated.js
+++ /dev/null
@@ -1,8 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "IeIam7",
-    components: {
-        ["foo-bar"]: <a href="/"/>
-    },
-    message: "<foo-bar>click</foo-bar>"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/attribute_ignored_when_not_configured.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/attribute_ignored_when_not_configured.js
deleted file mode 100644
index 21a689c..0000000
--- a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/attribute_ignored_when_not_configured.js
+++ /dev/null
@@ -1,8 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "MykGLZ",
-    components: {
-        0: <strong _t="em"/>
-    },
-    message: "Hello <0>world</0>!"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/basic.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/basic.js
deleted file mode 100644
index 6b3dbdc..0000000
--- a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/basic.js
+++ /dev/null
@@ -1,8 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "6N0Fej",
-    components: {
-        em: <strong/>
-    },
-    message: "Hello <em>world</em>!"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/deduplication_identical.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/deduplication_identical.js
deleted file mode 100644
index c8793e4..0000000
--- a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/deduplication_identical.js
+++ /dev/null
@@ -1,8 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "idxihm",
-    components: {
-        em: <em/>
-    },
-    message: "Hello <em>emphasis</em>, normal, <em>more emphasis</em>."
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/defaults.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/defaults.js
deleted file mode 100644
index f943bff..0000000
--- a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/defaults.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "Jg_WOt",
-    components: {
-        link: <a/>,
-        em: <em/>
-    },
-    message: "Here's a <link>link</link> and <em>emphasis</em>."
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/identical_spreads_reused.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/identical_spreads_reused.js
deleted file mode 100644
index 05dfa6a..0000000
--- a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/identical_spreads_reused.js
+++ /dev/null
@@ -1,8 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "ctHZge",
-    components: {
-        same: <a {...spread}/>
-    },
-    message: "<same>A</same> <same>B</same>"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/mixed_explicit_and_defaults.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/mixed_explicit_and_defaults.js
deleted file mode 100644
index edba351..0000000
--- a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/mixed_explicit_and_defaults.js
+++ /dev/null
@@ -1,9 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "yU9TUm",
-    components: {
-        link: <a href="/a"/>,
-        link2: <a href="/b"/>
-    },
-    message: "Hello <link>link 1</link>, normal, <link2>link 2</link2>."
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/prop_order.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/prop_order.js
deleted file mode 100644
index 99ff206..0000000
--- a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/prop_order.js
+++ /dev/null
@@ -1,8 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "9en3MH",
-    components: {
-        link: <a href="/a" class="foo"/>
-    },
-    message: "Hello <link>link 1</link>, normal, <link>link 1 copy</link>."
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/stripped_ast.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/stripped_ast.js
deleted file mode 100644
index 9f6c088..0000000
--- a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/stripped_ast.js
+++ /dev/null
@@ -1,8 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "Ym2S6K",
-    components: {
-        link: <a href="/about"/>
-    },
-    message: "<link>About</link>"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/supports_string_in_jsx_expression.js b/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/supports_string_in_jsx_expression.js
deleted file mode 100644
index 44cbead..0000000
--- a/tests/__swc_snapshots__/tests/jsx_named_placeholders.rs/supports_string_in_jsx_expression.js
+++ /dev/null
@@ -1,8 +0,0 @@
-import { Trans as Trans_ } from "@lingui/react";
-<Trans_ {.../*i18n*/ {
-    id: "CeJE1x",
-    components: {
-        foo: <a href="/"/>
-    },
-    message: "<foo>click</foo>"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/runtime_config.rs/should_use_provided_runtime_modules.js b/tests/__swc_snapshots__/tests/runtime_config.rs/should_use_provided_runtime_modules.js
deleted file mode 100644
index 724a6d4..0000000
--- a/tests/__swc_snapshots__/tests/runtime_config.rs/should_use_provided_runtime_modules.js
+++ /dev/null
@@ -1,10 +0,0 @@
-import { CustomTrans as Trans_ } from "./custom-react";
-import { customI18n as $_i18n } from "./custom-core";
-$_i18n._(/*i18n*/ {
-    id: "EsCV2T",
-    message: "Refresh inbox"
-});
-const exp2 = <Trans_ {.../*i18n*/ {
-    id: "custom.id",
-    message: "Refresh inbox"
-}}/>;
diff --git a/tests/__swc_snapshots__/tests/use_lingui.rs/support_nested_macro.js b/tests/__swc_snapshots__/tests/use_lingui.rs/support_nested_macro.js
deleted file mode 100644
index e2b498f..0000000
--- a/tests/__swc_snapshots__/tests/use_lingui.rs/support_nested_macro.js
+++ /dev/null
@@ -1,11 +0,0 @@
-import { useLingui as $_useLingui } from "@lingui/react";
-function MyComponent() {
-    const { i18n: $__i18n, _: $__ } = $_useLingui();
-    const a = $__i18n._(/*i18n*/ {
-        id: "hJRCh6",
-        message: "Text {0, plural, offset:1 =0 {No books} =1 {1 book} other {# books}}",
-        values: {
-            0: users.length
-        }
-    });
-}
diff --git a/tests/__swc_snapshots__/tests/use_lingui.rs/support_nested_macro_when_in_arrow_function_issue_2095.js b/tests/__swc_snapshots__/tests/use_lingui.rs/support_nested_macro_when_in_arrow_function_issue_2095.js
deleted file mode 100644
index b0bc38e..0000000
--- a/tests/__swc_snapshots__/tests/use_lingui.rs/support_nested_macro_when_in_arrow_function_issue_2095.js
+++ /dev/null
@@ -1,11 +0,0 @@
-import { useLingui as $_useLingui } from "@lingui/react";
-const MyComponent = ()=>{
-    const { i18n: $__i18n, _: $__ } = $_useLingui();
-    const a = $__i18n._(/*i18n*/ {
-        id: "hJRCh6",
-        message: "Text {0, plural, offset:1 =0 {No books} =1 {1 book} other {# books}}",
-        values: {
-            0: users.length
-        }
-    });
-};
diff --git a/tests/__swc_snapshots__/tests/use_lingui.rs/work_when_t_is_not_used.js b/tests/__swc_snapshots__/tests/use_lingui.rs/work_when_t_is_not_used.js
deleted file mode 100644
index 434a7bb..0000000
--- a/tests/__swc_snapshots__/tests/use_lingui.rs/work_when_t_is_not_used.js
+++ /dev/null
@@ -1,5 +0,0 @@
-import { useLingui as $_useLingui } from "@lingui/react";
-function MyComponent() {
-    const { i18n, _: $__ } = $_useLingui();
-    console.log(i18n);
-}
diff --git a/tests/common/mod.rs b/tests/common/mod.rs
index 0c058e3..9da2c26 100644
--- a/tests/common/mod.rs
+++ b/tests/common/mod.rs
@@ -1,43 +1,168 @@
+use std::io::Write;
+use std::sync::{Arc, Mutex};
+
+use swc_core::common::comments::SingleThreadedComments;
+use swc_core::common::errors::{EmitterWriter, Handler, HANDLER};
+use swc_core::common::sync::Lrc;
+use swc_core::common::{FileName, Globals, Mark, SourceMap, GLOBALS};
+use swc_core::ecma::ast::Pass;
+use swc_core::ecma::codegen::to_code_default;
+use swc_core::ecma::parser::{Parser, StringInput, Syntax, TsSyntax};
+use swc_core::ecma::transforms::base::{fixer, hygiene, resolver};
+
+struct SharedWriter(Arc<Mutex<Vec<u8>>>);
+
+impl Write for SharedWriter {
+    fn write(&mut self, buf: &[u8]) -> std::io::Result<usize> {
+        self.0.lock().unwrap().write(buf)
+    }
+    fn flush(&mut self) -> std::io::Result<()> {
+        self.0.lock().unwrap().flush()
+    }
+}
+
+pub fn transform<P: Pass>(
+    input: &str,
+    transform_cb: impl FnOnce(&SingleThreadedComments) -> P,
+) -> Result<String, String> {
+    let error_buffer = Arc::new(Mutex::new(Vec::new()));
+    let cm: Lrc<SourceMap> = Default::default();
+    let comments = SingleThreadedComments::default();
+
+    let emitter = EmitterWriter::new(
+        Box::new(SharedWriter(error_buffer.clone())),
+        Some(cm.clone()),
+        false,
+        false,
+    );
+
+    let handler = Handler::with_emitter(true, false, Box::new(emitter));
+
+    let syntax = Syntax::Typescript(TsSyntax {
+        tsx: true,
+        ..Default::default()
+    });
+
+    let output = GLOBALS.set(&Globals::new(), || {
+        HANDLER.set(&handler, || {
+            let fm =
+                cm.new_source_file(FileName::Real("input.tsx".into()).into(), input.to_string());
+
+            let mut parser = Parser::new(syntax, StringInput::from(&*fm), Some(&comments));
+
+            let program = match parser.parse_program() {
+                Ok(program) => program,
+                Err(e) => {
+                    e.into_diagnostic(&handler).emit();
+                    for e in parser.take_errors() {
+                        e.into_diagnostic(&handler).emit();
+                    }
+                    return None;
+                }
+            };
+            for e in parser.take_errors() {
+                e.into_diagnostic(&handler).emit();
+            }
+
+            let program = program
+                .apply(resolver(Mark::new(), Mark::new(), true))
+                .apply(transform_cb(&comments))
+                .apply(hygiene::hygiene())
+                .apply(fixer::fixer(Some(&comments)));
+
+            Some(to_code_default(cm.clone(), Some(&comments), &program))
+        })
+    });
+
+    let errors = error_buffer.lock().unwrap().clone();
+    if !errors.is_empty() {
+        Err(String::from_utf8(errors).expect("Error output is not valid UTF-8"))
+    } else {
+        Ok(output.expect("Transform produced no output and no errors"))
+    }
+}
+
+pub fn dedent(s: &str) -> String {
+    let lines: Vec<&str> = s.lines().collect();
+
+    // Skip empty first/last lines (from r#" ... "# formatting)
+    let start = if lines.first().is_some_and(|l| l.trim().is_empty()) {
+        1
+    } else {
+        0
+    };
+    let end = if lines.last().is_some_and(|l| l.trim().is_empty()) {
+        lines.len() - 1
+    } else {
+        lines.len()
+    };
+
+    if start >= end {
+        return String::new();
+    }
+
+    let lines = &lines[start..end];
+
+    let min_indent = lines
+        .iter()
+        .filter(|l| !l.trim().is_empty())
+        .map(|l| l.len() - l.trim_start().len())
+        .min()
+        .unwrap_or(0);
+
+    lines
+        .iter()
+        .map(|l| {
+            if l.len() >= min_indent {
+                &l[min_indent..]
+            } else {
+                l.trim()
+            }
+        })
+        .collect::<Vec<_>>()
+        .join("\n")
+}
+
 #[macro_export]
 macro_rules! to {
     ($name:ident, $input:expr) => {
-        swc_core::ecma::transforms::testing::test!(
-            swc_core::ecma::parser::Syntax::Typescript(swc_core::ecma::parser::TsSyntax {
-                tsx: true,
-                ..Default::default()
-            }),
-            |tester| {
-                (
-                    swc_core::ecma::transforms::base::resolver(
-                        swc_core::common::Mark::new(),
-                        swc_core::common::Mark::new(),
-                        true,
-                    ),
-                    swc_core::ecma::visit::fold_pass(lingui_macro_plugin::LinguiMacroFolder::new(
-                        Default::default(),
-                        Some(tester.comments.clone()),
-                    )),
-                )
-            },
-            $name,
-            $input
-        );
+        #[test]
+        fn $name() {
+            let source = common::dedent($input);
+            let output = common::transform(source.as_str(), |comments| {
+                swc_core::ecma::visit::fold_pass(lingui_macro_plugin::LinguiMacroFolder::new(
+                    Default::default(),
+                    Some(comments.clone()),
+                ))
+            })
+            .expect("Transform produced unexpected errors");
+            insta::with_settings!({
+                omit_expression => true,
+            }, {
+                insta::assert_snapshot!(format!("{}\n\n↓ ↓ ↓ ↓ ↓ ↓\n\n{}", source, output));
+            });
+        }
     };
     ($name:ident, $options:expr, $input:expr) => {
-        swc_core::ecma::transforms::testing::test!(
-            swc_core::ecma::parser::Syntax::Typescript(swc_core::ecma::parser::TsSyntax {
-                tsx: true,
-                ..Default::default()
-            }),
-            |tester| {
+        #[test]
+        fn $name() {
+            let options: lingui_macro_plugin::LinguiOptions = $options;
+            let source = common::dedent($input);
+
+            let output = common::transform(source.as_str(), |comments| {
                 swc_core::ecma::visit::fold_pass(lingui_macro_plugin::LinguiMacroFolder::new(
-                    $options,
-                    Some(tester.comments.clone()),
+                    options.clone(),
+                    Some(comments.clone()),
                 ))
-            },
-            $name,
-            $input
-        );
+            })
+            .expect("Transform produced unexpected errors");
+            insta::with_settings!({
+                info => &options,
+                omit_expression => true,
+            }, {
+                insta::assert_snapshot!(format!("{}\n\n↓ ↓ ↓ ↓ ↓ ↓\n\n{}", source, output));
+            });
+        }
     };
 }
 
@@ -45,23 +170,22 @@ macro_rules! to {
 macro_rules! to_panic {
     ($name:ident, $options:expr, $input:expr) => {
         #[test]
-        #[should_panic]
         fn $name() {
-            swc_core::ecma::transforms::testing::test_inlined_transform(
-                stringify!($name),
-                swc_core::ecma::parser::Syntax::Typescript(swc_core::ecma::parser::TsSyntax {
-                    tsx: true,
-                    ..Default::default()
-                }),
-                None,
-                |tester| {
-                    swc_core::ecma::visit::fold_pass(lingui_macro_plugin::LinguiMacroFolder::new(
-                        $options,
-                        Some(tester.comments.clone()),
-                    ))
-                },
-                $input,
-            );
+            let options: lingui_macro_plugin::LinguiOptions = $options;
+            let source = common::dedent($input);
+            let err = common::transform(source.as_str(), |comments| {
+                swc_core::ecma::visit::fold_pass(lingui_macro_plugin::LinguiMacroFolder::new(
+                    options.clone(),
+                    Some(comments.clone()),
+                ))
+            })
+            .expect_err("Expected transform to produce an error, but it succeeded");
+            insta::with_settings!({
+                info => &options,
+                omit_expression => true,
+            }, {
+                insta::assert_snapshot!(format!("{}\n\n↓ ↓ ↓ ↓ ↓ ↓\n\n{}", source, err));
+            });
         }
     };
 }
diff --git a/tests/__swc_snapshots__/tests/imports.rs/js_should_process_only_elements_imported_from_macro.js b/tests/snapshots/imports__js_should_process_only_elements_imported_from_macro.snap
similarity index 54%
rename from tests/__swc_snapshots__/tests/imports.rs/js_should_process_only_elements_imported_from_macro.js
rename to tests/snapshots/imports__js_should_process_only_elements_imported_from_macro.snap
index 95323a9..93be868 100644
--- a/tests/__swc_snapshots__/tests/imports.rs/js_should_process_only_elements_imported_from_macro.js
+++ b/tests/snapshots/imports__js_should_process_only_elements_imported_from_macro.snap
@@ -1,3 +1,14 @@
+---
+source: tests/imports.rs
+---
+import { plural } from "@lingui/core/macro";
+import { t } from "./custom-t";
+
+ t`Don't touch me!`
+ plural(value, {one: "...", other: "..."})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 import { t } from "./custom-t";
 t`Don't touch me!`;
diff --git a/tests/__swc_snapshots__/tests/imports.rs/js_should_process_only_elements_imported_from_macro2.js b/tests/snapshots/imports__js_should_process_only_elements_imported_from_macro2.snap
similarity index 50%
rename from tests/__swc_snapshots__/tests/imports.rs/js_should_process_only_elements_imported_from_macro2.js
rename to tests/snapshots/imports__js_should_process_only_elements_imported_from_macro2.snap
index 0300ba9..6556100 100644
--- a/tests/__swc_snapshots__/tests/imports.rs/js_should_process_only_elements_imported_from_macro2.js
+++ b/tests/snapshots/imports__js_should_process_only_elements_imported_from_macro2.snap
@@ -1,3 +1,14 @@
+---
+source: tests/imports.rs
+---
+import { t } from "@lingui/core/macro";
+import { plural } from "./custom-plural";
+
+ t`Hello World!`;
+ plural(value, {one: "...", other: "..."});
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 import { plural } from "./custom-plural";
 $_i18n._(/*i18n*/ {
diff --git a/tests/__swc_snapshots__/tests/imports.rs/js_should_support_renamed_imports.js b/tests/snapshots/imports__js_should_support_renamed_imports.snap
similarity index 55%
rename from tests/__swc_snapshots__/tests/imports.rs/js_should_support_renamed_imports.js
rename to tests/snapshots/imports__js_should_support_renamed_imports.snap
index b0b288e..a6dc23a 100644
--- a/tests/__swc_snapshots__/tests/imports.rs/js_should_support_renamed_imports.js
+++ b/tests/snapshots/imports__js_should_support_renamed_imports.snap
@@ -1,3 +1,13 @@
+---
+source: tests/imports.rs
+---
+import { t as i18nT, plural as i18nPlural } from "@lingui/core/macro";
+
+ i18nT`Hello World!`;
+ i18nPlural(value, {one: "...", other: "..."});
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 $_i18n._(/*i18n*/ {
     id: "0IkKj6",
diff --git a/tests/__swc_snapshots__/tests/imports.rs/jsx_should_process_only_elements_imported_from_macro.js b/tests/snapshots/imports__jsx_should_process_only_elements_imported_from_macro.snap
similarity index 53%
rename from tests/__swc_snapshots__/tests/imports.rs/jsx_should_process_only_elements_imported_from_macro.js
rename to tests/snapshots/imports__jsx_should_process_only_elements_imported_from_macro.snap
index 5d7629a..4192324 100644
--- a/tests/__swc_snapshots__/tests/imports.rs/jsx_should_process_only_elements_imported_from_macro.js
+++ b/tests/snapshots/imports__jsx_should_process_only_elements_imported_from_macro.snap
@@ -1,3 +1,19 @@
+---
+source: tests/imports.rs
+---
+import { Plural } from "@lingui/react/macro";
+import { Select } from "./my-select-cmp";
+
+;<Plural
+ value={count}
+ one="Message"
+ other="Messages"
+/>
+
+;<Select prop="propValue">Should be untouched</Select>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 import { Select } from "./my-select-cmp";
 ;
diff --git a/tests/__swc_snapshots__/tests/imports.rs/jsx_should_process_only_elements_imported_from_macro2.js b/tests/snapshots/imports__jsx_should_process_only_elements_imported_from_macro2.snap
similarity index 53%
rename from tests/__swc_snapshots__/tests/imports.rs/jsx_should_process_only_elements_imported_from_macro2.js
rename to tests/snapshots/imports__jsx_should_process_only_elements_imported_from_macro2.snap
index 3fd845e..972c5b8 100644
--- a/tests/__swc_snapshots__/tests/imports.rs/jsx_should_process_only_elements_imported_from_macro2.js
+++ b/tests/snapshots/imports__jsx_should_process_only_elements_imported_from_macro2.snap
@@ -1,3 +1,19 @@
+---
+source: tests/imports.rs
+---
+import { Trans } from "@lingui/react";
+import { Plural } from "@lingui/react/macro";
+
+;<Plural
+ value={count}
+ one="Message"
+ other="Messages"
+/>
+
+;<Trans>Should be untouched</Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans } from "@lingui/react";
 import { Trans as Trans_ } from "@lingui/react";
 ;
diff --git a/tests/__swc_snapshots__/tests/imports.rs/jsx_should_support_renamed_imports.js b/tests/snapshots/imports__jsx_should_support_renamed_imports.snap
similarity index 53%
rename from tests/__swc_snapshots__/tests/imports.rs/jsx_should_support_renamed_imports.js
rename to tests/snapshots/imports__jsx_should_support_renamed_imports.snap
index 6571262..0d200b1 100644
--- a/tests/__swc_snapshots__/tests/imports.rs/jsx_should_support_renamed_imports.js
+++ b/tests/snapshots/imports__jsx_should_support_renamed_imports.snap
@@ -1,3 +1,18 @@
+---
+source: tests/imports.rs
+---
+import { Trans as I18nTrans, Plural as I18nPlural } from "@lingui/react/macro";
+
+;<I18nPlural
+ value={count}
+ one="Message"
+ other="Messages"
+/>
+
+;<I18nTrans>Hello!</I18nTrans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 ;
 <Trans_ {.../*i18n*/ {
diff --git a/tests/__swc_snapshots__/tests/imports.rs/should_add_imports_after_directive_prologues.js b/tests/snapshots/imports__should_add_imports_after_directive_prologues.snap
similarity index 50%
rename from tests/__swc_snapshots__/tests/imports.rs/should_add_imports_after_directive_prologues.js
rename to tests/snapshots/imports__should_add_imports_after_directive_prologues.snap
index 312e268..c723a6e 100644
--- a/tests/__swc_snapshots__/tests/imports.rs/should_add_imports_after_directive_prologues.js
+++ b/tests/snapshots/imports__should_add_imports_after_directive_prologues.snap
@@ -1,3 +1,13 @@
+---
+source: tests/imports.rs
+---
+"use client";
+ import { t } from "@lingui/core/macro"
+ import foo from "bar"
+ t`Text`
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 "use client";
 import { i18n as $_i18n } from "@lingui/core";
 import foo from "bar";
diff --git a/tests/__swc_snapshots__/tests/imports.rs/should_add_not_clashing_imports.js b/tests/snapshots/imports__should_add_not_clashing_imports.snap
similarity index 57%
rename from tests/__swc_snapshots__/tests/imports.rs/should_add_not_clashing_imports.js
rename to tests/snapshots/imports__should_add_not_clashing_imports.snap
index 62a66a9..e2befc2 100644
--- a/tests/__swc_snapshots__/tests/imports.rs/should_add_not_clashing_imports.js
+++ b/tests/snapshots/imports__should_add_not_clashing_imports.snap
@@ -1,3 +1,17 @@
+---
+source: tests/imports.rs
+---
+import { t } from "@lingui/core/macro";
+import { Plural } from "@lingui/react/macro";
+import { i18n } from "@lingui/core";
+import { Trans } from "@lingui/react";
+
+t`Test`;
+<Plural value={value} one="..." other="..."/>;
+<Trans>Untouched</Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 import { i18n as $_i18n } from "@lingui/core";
 import { i18n } from "@lingui/core";
diff --git a/tests/snapshots/js_define_message__define_message_should_support_template_literal.snap b/tests/snapshots/js_define_message__define_message_should_support_template_literal.snap
new file mode 100644
index 0000000..0d030a6
--- /dev/null
+++ b/tests/snapshots/js_define_message__define_message_should_support_template_literal.snap
@@ -0,0 +1,17 @@
+---
+source: tests/js_define_message.rs
+---
+import { defineMessage, msg } from '@lingui/macro';
+const message1 = defineMessage`Message`;
+const message2 = msg`Message`
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+const message1 = /*i18n*/ {
+    id: "xDAtGP",
+    message: "Message"
+};
+const message2 = /*i18n*/ {
+    id: "xDAtGP",
+    message: "Message"
+};
diff --git a/tests/snapshots/js_define_message__id_only_should_keep_only_id.snap b/tests/snapshots/js_define_message__id_only_should_keep_only_id.snap
new file mode 100644
index 0000000..62663b6
--- /dev/null
+++ b/tests/snapshots/js_define_message__id_only_should_keep_only_id.snap
@@ -0,0 +1,25 @@
+---
+source: tests/js_define_message.rs
+info:
+  descriptor_fields: id-only
+---
+import { defineMessage } from '@lingui/macro'
+const message1 = defineMessage`Message`;
+const message2 = defineMessage({
+    message: `Hello ${name}`,
+    id: 'msgId',
+    comment: 'description for translators',
+    context: 'My Context',
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+const message1 = /*i18n*/ {
+    id: "xDAtGP"
+};
+const message2 = /*i18n*/ {
+    id: "msgId",
+    values: {
+        name: name
+    }
+};
diff --git a/tests/snapshots/js_define_message__message_should_keep_message_and_context.snap b/tests/snapshots/js_define_message__message_should_keep_message_and_context.snap
new file mode 100644
index 0000000..3b19992
--- /dev/null
+++ b/tests/snapshots/js_define_message__message_should_keep_message_and_context.snap
@@ -0,0 +1,28 @@
+---
+source: tests/js_define_message.rs
+info:
+  descriptor_fields: message
+---
+import { defineMessage } from '@lingui/macro'
+const message1 = defineMessage`Message`;
+const message2 = defineMessage({
+    message: `Hello ${name}`,
+    id: 'msgId',
+    comment: 'description for translators',
+    context: 'My Context',
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+const message1 = /*i18n*/ {
+    id: "xDAtGP",
+    message: "Message"
+};
+const message2 = /*i18n*/ {
+    id: "msgId",
+    message: "Hello {name}",
+    values: {
+        name: name
+    },
+    context: "My Context"
+};
diff --git a/tests/snapshots/js_define_message__should_expand_macros.snap b/tests/snapshots/js_define_message__should_expand_macros.snap
new file mode 100644
index 0000000..ca04e78
--- /dev/null
+++ b/tests/snapshots/js_define_message__should_expand_macros.snap
@@ -0,0 +1,19 @@
+---
+source: tests/js_define_message.rs
+---
+import { defineMessage, plural, arg } from '@lingui/macro';
+const message = defineMessage({
+  comment: "Description",
+  message: plural(count, { one: "book", other: "books" })
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+const message = /*i18n*/ {
+    id: "AJdPPy",
+    message: "{count, plural, one {book} other {books}}",
+    values: {
+        count: count
+    },
+    comment: "Description"
+};
diff --git a/tests/snapshots/js_define_message__should_expand_values.snap b/tests/snapshots/js_define_message__should_expand_values.snap
new file mode 100644
index 0000000..d1e899b
--- /dev/null
+++ b/tests/snapshots/js_define_message__should_expand_values.snap
@@ -0,0 +1,17 @@
+---
+source: tests/js_define_message.rs
+---
+import { defineMessage, plural, arg } from '@lingui/macro';
+const message = defineMessage({
+  message: `Hello ${name}`
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+const message = /*i18n*/ {
+    id: "OVaF9k",
+    message: "Hello {name}",
+    values: {
+        name: name
+    }
+};
diff --git a/tests/snapshots/js_define_message__should_preserve_custom_id.snap b/tests/snapshots/js_define_message__should_preserve_custom_id.snap
new file mode 100644
index 0000000..d2011f9
--- /dev/null
+++ b/tests/snapshots/js_define_message__should_preserve_custom_id.snap
@@ -0,0 +1,17 @@
+---
+source: tests/js_define_message.rs
+---
+import { defineMessage, plural, arg } from '@lingui/macro';
+const message = defineMessage({
+  comment: "Description",
+  id: "custom.id",
+  message: "Message",
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+const message = /*i18n*/ {
+    id: "custom.id",
+    message: "Message",
+    comment: "Description"
+};
diff --git a/tests/snapshots/js_define_message__should_transform_define_message.snap b/tests/snapshots/js_define_message__should_transform_define_message.snap
new file mode 100644
index 0000000..341b8f8
--- /dev/null
+++ b/tests/snapshots/js_define_message__should_transform_define_message.snap
@@ -0,0 +1,25 @@
+---
+source: tests/js_define_message.rs
+---
+import { defineMessage, msg } from '@lingui/macro';
+const message1 = defineMessage({
+  comment: "Description",
+  message: "Message"
+})
+const message2 = msg({
+  comment: "Description",
+  message: "Message"
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+const message1 = /*i18n*/ {
+    id: "xDAtGP",
+    message: "Message",
+    comment: "Description"
+};
+const message2 = /*i18n*/ {
+    id: "xDAtGP",
+    message: "Message",
+    comment: "Description"
+};
diff --git a/tests/__swc_snapshots__/tests/js_icu.rs/js_choices_may_contain_expressions.js b/tests/snapshots/js_icu__js_choices_may_contain_expressions.snap
similarity index 62%
rename from tests/__swc_snapshots__/tests/js_icu.rs/js_choices_may_contain_expressions.js
rename to tests/snapshots/js_icu__js_choices_may_contain_expressions.snap
index d531460..a4aaa5c 100644
--- a/tests/__swc_snapshots__/tests/js_icu.rs/js_choices_may_contain_expressions.js
+++ b/tests/snapshots/js_icu__js_choices_may_contain_expressions.snap
@@ -1,3 +1,20 @@
+---
+source: tests/js_icu.rs
+---
+import { plural, select, selectOrdinal } from "@lingui/core/macro";
+const messagePlural = plural(count, {
+   one: foo.bar,
+   other: variable
+})
+const messageSelect = select(gender, {
+   male: 'he',
+   female: variable,
+   third: fn(),
+   other: foo.bar
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 const messagePlural = $_i18n._(/*i18n*/ {
     id: "l6reUi",
diff --git a/tests/__swc_snapshots__/tests/js_icu.rs/js_dedup_values_in_icu.js b/tests/snapshots/js_icu__js_dedup_values_in_icu.snap
similarity index 54%
rename from tests/__swc_snapshots__/tests/js_icu.rs/js_dedup_values_in_icu.js
rename to tests/snapshots/js_icu__js_dedup_values_in_icu.snap
index b008b58..0df731e 100644
--- a/tests/__swc_snapshots__/tests/js_icu.rs/js_dedup_values_in_icu.js
+++ b/tests/snapshots/js_icu__js_dedup_values_in_icu.snap
@@ -1,3 +1,15 @@
+---
+source: tests/js_icu.rs
+---
+import { plural } from "@lingui/core/macro";
+
+const message = plural(count, {
+    one: `${name} has ${count} friend`,
+    other: `${name} has {count} friends`
+ })
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 const message = $_i18n._(/*i18n*/ {
     id: "tK7kAV",
diff --git a/tests/__swc_snapshots__/tests/js_icu.rs/js_icu_diffrent_object_literal_syntax.js b/tests/snapshots/js_icu__js_icu_diffrent_object_literal_syntax.snap
similarity index 52%
rename from tests/__swc_snapshots__/tests/js_icu.rs/js_icu_diffrent_object_literal_syntax.js
rename to tests/snapshots/js_icu__js_icu_diffrent_object_literal_syntax.snap
index dac3cff..16db03e 100644
--- a/tests/__swc_snapshots__/tests/js_icu.rs/js_icu_diffrent_object_literal_syntax.js
+++ b/tests/snapshots/js_icu__js_icu_diffrent_object_literal_syntax.snap
@@ -1,3 +1,16 @@
+---
+source: tests/js_icu.rs
+---
+import { plural } from "@lingui/core/macro";
+
+const messagePlural = plural(count, {
+   one: '# Book',
+   "other": '# Books',
+   few: ('# Books'),
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 const messagePlural = $_i18n._(/*i18n*/ {
     id: "2y_Fr5",
diff --git a/tests/__swc_snapshots__/tests/js_icu.rs/js_icu_macro.js b/tests/snapshots/js_icu__js_icu_macro.snap
similarity index 58%
rename from tests/__swc_snapshots__/tests/js_icu.rs/js_icu_macro.js
rename to tests/snapshots/js_icu__js_icu_macro.snap
index 61a942a..97bc5dd 100644
--- a/tests/__swc_snapshots__/tests/js_icu.rs/js_icu_macro.js
+++ b/tests/snapshots/js_icu__js_icu_macro.snap
@@ -1,3 +1,25 @@
+---
+source: tests/js_icu.rs
+---
+import { plural, select, selectOrdinal } from "@lingui/core/macro";
+const messagePlural = plural(count, {
+   one: '# Book',
+   other: '# Books'
+})
+const messageSelect = select(gender, {
+   male: 'he',
+   female: 'she',
+   other: 'they'
+})
+const messageSelectOrdinal = selectOrdinal(count, {
+   one: '#st',
+   two: '#nd',
+   few: '#rd',
+   other: '#th',
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 const messagePlural = $_i18n._(/*i18n*/ {
     id: "V_M0Vc",
diff --git a/tests/__swc_snapshots__/tests/js_icu.rs/js_icu_nested_in_choices.js b/tests/snapshots/js_icu__js_icu_nested_in_choices.snap
similarity index 51%
rename from tests/__swc_snapshots__/tests/js_icu.rs/js_icu_nested_in_choices.js
rename to tests/snapshots/js_icu__js_icu_nested_in_choices.snap
index f0ec56c..5b9f7bb 100644
--- a/tests/__swc_snapshots__/tests/js_icu.rs/js_icu_nested_in_choices.js
+++ b/tests/snapshots/js_icu__js_icu_nested_in_choices.snap
@@ -1,3 +1,20 @@
+---
+source: tests/js_icu.rs
+---
+import { plural } from "@lingui/core/macro"
+const message = plural(numBooks, {
+   one: plural(numArticles, {
+      one: `1 book and 1 article`,
+      other: `1 book and ${numArticles} articles`,
+   }),
+   other: plural(numArticles, {
+      one: `${numBooks} books and 1 article`,
+      other: `${numBooks} books and ${numArticles} articles`,
+   }),
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 const message = $_i18n._(/*i18n*/ {
     id: "AA3wsz",
diff --git a/tests/__swc_snapshots__/tests/js_icu.rs/js_icu_nested_in_t.js b/tests/snapshots/js_icu__js_icu_nested_in_t.snap
similarity index 52%
rename from tests/__swc_snapshots__/tests/js_icu.rs/js_icu_nested_in_t.js
rename to tests/snapshots/js_icu__js_icu_nested_in_t.snap
index 9c39d03..f4df7fc 100644
--- a/tests/__swc_snapshots__/tests/js_icu.rs/js_icu_nested_in_t.js
+++ b/tests/snapshots/js_icu__js_icu_nested_in_t.snap
@@ -1,3 +1,16 @@
+---
+source: tests/js_icu.rs
+---
+import { t, selectOrdinal } from '@lingui/macro'
+
+t`This is my ${selectOrdinal(count, {
+  one: "st",
+  two: "nd",
+  other: "rd"
+})} cat`
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 $_i18n._(/*i18n*/ {
     id: "LF3Ndn",
diff --git a/tests/__swc_snapshots__/tests/js_icu.rs/js_plural_with_offset_and_exact_matches.js b/tests/snapshots/js_icu__js_plural_with_offset_and_exact_matches.snap
similarity index 52%
rename from tests/__swc_snapshots__/tests/js_icu.rs/js_plural_with_offset_and_exact_matches.js
rename to tests/snapshots/js_icu__js_plural_with_offset_and_exact_matches.snap
index 31b012d..2981d14 100644
--- a/tests/__swc_snapshots__/tests/js_icu.rs/js_plural_with_offset_and_exact_matches.js
+++ b/tests/snapshots/js_icu__js_plural_with_offset_and_exact_matches.snap
@@ -1,3 +1,16 @@
+---
+source: tests/js_icu.rs
+---
+import { plural } from '@lingui/macro'
+plural(users.length, {
+  offset: 1,
+  0: "No books",
+  1: "1 book",
+  other: "\# books"
+});
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 $_i18n._(/*i18n*/ {
     id: "CF5t-7",
diff --git a/tests/__swc_snapshots__/tests/js_icu.rs/js_plural_with_placeholders.js b/tests/snapshots/js_icu__js_plural_with_placeholders.snap
similarity index 54%
rename from tests/__swc_snapshots__/tests/js_icu.rs/js_plural_with_placeholders.js
rename to tests/snapshots/js_icu__js_plural_with_placeholders.snap
index 4cc7e19..227679f 100644
--- a/tests/__swc_snapshots__/tests/js_icu.rs/js_plural_with_placeholders.js
+++ b/tests/snapshots/js_icu__js_plural_with_placeholders.snap
@@ -1,3 +1,15 @@
+---
+source: tests/js_icu.rs
+---
+import { plural } from "@lingui/core/macro";
+
+const message = plural(count, {
+    one: `${name} has # friend`,
+    other: `${name} has # friends`
+ })
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 const message = $_i18n._(/*i18n*/ {
     id: "CvuUwE",
diff --git a/tests/snapshots/js_icu__js_should_not_touch_non_lungui_fns.snap b/tests/snapshots/js_icu__js_should_not_touch_non_lungui_fns.snap
new file mode 100644
index 0000000..3cda85f
--- /dev/null
+++ b/tests/snapshots/js_icu__js_should_not_touch_non_lungui_fns.snap
@@ -0,0 +1,15 @@
+---
+source: tests/js_icu.rs
+---
+import { plural } from "@lingui/core/macro";
+const messagePlural = customName(count, {
+   one: '# Book',
+   other: '# Books'
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+const messagePlural = customName(count, {
+    one: '# Book',
+    other: '# Books'
+});
diff --git a/tests/__swc_snapshots__/tests/js_icu.rs/js_should_not_treat_offset_in_select.js b/tests/snapshots/js_icu__js_should_not_treat_offset_in_select.snap
similarity index 54%
rename from tests/__swc_snapshots__/tests/js_icu.rs/js_should_not_treat_offset_in_select.js
rename to tests/snapshots/js_icu__js_should_not_treat_offset_in_select.snap
index f810a4a..0dc3485 100644
--- a/tests/__swc_snapshots__/tests/js_icu.rs/js_should_not_treat_offset_in_select.js
+++ b/tests/snapshots/js_icu__js_should_not_treat_offset_in_select.snap
@@ -1,3 +1,15 @@
+---
+source: tests/js_icu.rs
+---
+import { select } from '@lingui/macro'
+select(value, {
+  offset: "..",
+  any: "..",
+  other: "..",
+});
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 $_i18n._(/*i18n*/ {
     id: "QHtFym",
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_choice_labels_in_tpl_literal.js b/tests/snapshots/js_t__js_choice_labels_in_tpl_literal.snap
similarity index 59%
rename from tests/__swc_snapshots__/tests/js_t.rs/js_choice_labels_in_tpl_literal.js
rename to tests/snapshots/js_t__js_choice_labels_in_tpl_literal.snap
index fd653dc..c68505e 100644
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_choice_labels_in_tpl_literal.js
+++ b/tests/snapshots/js_t__js_choice_labels_in_tpl_literal.snap
@@ -1,3 +1,14 @@
+---
+source: tests/js_t.rs
+---
+import { t, ph, plural, select, selectOrdinal } from "@lingui/core/macro";
+
+t`We have ${plural({count: getDevelopersCount()}, {one: "# developer", other: "# developers"})}`
+t`${select(gender, {male: "he", female: "she", other: "they"})}`
+t`${selectOrdinal(count, {one: "#st", two: "#nd", few: "#rd", other: "#th"})}`
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 $_i18n._(/*i18n*/ {
     id: "-7z66M",
diff --git a/tests/snapshots/js_t__js_continuation_character.snap b/tests/snapshots/js_t__js_continuation_character.snap
new file mode 100644
index 0000000..b28a106
--- /dev/null
+++ b/tests/snapshots/js_t__js_continuation_character.snap
@@ -0,0 +1,14 @@
+---
+source: tests/js_t.rs
+---
+import { t } from '@lingui/core/macro';
+  t`Multiline\
+    string`;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { i18n as $_i18n } from "@lingui/core";
+$_i18n._(/*i18n*/ {
+    id: "eGqEZt",
+    message: "Multiline    string"
+});
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_custom_i18n_passed.js b/tests/snapshots/js_t__js_custom_i18n_passed.snap
similarity index 65%
rename from tests/__swc_snapshots__/tests/js_t.rs/js_custom_i18n_passed.js
rename to tests/snapshots/js_t__js_custom_i18n_passed.snap
index 55a9fd2..123d916 100644
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_custom_i18n_passed.js
+++ b/tests/snapshots/js_t__js_custom_i18n_passed.snap
@@ -1,3 +1,17 @@
+---
+source: tests/js_t.rs
+---
+import { t } from "@lingui/core/macro";
+import { custom_i18n } from "./i18n";
+
+t(custom_i18n)`Refresh inbox`
+t(custom_i18n)`Refresh ${foo} inbox ${bar}`
+t(custom_i18n)`Refresh ${foo.bar} inbox ${bar}`
+t(custom_i18n)`Refresh ${expr()}`
+t(custom.i18n)`Refresh ${expr()}`
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { custom_i18n } from "./i18n";
 custom_i18n._(/*i18n*/ {
     id: "EsCV2T",
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_dedup_values_in_tpl_literal.js b/tests/snapshots/js_t__js_dedup_values_in_tpl_literal.snap
similarity index 56%
rename from tests/__swc_snapshots__/tests/js_t.rs/js_dedup_values_in_tpl_literal.js
rename to tests/snapshots/js_t__js_dedup_values_in_tpl_literal.snap
index e0f17ec..54041fd 100644
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_dedup_values_in_tpl_literal.js
+++ b/tests/snapshots/js_t__js_dedup_values_in_tpl_literal.snap
@@ -1,3 +1,11 @@
+---
+source: tests/js_t.rs
+---
+import { t } from "@lingui/core/macro";
+t`Refresh ${foo} inbox ${foo}`
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 $_i18n._(/*i18n*/ {
     id: "YZhODz",
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_ph_labels_in_tpl_literal.js b/tests/snapshots/js_t__js_explicit_labels_in_tpl_literal.snap
similarity index 72%
rename from tests/__swc_snapshots__/tests/js_t.rs/js_ph_labels_in_tpl_literal.js
rename to tests/snapshots/js_t__js_explicit_labels_in_tpl_literal.snap
index 6ed91e0..b03a23d 100644
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_ph_labels_in_tpl_literal.js
+++ b/tests/snapshots/js_t__js_explicit_labels_in_tpl_literal.snap
@@ -1,3 +1,17 @@
+---
+source: tests/js_t.rs
+---
+import { t } from "@lingui/core/macro";
+
+t`Refresh ${{foo}} inbox`
+t`Refresh ${{foo: foo.bar}} inbox`
+t`Refresh ${{foo: expr()}} inbox`
+t`Refresh ${{foo: bar, baz: qux}} inbox`
+t`Refresh ${{}} inbox`
+t`Refresh ${{...spread}} inbox`
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 $_i18n._(/*i18n*/ {
     id: "rtxU8c",
diff --git a/tests/snapshots/js_t__js_id_only_should_keep_only_id.snap b/tests/snapshots/js_t__js_id_only_should_keep_only_id.snap
new file mode 100644
index 0000000..5ec552f
--- /dev/null
+++ b/tests/snapshots/js_t__js_id_only_should_keep_only_id.snap
@@ -0,0 +1,26 @@
+---
+source: tests/js_t.rs
+info:
+  descriptor_fields: id-only
+---
+import { t } from '@lingui/core/macro'
+const msg1 = t`Message`
+const msg2 = t({
+    message: `Hello ${name}`,
+    id: 'msgId',
+    comment: 'description for translators',
+    context: 'My Context',
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { i18n as $_i18n } from "@lingui/core";
+const msg1 = $_i18n._(/*i18n*/ {
+    id: "xDAtGP"
+});
+const msg2 = $_i18n._(/*i18n*/ {
+    id: "msgId",
+    values: {
+        name: name
+    }
+});
diff --git a/tests/snapshots/js_t__js_message_should_keep_message_and_context.snap b/tests/snapshots/js_t__js_message_should_keep_message_and_context.snap
new file mode 100644
index 0000000..494b338
--- /dev/null
+++ b/tests/snapshots/js_t__js_message_should_keep_message_and_context.snap
@@ -0,0 +1,29 @@
+---
+source: tests/js_t.rs
+info:
+  descriptor_fields: message
+---
+import { t } from '@lingui/core/macro'
+const msg1 = t`Message`
+const msg2 = t({
+    message: `Hello ${name}`,
+    id: 'msgId',
+    comment: 'description for translators',
+    context: 'My Context',
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { i18n as $_i18n } from "@lingui/core";
+const msg1 = $_i18n._(/*i18n*/ {
+    id: "xDAtGP",
+    message: "Message"
+});
+const msg2 = $_i18n._(/*i18n*/ {
+    id: "msgId",
+    message: "Hello {name}",
+    values: {
+        name: name
+    },
+    context: "My Context"
+});
diff --git a/tests/snapshots/js_t__js_newlines_are_preserved.snap b/tests/snapshots/js_t__js_newlines_are_preserved.snap
new file mode 100644
index 0000000..d57df55
--- /dev/null
+++ b/tests/snapshots/js_t__js_newlines_are_preserved.snap
@@ -0,0 +1,14 @@
+---
+source: tests/js_t.rs
+---
+import { t } from '@lingui/core/macro';
+  t`Multiline
+    string`;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { i18n as $_i18n } from "@lingui/core";
+$_i18n._(/*i18n*/ {
+    id: "esSxMt",
+    message: "Multiline\n    string"
+});
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_explicit_labels_in_tpl_literal.js b/tests/snapshots/js_t__js_ph_labels_in_tpl_literal.snap
similarity index 70%
rename from tests/__swc_snapshots__/tests/js_t.rs/js_explicit_labels_in_tpl_literal.js
rename to tests/snapshots/js_t__js_ph_labels_in_tpl_literal.snap
index 6ed91e0..389a99f 100644
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_explicit_labels_in_tpl_literal.js
+++ b/tests/snapshots/js_t__js_ph_labels_in_tpl_literal.snap
@@ -1,3 +1,17 @@
+---
+source: tests/js_t.rs
+---
+import { t, ph } from "@lingui/core/macro";
+
+t`Refresh ${ph({foo})} inbox`
+t`Refresh ${ph({foo: foo.bar})} inbox`
+t`Refresh ${ph({foo: expr()})} inbox`
+t`Refresh ${ph({foo: bar, baz: qux})} inbox`
+t`Refresh ${ph({})} inbox`
+t`Refresh ${ph({...spread})} inbox`
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 $_i18n._(/*i18n*/ {
     id: "rtxU8c",
diff --git a/tests/snapshots/js_t__js_should_not_touch_code_if_no_macro_import.snap b/tests/snapshots/js_t__js_should_not_touch_code_if_no_macro_import.snap
new file mode 100644
index 0000000..17efd3f
--- /dev/null
+++ b/tests/snapshots/js_t__js_should_not_touch_code_if_no_macro_import.snap
@@ -0,0 +1,8 @@
+---
+source: tests/js_t.rs
+---
+t`Refresh inbox`;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+t`Refresh inbox`;
diff --git a/tests/snapshots/js_t__js_should_not_touch_not_related_tagget_tpls.snap b/tests/snapshots/js_t__js_should_not_touch_not_related_tagget_tpls.snap
new file mode 100644
index 0000000..7f10f98
--- /dev/null
+++ b/tests/snapshots/js_t__js_should_not_touch_not_related_tagget_tpls.snap
@@ -0,0 +1,12 @@
+---
+source: tests/js_t.rs
+---
+import { t } from "@lingui/core/macro";
+
+b`Refresh inbox`;
+b(i18n)`Refresh inbox`;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+b`Refresh inbox`;
+b(i18n)`Refresh inbox`;
diff --git a/tests/snapshots/js_t__js_should_produce_all_fields_when_no_message_set.snap b/tests/snapshots/js_t__js_should_produce_all_fields_when_no_message_set.snap
new file mode 100644
index 0000000..3184536
--- /dev/null
+++ b/tests/snapshots/js_t__js_should_produce_all_fields_when_no_message_set.snap
@@ -0,0 +1,18 @@
+---
+source: tests/js_t.rs
+---
+import { t } from '@lingui/core/macro'
+const msg2 = t({
+    id: 'msgId',
+    comment: 'description for translators',
+    context: 'My Context',
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { i18n as $_i18n } from "@lingui/core";
+const msg2 = $_i18n._(/*i18n*/ {
+    id: "msgId",
+    context: "My Context",
+    comment: "description for translators"
+});
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_should_produce_all_fields_without_strip_flag.js b/tests/snapshots/js_t__js_should_produce_all_fields_without_strip_flag.snap
similarity index 50%
rename from tests/__swc_snapshots__/tests/js_t.rs/js_should_produce_all_fields_without_strip_flag.js
rename to tests/snapshots/js_t__js_should_produce_all_fields_without_strip_flag.snap
index 9a56ba0..8b79156 100644
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_should_produce_all_fields_without_strip_flag.js
+++ b/tests/snapshots/js_t__js_should_produce_all_fields_without_strip_flag.snap
@@ -1,3 +1,16 @@
+---
+source: tests/js_t.rs
+---
+import { t } from '@lingui/core/macro'
+const msg2 = t({
+    message: `Hello ${name}`,
+    id: 'msgId',
+    comment: 'description for translators',
+    context: 'My Context',
+})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 const msg2 = $_i18n._(/*i18n*/ {
     id: "msgId",
diff --git a/tests/snapshots/js_t__js_should_use_v5_generate_id_with_parameter.snap b/tests/snapshots/js_t__js_should_use_v5_generate_id_with_parameter.snap
new file mode 100644
index 0000000..29c5296
--- /dev/null
+++ b/tests/snapshots/js_t__js_should_use_v5_generate_id_with_parameter.snap
@@ -0,0 +1,19 @@
+---
+source: tests/js_t.rs
+info:
+  use_lingui_v5_id_generation: true
+---
+import { t } from '@lingui/core/macro'
+t({
+  message: "Hello World",
+  context: "my context"
+});
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { i18n as $_i18n } from "@lingui/core";
+$_i18n._(/*i18n*/ {
+    id: "SO/WB8",
+    message: "Hello World",
+    context: "my context"
+});
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_should_work_with_legacy_import.js b/tests/snapshots/js_t__js_should_work_with_legacy_import.snap
similarity index 51%
rename from tests/__swc_snapshots__/tests/js_t.rs/js_should_work_with_legacy_import.js
rename to tests/snapshots/js_t__js_should_work_with_legacy_import.snap
index 7942410..5d4f23f 100644
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_should_work_with_legacy_import.js
+++ b/tests/snapshots/js_t__js_should_work_with_legacy_import.snap
@@ -1,3 +1,12 @@
+---
+source: tests/js_t.rs
+---
+ import { t } from "@lingui/macro";
+
+t`Refresh inbox`;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 $_i18n._(/*i18n*/ {
     id: "EsCV2T",
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_substitution_in_tpl_literal.js b/tests/snapshots/js_t__js_substitution_in_tpl_literal.snap
similarity index 71%
rename from tests/__swc_snapshots__/tests/js_t.rs/js_substitution_in_tpl_literal.js
rename to tests/snapshots/js_t__js_substitution_in_tpl_literal.snap
index c8fcecb..e4b30f9 100644
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_substitution_in_tpl_literal.js
+++ b/tests/snapshots/js_t__js_substitution_in_tpl_literal.snap
@@ -1,3 +1,15 @@
+---
+source: tests/js_t.rs
+---
+import { t } from "@lingui/core/macro";
+
+t`Refresh inbox`
+t`Refresh ${foo} inbox ${bar}`
+t`Refresh ${foo.bar} inbox ${bar}`
+t`Refresh ${expr()}`
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 $_i18n._(/*i18n*/ {
     id: "EsCV2T",
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/js_support_message_descriptor_in_t_fn.js b/tests/snapshots/js_t__js_support_message_descriptor_in_t_fn.snap
similarity index 52%
rename from tests/__swc_snapshots__/tests/js_t.rs/js_support_message_descriptor_in_t_fn.js
rename to tests/snapshots/js_t__js_support_message_descriptor_in_t_fn.snap
index ed5007e..777b712 100644
--- a/tests/__swc_snapshots__/tests/js_t.rs/js_support_message_descriptor_in_t_fn.js
+++ b/tests/snapshots/js_t__js_support_message_descriptor_in_t_fn.snap
@@ -1,3 +1,11 @@
+---
+source: tests/js_t.rs
+---
+import { t } from '@lingui/core/macro'
+const msg = t({ message: `Hello ${name}`, id: 'msgId', comment: 'description for translators'  })
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 const msg = $_i18n._(/*i18n*/ {
     id: "msgId",
diff --git a/tests/snapshots/js_t__js_support_template_strings_in_t_macro_message_with_custom_i18n_instance.snap b/tests/snapshots/js_t__js_support_template_strings_in_t_macro_message_with_custom_i18n_instance.snap
new file mode 100644
index 0000000..427d6d9
--- /dev/null
+++ b/tests/snapshots/js_t__js_support_template_strings_in_t_macro_message_with_custom_i18n_instance.snap
@@ -0,0 +1,17 @@
+---
+source: tests/js_t.rs
+---
+import { t } from '@lingui/core/macro'
+import { i18n_custom } from './lingui'
+const msg = t(i18n_custom)({ message: `Hello ${name}` })
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { i18n_custom } from './lingui';
+const msg = i18n_custom._(/*i18n*/ {
+    id: "OVaF9k",
+    message: "Hello {name}",
+    values: {
+        name: name
+    }
+});
diff --git a/tests/snapshots/js_t__js_t_fn_wrapped_in_call_expr.snap b/tests/snapshots/js_t__js_t_fn_wrapped_in_call_expr.snap
new file mode 100644
index 0000000..7309002
--- /dev/null
+++ b/tests/snapshots/js_t__js_t_fn_wrapped_in_call_expr.snap
@@ -0,0 +1,13 @@
+---
+source: tests/js_t.rs
+---
+import { t } from '@lingui/core/macro'
+const msg = message.error(t({message: "dasd"}))
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { i18n as $_i18n } from "@lingui/core";
+const msg = message.error($_i18n._(/*i18n*/ {
+    id: "9ZMZjU",
+    message: "dasd"
+}));
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/should_generate_diffrent_id_when_context_provided.js b/tests/snapshots/js_t__should_generate_diffrent_id_when_context_provided.snap
similarity index 58%
rename from tests/__swc_snapshots__/tests/js_t.rs/should_generate_diffrent_id_when_context_provided.js
rename to tests/snapshots/js_t__should_generate_diffrent_id_when_context_provided.snap
index 2359798..28ab824 100644
--- a/tests/__swc_snapshots__/tests/js_t.rs/should_generate_diffrent_id_when_context_provided.js
+++ b/tests/snapshots/js_t__should_generate_diffrent_id_when_context_provided.snap
@@ -1,3 +1,13 @@
+---
+source: tests/js_t.rs
+---
+import { t } from '@lingui/core/macro'
+t({ message: 'Ola' })
+t({ message: 'Ola', context: "My Context"})
+t({ message: 'Ola', context: `My Context`})
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 $_i18n._(/*i18n*/ {
     id: "l1LkPs",
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/support_id_and_comment_in_t_macro_as_call_expression.js b/tests/snapshots/js_t__support_id_and_comment_in_t_macro_as_call_expression.snap
similarity index 50%
rename from tests/__swc_snapshots__/tests/js_t.rs/support_id_and_comment_in_t_macro_as_call_expression.js
rename to tests/snapshots/js_t__support_id_and_comment_in_t_macro_as_call_expression.snap
index 6021bbd..b4ee257 100644
--- a/tests/__swc_snapshots__/tests/js_t.rs/support_id_and_comment_in_t_macro_as_call_expression.js
+++ b/tests/snapshots/js_t__support_id_and_comment_in_t_macro_as_call_expression.snap
@@ -1,3 +1,11 @@
+---
+source: tests/js_t.rs
+---
+import { t, plural } from '@lingui/core/macro'
+const msg = t({ id: 'msgId', comment: 'description for translators', message: plural(val, { one: '...', other: '...' }) })
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 const msg = $_i18n._(/*i18n*/ {
     id: "msgId",
diff --git a/tests/snapshots/js_t__support_id_in_template_literal.snap b/tests/snapshots/js_t__support_id_in_template_literal.snap
new file mode 100644
index 0000000..ad476a4
--- /dev/null
+++ b/tests/snapshots/js_t__support_id_in_template_literal.snap
@@ -0,0 +1,12 @@
+---
+source: tests/js_t.rs
+---
+import { t } from '@lingui/core/macro'
+const msg = t({ id: `msgId` })
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { i18n as $_i18n } from "@lingui/core";
+const msg = $_i18n._(/*i18n*/ {
+    id: "msgId"
+});
diff --git a/tests/__swc_snapshots__/tests/js_t.rs/unicode_characters_interpreted.js b/tests/snapshots/js_t__unicode_characters_interpreted.snap
similarity index 58%
rename from tests/__swc_snapshots__/tests/js_t.rs/unicode_characters_interpreted.js
rename to tests/snapshots/js_t__unicode_characters_interpreted.snap
index 7b8327e..aa5c884 100644
--- a/tests/__swc_snapshots__/tests/js_t.rs/unicode_characters_interpreted.js
+++ b/tests/snapshots/js_t__unicode_characters_interpreted.snap
@@ -1,3 +1,12 @@
+---
+source: tests/js_t.rs
+---
+import { t } from '@lingui/core/macro';
+t`Message \u0020`;
+t`Bienvenue\xA0!`
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 $_i18n._(/*i18n*/ {
     id: "dZXeyN",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/elements_inside_expression_container.js b/tests/snapshots/jsx__elements_inside_expression_container.snap
similarity index 54%
rename from tests/__swc_snapshots__/tests/jsx.rs/elements_inside_expression_container.js
rename to tests/snapshots/jsx__elements_inside_expression_container.snap
index b5c4ab0..ef204b9 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/elements_inside_expression_container.js
+++ b/tests/snapshots/jsx__elements_inside_expression_container.snap
@@ -1,3 +1,11 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>{<span>Component inside expression container</span>}</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "1cZQQW",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/elements_without_children.js b/tests/snapshots/jsx__elements_without_children.snap
similarity index 55%
rename from tests/__swc_snapshots__/tests/jsx.rs/elements_without_children.js
rename to tests/snapshots/jsx__elements_without_children.snap
index 083dd16..ba1e7d2 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/elements_without_children.js
+++ b/tests/snapshots/jsx__elements_without_children.snap
@@ -1,3 +1,11 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>{<br />}</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "SCJtqt",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/html_attributes_are_handled.js b/tests/snapshots/jsx__html_attributes_are_handled.snap
similarity index 53%
rename from tests/__swc_snapshots__/tests/jsx.rs/html_attributes_are_handled.js
rename to tests/snapshots/jsx__html_attributes_are_handled.snap
index 464cac2..364b510 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/html_attributes_are_handled.js
+++ b/tests/snapshots/jsx__html_attributes_are_handled.snap
@@ -1,3 +1,13 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  <Text>This should work &nbsp;</Text>
+</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "K_1Xpr",
diff --git a/tests/snapshots/jsx__id_only_essential_props_are_kept.snap b/tests/snapshots/jsx__id_only_essential_props_are_kept.snap
new file mode 100644
index 0000000..ee0381d
--- /dev/null
+++ b/tests/snapshots/jsx__id_only_essential_props_are_kept.snap
@@ -0,0 +1,25 @@
+---
+source: tests/jsx.rs
+info:
+  descriptor_fields: id-only
+---
+import { Trans } from "@lingui/react/macro";
+<Trans
+id="msg.hello"
+render="render"
+i18n="i18n"
+context="My Context"
+comment="Hello World">Hello <strong>{name}</strong></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "msg.hello",
+    values: {
+        name: name
+    },
+    components: {
+        0: <strong/>
+    }
+}} render="render" i18n="i18n"/>;
diff --git a/tests/snapshots/jsx__ignore_jsx_empty_expression.snap b/tests/snapshots/jsx__ignore_jsx_empty_expression.snap
new file mode 100644
index 0000000..9757532
--- /dev/null
+++ b/tests/snapshots/jsx__ignore_jsx_empty_expression.snap
@@ -0,0 +1,13 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>Hello {/* and I cannot stress this enough */} World</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "i0M2R8",
+    message: "Hello  World"
+}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_comments_should_not_affect_expression_index.js b/tests/snapshots/jsx__jsx_comments_should_not_affect_expression_index.snap
similarity index 57%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_comments_should_not_affect_expression_index.js
rename to tests/snapshots/jsx__jsx_comments_should_not_affect_expression_index.snap
index 0d512f8..7d021eb 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_comments_should_not_affect_expression_index.js
+++ b/tests/snapshots/jsx__jsx_comments_should_not_affect_expression_index.snap
@@ -1,3 +1,25 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from '@lingui/react/macro';
+// Without comment - expression gets index 0
+<Trans>
+  Click here
+  <Link>
+    {getText()}
+  </Link>
+</Trans>;
+// With comment before expression - expression should STILL get index 0
+<Trans>
+  Click here
+  <Link>
+    {/* @ts-expect-error */}
+    {getText()}
+  </Link>
+</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 // Without comment - expression gets index 0
 <Trans_ {.../*i18n*/ {
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_components_interpolation.js b/tests/snapshots/jsx__jsx_components_interpolation.snap
similarity index 59%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_components_interpolation.js
rename to tests/snapshots/jsx__jsx_components_interpolation.snap
index 0057af1..a6dc681 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_components_interpolation.js
+++ b/tests/snapshots/jsx__jsx_components_interpolation.snap
@@ -1,3 +1,17 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+   Hello <strong>World!</strong><br />
+   <p>
+     My name is <a href="/about">{" "}
+     <em>{name}</em></a>
+   </p>
+ </Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "k9gsHO",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_explicit_labels.js b/tests/snapshots/jsx__jsx_explicit_labels.snap
similarity index 68%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_explicit_labels.js
rename to tests/snapshots/jsx__jsx_explicit_labels.snap
index b5ad3a8..11f4c97 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_explicit_labels.js
+++ b/tests/snapshots/jsx__jsx_explicit_labels.snap
@@ -1,3 +1,17 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+
+<Trans>Refresh {{foo}} inbox</Trans>;
+<Trans>Refresh {{foo: foo.bar}} inbox</Trans>;
+<Trans>Refresh {{foo: expr()}} inbox</Trans>;
+<Trans>Refresh {{foo: bar, baz: qux}} inbox</Trans>;
+<Trans>Refresh {{}} inbox</Trans>;
+<Trans>Refresh {{...spread}} inbox</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "rtxU8c",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_explicit_labels_with_as_statement.js b/tests/snapshots/jsx__jsx_explicit_labels_with_as_statement.snap
similarity index 51%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_explicit_labels_with_as_statement.js
rename to tests/snapshots/jsx__jsx_explicit_labels_with_as_statement.snap
index 26fcae2..5d4d7b0 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_explicit_labels_with_as_statement.js
+++ b/tests/snapshots/jsx__jsx_explicit_labels_with_as_statement.snap
@@ -1,3 +1,11 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>Refresh {{foo} as unknown as string} inbox</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "rtxU8c",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_expressions_are_converted_to_positional_arguments.js b/tests/snapshots/jsx__jsx_expressions_are_converted_to_positional_arguments.snap
similarity index 56%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_expressions_are_converted_to_positional_arguments.js
rename to tests/snapshots/jsx__jsx_expressions_are_converted_to_positional_arguments.snap
index f2db6de..f7b085c 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_expressions_are_converted_to_positional_arguments.js
+++ b/tests/snapshots/jsx__jsx_expressions_are_converted_to_positional_arguments.snap
@@ -1,3 +1,18 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+   Property {props.name},
+   function {random()},
+   array {array[index]},
+   constant {42},
+   object {new Date()},
+   everything {props.messages[index].value()}
+ </Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "HjKDmx",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_nested_labels.js b/tests/snapshots/jsx__jsx_nested_labels.snap
similarity index 64%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_nested_labels.js
rename to tests/snapshots/jsx__jsx_nested_labels.snap
index fe63a46..ef7599d 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_nested_labels.js
+++ b/tests/snapshots/jsx__jsx_nested_labels.snap
@@ -1,3 +1,13 @@
+---
+source: tests/jsx.rs
+---
+import { Trans, ph } from "@lingui/react/macro";
+
+<Trans>Refresh <span>{{foo}}</span> inbox</Trans>;
+<Trans>Refresh <span>{ph({foo})}</span> inbox</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "USNn2Q",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_ph_labels.js b/tests/snapshots/jsx__jsx_ph_labels.snap
similarity index 67%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_ph_labels.js
rename to tests/snapshots/jsx__jsx_ph_labels.snap
index b5ad3a8..a3f2c6a 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_ph_labels.js
+++ b/tests/snapshots/jsx__jsx_ph_labels.snap
@@ -1,3 +1,17 @@
+---
+source: tests/jsx.rs
+---
+import { Trans, ph } from "@lingui/react/macro";
+
+<Trans>Refresh {ph({foo})} inbox</Trans>;
+<Trans>Refresh {ph({foo: foo.bar})} inbox</Trans>;
+<Trans>Refresh {ph({foo: expr()})} inbox</Trans>;
+<Trans>Refresh {ph({foo: bar, baz: qux})} inbox</Trans>;
+<Trans>Refresh {ph({})} inbox</Trans>;
+<Trans>Refresh {ph({...spread})} inbox</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "rtxU8c",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_preserve_reserved_attrs.js b/tests/snapshots/jsx__jsx_preserve_reserved_attrs.snap
similarity index 50%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_preserve_reserved_attrs.js
rename to tests/snapshots/jsx__jsx_preserve_reserved_attrs.snap
index 4cffe76..000ca63 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_preserve_reserved_attrs.js
+++ b/tests/snapshots/jsx__jsx_preserve_reserved_attrs.snap
@@ -1,3 +1,11 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+const exp2 = <Trans comment="Translators Comment" context="Message Context" i18n="i18n" component={(p) => <div>{p.translation}</div>} render={(v) => v}>Refresh inbox</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 const exp2 = <Trans_ {.../*i18n*/ {
     id: "6J8UtY",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_should_suppor_legacy_import.js b/tests/snapshots/jsx__jsx_should_suppor_legacy_import.snap
similarity index 50%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_should_suppor_legacy_import.js
rename to tests/snapshots/jsx__jsx_should_suppor_legacy_import.snap
index c014955..f0de839 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_should_suppor_legacy_import.js
+++ b/tests/snapshots/jsx__jsx_should_suppor_legacy_import.snap
@@ -1,3 +1,11 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/macro";
+const exp2 = <Trans>Refresh inbox</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 const exp2 = <Trans_ {.../*i18n*/ {
     id: "EsCV2T",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_simple_jsx.js b/tests/snapshots/jsx__jsx_simple_jsx.snap
similarity index 53%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_simple_jsx.js
rename to tests/snapshots/jsx__jsx_simple_jsx.snap
index ca963c7..c29e6d3 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_simple_jsx.js
+++ b/tests/snapshots/jsx__jsx_simple_jsx.snap
@@ -1,3 +1,13 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+const exp1 = <Custom>Refresh inbox</Custom>;
+const exp2 = <Trans>Refresh inbox</Trans>;
+const exp3 = <div><Trans>Refresh inbox</Trans></div>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 const exp1 = <Custom>Refresh inbox</Custom>;
 const exp2 = <Trans_ {.../*i18n*/ {
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_template_literal_in_children.js b/tests/snapshots/jsx__jsx_template_literal_in_children.snap
similarity index 56%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_template_literal_in_children.js
rename to tests/snapshots/jsx__jsx_template_literal_in_children.snap
index 37dc513..aa04b3b 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_template_literal_in_children.js
+++ b/tests/snapshots/jsx__jsx_template_literal_in_children.snap
@@ -1,3 +1,11 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>{`Hello ${foo} and ${bar}`}</Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "pB1yir",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_values_dedup.js b/tests/snapshots/jsx__jsx_values_dedup.snap
similarity index 55%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_values_dedup.js
rename to tests/snapshots/jsx__jsx_values_dedup.snap
index 5be347c..e6951ba 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_values_dedup.js
+++ b/tests/snapshots/jsx__jsx_values_dedup.snap
@@ -1,3 +1,14 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+   Hello {foo} and {foo}{" "}
+   {bar}
+ </Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "LyhmWJ",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/jsx_with_context.js b/tests/snapshots/jsx__jsx_with_context.snap
similarity index 55%
rename from tests/__swc_snapshots__/tests/jsx.rs/jsx_with_context.js
rename to tests/snapshots/jsx__jsx_with_context.snap
index 38099fb..c752439 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/jsx_with_context.js
+++ b/tests/snapshots/jsx__jsx_with_context.snap
@@ -1,3 +1,12 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+const exp1 = <Trans>Refresh inbox</Trans>;
+const exp2 = <Trans context="My Context">Refresh inbox</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 const exp1 = <Trans_ {.../*i18n*/ {
     id: "EsCV2T",
diff --git a/tests/snapshots/jsx__jsx_with_custom_id.snap b/tests/snapshots/jsx__jsx_with_custom_id.snap
new file mode 100644
index 0000000..df8a1a8
--- /dev/null
+++ b/tests/snapshots/jsx__jsx_with_custom_id.snap
@@ -0,0 +1,13 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+const exp2 = <Trans id="custom.id">Refresh inbox</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+const exp2 = <Trans_ {.../*i18n*/ {
+    id: "custom.id",
+    message: "Refresh inbox"
+}}/>;
diff --git a/tests/snapshots/jsx__keep_multiple_forced_newlines.snap b/tests/snapshots/jsx__keep_multiple_forced_newlines.snap
new file mode 100644
index 0000000..c77c63e
--- /dev/null
+++ b/tests/snapshots/jsx__keep_multiple_forced_newlines.snap
@@ -0,0 +1,17 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  Keep multiple{"\n"}
+  forced{"\n"}
+  newlines!
+</Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "9xE5pD",
+    message: "Keep multiple\nforced\nnewlines!"
+}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/message_keeps_message_and_context.js b/tests/snapshots/jsx__message_keeps_message_and_context.snap
similarity index 50%
rename from tests/__swc_snapshots__/tests/jsx.rs/message_keeps_message_and_context.js
rename to tests/snapshots/jsx__message_keeps_message_and_context.snap
index b29a2fb..5a2c15b 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/message_keeps_message_and_context.js
+++ b/tests/snapshots/jsx__message_keeps_message_and_context.snap
@@ -1,3 +1,18 @@
+---
+source: tests/jsx.rs
+info:
+  descriptor_fields: message
+---
+import { Trans } from "@lingui/react/macro";
+<Trans
+id="msg.hello"
+render="render"
+i18n="i18n"
+context="My Context"
+comment="Hello World">Hello <strong>{name}</strong></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "msg.hello",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/non_breaking_whitespace_handling_2226.js b/tests/snapshots/jsx__non_breaking_whitespace_handling_2226.snap
similarity index 54%
rename from tests/__swc_snapshots__/tests/jsx.rs/non_breaking_whitespace_handling_2226.js
rename to tests/snapshots/jsx__non_breaking_whitespace_handling_2226.snap
index 9ecfc37..e0727d3 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/non_breaking_whitespace_handling_2226.js
+++ b/tests/snapshots/jsx__non_breaking_whitespace_handling_2226.snap
@@ -1,3 +1,16 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  <span>hello</span>
+  &nbsp;
+  <span>world</span>
+</Trans>;
+
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "kJt6bJ",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/normalize_crlf_lf_cr.js b/tests/snapshots/jsx__normalize_crlf_lf_cr.snap
similarity index 59%
rename from tests/__swc_snapshots__/tests/jsx.rs/normalize_crlf_lf_cr.js
rename to tests/snapshots/jsx__normalize_crlf_lf_cr.snap
index fba8d48..c58766c 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/normalize_crlf_lf_cr.js
+++ b/tests/snapshots/jsx__normalize_crlf_lf_cr.snap
@@ -1,3 +1,17 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+hello
+</Trans>;
+<Trans>
+hello
+</Trans>;
+<Trans>
hello
</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "WfCysZ",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/quoted_jsx_attributes_are_handled.js b/tests/snapshots/jsx__quoted_jsx_attributes_are_handled.snap
similarity index 53%
rename from tests/__swc_snapshots__/tests/jsx.rs/quoted_jsx_attributes_are_handled.js
rename to tests/snapshots/jsx__quoted_jsx_attributes_are_handled.snap
index 36683ff..b14e0eb 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/quoted_jsx_attributes_are_handled.js
+++ b/tests/snapshots/jsx__quoted_jsx_attributes_are_handled.snap
@@ -1,3 +1,12 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>Speak "friend"!</Trans>;
+<Trans id="custom-id">Speak "friend"!</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "NWmRwM",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/strip_whitespace_around_arguments.js b/tests/snapshots/jsx__strip_whitespace_around_arguments.snap
similarity index 53%
rename from tests/__swc_snapshots__/tests/jsx.rs/strip_whitespace_around_arguments.js
rename to tests/snapshots/jsx__strip_whitespace_around_arguments.snap
index 6f5d51f..0fb5e5f 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/strip_whitespace_around_arguments.js
+++ b/tests/snapshots/jsx__strip_whitespace_around_arguments.snap
@@ -1,3 +1,15 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  Strip whitespace around arguments: '
+  {name}
+  '
+</Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "tRMgLt",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/strip_whitespace_around_tags_but_keep_forced_spaces.js b/tests/snapshots/jsx__strip_whitespace_around_tags_but_keep_forced_spaces.snap
similarity index 52%
rename from tests/__swc_snapshots__/tests/jsx.rs/strip_whitespace_around_tags_but_keep_forced_spaces.js
rename to tests/snapshots/jsx__strip_whitespace_around_tags_but_keep_forced_spaces.snap
index 432189b..b4605c1 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/strip_whitespace_around_tags_but_keep_forced_spaces.js
+++ b/tests/snapshots/jsx__strip_whitespace_around_tags_but_keep_forced_spaces.snap
@@ -1,3 +1,15 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  Strip whitespace around tags, but keep{" "}
+  <strong>forced spaces</strong>
+  !
+</Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "Ud4KOf",
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/strip_whitespaces_in_jsxtext_but_keep_in_jsx_expression_containers.js b/tests/snapshots/jsx__strip_whitespaces_in_jsxtext_but_keep_in_jsx_expression_containers.snap
similarity index 52%
rename from tests/__swc_snapshots__/tests/jsx.rs/strip_whitespaces_in_jsxtext_but_keep_in_jsx_expression_containers.js
rename to tests/snapshots/jsx__strip_whitespaces_in_jsxtext_but_keep_in_jsx_expression_containers.snap
index 11f9d4e..ee01ce2 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/strip_whitespaces_in_jsxtext_but_keep_in_jsx_expression_containers.js
+++ b/tests/snapshots/jsx__strip_whitespaces_in_jsxtext_but_keep_in_jsx_expression_containers.snap
@@ -1,3 +1,17 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+  <Trans>
+  {"Wonderful framework "}
+  <a href="https://nextjs.org">Next.js</a>
+  {" say hi. And "}
+  <a href="https://nextjs.org">Next.js</a>
+  {" say hi."}
+</Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "3YVd0H",
diff --git a/tests/snapshots/jsx__use_decoded_html_entities.snap b/tests/snapshots/jsx__use_decoded_html_entities.snap
new file mode 100644
index 0000000..0978862
--- /dev/null
+++ b/tests/snapshots/jsx__use_decoded_html_entities.snap
@@ -0,0 +1,13 @@
+---
+source: tests/jsx.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>&amp;</Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "EwTON7",
+    message: "&"
+}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/use_js_macro_in_jsx_attrs.js b/tests/snapshots/jsx__use_js_macro_in_jsx_attrs.snap
similarity index 65%
rename from tests/__swc_snapshots__/tests/jsx.rs/use_js_macro_in_jsx_attrs.js
rename to tests/snapshots/jsx__use_js_macro_in_jsx_attrs.snap
index 1cf5e4d..a9a4ecc 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/use_js_macro_in_jsx_attrs.js
+++ b/tests/snapshots/jsx__use_js_macro_in_jsx_attrs.snap
@@ -1,3 +1,12 @@
+---
+source: tests/jsx.rs
+---
+import { t } from '@lingui/core/macro';
+import { Trans } from '@lingui/react/macro';
+<Trans>Read <a href="/more" title={t`Full content of ${articleName}`}>more</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 import { i18n as $_i18n } from "@lingui/core";
 <Trans_ {.../*i18n*/ {
diff --git a/tests/__swc_snapshots__/tests/jsx.rs/use_js_plural_in_jsx_attrs.js b/tests/snapshots/jsx__use_js_plural_in_jsx_attrs.snap
similarity index 54%
rename from tests/__swc_snapshots__/tests/jsx.rs/use_js_plural_in_jsx_attrs.js
rename to tests/snapshots/jsx__use_js_plural_in_jsx_attrs.snap
index dbb4555..4987807 100644
--- a/tests/__swc_snapshots__/tests/jsx.rs/use_js_plural_in_jsx_attrs.js
+++ b/tests/snapshots/jsx__use_js_plural_in_jsx_attrs.snap
@@ -1,3 +1,14 @@
+---
+source: tests/jsx.rs
+---
+import { plural } from '@lingui/core/macro';
+<a href="/about" title={plural(count, {
+  one: "\# book",
+  other: "\# books"
+})}>About</a>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { i18n as $_i18n } from "@lingui/core";
 <a href="/about" title={$_i18n._(/*i18n*/ {
     id: "esnaQO",
diff --git a/tests/snapshots/jsx_icu__id_only_essential_props_are_kept.snap b/tests/snapshots/jsx_icu__id_only_essential_props_are_kept.snap
new file mode 100644
index 0000000..72b9135
--- /dev/null
+++ b/tests/snapshots/jsx_icu__id_only_essential_props_are_kept.snap
@@ -0,0 +1,31 @@
+---
+source: tests/jsx_icu.rs
+info:
+  descriptor_fields: id-only
+---
+import { Plural } from '@lingui/macro';
+
+<Plural
+  id="custom.id"
+  context="My Context"
+  comment="This is for translators"
+  render="render"
+  i18n="i18n"
+  value={count}
+  offset="1"
+  _0="Zero items"
+  other={<a href="/more">A lot of them</a>}
+  />
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "custom.id",
+    values: {
+        count: count
+    },
+    components: {
+        0: <a href="/more"/>
+    }
+}} render="render" i18n="i18n"/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_icu.js b/tests/snapshots/jsx_icu__jsx_icu.snap
similarity index 60%
rename from tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_icu.js
rename to tests/snapshots/jsx_icu__jsx_icu.snap
index 4945b55..0ad6d0c 100644
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_icu.js
+++ b/tests/snapshots/jsx_icu__jsx_icu.snap
@@ -1,3 +1,22 @@
+---
+source: tests/jsx_icu.rs
+---
+import { Plural } from "@lingui/react/macro";
+
+const ex1 = <Plural
+ value={count}
+ one="Message"
+ other="Messages"
+/>
+
+const ex2 = <div><Plural
+value={count}
+one="Message"
+other="Messages"
+/></div>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 const ex1 = <Trans_ {.../*i18n*/ {
     id: "V4EO9s",
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_icu_explicit_id.js b/tests/snapshots/jsx_icu__jsx_icu_explicit_id.snap
similarity index 52%
rename from tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_icu_explicit_id.js
rename to tests/snapshots/jsx_icu__jsx_icu_explicit_id.snap
index 2d1e1e6..5108994 100644
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_icu_explicit_id.js
+++ b/tests/snapshots/jsx_icu__jsx_icu_explicit_id.snap
@@ -1,3 +1,17 @@
+---
+source: tests/jsx_icu.rs
+---
+ import { Plural } from "@lingui/react/macro";
+
+<Plural
+ id="plural.id"
+ value={count}
+ one="Message"
+ other="Messages"
+/>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "plural.id",
diff --git a/tests/snapshots/jsx_icu__jsx_icu_nested.snap b/tests/snapshots/jsx_icu__jsx_icu_nested.snap
new file mode 100644
index 0000000..0564ead
--- /dev/null
+++ b/tests/snapshots/jsx_icu__jsx_icu_nested.snap
@@ -0,0 +1,24 @@
+---
+source: tests/jsx_icu.rs
+---
+ import { Plural, Trans } from "@lingui/react/macro";
+
+ <Trans>
+     You have{" "}
+        <Plural
+         value={count}
+         one="Message"
+         other="Messages"
+        />
+</Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "dzhU0t",
+    values: {
+        count: count
+    },
+    message: "You have {count, plural, one {Message} other {Messages}}"
+}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_icu_with_template_literal.js b/tests/snapshots/jsx_icu__jsx_icu_with_template_literal.snap
similarity index 53%
rename from tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_icu_with_template_literal.js
rename to tests/snapshots/jsx_icu__jsx_icu_with_template_literal.snap
index 36c65df..9072dce 100644
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_icu_with_template_literal.js
+++ b/tests/snapshots/jsx_icu__jsx_icu_with_template_literal.snap
@@ -1,3 +1,16 @@
+---
+source: tests/jsx_icu.rs
+---
+import { Plural } from "@lingui/react/macro";
+
+ <Plural
+   value={count}
+   one={`${count} items`}
+   other="..."
+ />;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "-hE-5_",
diff --git a/tests/snapshots/jsx_icu__jsx_multivelel_nesting.snap b/tests/snapshots/jsx_icu__jsx_multivelel_nesting.snap
new file mode 100644
index 0000000..470da4f
--- /dev/null
+++ b/tests/snapshots/jsx_icu__jsx_multivelel_nesting.snap
@@ -0,0 +1,48 @@
+---
+source: tests/jsx_icu.rs
+---
+import { Trans, Plural } from '@lingui/macro';
+
+<Plural
+  value={count}
+  one={
+    <Trans>
+      <Plural
+        value={count2}
+        one={
+          <Trans>
+            second level one
+          </Trans>
+        }
+        other={
+          <Trans>
+            second level other
+          </Trans>
+        }
+      />
+
+      <strong>#</strong> slot added
+    </Trans>
+  }
+  other={
+    <Trans>
+      <strong>#</strong> slots added
+    </Trans>
+  }
+/>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "bDgQmM",
+    values: {
+        count: count,
+        count2: count2
+    },
+    components: {
+        0: <strong/>,
+        1: <strong/>
+    },
+    message: "{count, plural, one {{count2, plural, one {second level one} other {second level other}}<0>#</0> slot added} other {<1>#</1> slots added}}"
+}}/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_plural_preserve_reserved_attrs.js b/tests/snapshots/jsx_icu__jsx_plural_preserve_reserved_attrs.snap
similarity index 54%
rename from tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_plural_preserve_reserved_attrs.js
rename to tests/snapshots/jsx_icu__jsx_plural_preserve_reserved_attrs.snap
index 7546026..d5fd81f 100644
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_plural_preserve_reserved_attrs.js
+++ b/tests/snapshots/jsx_icu__jsx_plural_preserve_reserved_attrs.snap
@@ -1,3 +1,19 @@
+---
+source: tests/jsx_icu.rs
+---
+ import { Plural } from "@lingui/react/macro";
+
+<Plural
+ comment="Translators Comment"
+ context="Message Context"
+ render={(v) => v}
+ value={count}
+ one="..."
+ other="..."
+/>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "8I55rI",
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_plural_with_offset_and_exact_matches.js b/tests/snapshots/jsx_icu__jsx_plural_with_offset_and_exact_matches.snap
similarity index 56%
rename from tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_plural_with_offset_and_exact_matches.js
rename to tests/snapshots/jsx_icu__jsx_plural_with_offset_and_exact_matches.snap
index 4d22c83..a8e02f2 100644
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_plural_with_offset_and_exact_matches.js
+++ b/tests/snapshots/jsx_icu__jsx_plural_with_offset_and_exact_matches.snap
@@ -1,3 +1,17 @@
+---
+source: tests/jsx_icu.rs
+---
+import { Plural } from "@lingui/react/macro";
+
+ <Plural
+   value={count}
+   offset="1"
+   _0="Zero items"
+   other={<a href="/more">A lot of them</a>}
+ />;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "ZFknU1",
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_select_ordinal_with_offset_and_exact_matches.js b/tests/snapshots/jsx_icu__jsx_select_ordinal_with_offset_and_exact_matches.snap
similarity index 51%
rename from tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_select_ordinal_with_offset_and_exact_matches.js
rename to tests/snapshots/jsx_icu__jsx_select_ordinal_with_offset_and_exact_matches.snap
index c1475d2..ad84de3 100644
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_select_ordinal_with_offset_and_exact_matches.js
+++ b/tests/snapshots/jsx_icu__jsx_select_ordinal_with_offset_and_exact_matches.snap
@@ -1,3 +1,18 @@
+---
+source: tests/jsx_icu.rs
+---
+import { SelectOrdinal } from "@lingui/react/macro";
+
+ <SelectOrdinal
+   value={count}
+   offset="1"
+   _0=" #st"
+   one=" #nd"
+   other=' #rd'
+ />;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "cp8FR4",
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_select_simple.js b/tests/snapshots/jsx_icu__jsx_select_simple.snap
similarity index 57%
rename from tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_select_simple.js
rename to tests/snapshots/jsx_icu__jsx_select_simple.snap
index 5715de4..33268c4 100644
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_select_simple.js
+++ b/tests/snapshots/jsx_icu__jsx_select_simple.snap
@@ -1,3 +1,16 @@
+---
+source: tests/jsx_icu.rs
+---
+import { Select } from '@lingui/macro';
+<Select
+  value={count}
+  _male="He"
+  _female={`She`}
+  other={<strong>Other</strong>}
+/>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "Imwef9",
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_select_with_expressions_in_cases.js b/tests/snapshots/jsx_icu__jsx_select_with_expressions_in_cases.snap
similarity index 60%
rename from tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_select_with_expressions_in_cases.js
rename to tests/snapshots/jsx_icu__jsx_select_with_expressions_in_cases.snap
index b4e6e6e..9251d94 100644
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_select_with_expressions_in_cases.js
+++ b/tests/snapshots/jsx_icu__jsx_select_with_expressions_in_cases.snap
@@ -1,3 +1,17 @@
+---
+source: tests/jsx_icu.rs
+---
+import { Select } from '@lingui/macro';
+<Select
+  value={count}
+  _male={variable}
+  _third={foo.bar}
+  _female={`She`}
+  other={<strong>Other</strong>}
+/>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "_7RSeH",
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_select_with_reserved_attrs.js b/tests/snapshots/jsx_icu__jsx_select_with_reserved_attrs.snap
similarity index 55%
rename from tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_select_with_reserved_attrs.js
rename to tests/snapshots/jsx_icu__jsx_select_with_reserved_attrs.snap
index dab5412..2d6571f 100644
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/jsx_select_with_reserved_attrs.js
+++ b/tests/snapshots/jsx_icu__jsx_select_with_reserved_attrs.snap
@@ -1,3 +1,20 @@
+---
+source: tests/jsx_icu.rs
+---
+import { Select } from '@lingui/macro';
+<Select
+  comment="Translators Comment"
+  context="Message Context"
+  render={(v) => v}
+
+  value={count}
+  _male="He"
+  _female={`She`}
+  other={<strong>Other</strong>}
+/>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "4jX4Bx",
diff --git a/tests/snapshots/jsx_icu__jsx_trans_inside_plural.snap b/tests/snapshots/jsx_icu__jsx_trans_inside_plural.snap
new file mode 100644
index 0000000..fb2d271
--- /dev/null
+++ b/tests/snapshots/jsx_icu__jsx_trans_inside_plural.snap
@@ -0,0 +1,32 @@
+---
+source: tests/jsx_icu.rs
+---
+import { Trans, Plural } from '@lingui/macro';
+ <Plural
+   value={count}
+   one={
+     <Trans>
+       <strong>#</strong> slot added
+     </Trans>
+   }
+   other={
+     <Trans>
+       <strong>#</strong> slots added
+     </Trans>
+   }
+ />;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "X8eyr1",
+    values: {
+        count: count
+    },
+    components: {
+        0: <strong/>,
+        1: <strong/>
+    },
+    message: "{count, plural, one {<0>#</0> slot added} other {<1>#</1> slots added}}"
+}}/>;
diff --git a/tests/snapshots/jsx_icu__message_keeps_message_and_context.snap b/tests/snapshots/jsx_icu__message_keeps_message_and_context.snap
new file mode 100644
index 0000000..5da97ec
--- /dev/null
+++ b/tests/snapshots/jsx_icu__message_keeps_message_and_context.snap
@@ -0,0 +1,33 @@
+---
+source: tests/jsx_icu.rs
+info:
+  descriptor_fields: message
+---
+import { Plural } from '@lingui/macro';
+
+<Plural
+  id="custom.id"
+  context="My Context"
+  comment="This is for translators"
+  render="render"
+  i18n="i18n"
+  value={count}
+  offset="1"
+  _0="Zero items"
+  other={<a href="/more">A lot of them</a>}
+  />
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "custom.id",
+    values: {
+        count: count
+    },
+    components: {
+        0: <a href="/more"/>
+    },
+    message: "{count, plural, offset:1 =0 {Zero items} other {<0>A lot of them</0>}}",
+    context: "My Context"
+}} render="render" i18n="i18n"/>;
diff --git a/tests/__swc_snapshots__/tests/jsx_icu.rs/multiple_new_lines_with_nbsp_endind.js b/tests/snapshots/jsx_icu__multiple_new_lines_with_nbsp_endind.snap
similarity index 51%
rename from tests/__swc_snapshots__/tests/jsx_icu.rs/multiple_new_lines_with_nbsp_endind.js
rename to tests/snapshots/jsx_icu__multiple_new_lines_with_nbsp_endind.snap
index 161785c..bb39af5 100644
--- a/tests/__swc_snapshots__/tests/jsx_icu.rs/multiple_new_lines_with_nbsp_endind.js
+++ b/tests/snapshots/jsx_icu__multiple_new_lines_with_nbsp_endind.snap
@@ -1,3 +1,14 @@
+---
+source: tests/jsx_icu.rs
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  Line ending in non-breaking space.&nbsp;
+  <strong>text in element</strong>
+</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { Trans as Trans_ } from "@lingui/react";
 <Trans_ {.../*i18n*/ {
     id: "CJuEhi",
diff --git a/tests/snapshots/jsx_named_placeholders__allows_dotted.snap b/tests/snapshots/jsx_named_placeholders__allows_dotted.snap
new file mode 100644
index 0000000..f4f1cae
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__allows_dotted.snap
@@ -0,0 +1,18 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="ns.link" href="/">click</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "_0hJpt",
+    components: {
+        ["ns.link"]: <a href="/"/>
+    },
+    message: "<ns.link>click</ns.link>"
+}}/>;
diff --git a/tests/snapshots/jsx_named_placeholders__allows_hyphenated.snap b/tests/snapshots/jsx_named_placeholders__allows_hyphenated.snap
new file mode 100644
index 0000000..6d2b573
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__allows_hyphenated.snap
@@ -0,0 +1,18 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="foo-bar" href="/">click</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "IeIam7",
+    components: {
+        ["foo-bar"]: <a href="/"/>
+    },
+    message: "<foo-bar>click</foo-bar>"
+}}/>;
diff --git a/tests/snapshots/jsx_named_placeholders__attribute_ignored_when_not_configured.snap b/tests/snapshots/jsx_named_placeholders__attribute_ignored_when_not_configured.snap
new file mode 100644
index 0000000..168bdbd
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__attribute_ignored_when_not_configured.snap
@@ -0,0 +1,19 @@
+---
+source: tests/jsx_named_placeholders.rs
+info: {}
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  Hello <strong _t="em">world</strong>!
+</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "MykGLZ",
+    components: {
+        0: <strong _t="em"/>
+    },
+    message: "Hello <0>world</0>!"
+}}/>;
diff --git a/tests/snapshots/jsx_named_placeholders__basic.snap b/tests/snapshots/jsx_named_placeholders__basic.snap
new file mode 100644
index 0000000..a97df28
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__basic.snap
@@ -0,0 +1,20 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  Hello <strong _t="em">world</strong>!
+</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "6N0Fej",
+    components: {
+        em: <strong/>
+    },
+    message: "Hello <em>world</em>!"
+}}/>;
diff --git a/tests/snapshots/jsx_named_placeholders__deduplication_different_props.snap b/tests/snapshots/jsx_named_placeholders__deduplication_different_props.snap
new file mode 100644
index 0000000..ae5cfb9
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__deduplication_different_props.snap
@@ -0,0 +1,16 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_defaults:
+    a: a
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>Hello <a href="/a">link 1</a>, normal, <a href="/b">link 2</a>.</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: Multiple distinct JSX elements with the same placeholder name (`a`). Differentiate them by setting `macro.jsxPlaceholderAttribute` in the lingui config and then adding the attribute to your JSX elements (e.g. `<element _t="newName" />`).
+ --> input.tsx:2:47
+  |
+2 | <Trans>Hello <a href="/a">link 1</a>, normal, <a href="/b">link 2</a>.</Trans>;
+  |                                               ^^^^^^^^^^^^^
diff --git a/tests/snapshots/jsx_named_placeholders__deduplication_identical.snap b/tests/snapshots/jsx_named_placeholders__deduplication_identical.snap
new file mode 100644
index 0000000..068c830
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__deduplication_identical.snap
@@ -0,0 +1,19 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_defaults:
+    em: em
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>Hello <em>emphasis</em>, normal, <em>more emphasis</em>.</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "idxihm",
+    components: {
+        em: <em/>
+    },
+    message: "Hello <em>emphasis</em>, normal, <em>more emphasis</em>."
+}}/>;
diff --git a/tests/snapshots/jsx_named_placeholders__deduplication_with_stripped_props.snap b/tests/snapshots/jsx_named_placeholders__deduplication_with_stripped_props.snap
new file mode 100644
index 0000000..470e1c6
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__deduplication_with_stripped_props.snap
@@ -0,0 +1,15 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>Hello <a _t="link" href="/a">link 1</a>, normal, <a _t="link" href="/a">link 1 copy</a> and <a _t="link" href="/b">link 2</a>.</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: Multiple distinct JSX elements with the same placeholder name (`link`). Differentiate them by adding/modifying the `_t` attribute (e.g. `<element _t="newName" />`).
+ --> input.tsx:2:100
+  |
+2 | <Trans>Hello <a _t="link" href="/a">link 1</a>, normal, <a _t="link" href="/a">link 1 copy</a> and <a _t="link" href="/b">link 2</a>.</Trans>;
+  |                                                                                                    ^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/tests/snapshots/jsx_named_placeholders__defaults.snap b/tests/snapshots/jsx_named_placeholders__defaults.snap
new file mode 100644
index 0000000..7c68cea
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__defaults.snap
@@ -0,0 +1,23 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_defaults:
+    a: link
+    em: em
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  Here's a <a>link</a> and <em>emphasis</em>.
+</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "Jg_WOt",
+    components: {
+        link: <a/>,
+        em: <em/>
+    },
+    message: "Here's a <link>link</link> and <em>emphasis</em>."
+}}/>;
diff --git a/tests/snapshots/jsx_named_placeholders__different_spreads_throw.snap b/tests/snapshots/jsx_named_placeholders__different_spreads_throw.snap
new file mode 100644
index 0000000..f62855b
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__different_spreads_throw.snap
@@ -0,0 +1,15 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="same" {...spread1}>A</a> <a _t="same" {...spread2}>B</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: Multiple distinct JSX elements with the same placeholder name (`same`). Differentiate them by adding/modifying the `_t` attribute (e.g. `<element _t="newName" />`).
+ --> input.tsx:2:40
+  |
+2 | <Trans><a _t="same" {...spread1}>A</a> <a _t="same" {...spread2}>B</a></Trans>
+  |                                        ^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/tests/snapshots/jsx_named_placeholders__identical_spreads_reused.snap b/tests/snapshots/jsx_named_placeholders__identical_spreads_reused.snap
new file mode 100644
index 0000000..ab37219
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__identical_spreads_reused.snap
@@ -0,0 +1,18 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="same" {...spread}>A</a> <a _t="same" {...spread}>B</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "ctHZge",
+    components: {
+        same: <a {...spread}/>
+    },
+    message: "<same>A</same> <same>B</same>"
+}}/>;
diff --git a/tests/snapshots/jsx_named_placeholders__mixed_explicit_and_defaults.snap b/tests/snapshots/jsx_named_placeholders__mixed_explicit_and_defaults.snap
new file mode 100644
index 0000000..49d008d
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__mixed_explicit_and_defaults.snap
@@ -0,0 +1,21 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+  jsx_placeholder_defaults:
+    a: link
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>Hello <a href="/a">link 1</a>, normal, <a _t="link2" href="/b">link 2</a>.</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "yU9TUm",
+    components: {
+        link: <a href="/a"/>,
+        link2: <a href="/b"/>
+    },
+    message: "Hello <link>link 1</link>, normal, <link2>link 2</link2>."
+}}/>;
diff --git a/tests/snapshots/jsx_named_placeholders__prop_order.snap b/tests/snapshots/jsx_named_placeholders__prop_order.snap
new file mode 100644
index 0000000..6e57f42
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__prop_order.snap
@@ -0,0 +1,18 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>Hello <a _t="link" href="/a" class="foo">link 1</a>, normal, <a _t="link" class="foo" href="/a">link 1 copy</a>.</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "9en3MH",
+    components: {
+        link: <a href="/a" class="foo"/>
+    },
+    message: "Hello <link>link 1</link>, normal, <link>link 1 copy</link>."
+}}/>;
diff --git a/tests/snapshots/jsx_named_placeholders__prop_order2.snap b/tests/snapshots/jsx_named_placeholders__prop_order2.snap
new file mode 100644
index 0000000..d48df23
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__prop_order2.snap
@@ -0,0 +1,15 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>Hello <a _t="link" href="/a" class="foo">link 1</a>, normal, <a _t="link" href="/b" class="foo">link 1 copy</a>.</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: Multiple distinct JSX elements with the same placeholder name (`link`). Differentiate them by adding/modifying the `_t` attribute (e.g. `<element _t="newName" />`).
+ --> input.tsx:2:69
+  |
+2 | <Trans>Hello <a _t="link" href="/a" class="foo">link 1</a>, normal, <a _t="link" href="/b" class="foo">link 1 copy</a>.</Trans>;
+  |                                                                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/tests/snapshots/jsx_named_placeholders__same_element_diffrent_attributes_count_throw.snap b/tests/snapshots/jsx_named_placeholders__same_element_diffrent_attributes_count_throw.snap
new file mode 100644
index 0000000..dbeaac0
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__same_element_diffrent_attributes_count_throw.snap
@@ -0,0 +1,15 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><em _t="same" class="hello">A</em> and <em _t="same" class="hello" data-testId="bla">B</em></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: Multiple distinct JSX elements with the same placeholder name (`same`). Differentiate them by adding/modifying the `_t` attribute (e.g. `<element _t="newName" />`).
+ --> input.tsx:2:47
+  |
+2 | <Trans><em _t="same" class="hello">A</em> and <em _t="same" class="hello" data-testId="bla">B</em></Trans>
+  |                                               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/tests/snapshots/jsx_named_placeholders__same_name_different_element_throws.snap b/tests/snapshots/jsx_named_placeholders__same_name_different_element_throws.snap
new file mode 100644
index 0000000..f4fe6f8
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__same_name_different_element_throws.snap
@@ -0,0 +1,15 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><em _t="same">A</em> and <strong _t="same">B</strong></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: Multiple distinct JSX elements with the same placeholder name (`same`). Differentiate them by adding/modifying the `_t` attribute (e.g. `<element _t="newName" />`).
+ --> input.tsx:2:33
+  |
+2 | <Trans><em _t="same">A</em> and <strong _t="same">B</strong></Trans>
+  |                                 ^^^^^^^^^^^^^^^^^^
diff --git a/tests/snapshots/jsx_named_placeholders__same_spread_different_order_throws.snap b/tests/snapshots/jsx_named_placeholders__same_spread_different_order_throws.snap
new file mode 100644
index 0000000..54523a2
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__same_spread_different_order_throws.snap
@@ -0,0 +1,15 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="same" href="/" {...spread}>A</a> <a _t="same" {...spread} href="/">B</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: Multiple distinct JSX elements with the same placeholder name (`same`). Differentiate them by adding/modifying the `_t` attribute (e.g. `<element _t="newName" />`).
+ --> input.tsx:2:48
+  |
+2 | <Trans><a _t="same" href="/" {...spread}>A</a> <a _t="same" {...spread} href="/">B</a></Trans>
+  |                                                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/tests/snapshots/jsx_named_placeholders__stripped_ast.snap b/tests/snapshots/jsx_named_placeholders__stripped_ast.snap
new file mode 100644
index 0000000..ff9a966
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__stripped_ast.snap
@@ -0,0 +1,20 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from "@lingui/react/macro";
+<Trans>
+  <a _t="link" href="/about">About</a>
+</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "Ym2S6K",
+    components: {
+        link: <a href="/about"/>
+    },
+    message: "<link>About</link>"
+}}/>;
diff --git a/tests/snapshots/jsx_named_placeholders__supports_string_in_jsx_expression.snap b/tests/snapshots/jsx_named_placeholders__supports_string_in_jsx_expression.snap
new file mode 100644
index 0000000..b91d8c0
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__supports_string_in_jsx_expression.snap
@@ -0,0 +1,18 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t={"foo"} href="/">click</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { Trans as Trans_ } from "@lingui/react";
+<Trans_ {.../*i18n*/ {
+    id: "CeJE1x",
+    components: {
+        foo: <a href="/"/>
+    },
+    message: "<foo>click</foo>"
+}}/>;
diff --git a/tests/snapshots/jsx_named_placeholders__throws_ending_with_dot.snap b/tests/snapshots/jsx_named_placeholders__throws_ending_with_dot.snap
new file mode 100644
index 0000000..5bcf605
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__throws_ending_with_dot.snap
@@ -0,0 +1,15 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="foo." href="/">click</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: Placeholder name `foo.` is not valid. Names must start and end with a letter/digit/underscore, but may contain `.-` in between.
+ --> input.tsx:2:8
+  |
+2 | <Trans><a _t="foo." href="/">click</a></Trans>
+  |        ^^^^^^^^^^^^^^^^^^^^^^
diff --git a/tests/snapshots/jsx_named_placeholders__throws_on_boolean_expr.snap b/tests/snapshots/jsx_named_placeholders__throws_on_boolean_expr.snap
new file mode 100644
index 0000000..d5c6080
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__throws_on_boolean_expr.snap
@@ -0,0 +1,15 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t href="/">click</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: The `_t` attribute must be a non-empty string literal.
+ --> input.tsx:2:8
+  |
+2 | <Trans><a _t href="/">click</a></Trans>
+  |        ^^^^^^^^^^^^^^^
diff --git a/tests/snapshots/jsx_named_placeholders__throws_on_empty_attribute_value.snap b/tests/snapshots/jsx_named_placeholders__throws_on_empty_attribute_value.snap
new file mode 100644
index 0000000..cc1eb94
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__throws_on_empty_attribute_value.snap
@@ -0,0 +1,15 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="" href="/">click</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: Placeholder name `` is not valid. Names must start and end with a letter/digit/underscore, but may contain `.-` in between.
+ --> input.tsx:2:8
+  |
+2 | <Trans><a _t="" href="/">click</a></Trans>
+  |        ^^^^^^^^^^^^^^^^^^
diff --git a/tests/snapshots/jsx_named_placeholders__throws_on_empty_string.snap b/tests/snapshots/jsx_named_placeholders__throws_on_empty_string.snap
new file mode 100644
index 0000000..cc1eb94
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__throws_on_empty_string.snap
@@ -0,0 +1,15 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="" href="/">click</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: Placeholder name `` is not valid. Names must start and end with a letter/digit/underscore, but may contain `.-` in between.
+ --> input.tsx:2:8
+  |
+2 | <Trans><a _t="" href="/">click</a></Trans>
+  |        ^^^^^^^^^^^^^^^^^^
diff --git a/tests/snapshots/jsx_named_placeholders__throws_on_non_string_attribute_value.snap b/tests/snapshots/jsx_named_placeholders__throws_on_non_string_attribute_value.snap
new file mode 100644
index 0000000..339cbd3
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__throws_on_non_string_attribute_value.snap
@@ -0,0 +1,16 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+const name = "link";
+<Trans><a _t={name} href="/">click</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: The `_t` attribute must be a non-empty string literal.
+ --> input.tsx:3:8
+  |
+3 | <Trans><a _t={name} href="/">click</a></Trans>
+  |        ^^^^^^^^^^^^^^^^^^^^^^
diff --git a/tests/snapshots/jsx_named_placeholders__throws_on_numeric_name.snap b/tests/snapshots/jsx_named_placeholders__throws_on_numeric_name.snap
new file mode 100644
index 0000000..c636836
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__throws_on_numeric_name.snap
@@ -0,0 +1,15 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="0" href="/">click</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: Placeholder name `0` is not allowed because it conflicts with auto-generated numeric placeholders. Use a non-numeric name instead.
+ --> input.tsx:2:8
+  |
+2 | <Trans><a _t="0" href="/">click</a></Trans>
+  |        ^^^^^^^^^^^^^^^^^^^
diff --git a/tests/snapshots/jsx_named_placeholders__throws_starting_with_hyphen.snap b/tests/snapshots/jsx_named_placeholders__throws_starting_with_hyphen.snap
new file mode 100644
index 0000000..2219efb
--- /dev/null
+++ b/tests/snapshots/jsx_named_placeholders__throws_starting_with_hyphen.snap
@@ -0,0 +1,15 @@
+---
+source: tests/jsx_named_placeholders.rs
+info:
+  jsx_placeholder_attribute: _t
+---
+import { Trans } from '@lingui/react/macro';
+<Trans><a _t="-foo" href="/">click</a></Trans>
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+error: Placeholder name `-foo` is not valid. Names must start and end with a letter/digit/underscore, but may contain `.-` in between.
+ --> input.tsx:2:8
+  |
+2 | <Trans><a _t="-foo" href="/">click</a></Trans>
+  |        ^^^^^^^^^^^^^^^^^^^^^^
diff --git a/tests/snapshots/runtime_config__should_use_provided_runtime_modules.snap b/tests/snapshots/runtime_config__should_use_provided_runtime_modules.snap
new file mode 100644
index 0000000..4cdd1da
--- /dev/null
+++ b/tests/snapshots/runtime_config__should_use_provided_runtime_modules.snap
@@ -0,0 +1,32 @@
+---
+source: tests/runtime_config.rs
+info:
+  runtime_modules:
+    i18n:
+      - "./custom-core"
+      - customI18n
+    trans:
+      - "./custom-react"
+      - CustomTrans
+    use_lingui:
+      - "./custom-react"
+      - useLingui2
+---
+import { t } from "@lingui/core/macro";
+import { Trans } from "@lingui/react/macro";
+
+t`Refresh inbox`;
+const exp2 = <Trans id="custom.id">Refresh inbox</Trans>;
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { CustomTrans as Trans_ } from "./custom-react";
+import { customI18n as $_i18n } from "./custom-core";
+$_i18n._(/*i18n*/ {
+    id: "EsCV2T",
+    message: "Refresh inbox"
+});
+const exp2 = <Trans_ {.../*i18n*/ {
+    id: "custom.id",
+    message: "Refresh inbox"
+}}/>;
diff --git a/tests/__swc_snapshots__/tests/use_lingui.rs/js_use_lingui_hook.js b/tests/snapshots/use_lingui__js_use_lingui_hook.snap
similarity index 53%
rename from tests/__swc_snapshots__/tests/use_lingui.rs/js_use_lingui_hook.js
rename to tests/snapshots/use_lingui__js_use_lingui_hook.snap
index 2b9f8a9..5f50f73 100644
--- a/tests/__swc_snapshots__/tests/use_lingui.rs/js_use_lingui_hook.js
+++ b/tests/snapshots/use_lingui__js_use_lingui_hook.snap
@@ -1,3 +1,19 @@
+---
+source: tests/use_lingui.rs
+---
+import { useLingui } from "@lingui/react/macro";
+
+const bla1 = () => {
+   console.log()
+}
+
+ function bla() {
+   const { t, i18n } = useLingui();
+   t`Refresh inbox`;
+ }
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { useLingui as $_useLingui } from "@lingui/react";
 const bla1 = ()=>{
     console.log();
diff --git a/tests/__swc_snapshots__/tests/use_lingui.rs/should_process_macro_with_matching_name_in_correct_scopes.js b/tests/snapshots/use_lingui__should_process_macro_with_matching_name_in_correct_scopes.snap
similarity index 57%
rename from tests/__swc_snapshots__/tests/use_lingui.rs/should_process_macro_with_matching_name_in_correct_scopes.js
rename to tests/snapshots/use_lingui__should_process_macro_with_matching_name_in_correct_scopes.snap
index 236366c..3a16cdb 100644
--- a/tests/__swc_snapshots__/tests/use_lingui.rs/should_process_macro_with_matching_name_in_correct_scopes.js
+++ b/tests/snapshots/use_lingui__should_process_macro_with_matching_name_in_correct_scopes.snap
@@ -1,3 +1,25 @@
+---
+source: tests/use_lingui.rs
+---
+import { useLingui } from '@lingui/react/macro';
+
+function MyComponent() {
+  const { t } = useLingui();
+  const a = t`Text`;
+
+  {
+    // here is child scope with own "t" binding, shouldn't be processed
+    const t = () => {};
+    t`Text`;
+  }
+  {
+    // here is child scope which should be processed, since 't' relates to outer scope
+    t`Text`;
+  }
+}
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { useLingui as $_useLingui } from "@lingui/react";
 function MyComponent() {
     const { i18n: $__i18n, _: $__ } = $_useLingui();
diff --git a/tests/snapshots/use_lingui__support_nested_macro.snap b/tests/snapshots/use_lingui__support_nested_macro.snap
new file mode 100644
index 0000000..9744b6d
--- /dev/null
+++ b/tests/snapshots/use_lingui__support_nested_macro.snap
@@ -0,0 +1,29 @@
+---
+source: tests/use_lingui.rs
+---
+import { useLingui } from '@lingui/react/macro';
+import { plural } from '@lingui/core/macro';
+
+function MyComponent() {
+  const { t } = useLingui();
+  const a = t`Text ${plural(users.length, {
+          offset: 1,
+          0: "No books",
+          1: "1 book",
+          other: "\# books"
+        })}`;
+}
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { useLingui as $_useLingui } from "@lingui/react";
+function MyComponent() {
+    const { i18n: $__i18n, _: $__ } = $_useLingui();
+    const a = $__i18n._(/*i18n*/ {
+        id: "hJRCh6",
+        message: "Text {0, plural, offset:1 =0 {No books} =1 {1 book} other {# books}}",
+        values: {
+            0: users.length
+        }
+    });
+}
diff --git a/tests/snapshots/use_lingui__support_nested_macro_when_in_arrow_function_issue_2095.snap b/tests/snapshots/use_lingui__support_nested_macro_when_in_arrow_function_issue_2095.snap
new file mode 100644
index 0000000..c2c6ba0
--- /dev/null
+++ b/tests/snapshots/use_lingui__support_nested_macro_when_in_arrow_function_issue_2095.snap
@@ -0,0 +1,29 @@
+---
+source: tests/use_lingui.rs
+---
+import { plural } from '@lingui/core/macro'
+import { useLingui } from '@lingui/react/macro'
+
+const MyComponent = () => {
+  const { t } = useLingui();
+  const a = t`Text ${plural(users.length, {
+          offset: 1,
+          0: "No books",
+          1: "1 book",
+          other: "\# books"
+        })}`;
+}
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { useLingui as $_useLingui } from "@lingui/react";
+const MyComponent = ()=>{
+    const { i18n: $__i18n, _: $__ } = $_useLingui();
+    const a = $__i18n._(/*i18n*/ {
+        id: "hJRCh6",
+        message: "Text {0, plural, offset:1 =0 {No books} =1 {1 book} other {# books}}",
+        values: {
+            0: users.length
+        }
+    });
+};
diff --git a/tests/__swc_snapshots__/tests/use_lingui.rs/support_passing_t_variable_as_dependency.js b/tests/snapshots/use_lingui__support_passing_t_variable_as_dependency.snap
similarity index 56%
rename from tests/__swc_snapshots__/tests/use_lingui.rs/support_passing_t_variable_as_dependency.js
rename to tests/snapshots/use_lingui__support_passing_t_variable_as_dependency.snap
index f8b2407..3e7095e 100644
--- a/tests/__swc_snapshots__/tests/use_lingui.rs/support_passing_t_variable_as_dependency.js
+++ b/tests/snapshots/use_lingui__support_passing_t_variable_as_dependency.snap
@@ -1,3 +1,15 @@
+---
+source: tests/use_lingui.rs
+---
+import { useLingui } from '@lingui/react/macro';
+
+function MyComponent() {
+  const { t } = useLingui();
+  const a = useMemo(() => t`Text`, [t]);
+}
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { useLingui as $_useLingui } from "@lingui/react";
 function MyComponent() {
     const { i18n: $__i18n, _: $__ } = $_useLingui();
diff --git a/tests/__swc_snapshots__/tests/use_lingui.rs/support_renamed_destructuring.js b/tests/snapshots/use_lingui__support_renamed_destructuring.snap
similarity index 54%
rename from tests/__swc_snapshots__/tests/use_lingui.rs/support_renamed_destructuring.js
rename to tests/snapshots/use_lingui__support_renamed_destructuring.snap
index ea8b622..3258259 100644
--- a/tests/__swc_snapshots__/tests/use_lingui.rs/support_renamed_destructuring.js
+++ b/tests/snapshots/use_lingui__support_renamed_destructuring.snap
@@ -1,3 +1,15 @@
+---
+source: tests/use_lingui.rs
+---
+import { useLingui } from '@lingui/react/macro';
+
+function MyComponent() {
+  const { t: _ } = useLingui();
+  const a = _`Text`;
+}
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { useLingui as $_useLingui } from "@lingui/react";
 function MyComponent() {
     const { i18n: $__i18n, _: $__ } = $_useLingui();
diff --git a/tests/snapshots/use_lingui__work_when_t_is_not_used.snap b/tests/snapshots/use_lingui__work_when_t_is_not_used.snap
new file mode 100644
index 0000000..625b1b8
--- /dev/null
+++ b/tests/snapshots/use_lingui__work_when_t_is_not_used.snap
@@ -0,0 +1,17 @@
+---
+source: tests/use_lingui.rs
+---
+import { useLingui } from '@lingui/react/macro';
+
+function MyComponent() {
+  const { i18n } = useLingui();
+  console.log(i18n);
+}
+
+↓ ↓ ↓ ↓ ↓ ↓
+
+import { useLingui as $_useLingui } from "@lingui/react";
+function MyComponent() {
+    const { i18n, _: $__ } = $_useLingui();
+    console.log(i18n);
+}
diff --git a/tests/__swc_snapshots__/tests/use_lingui.rs/work_with_components_defined_as_arrow_function.js b/tests/snapshots/use_lingui__work_with_components_defined_as_arrow_function.snap
similarity index 54%
rename from tests/__swc_snapshots__/tests/use_lingui.rs/work_with_components_defined_as_arrow_function.js
rename to tests/snapshots/use_lingui__work_with_components_defined_as_arrow_function.snap
index 5100fc5..6379c8d 100644
--- a/tests/__swc_snapshots__/tests/use_lingui.rs/work_with_components_defined_as_arrow_function.js
+++ b/tests/snapshots/use_lingui__work_with_components_defined_as_arrow_function.snap
@@ -1,3 +1,15 @@
+---
+source: tests/use_lingui.rs
+---
+import { useLingui } from '@lingui/react/macro';
+
+const MyComponent = () => {
+  const { t } = useLingui();
+  const a = t`Text`;
+}
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { useLingui as $_useLingui } from "@lingui/react";
 const MyComponent = ()=>{
     const { i18n: $__i18n, _: $__ } = $_useLingui();
diff --git a/tests/__swc_snapshots__/tests/use_lingui.rs/work_with_existing_use_lingui_statement.js b/tests/snapshots/use_lingui__work_with_existing_use_lingui_statement.snap
similarity index 51%
rename from tests/__swc_snapshots__/tests/use_lingui.rs/work_with_existing_use_lingui_statement.js
rename to tests/snapshots/use_lingui__work_with_existing_use_lingui_statement.snap
index 6cbd52a..dae7280 100644
--- a/tests/__swc_snapshots__/tests/use_lingui.rs/work_with_existing_use_lingui_statement.js
+++ b/tests/snapshots/use_lingui__work_with_existing_use_lingui_statement.snap
@@ -1,3 +1,19 @@
+---
+source: tests/use_lingui.rs
+---
+import { useLingui as useLinguiMacro } from '@lingui/react/macro';
+import { useLingui } from '@lingui/react';
+
+function MyComponent() {
+  const { _ } = useLingui();
+
+  console.log(_);
+  const { t } = useLinguiMacro();
+  const a = t`Text`;
+}
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { useLingui as $_useLingui } from "@lingui/react";
 import { useLingui } from '@lingui/react';
 function MyComponent() {
diff --git a/tests/__swc_snapshots__/tests/use_lingui.rs/work_with_multiple_react_components.js b/tests/snapshots/use_lingui__work_with_multiple_react_components.snap
similarity index 59%
rename from tests/__swc_snapshots__/tests/use_lingui.rs/work_with_multiple_react_components.js
rename to tests/snapshots/use_lingui__work_with_multiple_react_components.snap
index cacb131..6bbe8ec 100644
--- a/tests/__swc_snapshots__/tests/use_lingui.rs/work_with_multiple_react_components.js
+++ b/tests/snapshots/use_lingui__work_with_multiple_react_components.snap
@@ -1,3 +1,20 @@
+---
+source: tests/use_lingui.rs
+---
+import { useLingui } from '@lingui/react/macro';
+
+function MyComponent() {
+  const { t } = useLingui();
+  const a = t`Text`;
+}
+
+function MyComponent2() {
+  const { t } = useLingui();
+  const b = t`Text`;
+}
+
+↓ ↓ ↓ ↓ ↓ ↓
+
 import { useLingui as $_useLingui } from "@lingui/react";
 function MyComponent() {
     const { i18n: $__i18n, _: $__ } = $_useLingui();

From 367c85d171655e42ba6b1e6379e6513991a11c7d Mon Sep 17 00:00:00 2001
From: iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Tue, 21 Apr 2026 15:05:42 +0200
Subject: [PATCH 10/14] add more ai docs

---
 .agents/SWC_TRANSFORM_TESTING.md | 374 +++++++++++++++++++++++++++++++
 CLAUDE.md                        |   4 +
 2 files changed, 378 insertions(+)
 create mode 100644 .agents/SWC_TRANSFORM_TESTING.md

diff --git a/.agents/SWC_TRANSFORM_TESTING.md b/.agents/SWC_TRANSFORM_TESTING.md
new file mode 100644
index 0000000..cb7a09e
--- /dev/null
+++ b/.agents/SWC_TRANSFORM_TESTING.md
@@ -0,0 +1,374 @@
+# Running SWC transforms outside the plugin host
+
+This document explains how to parse, transform, and emit JavaScript/TypeScript code using SWC's Rust API **without** the SWC plugin host (WASM runtime). This is what powers our test suite, but the techniques apply any time you want to run an SWC `Fold`/`VisitMut` pass in a standalone Rust binary or test harness.
+
+## Required `swc_core` features
+
+```toml
+swc_core = { version = "50.2.3", features = [
+  "ecma_ast",       # AST types, Program, Pass trait
+  "ecma_parser",    # Parser, Lexer, Syntax
+  "ecma_visit",     # Fold, VisitMut, FoldWith, fold_pass()
+  "ecma_codegen",   # Emitter, to_code_default()
+  "ecma_utils",     # pulls in swc_ecma_transforms_base (resolver, hygiene, fixer)
+  "common",         # SourceMap, GLOBALS, HANDLER, Mark, Comments
+] }
+```
+
+The `ecma_utils` feature transitively enables `swc_ecma_transforms_base`, which provides the standard passes: `resolver`, `hygiene`, and `fixer`.
+
+The `ecma_codegen` feature provides `to_code_default()` and the lower-level `Emitter` + `JsWriter` for turning an AST back into a string.
+
+> **You do NOT need `testing_transform`.** That feature pulls in the entire `swc_ecma_transforms_testing` crate (and its transitive deps: `testing`, `swc_error_reporters`, `ansi_term`, `base64`, `tempfile`, Node.js exec support, etc.). Everything it does can be inlined in ~60 lines.
+
+## Thread-local globals
+
+SWC uses two scoped thread-locals that must be set before any transform work:
+
+### `GLOBALS`
+
+```rust
+use swc_core::common::{Globals, GLOBALS};
+
+GLOBALS.set(&Globals::new(), || {
+    // All SWC work goes here
+});
+```
+
+`Mark::new()` (used by the resolver and by hygiene) allocates from a global arena stored in `GLOBALS`. If `GLOBALS` is not set, `Mark::new()` will panic.
+
+### `HANDLER`
+
+```rust
+use swc_core::common::errors::{Handler, HandlerFlags, HANDLER};
+
+let handler = Handler::with_emitter_and_flags(
+    Box::new(my_emitter),
+    HandlerFlags {
+        can_emit_warnings: true,
+        ..Default::default()
+    },
+);
+
+HANDLER.set(&handler, || {
+    // Transforms that emit diagnostics go here
+});
+```
+
+Plugin code (and some built-in SWC transforms) report errors via `HANDLER.with(|h| h.struct_span_err(span, msg).emit())`. If `HANDLER` is not set, those calls panic with a "HANDLER not set" message.
+
+**`HANDLER` must be nested inside `GLOBALS`** — both must be active simultaneously.
+
+#### Handler behavior flags
+
+| Flag | Default | Effect |
+|---|---|---|
+| `can_emit_warnings` | `true` | Whether warning-level diagnostics are emitted |
+| `treat_err_as_bug` | `false` | If `true`, any error immediately panics via `bug!()` |
+| `continue_after_error` | `true` (Cell) | If `true`, errors are collected and execution continues. If `false`, the first error triggers `FatalError.raise()` which calls `panic::resume_unwind` |
+
+For tests, the default flags work well: errors are collected silently, and you check for them after the transform completes.
+
+#### Custom error emitters
+
+The `Handler` accepts a `Box<dyn Emitter + Send>` where `Emitter` is `swc_core::common::errors::Emitter` (not the codegen `Emitter`). This is how you capture error messages programmatically:
+
+```rust
+use std::sync::{Arc, Mutex};
+
+struct StringEmitter {
+    buffer: Arc<Mutex<String>>,
+}
+
+impl swc_core::common::errors::Emitter for StringEmitter {
+    fn emit(&mut self, db: &mut swc_core::common::errors::DiagnosticBuilder<'_>) {
+        // DiagnosticBuilder derefs to Diagnostic
+        // Diagnostic.message is Vec<Message> where Message(pub String, pub Style)
+        let msg: String = db.message.iter().map(|m| m.0.as_str()).collect::<Vec<_>>().join("");
+        let mut buf = self.buffer.lock().unwrap();
+        if !buf.is_empty() {
+            buf.push('\n');
+        }
+        buf.push_str(&msg);
+    }
+}
+```
+
+The `Arc<Mutex<String>>` gives you a handle to read errors after the transform. This is preferable to `Handler::with_tty_emitter()` when you need to inspect or assert on error output.
+
+> **Caveat:** The `Emitter` trait requires `Send`. `Rc<...>` won't work. Use `Arc<Mutex<...>>` or `Arc<RwLock<...>>`.
+
+## Parsing
+
+```rust
+use swc_core::common::{FileName, SourceMap, sync::Lrc};
+use swc_core::common::comments::SingleThreadedComments;
+use swc_core::ecma::parser::{lexer::Lexer, Parser, StringInput, Syntax, TsSyntax};
+
+let cm: Lrc<SourceMap> = Default::default();
+let comments = SingleThreadedComments::default();
+
+let syntax = Syntax::Typescript(TsSyntax {
+    tsx: true,
+    ..Default::default()
+});
+
+let fm = cm.new_source_file(
+    FileName::Real("input.tsx".into()).into(),
+    input.to_string(),
+);
+
+let lexer = Lexer::new(
+    syntax,
+    Default::default(),  // EsVersion — latest
+    StringInput::from(&*fm),
+    Some(&comments),     // attaches comments to the AST
+);
+
+let mut parser = Parser::new_from(lexer);
+let program: Program = parser.parse_program().expect("parse error");
+```
+
+**Key points:**
+
+- `SourceMap` (`Lrc<SourceMap>`) is required. It maps byte positions in the AST back to source locations. Even if you don't need source maps in output, the parser and codegen need it.
+- `SingleThreadedComments` stores comments (leading/trailing) associated with AST nodes. Pass it to the parser, your transforms, and the code emitter to preserve `/* ... */` and `// ...` comments through the pipeline.
+- `parse_program()` auto-detects Module vs Script. Use `parse_module()` or `parse_script()` if you need a specific mode.
+- Parse errors are returned as `Result`, not emitted through `HANDLER`. The parser does **not** require `HANDLER` to be set (though it won't hurt).
+
+### Routing parse errors through HANDLER
+
+The parser returns errors as `Result`, but you can convert them to diagnostics emitted through `HANDLER`. This is useful when you want parse errors to be captured by a custom `Emitter` alongside transform errors, rather than causing a hard panic:
+
+```rust
+let mut parser = Parser::new_from(lexer);
+let program = match parser.parse_program() {
+    Ok(program) => program,
+    Err(e) => {
+        // Convert the parse error to a diagnostic and emit it through HANDLER
+        e.into_diagnostic(&handler).emit();
+        for e in parser.take_errors() {
+            e.into_diagnostic(&handler).emit();
+        }
+        return None; // or however you signal failure
+    }
+};
+// Also emit any non-fatal parse errors (warnings, recoverable errors)
+for e in parser.take_errors() {
+    e.into_diagnostic(&handler).emit();
+}
+```
+
+This pattern (from SWC's `Tester::with_parser`) is what we use in `tests/common/mod.rs` so that `to_panic!` tests can capture parse errors in snapshots just like transform errors.
+
+## Applying transforms
+
+SWC has two transform APIs: the older `Fold` trait (immutable, returns new nodes) and the newer `VisitMut`/`Pass` trait (mutable in-place). Both are actively used.
+
+### The `Pass` trait
+
+```rust
+// Defined in swc_core::ecma::ast
+pub trait Pass {
+    fn process(&mut self, program: &mut Program);
+}
+```
+
+`Program` has an `.apply()` convenience method:
+
+```rust
+let program = program.apply(my_pass);   // consumes and returns Program
+```
+
+### Wrapping `Fold` into `Pass`
+
+If your transform implements `Fold` (like `LinguiMacroFolder`), wrap it:
+
+```rust
+use swc_core::ecma::visit::fold_pass;
+
+let program = program.apply(fold_pass(MyFolder::new()));
+```
+
+`fold_pass()` returns an opaque type implementing `Pass`.
+
+### Standard passes
+
+All three standard passes return `impl Pass + VisitMut`:
+
+```rust
+use swc_core::ecma::transforms::base::{resolver, hygiene, fixer};
+use swc_core::common::Mark;
+
+// 1. Resolver — assigns unique Marks to identifiers for scope tracking
+//    Requires GLOBALS to be set (Mark::new() allocates from it)
+let program = program.apply(resolver(
+    Mark::new(),    // unresolved_mark — for free identifiers
+    Mark::new(),    // top_level_mark — for top-level declarations
+    true,           // typescript mode
+));
+
+// 2. Your transform
+let program = program.apply(fold_pass(MyTransform::new()));
+
+// 3. Hygiene — renames identifiers to avoid conflicts introduced by transforms
+let program = program.apply(hygiene::hygiene());
+
+// 4. Fixer — corrects operator precedence, adds necessary parentheses
+let program = program.apply(fixer::fixer(Some(&comments)));
+```
+
+### Pass composition
+
+Tuples of `Pass` implement `Pass` (up to 12 elements):
+
+```rust
+let program = program.apply((
+    resolver(Mark::new(), Mark::new(), true),
+    fold_pass(MyTransform::new()),
+));
+```
+
+### Ordering caveats
+
+- **Resolver must come first** if your transform relies on identifier scoping (e.g., distinguishing local `t` from imported `t`). Without it, all identifiers with the same name look identical.
+- **Hygiene must come after your transform.** It cleans up naming conflicts your transform may have introduced (e.g., injecting an `i18n` import that clashes with a user's `i18n` variable).
+- **Fixer must come last.** It fixes the AST for correct code emission (adds parens for precedence, etc.). Running transforms after fixer can undo its corrections.
+- **Fixer takes `Option<&dyn Comments>`** so it can adjust comment positions when it restructures the AST. Always pass your comments reference.
+
+## Code emission
+
+### Simple: `to_code_default`
+
+```rust
+use swc_core::ecma::codegen::to_code_default;
+
+let code: String = to_code_default(cm.clone(), Some(&comments), &program);
+```
+
+This is a one-liner that creates an `Emitter` + `JsWriter` internally, emits the program, and returns a `String`. Good enough for tests and most use cases.
+
+### Manual: `Emitter` + `JsWriter`
+
+For source map output or custom writer config:
+
+```rust
+use swc_core::ecma::codegen::{Emitter, text_writer::JsWriter};
+
+let mut buf = Vec::new();
+let mut src_map = Vec::new(); // (BytePos, LineCol) pairs
+
+{
+    let mut emitter = Emitter {
+        cfg: Default::default(),
+        cm: cm.clone(),
+        comments: Some(&comments),
+        wr: JsWriter::new(
+            cm.clone(),
+            "\n",               // line separator
+            &mut buf,
+            Some(&mut src_map), // None to skip source map
+        ),
+    };
+    emitter.emit_program(&program).unwrap();
+}
+
+let output = String::from_utf8(buf).unwrap();
+```
+
+> **Naming collision:** `swc_core::ecma::codegen::Emitter` (code emission struct) and `swc_core::common::errors::Emitter` (diagnostic trait) are completely different types that happen to share a name. If you use both, alias one: `use swc_core::common::errors::Emitter as DiagEmitter;`
+
+## Complete example
+
+Putting it all together — a function that parses TSX, applies a `Fold` transform, and returns the output code (or collected error messages):
+
+```rust
+use std::sync::{Arc, Mutex};
+use swc_core::common::comments::SingleThreadedComments;
+use swc_core::common::errors::{Handler, HandlerFlags, HANDLER};
+use swc_core::common::{FileName, Globals, Mark, SourceMap, GLOBALS, sync::Lrc};
+use swc_core::ecma::codegen::to_code_default;
+use swc_core::ecma::parser::{lexer::Lexer, Parser, StringInput, Syntax, TsSyntax};
+use swc_core::ecma::transforms::base::{fixer, hygiene, resolver};
+use swc_core::ecma::visit::fold_pass;
+
+fn run_transform(input: &str) -> Result<String, String> {
+    let error_buffer = Arc::new(Mutex::new(String::new()));
+    let cm: Lrc<SourceMap> = Default::default();
+    let comments = SingleThreadedComments::default();
+
+    let handler = Handler::with_emitter_and_flags(
+        Box::new(StringEmitter { buffer: error_buffer.clone() }),
+        HandlerFlags { can_emit_warnings: true, ..Default::default() },
+    );
+
+    let syntax = Syntax::Typescript(TsSyntax { tsx: true, ..Default::default() });
+
+    let output = GLOBALS.set(&Globals::new(), || {
+        HANDLER.set(&handler, || {
+            let fm = cm.new_source_file(
+                FileName::Real("input.tsx".into()).into(),
+                input.to_string(),
+            );
+            let lexer = Lexer::new(syntax, Default::default(), StringInput::from(&*fm), Some(&comments));
+            let mut parser = Parser::new_from(lexer);
+            let program = parser.parse_program().expect("parse failed");
+
+            let program = program
+                .apply(resolver(Mark::new(), Mark::new(), true))
+                .apply(fold_pass(MyTransform::new()))
+                .apply(hygiene::hygiene())
+                .apply(fixer::fixer(Some(&comments)));
+
+            to_code_default(cm.clone(), Some(&comments), &program)
+        })
+    });
+
+    let errors = error_buffer.lock().unwrap().clone();
+    if errors.is_empty() { Ok(output) } else { Err(errors) }
+}
+```
+
+## How `swc_ecma_transforms_testing` does it (and why we don't use it)
+
+The `testing_transform` feature of `swc_core` pulls in `swc_ecma_transforms_testing`, which provides `test!()` and `test_inlined_transform()`. Under the hood:
+
+1. `test!` is a macro that generates a `#[test]` fn calling `test_inlined_transform`.
+2. `test_inlined_transform` uses `#[track_caller]` to derive the snapshot file path from the calling file location: `tests/__swc_snapshots__/{test_file}.rs/{test_name}.js`.
+3. It delegates to `test_fixture_inner`, which:
+   - Creates a `Tester` (wraps `SourceMap`, `Handler`, `Rc<SingleThreadedComments>`)
+   - Sets `GLOBALS`, `HANDLER`, and `HELPERS` thread-locals
+   - Parses input, applies the transform pass, then `hygiene()` + `fixer()`
+   - Emits code via `Emitter` + `JsWriter` (manually, not `to_code_default`)
+   - Compares output to a snapshot file using `NormalizedOutput::compare_to_file`
+   - Supports `UPDATE=1` env var to overwrite snapshots
+
+This is roughly 200 lines of code, but it pulls in a large dependency tree (the `testing` crate with graphical error reporters, the `swc_ecma_testing` crate with Node.js execution support, etc.). The actual transform logic can be inlined in ~60 lines (see `tests/common/mod.rs` in this repo).
+
+### What `HELPERS` is (and why we skip it)
+
+`swc_ecma_transforms_testing` also sets `HELPERS` (from `swc_ecma_transforms_base::helpers`). This thread-local tracks which runtime helpers a transform needs to inject (e.g., `_class_call_check`, `_inherits` for class transpilation). Our plugin doesn't use runtime helpers, so we don't set it. If your transform calls `helper!()` macros, you'll need:
+
+```rust
+use swc_core::ecma::transforms::base::helpers::HELPERS;
+
+HELPERS.set(&Default::default(), || {
+    // transform code here
+});
+```
+
+## SWC error handling model
+
+SWC transforms report errors as **side effects** through the `HANDLER` thread-local, not by returning `Result`. This is a deliberate design choice — the `Fold` and `VisitMut` traits don't have `Result` return types.
+
+The flow:
+1. Transform calls `HANDLER.with(|h| h.struct_span_err(span, "message").emit())`
+2. The handler's emitter receives the diagnostic
+3. Depending on `HandlerFlags`:
+   - `continue_after_error: true` (default) — error is recorded, execution continues
+   - `continue_after_error: false` — `abort_if_errors()` is called, which triggers `FatalError.raise()` → `panic::resume_unwind(Box::new(FatalErrorMarker))`
+   - `treat_err_as_bug: true` — immediate panic via `bug!()`
+
+**Caveat:** `FatalError.raise()` uses `resume_unwind`, not `panic!()`. The panic payload is a `FatalErrorMarker` struct, not a string. If you use `catch_unwind`, you won't get a human-readable message from the panic itself — you need to capture it from the emitter.
+
+This is why our test helper uses a custom `StringEmitter`: it collects error text in a buffer, then checks the buffer after the transform completes. The `to_panic!` test macro uses `Result::expect_err()` on the buffered errors rather than `#[should_panic]`.
diff --git a/CLAUDE.md b/CLAUDE.md
index 8388383..39a8364 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -61,6 +61,10 @@ Snapshots live in `tests/snapshots/` and contain input + `↓ ↓ ↓ ↓ ↓ 
 
 To update snapshots use `INSTA_UPDATE=always cargo test` command or `cargo insta test --review` to review them interactively
 
+## Reference
+
+- [SWC Transform Testing](.agents/SWC_TRANSFORM_TESTING.md) — how to parse, transform, and emit code using SWC's Rust API outside the plugin host (thread-locals, error handling, pass ordering, codegen).
+
 ## Toolchain
 
 - Rust 1.85 pinned in `rust-toolchain.toml`

From 13f4a459b458f676971ba17af619eed4fe411162 Mon Sep 17 00:00:00 2001
From: Timofei Iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Tue, 21 Apr 2026 15:11:00 +0200
Subject: [PATCH 11/14] Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/builder.rs                  | 2 +-
 tests/jsx_named_placeholders.rs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/builder.rs b/src/builder.rs
index b6cd296..630d262 100644
--- a/src/builder.rs
+++ b/src/builder.rs
@@ -181,7 +181,7 @@ impl<'a> MessageBuilder<'a> {
 
             base_name = attr_value;
 
-            el.attrs = omit_jsx_attrs(el.attrs, HashSet::from([attr_name.as_str()]))
+            el.attrs = omit_jsx_attrs(el.attrs, HashSet::from([attr_name.as_str()]));
         }
 
         if base_name.is_none() {
diff --git a/tests/jsx_named_placeholders.rs b/tests/jsx_named_placeholders.rs
index 972b138..6d220f2 100644
--- a/tests/jsx_named_placeholders.rs
+++ b/tests/jsx_named_placeholders.rs
@@ -240,7 +240,7 @@ import { Trans } from '@lingui/react/macro';
 );
 
 to_panic!(
-    same_element_diffrent_attributes_count_throw,
+    same_element_different_attributes_count_throws,
     LinguiOptions {
         jsx_placeholder_attribute: Some("_t".into()),
         ..Default::default()

From 9a67f0d80cab7a96d0f9f0d8ec4b6d3e66d4d0aa Mon Sep 17 00:00:00 2001
From: iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Tue, 21 Apr 2026 15:11:26 +0200
Subject: [PATCH 12/14] delete extra case

---
 tests/jsx_named_placeholders.rs | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/tests/jsx_named_placeholders.rs b/tests/jsx_named_placeholders.rs
index 6d220f2..3b26a27 100644
--- a/tests/jsx_named_placeholders.rs
+++ b/tests/jsx_named_placeholders.rs
@@ -287,18 +287,6 @@ import { Trans } from '@lingui/react/macro';
      "#
 );
 
-to_panic!(
-    throws_on_empty_string,
-    LinguiOptions {
-        jsx_placeholder_attribute: Some("_t".into()),
-        ..Default::default()
-    },
-    r#"
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t="" href="/">click</a></Trans>
-     "#
-);
-
 to!(
     supports_string_in_jsx_expression,
     LinguiOptions {

From ae9eb88f56246ed8cdba165b5c3ef490e1f70a9d Mon Sep 17 00:00:00 2001
From: iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Tue, 21 Apr 2026 15:16:18 +0200
Subject: [PATCH 13/14] fixes

---
 .gitignore                                        |  1 +
 ...lement_different_attributes_count_throws.snap} |  0
 ...amed_placeholders__throws_on_empty_string.snap | 15 ---------------
 3 files changed, 1 insertion(+), 15 deletions(-)
 rename tests/snapshots/{jsx_named_placeholders__same_element_diffrent_attributes_count_throw.snap => jsx_named_placeholders__same_element_different_attributes_count_throws.snap} (100%)
 delete mode 100644 tests/snapshots/jsx_named_placeholders__throws_on_empty_string.snap

diff --git a/.gitignore b/.gitignore
index 96ea0a7..d5a5977 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,3 +6,4 @@ lcov.info
 node_modules
 .yarn
 .swc
+.new
diff --git a/tests/snapshots/jsx_named_placeholders__same_element_diffrent_attributes_count_throw.snap b/tests/snapshots/jsx_named_placeholders__same_element_different_attributes_count_throws.snap
similarity index 100%
rename from tests/snapshots/jsx_named_placeholders__same_element_diffrent_attributes_count_throw.snap
rename to tests/snapshots/jsx_named_placeholders__same_element_different_attributes_count_throws.snap
diff --git a/tests/snapshots/jsx_named_placeholders__throws_on_empty_string.snap b/tests/snapshots/jsx_named_placeholders__throws_on_empty_string.snap
deleted file mode 100644
index cc1eb94..0000000
--- a/tests/snapshots/jsx_named_placeholders__throws_on_empty_string.snap
+++ /dev/null
@@ -1,15 +0,0 @@
----
-source: tests/jsx_named_placeholders.rs
-info:
-  jsx_placeholder_attribute: _t
----
-import { Trans } from '@lingui/react/macro';
-<Trans><a _t="" href="/">click</a></Trans>
-
-↓ ↓ ↓ ↓ ↓ ↓
-
-error: Placeholder name `` is not valid. Names must start and end with a letter/digit/underscore, but may contain `.-` in between.
- --> input.tsx:2:8
-  |
-2 | <Trans><a _t="" href="/">click</a></Trans>
-  |        ^^^^^^^^^^^^^^^^^^

From 3a836c6f6d22afbcbb94d06d469546201e862cf6 Mon Sep 17 00:00:00 2001
From: iatsenko <1586852+timofei-iatsenko@users.noreply.github.com>
Date: Tue, 21 Apr 2026 15:18:23 +0200
Subject: [PATCH 14/14] fixes

---
 src/options.rs | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/src/options.rs b/src/options.rs
index 4bdd370..197ccd1 100644
--- a/src/options.rs
+++ b/src/options.rs
@@ -5,10 +5,11 @@ fn is_default<T: Default + PartialEq>(t: &T) -> bool {
     t == &T::default()
 }
 
-#[derive(Deserialize, Serialize, Debug, PartialEq, Clone)]
+#[derive(Deserialize, Serialize, Debug, PartialEq, Clone, Default)]
 #[serde(rename_all = "kebab-case")]
 pub enum DescriptorFields {
     Auto,
+    #[default]
     All,
     IdOnly,
     Message,
@@ -28,12 +29,6 @@ impl DescriptorFields {
     }
 }
 
-impl Default for DescriptorFields {
-    fn default() -> Self {
-        DescriptorFields::All
-    }
-}
-
 #[derive(Deserialize, Debug, PartialEq)]
 #[serde(rename_all = "camelCase")]
 pub struct LinguiJsOptions {