Skip to content

fix: stop recursing into re-exports of external packages#27

Merged
flxapps merged 5 commits intomainfrom
fix/stop-transitive-reexport-traversal
Mar 25, 2026
Merged

fix: stop recursing into re-exports of external packages#27
flxapps merged 5 commits intomainfrom
fix/stop-transitive-reexport-traversal

Conversation

@flxapps
Copy link
Copy Markdown
Collaborator

@flxapps flxapps commented Mar 25, 2026

When a host package re-exports symbols from a dependency (e.g. patrol), the doc generator was recursively following that dependency's own export chain too — pulling in the entire Flutter/vector_math transitive graph. This adds an isHostPackage check so re-export traversal stops at the package boundary: external libraries are still visited (their symbols are part of the public API), but their own exports are not followed.

@github-actions
Copy link
Copy Markdown

Version Analysis

Next Version: 6.0.6

Changelog: 📄 View detailed changelog in job summary

Badge:
Version Badge

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the Dart doc generator’s recursive export traversal to stop following external packages’ own re-export chains, preventing large transitive dependency graphs (e.g., Flutter/vector_math) from being pulled into generated API docs.

Changes:

  • Track whether the currently visited library belongs to the host package (isHostPackage).
  • Only recurse into exportedLibraries2 when visiting host-package libraries, not external dependencies.

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

Comment thread lib/doc_generator/doc_generator.dart Outdated
Comment thread lib/doc_generator/doc_generator.dart Outdated
Comment thread lib/doc_generator/doc_generator.dart
@github-actions
Copy link
Copy Markdown

Version Analysis

Next Version: 6.0.6

Changelog: 📄 View detailed changelog in job summary

Badge:
Version Badge

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.


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

Comment thread lib/doc_generator/doc_generator.dart Outdated
Comment thread lib/doc_generator/doc_generator.dart
@github-actions
Copy link
Copy Markdown

Version Analysis

Next Version: 6.0.6

Changelog: 📄 View detailed changelog in job summary

Badge:
Version Badge

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 3 comments.


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

Comment thread lib/doc_generator/doc_generator.dart Outdated
Comment thread lib/doc_generator/doc_generator.dart
Comment thread lib/doc_generator/doc_generator.dart
@github-actions
Copy link
Copy Markdown

Version Analysis

Next Version: 6.0.6

Changelog: 📄 View detailed changelog in job summary

Badge:
Version Badge

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.


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

Comment thread lib/doc_generator/doc_generator.dart
Comment thread lib/doc_generator/doc_generator.dart
@github-actions
Copy link
Copy Markdown

Version Analysis

Next Version: 6.0.6

Changelog: 📄 View detailed changelog in job summary

Badge:
Version Badge

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.


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

@flxapps flxapps merged commit 0043941 into main Mar 25, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants