Skip to content

docs(svelte-query): call 'useIsMutating' a function instead of a hook - #11559

Merged
sukvvon merged 1 commit into
mainfrom
docs/svelte-query-terminology
Sep 21, 2026
Merged

sukvvon merged 1 commit into
mainfrom
docs/svelte-query-terminology

Conversation

@sukvvon

@sukvvon sukvvon commented Sep 21, 2026

Copy link
Copy Markdown
Member

🎯 Changes

#11553 gave useIsFetching the summary shared with the React and Preact adapters, writing "hook" as "function" to match this adapter. Its sibling useIsMutating carries the near-identical sentence and kept "hook", so the two now contradict each other inside one package:

useIsFetching  The `useIsFetching` function returns the `number` of the queries…
useIsMutating  `useIsMutating` is an optional hook that returns the `number` of mutations…

This changes that one word.

"hook" is React and Preact terminology for these APIs. Svelte doesn't use it — its reactivity APIs are runes, and the only "hook" in svelte's own type definitions refers to preprocess build hooks. "function" is what this package already says elsewhere: createMutation is the function for that.

Not touched

  • useMutationState.svelte.ts says mutations "were created by a different component or hook instance". There "hook" means a call site rather than an API category, so "function instance" would read wrong; left as is.
  • query-core describes "a framework hook like useQuery" in Query, Mutation and MutationObserver. That's a framework-agnostic package referring to React/Vue/etc. generically and is correct as written, so those three class pages still contain the word after this PR.

Generated docs

pnpm run generate-docs updates the one corresponding page.

✅ 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
    • Clarified that useIsMutating is an optional function returning a reactive value, rather than an optional hook.
    • No runtime behavior changes.

@coderabbitai

coderabbitai Bot commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Review Change StackReview Change Stack

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: cc625257-5593-4122-80c1-3ae616fa1082

📥 Commits

Reviewing files that changed from the base of the PR and between 47f27a4 and c1680c5.

📒 Files selected for processing (2)
  • docs/framework/svelte/reference/functions/useIsMutating.md
  • packages/svelte-query/src/useIsMutating.svelte.ts

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


📝 Walkthrough

Walkthrough

The change replaces “optional hook” with “optional function” in the useIsMutating source documentation and Svelte reference documentation. Runtime behavior remains unchanged.

Changes

useIsMutating terminology

Layer / File(s) Summary
Documentation terminology update
packages/svelte-query/src/useIsMutating.svelte.ts, docs/framework/svelte/reference/functions/useIsMutating.md
Both documentation locations describe useIsMutating as an optional function instead of an optional hook.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~2 minutes

Change: Other

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description check ✅ Passed The description explains the terminology change, its motivation, affected documentation, generated-doc updates, testing status, checklist completion, and release impact. It is complete and aligned wit…
Title check ✅ Passed The title clearly and concisely identifies the main documentation change: describing useIsMutating as a function instead of a hook.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 1…
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.
✨ Finishing Touches
📝 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.

@sukvvon sukvvon self-assigned this Sep 21, 2026
@nx-cloud

nx-cloud Bot commented Sep 21, 2026

Copy link
Copy Markdown

View your CI Pipeline Execution ↗ for commit c1680c5

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

☁️ Nx Cloud last updated this comment at 2026-09-21 01:14:54 UTC

@github-actions

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

1 package(s) bumped directly, 24 bumped as dependents.

🟩 Patch bumps

Package Version Reason
@tanstack/query-core 5.103.1 → 5.103.2 Changeset
@tanstack/angular-query-experimental 5.103.1 → 5.103.2 Dependent
@tanstack/angular-query-persist-client 5.103.1 → 5.103.2 Dependent
@tanstack/eslint-plugin-query 5.103.1 → 5.103.2 Dependent
@tanstack/lit-query 0.2.22 → 0.2.23 Dependent
@tanstack/preact-query 5.103.1 → 5.103.2 Dependent
@tanstack/preact-query-devtools 5.103.1 → 5.103.2 Dependent
@tanstack/preact-query-persist-client 5.103.1 → 5.103.2 Dependent
@tanstack/query-async-storage-persister 5.103.1 → 5.103.2 Dependent
@tanstack/query-broadcast-client-experimental 5.103.1 → 5.103.2 Dependent
@tanstack/query-devtools 5.103.1 → 5.103.2 Dependent
@tanstack/query-persist-client-core 5.103.1 → 5.103.2 Dependent
@tanstack/query-sync-storage-persister 5.103.1 → 5.103.2 Dependent
@tanstack/react-query 5.103.1 → 5.103.2 Dependent
@tanstack/react-query-devtools 5.103.1 → 5.103.2 Dependent
@tanstack/react-query-next-experimental 5.103.1 → 5.103.2 Dependent
@tanstack/react-query-persist-client 5.103.1 → 5.103.2 Dependent
@tanstack/solid-query 5.103.1 → 5.103.2 Dependent
@tanstack/solid-query-devtools 5.103.1 → 5.103.2 Dependent
@tanstack/solid-query-persist-client 5.103.1 → 5.103.2 Dependent
@tanstack/svelte-query 6.2.1 → 6.2.2 Dependent
@tanstack/svelte-query-devtools 6.2.1 → 6.2.2 Dependent
@tanstack/svelte-query-persist-client 6.2.1 → 6.2.2 Dependent
@tanstack/vue-query 5.103.1 → 5.103.2 Dependent
@tanstack/vue-query-devtools 6.2.1 → 6.2.2 Dependent

@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@11559

@tanstack/eslint-plugin-query

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

@tanstack/lit-query

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

@tanstack/preact-query

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

@tanstack/preact-query-devtools

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

@tanstack/preact-query-persist-client

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

@tanstack/query-async-storage-persister

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

@tanstack/query-broadcast-client-experimental

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

@tanstack/query-core

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

@tanstack/query-devtools

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

@tanstack/query-persist-client-core

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

@tanstack/query-sync-storage-persister

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

@tanstack/react-query

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

@tanstack/react-query-devtools

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

@tanstack/react-query-next-experimental

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

@tanstack/react-query-persist-client

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

@tanstack/solid-query

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

@tanstack/solid-query-devtools

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

@tanstack/solid-query-persist-client

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

@tanstack/svelte-query

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

@tanstack/svelte-query-devtools

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

@tanstack/svelte-query-persist-client

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

@tanstack/vue-query

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

@tanstack/vue-query-devtools

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

commit: c1680c5

@github-actions

Copy link
Copy Markdown
Contributor

size-limit report 📦

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

@sukvvon
sukvvon merged commit 94de9b4 into main Sep 21, 2026
9 checks passed
@sukvvon
sukvvon deleted the docs/svelte-query-terminology branch September 21, 2026 01:16
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