Skip to content

docs(*): exclude protected members from generated reference docs - #11564

Open
sukvvon wants to merge 3 commits into
mainfrom
docs/exclude-protected-from-reference
Open

sukvvon wants to merge 3 commits into
mainfrom
docs/exclude-protected-from-reference

Conversation

@sukvvon

@sukvvon sukvvon commented Sep 21, 2026

Copy link
Copy Markdown
Member

🎯 Changes

scripts/generate-docs.ts already tells TypeDoc to drop private and @internal members, but not protected ones:

excludePrivate: true,
excludeProtected: true,   // added
excludeInternal: true,

So the reference pages documented internals that callers can't reach — Query.scheduleGc(), QueryObserver.bindMethods(), InfiniteQueryObserver.createResult() and friends. Several rendered their modifier right in the signature, e.g. protected fetch: ReplaceReturnType<…>.

Adding the option removes 217 method/property entries and 5,096 lines across the seven adapters, without touching any public API.

What disappears

Every removed member is declared protected in query-core:

Member Declared in
onSubscribe, onUnsubscribe, listeners subscribable.ts
scheduleGc, updateGcTime, clearGcTimeout removable.ts
optionalRemove mutation.ts
bindMethods, createResult, fetch (property) infiniteQueryObserver.ts
fetch (method) queryObserver.ts

Nothing is added, and no public member is dropped. fetch is the case worth checking: QueryObserver.fetch is protected and goes, while Query.fetch is public and stays — the option keys off the modifier, not the name.

Effect

Before After
classes/QueryObserver.md 651 lines 537 lines

Why this hides currently-published members

Opened as a draft, now ready, because it hides members that are currently published. The case for it is that these aren't callable from outside the class, so the pages describe implementation rather than API — but that's a maintainer call, and hideInherited/hideSources in #11533 were decided the same way.

✅ Checklist

  • I have followed the steps in the Contributing guide.
  • I have tested code changes locally with pnpm run test:pr, or these tests do not apply to this pull request.
  • I fully understand the code in this pull request, including any code generated with AI assistance.

🚀 Release Impact

  • This change affects published code, and I have generated a changeset.
  • This change is docs/CI/dev-only (no release).

Summary by CodeRabbit

  • Documentation
    • Updated generated API references across supported frameworks to omit protected members and inherited implementation details.
    • Public methods, properties, and runtime behavior remain unchanged.
    • Future reference documentation generation now consistently excludes protected members.

@coderabbitai

coderabbitai Bot commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Review in Change Stack →

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository: TanStack/query/.coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: 8d12051d-aa61-489d-bf17-2a83a8f6ad2a

📥 Commits

Reviewing files that changed from the base of the PR and between baf7cc6 and badf19c.

