fix: rewrite composed refs inside extensions

[matoous]

Composed bundles could leave root-level vendor extension $refs pointing at external files even when the referenced component had been composed into the bundle. Such refs made the bundled document not self-contained.

Allow the final composed-ref rewrite pass to also process $ref values under x-* extension fields, and add a regression test.

Spotted on our side once we upgraded to the latest vacuum version. In our case, we use extensions similarly to the included regression tests which stopped being properly composed.

Related: 8585a05

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.78%. Comparing base (d4c45ce) to head (f82bb41).
⚠️ Report is 9 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #602      +/-   ##
==========================================
+ Coverage   99.75%   99.78%   +0.03%     
==========================================
  Files         281      283       +2     
  Lines       34061    34479     +418     
==========================================
+ Hits        33977    34405     +428     
+ Misses         51       46       -5     
+ Partials       33       28       -5     

Flag	Coverage Δ
unittests	99.78% <100.00%> (+0.03%)	⬆️

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

☔ 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.

[daveshanley]

Thank you for your contribution!

one case that still leaves the composed bundle non-self-contained.

The patch rewrites extension $refs when the complete target exactly matches an entry in processedNodes, but not when the ref points below a composed component. For example:

x-related-field:
  $ref: './models.yaml#/components/schemas/Thing/properties/id'

If Thing is composed elsewhere, the bundle contains #/components/schemas/Thing, but the extension still retains the external ./models.yaml#... reference.

Could resolveRefToComposed find the longest composed ancestor and append the remaining JSON Pointer suffix? A regression test using a nested target such as Thing/properties/id would cover this case.

[matoous]

@daveshanley thanks, make sense! I tried to address it but I am not 100% confident I got it right, please let me know if additional adjustments are needed.