Skip to content

fix(docs): ensure cross-package refs are inlined#201

Merged
raphael merged 3 commits into
v3from
fix/docs-inlining-cross-package
Sep 14, 2025
Merged

fix(docs): ensure cross-package refs are inlined#201
raphael merged 3 commits into
v3from
fix/docs-inlining-cross-package

Conversation

@raphael
Copy link
Copy Markdown
Member

@raphael raphael commented Sep 14, 2025

The docs plugin was failing to inline type references for types defined in other design packages. This was because it processed each design root in isolation, resulting in an incomplete map of definitions when resolving refs.

This commit refactors the generator to first build a global map of all type definitions from all design roots. This complete map is then used for the inlining process, ensuring that cross-package and cross-service references are correctly resolved.

A new test case, , has been added to verify this behavior and prevent regressions.

The docs plugin was failing to inline type references for types defined in other design packages. This was because it processed each design root in isolation, resulting in an incomplete map of definitions when resolving refs.

This commit refactors the generator to first build a global map of all type definitions from all design roots. This complete map is then used for the inlining process, ensuring that cross-package and cross-service references are correctly resolved.

A new test case, , has been added to verify this behavior and prevent regressions.
@raphael raphael force-pushed the fix/docs-inlining-cross-package branch 8 times, most recently from 28d962d to 9b8b805 Compare September 14, 2025 05:32
@raphael raphael force-pushed the fix/docs-inlining-cross-package branch from 9b8b805 to 0ee8bf4 Compare September 14, 2025 05:34
@raphael raphael merged commit 16d81c5 into v3 Sep 14, 2025
5 checks passed
@raphael raphael deleted the fix/docs-inlining-cross-package branch September 14, 2025 05:36
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