* docs(example): dataloader
* use tanstack pacer instead of dataloader
* add staleTime
* switch to useAsyncBatchedCallback
* Revert "switch to useAsyncBatchedCallback"
This reverts commit 4d408daa63.
* fix: use PromiseWithResolvers
* add batching example to docs
* docs(svelte): replace deprecated isLoading with isPending in overview
`isLoading` is a deprecated alias for `isPending && isFetching` and is
scheduled for removal in the next major version. The overview example
shows a standard (always-enabled) query, so `isPending` is the correct
flag. All other framework overview docs (React, Vue, Angular, Lit,
Preact) already use `isPending`.
Note: `isLoading` is intentionally retained in disabling-queries guides
where it is the right flag for disabled/lazy queries.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* docs(preact): add missing polling guide
The Polling guide existed for React, Vue, Solid, and Angular but was
missing from the Preact docs. Added the ref stub and wired it into
the nav config between Window Focus Refetching and Disabling Queries,
matching the ordering used by all other frameworks.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
* feat lit-query: add initial lit-query package
* remove internal docs from initial PR
* fix review issues
* align scripts with monorepo Nx targets and use workspace:* for query-core
* feat(lit-query): fix type inference and monorepo integration
- Fix createQueriesController tuple type inference with recursive types
- Add DataTag support to queryOptions
- Fix build config and vitest custom-condition resolution
- Fix example install scripts for standalone bootstrap
* fix(lit-query): polish package validation and examples
* ci: apply automated fixes
* lit-query: preserve provider handshake ordering in BaseController
* Update .changeset/lemon-memes-divide.md
Co-authored-by: Dominik Dorfmeister 🔮 <office@dorfmeister.cc>
* removing prettier config from adapter, so that global config from the monorepo is used
* removed the package local format scripts so formatting stays centralized at the monorepo root
* removing like other adapters keep build and test:build as separate targets
* Compared against the other adapters and removed the lit-query-only aliases/gates, keeping the standard Nx target names so root CI can pick them up consistently
* package:check has been removed. The CJS smoke check is still needed because lit-query publishes custom CJS output/types
* fix(lit-query): align lit examples and integration with monorepo conventions
* chore(lit-query): clean up stale package checks
* fix(lit-query): address review feedback for lit examples and lifecycle tests
* chore: fix lockfile
* fix: add customCondition
* docs(lit-query): add Lit docs and generated reference
* docs(lit-query): fix Lit docs review comment and align examples
---------
Co-authored-by: gauravchugh <gauravchugh@servicenow.com>
Co-authored-by: Dominik Dorfmeister 🔮 <office@dorfmeister.cc>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
* feat(vue-query): add 'mutationOptions'
* ci: apply automated fixes
* chore(.changeset): add changeset for 'mutationOptions' in vue-query
* feat(vue-query/mutationOptions): add getter support and fix test descriptions to match actual behavior
* refactor(vue-query): rename 'VueMutationOptions' to 'MutationOptions'
* docs(vue-query): add 'mutationOptions' reference page
* test(vue-query/mutationOptions): add runtime test for getter without 'mutationKey'
* docs(vue-query): add 'mutationOptions' to config.json navigation
---------
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
* docs(react): add polling guide
Adds a dedicated guide for refetchInterval-based polling. The option was
only mentioned in passing in important-defaults.md with no explanation of
how it works, how to adapt it dynamically, or how it interacts with window
focus, networkMode, and the enabled flag.
Covers:
- Basic setup and independence from staleTime
- Dynamic intervals via function form
- refetchIntervalInBackground for dashboards / always-on UIs
- Disabling window-focus refetching for fullscreen game and kiosk UIs
- Pausing polling with the enabled flag
- networkMode: 'always' for unreliable navigator.onLine environments
- Deduplication behavior across multiple observers
Updates config.json to add the guide to the React sidebar between
Window Focus Refetching and Disabling/Pausing Queries.
Adds a cross-reference in important-defaults.md.
* docs(react/polling): add example markers for framework portability
* docs(react): fix deduplication note — timers are per observer, not per query
* docs(react): address review feedback on polling guide
- Remove staleTime enumeration; link to Important Defaults instead
- Remove game/kiosk focus management examples (scope creep)
- Rewrite pausing polling to use refetchInterval function instead of enabled: false
- Fix offline support section: connectivity uses online/offline events, not navigator.onLine
- Fix deduplication note: remove queuing implication and em dash
- Add non-browser environments note pointing to React Native guide
* docs(solid,vue): add polling guide framework ports
* docs: wrap React Native section in markers for framework port exclusion
* ci: apply automated fixes
---------
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
* feat(svelte-query/mutationOptions): add 'mutationOptions' identity function for type-safe mutation configuration
* test(svelte-query/mutationOptions): add type and runtime tests for 'mutationOptions'
* docs(svelte-query/mutationOptions): add reference documentation for 'mutationOptions'
* chore(svelte-query): add changeset for 'mutationOptions'
* ci: apply automated fixes
* test(svelte-query/mutationOptions): use 'Accessor' type for props in BaseExample and wrap test values with arrow functions
* style(svelte-query/mutationOptions): remove blank lines between 'fireEvent' and assertion blocks
* refactor(svelte-query/mutationOptions): split BaseExample into BaseExample and MultiExample for single and multi mutation tests
* ci: apply automated fixes
---------
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
* add community resources page
* update link for blog posts
* update community resource links
* rm vue community section
* update old links
* fix community resource link
* add timeoutManager class
* add additional types & export functions
* convert all setTimeout/setInterval to managed versions
* tweaks
* add claude-generated tests
* tests
* revert changes in query-async-storage-persister: no path to import query-core
* re-export more types
* console.warn -> non-production console.error
* query-async-storage-persister: use query-core managedSetTimeout
* pdate pnpm-lock for new dependency edge
* sleep: always managedSetTimeout
* remove managed* functions, call method directly
* remove runtime coercion and accept unsafe any within TimeoutManager class
* cleanup; fix test after changes
* name is __TEST_ONLY__
* notifyManager: default scheduler === systemSetTimeoutZero
* Improve TimeoutCallback comment since ai was confused
* remove unnecessary timeoutManager-related exports
* prettier-ify index.ts (seems my editor messed with it already this pr?)
* continue to export defaultTimeoutProvider for tests
* oops missing import
* fix: export systemSetTimeoutZero from core
* ref: use notifyManager.schedule in createPersister
because it needs to work with whatever scheduleFn we have set there
* ref: move provider check behind env check
* docs
* doc tweaks
* doc tweaks
* docs: reference timeoutManager in discussion of 24 day setTimout limit
* Apply suggestion from @TkDodo
* Apply suggestion from @TkDodo
* chore: fix broken links
* docs: syntax fix
---------
Co-authored-by: Dominik Dorfmeister <office@dorfmeister.cc>
Fix broken navigation where clicking "Does this replace state managers?"
in Solid docs incorrectly redirected to Angular guide instead of the proper Solid guide page.
* feat(react-query): add mutationOptions
* test(react-query): add DataTag test case
* fix(react-query): remove unnecessary types from mutation
* fix(react-query): remove unncessary type overload
* chore(react-query): add mutationOptions to barrel file
* fix(react-query): fix test eslint issue
* docs(react-query): add more examples
* test(react-query): add more test cases
* chore(react-query): Change mutaitonKey to required
* fix(react-query): fix test code type error
* test(react-query): add testcase when used with other mutation util
* fix(react-query): fix error test code and avoid use deprecateed method
* fix(react-query): fix error test code and avoid use deprecateed method
* fix(react-query): fix import detect error
* fix(react-query): fix import detect error
* fix(react-query): add function overload
* test(react-query): fix mutation options test code
* Update docs/framework/react/typescript.md
* Update docs/framework/react/reference/mutationOptions.md
* Update docs/framework/react/typescript.md
* fix: update mutationOptions type definition to allow optional mutationKey with restricting filter when mutationKey wasn't passed
* ci: apply automated fixes
* chore: add Nick-Lucas as co-author
Co-authored-by: Nick Lucas <8896153+Nick-Lucas@users.noreply.github.com>
* test(react-query): fix test code and add used with useMutation without mutationKey
* Update packages/react-query/src/__tests__/mutationOptions.test-d.tsx
* docs: add mutationOptions to sidebar config
---------
Co-authored-by: Dominik Dorfmeister <office@dorfmeister.cc>
Co-authored-by: Jonghyeon Ko <manudeli.ko@gmail.com>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
Co-authored-by: Nick Lucas <8896153+Nick-Lucas@users.noreply.github.com>
* docs(svelte-query): add the devtools page to the svelte-query docs
* docs(svelte-query): remove the angular stuff, what is skipped
---------
Co-authored-by: Lachlan Collins <1667261+lachlancollins@users.noreply.github.com>
* feat(react-query-dev-tools): Add ReactQueryDevToolsPanel support
Devtools Embedded Support is finally here!
Embedded Mode will embed the devtools as a regular component in your application. You can style it however you'd like after that!
---------
Co-authored-by: Aryan Deora <adeora@iu.edu>
* feat(eslint-plugin-query): add rule that disallows putting the result of useMutation directly in a React hook dependency array
* add doc
* add rule to recommended rules
* generalize to all affected query hooks
* rename rule to "no-unstable-deps"