@raf-query/react 0.10.1 → 0.10.2

package/CHANGELOG.md

@@ -1,14 +1,21 @@
 # Changelog
 
+## [0.10.2](https://github.com/KATT/raf-query/compare/0.10.1...0.10.2) (2026-10-16)
+
+### Features
+
+* **react:** re-render useQuery readers of the thenable's status when the first load settles (2/3) ([#198](https://github.com/KATT/raf-query/issues/198)) ([436d83c](https://github.com/KATT/raf-query/commit/436d83cfd6a3944265eb56d5597c322342c5a6c6))
+* **react:** type useQuery's promise as a Thenable (1/3) ([#200](https://github.com/KATT/raf-query/issues/200)) ([47e5309](https://github.com/KATT/raf-query/commit/47e530957565a2bd345642ae7a4be5d3c501ffb2))
+
 ## [0.10.1](https://github.com/KATT/raf-query/compare/0.10.0...0.10.1) (2026-10-16)
 
 ### Features
 
-* **core:** export QueryClient, dehydrate, hydrate, allKeyed and the useQuery controls from @raf-query/core ([#193](https://github.com/KATT/raf-query/issues/193)) ([54492ab](https://github.com/KATT/raf-query/commit/54492abbe2966a0645e8a4c77f9c5ab31d6e3a20)), references [#194](https://github.com/KATT/raf-query/issues/194)
+- **core:** export QueryClient, dehydrate, hydrate, allKeyed and the useQuery controls from @raf-query/core ([#193](https://github.com/KATT/raf-query/issues/193)) ([54492ab](https://github.com/KATT/raf-query/commit/54492abbe2966a0645e8a4c77f9c5ab31d6e3a20)), references [#194](https://github.com/KATT/raf-query/issues/194)
 
 ### Documentation
 
-* React Router client-only and server sections with one server client per request, Effect under Integrations, official docs links, and ensure waits like fetch in server-only code ([#192](https://github.com/KATT/raf-query/issues/192)) ([841ffcf](https://github.com/KATT/raf-query/commit/841ffcf4d0fa0a40dfc58dc65bfcfadca8948874)), references [#190](https://github.com/KATT/raf-query/issues/190)
+- React Router client-only and server sections with one server client per request, Effect under Integrations, official docs links, and ensure waits like fetch in server-only code ([#192](https://github.com/KATT/raf-query/issues/192)) ([841ffcf](https://github.com/KATT/raf-query/commit/841ffcf4d0fa0a40dfc58dc65bfcfadca8948874)), references [#190](https://github.com/KATT/raf-query/issues/190)
 
 ## [0.10.0](https://github.com/KATT/raf-query/compare/0.9.2...0.10.0) (2026-10-16)
 

package/dist/use-query.d.mts

@@ -1,7 +1,7 @@
-import { DataOf, ErrorOf, QueryFactory, QueryHandle, QueryHandleWithData, ThrowsOnError, UseQueryControls, UseQueryOptions, UseQueryThrowOptions } from "@raf-query/core";
+import { DataOf, ErrorOf, QueryFactory, QueryHandle, QueryHandleWithData, Thenable, ThrowsOnError, UseQueryControls, UseQueryOptions, UseQueryThrowOptions } from "@raf-query/core";
 import { Result } from "effect";
 //#region src/use-query.d.ts
-export type UseQueryResult<TFactory extends QueryFactory, TThrow extends boolean | undefined = undefined> = ThrowsOnError<TFactory, TThrow> extends true ? readonly [promise: Promise<DataOf<TFactory>>, controls: UseQueryControls<TFactory>] : readonly [promise: Promise<Result.Result<DataOf<TFactory>, ErrorOf<TFactory>>>, controls: UseQueryControls<TFactory>];
+export type UseQueryResult<TFactory extends QueryFactory, TThrow extends boolean | undefined = undefined> = ThrowsOnError<TFactory, TThrow> extends true ? readonly [promise: Thenable<DataOf<TFactory>>, controls: UseQueryControls<TFactory>] : readonly [promise: Thenable<Result.Result<DataOf<TFactory>, ErrorOf<TFactory>>>, controls: UseQueryControls<TFactory>];
 /** {@link useQuery}'s result for a handle from `ensure` or `fetch`. */
 export type UseQueryResultWithData<TFactory extends QueryFactory, TThrow extends boolean | undefined = undefined> = ThrowsOnError<TFactory, TThrow> extends true ? readonly [data: DataOf<TFactory>, controls: UseQueryControls<TFactory>] : readonly [result: Result.Result<DataOf<TFactory>, ErrorOf<TFactory>>, controls: UseQueryControls<TFactory>];
 /**
@@ -26,7 +26,15 @@ export type UseQueryResultWithData<TFactory extends QueryFactory, TThrow extends
  * The promise is stable per data version and already fulfilled once the
  * cache has data, so `use()` only suspends while there is nothing to show.
  * The component re-renders when the promise changes, and when a control it
- * has read changes; changes to controls it never reads are skipped.
+ * has read changes; changes to controls it never reads are skipped. A
+ * first load settles its pending promise in place: that counts as a change
+ * once the component has read the promise's `status`, `value` or `reason`,
+ * so reading them without `use()` re-renders when the data lands:
+ *
+ * ```tsx
+ * const [tagPromise] = useQuery(tagQuery, loaderData.tag);
+ * const tag = tagPromise.status === "fulfilled" ? tagPromise.value : "…";
+ * ```
  *
  * A handle from `ensure` or `fetch` already has its data, so the hook
  * unwraps the promise itself and returns the data (or `Result`):

package/dist/use-query.mjs

@@ -51,10 +51,10 @@ function useQuery(factory, handle, options = {}) {
 	if (!throwOnError) {
 		const resultPromise = resultThenable(result.promise);
 		if (withData) return [use(resultPromise), controls];
-		return [resultPromise, controls];
+		return [QueryObserver.trackThenable(observer, resultPromise), controls];
 	}
 	if (withData) return [use(result.promise), controls];
-	return [result.promise, controls];
+	return [QueryObserver.trackThenable(observer, result.promise), controls];
 }
 //#endregion
 export { useQuery };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raf-query/react",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "React bindings for raf-query, a render-as-you-fetch query library",
   "keywords": [
     "query",
@@ -48,7 +48,7 @@
     }
   },
   "dependencies": {
-    "@raf-query/core": "0.10.1"
+    "@raf-query/core": "0.10.2"
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.170.0",