Skip to content

fix(platform-api-docs): prefer source over build output when deduplicating - #10085

Open
cryptodev-2s wants to merge 2 commits into
mainfrom
fix/platform-api-docs-prefer-source-over-dist
Open

fix(platform-api-docs): prefer source over build output when deduplicating#10085
cryptodev-2s wants to merge 2 commits into
mainfrom
fix/platform-api-docs-prefer-source-over-dist

Conversation

@cryptodev-2s

@cryptodev-2s cryptodev-2s commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Explanation

A capability declared in a package's source is also visible in the dist built from it, and a cross-package import resolves to that dist rather than to the sibling's source. Whichever was reached first won, so 83 of 1164 source links pointed at .d.cts build output instead of code you can read and edit.

Deduplication now scores source above build output, so the outcome no longer depends on traversal order. All 1164 links point at source, and namespace, action and event counts are unchanged.

Both clients generate byte-identical docs, since they only ever see published packages and score every candidate the same way.

References

Checklist

  • I've updated the test suite for new or updated code as appropriate
  • I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
  • I've communicated my changes to consumers by updating changelogs for packages I've changed
  • I've introduced breaking changes in this PR and have prepared draft pull requests for clients and consumer packages to resolve them

@cryptodev-2s
cryptodev-2s requested a review from a team as a code owner September 3, 2026 08:39
@cryptodev-2s cryptodev-2s self-assigned this Sep 3, 2026
@cryptodev-2s
cryptodev-2s requested a review from mcmire September 3, 2026 08:51
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.

1 participant