Run & review this pull request in StackBlitz Codeflow.

Reviewed and approved. The only change since review was a changeset file addition — no code changes to re-review.

  ^{｜ View workflow run ｜ Triggered by Pullfrog ｜ 𝕏}

🦋 Changeset detected

Latest commit: 8e2c4b1

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

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

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

Project	Deployment	Actions	Updated (UTC)
hey-api-docs	Ready	Preview, Comment	Apr 6, 2026 9:16pm

TL;DR — When users explicitly include schemas, request bodies, parameters, or responses via filters, the orphan-dropping pass now preserves those resources and their transitive dependencies instead of discarding them as unreferenced.

Key changes

• Fix dropOrphans to respect explicitly included resources — Resources added via include filters (and their transitive dependencies) are no longer removed by the orphan-dropping pass, which previously only checked whether a resource was reachable from an operation.
• Add collectExplicitDependencies and collectDependencies helpers — New functions walk the dependency graph from explicitly included filter seeds, collecting all transitive dependencies so dropOrphans can preserve them.
• Extract getResourceDependencies utility — Deduplicates the namespace-based dependency lookup that was previously inlined in collectOperationDependencies.
• Add unit tests for createFilteredDependencies — Three tests cover the core scenarios: included schemas with deps, included request bodies with schema deps, and exclude-wins-over-include precedence.
• Convert arrow functions to function declarations — All module-level const fn = () => {} patterns in filter.ts are converted to function declarations.

_{Summary ｜ 3 files ｜ 1 commit ｜ base: main ← fix/parser-include-orphans}

Explicitly included resources survive orphan pruning

Before: The orphan-dropping pass only kept schemas, parameters, request bodies, and responses that were transitively reachable from operations. Explicitly including a schema (e.g. schemas.include: ['Foo']) had no effect if no operation referenced it — it was silently dropped.
After: A new collectExplicitDependencies function gathers all non-excluded include-filter seeds across every resource type, walks their full dependency graph via collectDependencies, and passes the result as includedDependencies into dropOrphans. The orphan check now keeps a resource if it appears in either operationDependencies or includedDependencies.

How does exclude-wins-over-include work here?

collectExplicitDependencies first skips any seed that appears in the corresponding exclude set. After collecting transitive dependencies, it makes a second pass to remove any dependency whose namespace-specific exclude set contains it. This means excludes are respected at both the root and transitive levels.

The getResourceDependencies helper consolidates the namespace-switch logic previously duplicated in collectOperationDependencies, and is now shared by both collectOperationDependencies and collectDependencies.

filter.ts · filter.test.ts

  ^{｜ View workflow run ｜ Triggered by Pullfrog ｜ 𝕏}

Reviewed PR #3714. The fix correctly ensures explicitly included components (schemas, parameters, request bodies, responses) and their transitive dependencies survive orphan dropping via the new collectExplicitDependencies / collectDependencies functions. Exclude-wins-over-include semantics are properly respected. Approved with no issues.

  ^{｜ View workflow run ｜ Triggered by Pullfrog ｜ 𝕏}

Codecov Report

❌ Patch coverage is 77.21519% with 18 lines in your changes missing coverage. Please review.
✅ Project coverage is 40.24%. Comparing base (bb6c491) to head (8e2c4b1).
⚠️ Report is 6 commits behind head on main.

@@            Coverage Diff             @@
##             main    #3714      +/-   ##
==========================================
+ Coverage   39.39%   40.24%   +0.85%     
==========================================
  Files         520      520              
  Lines       19278    19302      +24     
  Branches     5714     5726      +12     
==========================================
+ Hits         7594     7769     +175     
+ Misses       9445     9337     -108     
+ Partials     2239     2196      -43     

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

Open in StackBlitz

npm i https://pkg.pr.new/@hey-api/codegen-core@3714

npm i https://pkg.pr.new/@hey-api/json-schema-ref-parser@3714

npm i https://pkg.pr.new/@hey-api/nuxt@3714

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

npm i https://pkg.pr.new/@hey-api/shared@3714

npm i https://pkg.pr.new/@hey-api/spec-types@3714

npm i https://pkg.pr.new/@hey-api/types@3714

npm i https://pkg.pr.new/@hey-api/vite-plugin@3714

commit: 8e2c4b1