@uniflowed/hooks 0.0.0-alpha.40 → 0.0.0-alpha.42

package/async.js

@@ -118,6 +118,9 @@ export hook useAsync<T>(
     // Guarded rather than unconditional: a reload that arrives while a call is
     // already in flight would otherwise build a new state object, and a new
     // object is a re-render that changes nothing anyone can see.
+    // This effect owns the request lifecycle; the synchronous write marks that
+    // external request as pending before its callbacks settle it.
+    // uf-lint-disable-next-line react-compiler/set-state-in-effect
     setState((current) => (current.pending ? current : { ...current, pending: true }));
 
     const run = (tries: number) => {

package/events.js

@@ -213,6 +213,8 @@ export hook useEventSource(url: string | null, options?: EventSourceOptions): Us
   useEffect(() => {
     const Constructor = streamConstructor();
     if (Constructor == null || url == null || !enabled) {
+      // The connection state mirrors whether the external stream exists.
+      // uf-lint-disable-next-line react-compiler/set-state-in-effect
       setStatus(stopped ? "closed" : "idle");
       return;
     }

package/lifecycle.js

@@ -70,6 +70,9 @@ export hook usePrevious<T>(value: T): T | void {
   useEffect(() => {
     previous.current = value;
   }, [value]);
+  // This hook's public value is the last committed render; reading the ref
+  // during render is the contract rather than hidden reactive input.
+  // uf-lint-disable-next-line react-compiler/refs
   return previous.current;
 }
 
@@ -83,6 +86,9 @@ export hook usePrevious<T>(value: T): T | void {
 export hook useMounted(): boolean {
   const [mounted, setMounted] = useState(false);
   useEffect(() => {
+    // The first client render intentionally matches the server, then flips
+    // after mount for hydration-sensitive values.
+    // uf-lint-disable-next-line react-compiler/set-state-in-effect
     setMounted(true);
   }, []);
   return mounted;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniflowed/hooks",
-  "version": "0.0.0-alpha.40",
+  "version": "0.0.0-alpha.42",
   "description": "The React hooks an application writes anyway, prerender-safe, part of the Unified Toolchain for Flow.",
   "type": "module",
   "license": "MIT",
@@ -28,8 +28,8 @@
     "!*.test.js"
   ],
   "dependencies": {
-    "@uniflowed/core": "0.0.0-alpha.40",
-    "@uniflowed/react": "0.0.0-alpha.40"
+    "@uniflowed/core": "0.0.0-alpha.42",
+    "@uniflowed/react": "0.0.0-alpha.42"
   },
   "peerDependencies": {
     "react": ">=19"

package/timing.js

@@ -306,6 +306,9 @@ export hook useNow(millis: number | null = 1000, serverValue: Date | null = null
 
   useEffect(() => {
     if (since != null) {
+      // A prerender starts from the server's timestamp for hydration, then
+      // adopts the live clock once effects can run.
+      // uf-lint-disable-next-line react-compiler/set-state-in-effect
       setNow(new Date(currentClock().now()));
     }
   }, [since]);
@@ -427,6 +430,9 @@ export hook useTimeAgo(
 
   const wanted = cadence(Math.abs(now.getTime() - instant));
   useEffect(() => {
+    // The schedule is derived from the ticking external clock. Storing it here
+    // lets the interval slow down without adding a second clock source.
+    // uf-lint-disable-next-line react-compiler/set-state-in-effect
     setSchedule(wanted);
   }, [wanted]);