feat(macro): Add arg macro tests, docs and typings

[DeyLak]

Description

This PR resolves part of the discussed changes in #2279. It adds tests, docs and typings for the arg macro that was already available in the babel plugin.

Types of changes

• Bugfix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Examples update

Fixes #2279

Checklist

• I have read the CONTRIBUTING and CODE_OF_CONDUCT docs
• I have added tests that prove my fix is effective or that my feature works
• I have added the necessary documentation (if appropriate)

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
js-lingui	✅ Ready (Inspect)	Visit Preview	Aug 4, 2025 8:55am

[codecov]

Codecov Report

❌ Patch coverage is 80.00000% with 2 lines in your changes missing coverage. Please review.
⚠️ Please upload report for BASE (main-renamed@36513df). Learn more about missing BASE report.

Files with missing lines	Patch %	Lines
...ckages/babel-plugin-lingui-macro/src/macroJsAst.ts	80.00%	1 Missing and 1 partial ⚠️

Additional details and impacted files

@@               Coverage Diff               @@
##             main-renamed    #2292   +/-   ##
===============================================
  Coverage                ?   77.01%           
===============================================
  Files                   ?       89           
  Lines                   ?     2506           
  Branches                ?      651           
===============================================
  Hits                    ?     1930           
  Misses                  ?      461           
  Partials                ?      115           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[timofei-iatsenko]

Regardless of the original conversation we had, i feel that this PR is still quite a valuable contribution for the library, so would like to move this forward.

The PR itself LGTM

[timofei-iatsenko]

I'd like to do some changes first, than will mark as ready

[timofei-iatsenko]

I added support for named placeholders to the arg macro, to be consistent with other places and added type tests for that.

[timofei-iatsenko]

@andrii-bodnar anything else to be done to merge it?

[andrii-bodnar]

@timofei-iatsenko I was waiting here for lingui/swc-plugin#161, to release them synchronously