📒 Files selected for processing (71)
  • docs/framework/angular/reference/classes/InfiniteQueryObserver.md
  • docs/framework/angular/reference/classes/Mutation.md
  • docs/framework/angular/reference/classes/MutationCache.md
  • docs/framework/angular/reference/classes/MutationObserver.md
  • docs/framework/angular/reference/classes/QueriesObserver.md
  • docs/framework/angular/reference/classes/Query.md
  • docs/framework/angular/reference/classes/QueryCache.md
  • docs/framework/angular/reference/classes/QueryObserver.md
  • docs/framework/angular/reference/interfaces/FocusManager.md
  • docs/framework/angular/reference/interfaces/OnlineManager.md
  • docs/framework/lit/reference/classes/InfiniteQueryObserver.md
  • docs/framework/lit/reference/classes/Mutation.md
  • docs/framework/lit/reference/classes/MutationCache.md
  • docs/framework/lit/reference/classes/MutationObserver.md
  • docs/framework/lit/reference/classes/QueriesObserver.md
  • docs/framework/lit/reference/classes/Query.md
  • docs/framework/lit/reference/classes/QueryCache.md
  • docs/framework/lit/reference/classes/QueryObserver.md
  • docs/framework/lit/reference/interfaces/FocusManager.md
  • docs/framework/lit/reference/interfaces/OnlineManager.md
  • docs/framework/preact/reference/classes/InfiniteQueryObserver.md
  • docs/framework/preact/reference/classes/Mutation.md
  • docs/framework/preact/reference/classes/MutationCache.md
  • docs/framework/preact/reference/classes/MutationObserver.md
  • docs/framework/preact/reference/classes/QueriesObserver.md
  • docs/framework/preact/reference/classes/Query.md
  • docs/framework/preact/reference/classes/QueryCache.md
  • docs/framework/preact/reference/classes/QueryObserver.md
  • docs/framework/preact/reference/interfaces/FocusManager.md
  • docs/framework/preact/reference/interfaces/OnlineManager.md
  • docs/framework/react/reference/classes/InfiniteQueryObserver.md
  • docs/framework/react/reference/classes/Mutation.md
  • docs/framework/react/reference/classes/MutationCache.md
  • docs/framework/react/reference/classes/MutationObserver.md
  • docs/framework/react/reference/classes/QueriesObserver.md
  • docs/framework/react/reference/classes/Query.md
  • docs/framework/react/reference/classes/QueryCache.md
  • docs/framework/react/reference/classes/QueryObserver.md
  • docs/framework/react/reference/interfaces/FocusManager.md
  • docs/framework/react/reference/interfaces/OnlineManager.md
  • docs/framework/solid/reference/classes/InfiniteQueryObserver.md
  • docs/framework/solid/reference/classes/Mutation.md
  • docs/framework/solid/reference/classes/MutationCache.md
  • docs/framework/solid/reference/classes/MutationObserver.md
  • docs/framework/solid/reference/classes/QueriesObserver.md
  • docs/framework/solid/reference/classes/Query.md
  • docs/framework/solid/reference/classes/QueryCache.md
  • docs/framework/solid/reference/classes/QueryObserver.md
  • docs/framework/solid/reference/interfaces/FocusManager.md
  • docs/framework/solid/reference/interfaces/OnlineManager.md
  • docs/framework/svelte/reference/classes/InfiniteQueryObserver.md
  • docs/framework/svelte/reference/classes/Mutation.md
  • docs/framework/svelte/reference/classes/MutationCache.md
  • docs/framework/svelte/reference/classes/MutationObserver.md
  • docs/framework/svelte/reference/classes/QueriesObserver.md
  • docs/framework/svelte/reference/classes/Query.md
  • docs/framework/svelte/reference/classes/QueryCache.md
  • docs/framework/svelte/reference/classes/QueryObserver.md
  • docs/framework/svelte/reference/interfaces/FocusManager.md
  • docs/framework/svelte/reference/interfaces/OnlineManager.md
  • docs/framework/vue/reference/classes/InfiniteQueryObserver.md
  • docs/framework/vue/reference/classes/Mutation.md
  • docs/framework/vue/reference/classes/MutationCache.md
  • docs/framework/vue/reference/classes/MutationObserver.md
  • docs/framework/vue/reference/classes/QueriesObserver.md
  • docs/framework/vue/reference/classes/Query.md
  • docs/framework/vue/reference/classes/QueryCache.md
  • docs/framework/vue/reference/classes/QueryObserver.md
  • docs/framework/vue/reference/interfaces/FocusManager.md
  • docs/framework/vue/reference/interfaces/OnlineManager.md
  • scripts/generate-docs.ts
