feat!: Consolidate Metadata Transformation Options into descriptorFields

[timofei-iatsenko]

Related PR in Babel version: lingui/js-lingui#2513

Related issue: lingui/js-lingui#2511

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.24%. Comparing base (0e5c2d9) to head (535d47f).

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #208      +/-   ##
==========================================
+ Coverage   93.01%   93.24%   +0.22%     
==========================================
  Files           8        8              
  Lines        1531     1583      +52     
==========================================
+ Hits         1424     1476      +52     
  Misses        107      107              

Flag	Coverage Δ
unittests	93.24% <100.00%> (+0.22%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
src/js_macro_folder.rs	97.89% <100.00%> (ø)
src/lib.rs	92.05% <100.00%> (+0.07%)	⬆️
src/options.rs	100.00% <100.00%> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Pull request overview

This PR introduces a new descriptorFields option to control which message-descriptor properties (e.g., message, context, comment) are preserved during SWC macro transformation, replacing the previous boolean stripNonEssentialFields behavior and aligning with the related Babel change.

Changes:

• Add DescriptorFields enum and replace strip_non_essential_fields with descriptor_fields across config parsing and runtime options (with auto env-based defaults).
• Update macro transforms to conditionally emit message, context, and comment based on descriptor_fields.
• Update docs, tests, and SWC snapshot fixtures to cover the new configuration modes (id-only, message, etc.).

Reviewed changes

Copilot reviewed 12 out of 16 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/options.rs	Introduces DescriptorFields, updates config parsing/defaulting, and replaces the old boolean option.
src/lib.rs	Updates JSX macro transform to conditionally include descriptor fields and exports DescriptorFields.
src/js_macro_folder.rs	Updates JS macro transforms (t, defineMessage, etc.) to respect descriptor_fields for message/context/comment.
README.md	Documents descriptorFields behavior and supported values.
tests/jsx.rs	Adjusts tests to use descriptor_fields and adds coverage for "message" mode.
tests/jsx_icu.rs	Adjusts tests to use descriptor_fields and adds coverage for "message" mode with ICU JSX.
tests/js_t.rs	Adjusts tests to use descriptor_fields and adds coverage for "message" mode.
tests/js_define_message.rs	Adjusts tests to use descriptor_fields and adds coverage for "message" mode.
tests/__swc_snapshots__/...	Updates/adds snapshots reflecting new field-preservation behavior.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

get_jsx_attr_value_as_string(context_attr) can return None for non-literal/unsupported context values (e.g. {expr}), and the current .unwrap() will panic and crash the transform. Please handle the Option safely (e.g., only emit the context prop when a supported literal value is present, otherwise skip or emit a structured diagnostic via HANDLER).