Fix(parser) improve $ref handling

[carson2222]

It will fail for now, waiting for hey-api/json-schema-ref-parser#13 to be merged.
fix #2550
fix #2551

[bolt-new-by-stackblitz]

Run & review this pull request in StackBlitz Codeflow.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 14af188

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
hey-api-docs	Ready	Preview	Comment	Sep 3, 2025 11:31am

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/codegen-core@2583

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/nuxt@2583

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/openapi-ts@2583

npm i https://pkg.pr.new/hey-api/openapi-ts/@hey-api/vite-plugin@2583

commit: 14af188

[codecov]

Codecov Report

❌ Patch coverage is 0% with 45 lines in your changes missing coverage. Please review.
✅ Project coverage is 23.59%. Comparing base (a312623) to head (14af188).
⚠️ Report is 4 commits behind head on main.

Files with missing lines	Patch %	Lines
...ages/openapi-ts/src/openApi/2.0.x/parser/schema.ts	0.00%	15 Missing ⚠️
...ages/openapi-ts/src/openApi/3.0.x/parser/schema.ts	0.00%	15 Missing ⚠️
...ages/openapi-ts/src/openApi/3.1.x/parser/schema.ts	0.00%	15 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2583      +/-   ##
==========================================
- Coverage   23.61%   23.59%   -0.03%     
==========================================
  Files         363      363              
  Lines       36504    36549      +45     
  Branches     1562     1562              
==========================================
  Hits         8622     8622              
- Misses      27869    27914      +45     
  Partials       13       13              

Flag	Coverage Δ
unittests	23.59% <0.00%> (-0.03%)	⬇️

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

☔ View full report in Codecov by Sentry.
📢 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.