@uniflowed/hooks 0.9.0 → 0.11.0

package/browser.js

@@ -55,7 +55,7 @@
 // | `usePermission` | `"unknown"` | what the browser answers |
 // | `useScrollLock` | nothing at all — effects do not run in a prerender | the page is held |
 //
-// `packages/hooks/hooks-ssr.test.js` renders every one of them in a process with
+// `npm/hooks/hooks-ssr.test.js` renders every one of them in a process with
 // no document and asserts the markup, so a row of this table that stopped being
 // true would fail there rather than in somebody's browser.
 //

package/index.js

@@ -111,8 +111,8 @@
 // cross-tab sync;
 // broadcast channels; the clipboard; a server-sent event stream, including the
 // one case the platform's own reconnection gives up on; the render anchor and
-// the seeded stream in `render.js`. `packages/hooks/hooks.test.js` covers
-// behaviour and cleanup, and `packages/hooks/hooks-ssr.test.js` renders the
+// the seeded stream in `render.js`. `npm/hooks/hooks.test.js` covers
+// behaviour and cleanup, and `npm/hooks/hooks-ssr.test.js` renders the
 // whole surface in a process that has no DOM at all.
 //
 // **Experimental.** `useGeolocation`, `useNetwork` and `usePermission`. The

package/lifecycle.js

@@ -28,6 +28,7 @@ import {
   useEffect,
   useInsertionEffect,
   useLayoutEffect,
+  useMemo,
   useRef,
   useState,
 } from "@uniflowed/react";
@@ -61,7 +62,14 @@ export hook useStableCallback<TArgs extends $ReadOnlyArray<mixed>, TReturn>(
     latest.current = callback;
   }, [callback]);
 
-  return useCallback((...args: TArgs) => latest.current(...args), []);
+  // `useMemo` over a function rather than `useCallback`: the same cache, and
+  // `useCallback`'s bound cannot hold a function generic in its arguments.
+  return useMemo(
+    () =>
+      (...args: TArgs) =>
+        latest.current(...args),
+    [],
+  );
 }
 
 /** The value from the previous render, or `undefined` on the first. */
@@ -72,8 +80,10 @@ export hook usePrevious<T>(value: T): T | void {
   }, [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
+  // uf-lint-disable react-compiler/refs
+  // $FlowExpectedError[react-rule-unsafe-ref] the same deliberate read, as Flow's React rules see it.
   return previous.current;
+  // uf-lint-enable react-compiler/refs
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniflowed/hooks",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "The React hooks an application writes anyway, prerender-safe, part of the Unified Toolchain for Flow.",
   "type": "module",
   "license": "MIT",
@@ -8,7 +8,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ubugeeei-prod/uf.git",
-    "directory": "packages/hooks"
+    "directory": "npm/hooks"
   },
   "exports": {
     ".": "./index.js",
@@ -28,8 +28,8 @@
     "!*.test.js"
   ],
   "dependencies": {
-    "@uniflowed/core": "0.9.0",
-    "@uniflowed/react": "0.9.0"
+    "@uniflowed/core": "0.11.0",
+    "@uniflowed/react": "0.11.0"
   },
   "peerDependencies": {
     "react": ">=19"

package/render.js

@@ -77,7 +77,7 @@
 // the price of the guarantee rather than an oversight. A render that has to be
 // reproducible fixes `at` and `seed` itself, which is what those two props are
 // for; `gives the same document however the host takes it` in
-// `packages/router/streaming.test.js` is a test that compares two renders and says
+// `npm/router/streaming.test.js` is a test that compares two renders and says
 // so.
 //
 // # What belongs in this module

package/state.js

@@ -396,7 +396,7 @@ function announce(key: string): void {
  * # Why this guard is written twice
  *
  * `@uniflowed/state`'s `createJSONStorage`
- * (`packages/state/internal/composed.js`) guards the same four hazards — a
+ * (`npm/state/internal/composed.js`) guards the same four hazards — a
  * storage property that throws, a read that throws, a write that throws, and
  * finding the object a `storage` event arrives on — and reaches the same
  * conclusions about each. Merging the two was considered and declined;