💤 Files with no reviewable changes (70)
  • docs/framework/angular/reference/classes/QueriesObserver.md
  • docs/framework/vue/reference/interfaces/OnlineManager.md
  • docs/framework/react/reference/classes/Query.md
  • docs/framework/preact/reference/classes/MutationCache.md
  • docs/framework/svelte/reference/classes/MutationCache.md
  • docs/framework/react/reference/interfaces/FocusManager.md
  • docs/framework/solid/reference/classes/QueriesObserver.md
  • docs/framework/react/reference/classes/MutationCache.md
  • docs/framework/svelte/reference/classes/QueriesObserver.md
  • docs/framework/preact/reference/interfaces/FocusManager.md
  • docs/framework/angular/reference/classes/MutationCache.md
  • docs/framework/lit/reference/interfaces/OnlineManager.md
  • docs/framework/angular/reference/interfaces/OnlineManager.md
  • docs/framework/lit/reference/classes/MutationObserver.md
  • docs/framework/lit/reference/classes/QueryCache.md
  • docs/framework/lit/reference/classes/QueriesObserver.md
  • docs/framework/react/reference/interfaces/OnlineManager.md
  • docs/framework/angular/reference/classes/Query.md
  • docs/framework/angular/reference/classes/Mutation.md
  • docs/framework/preact/reference/classes/QueryObserver.md
  • docs/framework/react/reference/classes/QueryObserver.md
  • docs/framework/preact/reference/classes/Mutation.md
  • docs/framework/vue/reference/classes/Mutation.md
  • docs/framework/angular/reference/classes/MutationObserver.md
  • docs/framework/react/reference/classes/QueryCache.md
  • docs/framework/solid/reference/classes/MutationCache.md
  • docs/framework/svelte/reference/interfaces/FocusManager.md
  • docs/framework/react/reference/classes/MutationObserver.md
  • docs/framework/svelte/reference/classes/Mutation.md
  • docs/framework/solid/reference/classes/MutationObserver.md
  • docs/framework/solid/reference/classes/InfiniteQueryObserver.md
  • docs/framework/vue/reference/classes/QueryCache.md
  • docs/framework/lit/reference/classes/MutationCache.md
  • docs/framework/angular/reference/interfaces/FocusManager.md
  • docs/framework/vue/reference/classes/QueriesObserver.md
  • docs/framework/react/reference/classes/QueriesObserver.md
  • docs/framework/solid/reference/interfaces/OnlineManager.md
  • docs/framework/vue/reference/classes/MutationObserver.md
  • docs/framework/lit/reference/classes/Query.md
  • docs/framework/svelte/reference/classes/MutationObserver.md
  • docs/framework/preact/reference/classes/QueriesObserver.md
  • docs/framework/vue/reference/classes/MutationCache.md
  • docs/framework/svelte/reference/interfaces/OnlineManager.md
  • docs/framework/svelte/reference/classes/QueryObserver.md
  • docs/framework/preact/reference/classes/QueryCache.md
  • docs/framework/angular/reference/classes/QueryObserver.md
  • docs/framework/lit/reference/interfaces/FocusManager.md
  • docs/framework/svelte/reference/classes/InfiniteQueryObserver.md
  • docs/framework/vue/reference/interfaces/FocusManager.md
  • docs/framework/solid/reference/classes/QueryCache.md
  • docs/framework/preact/reference/interfaces/OnlineManager.md
  • docs/framework/svelte/reference/classes/QueryCache.md
  • docs/framework/angular/reference/classes/InfiniteQueryObserver.md
  • docs/framework/vue/reference/classes/Query.md
  • docs/framework/react/reference/classes/InfiniteQueryObserver.md
  • docs/framework/solid/reference/interfaces/FocusManager.md
  • docs/framework/lit/reference/classes/Mutation.md
  • docs/framework/angular/reference/classes/QueryCache.md
  • docs/framework/vue/reference/classes/QueryObserver.md
  • docs/framework/lit/reference/classes/InfiniteQueryObserver.md
  • docs/framework/preact/reference/classes/Query.md
  • docs/framework/solid/reference/classes/Query.md
  • docs/framework/svelte/reference/classes/Query.md
  • docs/framework/lit/reference/classes/QueryObserver.md
  • docs/framework/react/reference/classes/Mutation.md
  • docs/framework/preact/reference/classes/MutationObserver.md
  • docs/framework/preact/reference/classes/InfiniteQueryObserver.md
  • docs/framework/vue/reference/classes/InfiniteQueryObserver.md
  • docs/framework/solid/reference/classes/Mutation.md
  • docs/framework/solid/reference/classes/QueryObserver.md

Included review availability: Your plan provides up to 10 included reviews per hour; 5 remain after this review.


📝 Walkthrough

Walkthrough

The TypeDoc configuration now excludes protected members. Generated Angular, Lit, Preact, React, Solid, Svelte, and Vue reference pages remove protected and inherited member entries. Runtime code and public API behavior are unchanged.

Changes

Protected API documentation cleanup

Layer / File(s) Summary
Protected-member exclusion configuration
scripts/generate-docs.ts
TypeDoc now uses excludeProtected: true when generating package reference documentation.
Observer reference cleanup
docs/framework/*/reference/classes/{InfiniteQueryObserver,MutationObserver,QueriesObserver,QueryObserver}.md
Generated references no longer list protected properties or methods such as listeners, bindMethods, createResult, fetch, onSubscribe, and onUnsubscribe.
Cache, lifecycle, and manager reference cleanup
docs/framework/*/reference/classes/{Mutation,MutationCache,Query,QueryCache}.md, docs/framework/*/reference/interfaces/{FocusManager,OnlineManager}.md
Generated references no longer list protected or inherited members from Removable and Subscribable, including garbage-collection methods, listeners, and subscription lifecycle hooks.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to badf1

This change removes protected members from generated reference documentation while preserving runtime behavior and the public API; it is ready to merge.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 1 functions across 1 files. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description check ✅ Passed The description clearly explains the addition of excludeProtected: true, identifies the documentation-only impact, and completes all required checklist and release-impact sections.
Title check ✅ Passed The title clearly and concisely describes the main change: excluding protected members from generated reference documentation.
  • Fix all pre-merge checks with AI
✨ Finishing Touches 💡 1
📝 Generate docstrings 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@nx-cloud

nx-cloud Bot commented Sep 21, 2026

Copy link
Copy Markdown

View your CI Pipeline Execution ↗ for commit badf19c

Command Status Duration Result
nx run-many --target=build --exclude=examples/*... ✅ Succeeded <1s View ↗
nx affected --targets=test:sherif,test:knip,tes... ✅ Succeeded 54s View ↗

☁️ Nx Cloud last updated this comment at 2026-09-22 02:42:30 UTC

@github-actions

github-actions Bot commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

@sukvvon sukvvon self-assigned this Sep 21, 2026
@pkg-pr-new

pkg-pr-new Bot commented Sep 21, 2026

Copy link
Copy Markdown
More templates

@tanstack/angular-query-experimental

npm i https://pkg.pr.new/@tanstack/angular-query-experimental@11564

@tanstack/eslint-plugin-query

npm i https://pkg.pr.new/@tanstack/eslint-plugin-query@11564

@tanstack/lit-query

npm i https://pkg.pr.new/@tanstack/lit-query@11564

@tanstack/preact-query

npm i https://pkg.pr.new/@tanstack/preact-query@11564

@tanstack/preact-query-devtools

npm i https://pkg.pr.new/@tanstack/preact-query-devtools@11564

@tanstack/preact-query-persist-client

npm i https://pkg.pr.new/@tanstack/preact-query-persist-client@11564

@tanstack/query-async-storage-persister

npm i https://pkg.pr.new/@tanstack/query-async-storage-persister@11564

@tanstack/query-broadcast-client-experimental

npm i https://pkg.pr.new/@tanstack/query-broadcast-client-experimental@11564

@tanstack/query-core

npm i https://pkg.pr.new/@tanstack/query-core@11564

@tanstack/query-devtools

npm i https://pkg.pr.new/@tanstack/query-devtools@11564

@tanstack/query-persist-client-core

npm i https://pkg.pr.new/@tanstack/query-persist-client-core@11564

@tanstack/query-sync-storage-persister

npm i https://pkg.pr.new/@tanstack/query-sync-storage-persister@11564

@tanstack/react-query

npm i https://pkg.pr.new/@tanstack/react-query@11564

@tanstack/react-query-devtools

npm i https://pkg.pr.new/@tanstack/react-query-devtools@11564

@tanstack/react-query-next-experimental

npm i https://pkg.pr.new/@tanstack/react-query-next-experimental@11564

@tanstack/react-query-persist-client

npm i https://pkg.pr.new/@tanstack/react-query-persist-client@11564

@tanstack/solid-query

npm i https://pkg.pr.new/@tanstack/solid-query@11564

@tanstack/solid-query-devtools

npm i https://pkg.pr.new/@tanstack/solid-query-devtools@11564

@tanstack/solid-query-persist-client

npm i https://pkg.pr.new/@tanstack/solid-query-persist-client@11564

@tanstack/svelte-query

npm i https://pkg.pr.new/@tanstack/svelte-query@11564

@tanstack/svelte-query-devtools

npm i https://pkg.pr.new/@tanstack/svelte-query-devtools@11564

@tanstack/svelte-query-persist-client

npm i https://pkg.pr.new/@tanstack/svelte-query-persist-client@11564

@tanstack/vue-query

npm i https://pkg.pr.new/@tanstack/vue-query@11564

@tanstack/vue-query-devtools

npm i https://pkg.pr.new/@tanstack/vue-query-devtools@11564

commit: badf19c

@github-actions

Copy link
Copy Markdown
Contributor

size-limit report 📦

Path Size
react full 11.87 KB (0%)
react minimal 8.85 KB (0%)

…d-from-reference

# Conflicts:
#	docs/framework/angular/reference/classes/InfiniteQueryObserver.md
#	docs/framework/angular/reference/classes/Mutation.md
#	docs/framework/angular/reference/classes/MutationCache.md
#	docs/framework/angular/reference/classes/MutationObserver.md
#	docs/framework/angular/reference/classes/QueriesObserver.md
#	docs/framework/angular/reference/classes/Query.md
#	docs/framework/angular/reference/classes/QueryCache.md
#	docs/framework/angular/reference/classes/QueryObserver.md
#	docs/framework/lit/reference/classes/InfiniteQueryObserver.md
#	docs/framework/lit/reference/classes/Mutation.md
#	docs/framework/lit/reference/classes/MutationCache.md
#	docs/framework/lit/reference/classes/MutationObserver.md
#	docs/framework/lit/reference/classes/QueriesObserver.md
#	docs/framework/lit/reference/classes/Query.md
#	docs/framework/lit/reference/classes/QueryCache.md
#	docs/framework/lit/reference/classes/QueryObserver.md
#	docs/framework/preact/reference/classes/InfiniteQueryObserver.md
#	docs/framework/preact/reference/classes/Mutation.md
#	docs/framework/preact/reference/classes/MutationCache.md
#	docs/framework/preact/reference/classes/MutationObserver.md
#	docs/framework/preact/reference/classes/QueriesObserver.md
#	docs/framework/preact/reference/classes/Query.md
#	docs/framework/preact/reference/classes/QueryCache.md
#	docs/framework/preact/reference/classes/QueryObserver.md
#	docs/framework/react/reference/classes/InfiniteQueryObserver.md
#	docs/framework/react/reference/classes/Mutation.md
#	docs/framework/react/reference/classes/MutationCache.md
#	docs/framework/react/reference/classes/MutationObserver.md
#	docs/framework/react/reference/classes/QueriesObserver.md
#	docs/framework/react/reference/classes/Query.md
#	docs/framework/react/reference/classes/QueryCache.md
#	docs/framework/react/reference/classes/QueryObserver.md
#	docs/framework/solid/reference/classes/InfiniteQueryObserver.md
#	docs/framework/solid/reference/classes/Mutation.md
#	docs/framework/solid/reference/classes/MutationCache.md
#	docs/framework/solid/reference/classes/MutationObserver.md
#	docs/framework/solid/reference/classes/QueriesObserver.md
#	docs/framework/solid/reference/classes/Query.md
#	docs/framework/solid/reference/classes/QueryCache.md
#	docs/framework/solid/reference/classes/QueryObserver.md
#	docs/framework/svelte/reference/classes/InfiniteQueryObserver.md
#	docs/framework/svelte/reference/classes/Mutation.md
#	docs/framework/svelte/reference/classes/MutationCache.md
#	docs/framework/svelte/reference/classes/MutationObserver.md
#	docs/framework/svelte/reference/classes/QueriesObserver.md
#	docs/framework/svelte/reference/classes/Query.md
#	docs/framework/svelte/reference/classes/QueryCache.md
#	docs/framework/svelte/reference/classes/QueryObserver.md
#	docs/framework/vue/reference/classes/InfiniteQueryObserver.md
#	docs/framework/vue/reference/classes/Mutation.md
#	docs/framework/vue/reference/classes/MutationCache.md
#	docs/framework/vue/reference/classes/MutationObserver.md
#	docs/framework/vue/reference/classes/QueriesObserver.md
#	docs/framework/vue/reference/classes/Query.md
#	docs/framework/vue/reference/classes/QueryCache.md
#	docs/framework/vue/reference/classes/QueryObserver.md
@sukvvon
sukvvon requested a review from TkDodo September 22, 2026 02:40
@sukvvon
sukvvon marked this pull request as ready for review September 22, 2026 02:40
@sukvvon
sukvvon requested a review from a team as a code owner September 22, 2026 02:40
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