@mapled/react 0.1.0 → 0.1.3

package/README.md

@@ -112,7 +112,7 @@ export function Post() {
 ```
 
 - `useSingle(key, options?)` — `data` is the single's record, or `null` while it is empty.
-- `useRecords(collection, options?)` — `data` is `{ records, total, release }`; options are the client's: `filter`, `sort`, `limit`, `offset`, `fields`, `expand`.
+- `useRecords(collection, options?)` — `data` is `{ records, total, release }`; options are the client's: `filter`, `sort`, `limit`, `offset`, `fields`, `expand`, `locale` (read in one of the project's languages; `createClient({ key, locale })` for every read).
 - `useRecord(collection, { slug } | { id } | null, options?)` — `data` is `null` when the record isn't published; `null` instead of a reference reads nothing (a router param that hasn't arrived).
 - Components that ask for the same thing share one request; an inline options object is the same read on every render.
 - Rich text values are Markdown — render them with a Markdown component, never as raw HTML.
@@ -158,7 +158,7 @@ export function LiveApp() {
 }
 ```
 
-Each open tab then asks Mapled for the release pointer once a minute (`live={{ interval: 30 }}` for thirty seconds, never under fifteen) while it is visible, and the hooks read again — pinned to the new release — when it moves; what was on screen stays there until the new answer arrives. It is off by default because every check is a request of the delivery key's budget (1,200 a minute).
+Each open tab then asks Mapled for the release pointer once a minute (`live={{ interval: 30 }}` for thirty seconds, never under fifteen) while it is visible, and the hooks read again — pinned to the new release — when it moves; what was on screen stays there until the new answer arrives. The watch starts from the release the hooks' reads answered, so a publish that landed between them and the first check, or while a tab opened in the background waited to be shown, is heard at once. It is off by default because every check is a request of the delivery key's budget (1,200 a minute).
 
 ## Forms
 

package/dist/index.js

@@ -71,6 +71,7 @@ export function MapledProvider({ client, live = false, children }) {
     useEffect(() => {
         let mounted = true;
         setRelease(undefined);
+        followed.current = undefined;
         setPreview(null);
         client.isPreview().then((on) => mounted && setPreview(on), () => mounted && setPreview(false));
         return () => {
@@ -79,11 +80,18 @@ export function MapledProvider({ client, live = false, children }) {
     }, [client]);
     const interval = typeof live === "object" ? live.interval : undefined;
     const watching = Boolean(live) && preview === false;
+    // the newest release the page followed: a watch restarted for a new pace starts there
+    const followed = useRef(undefined);
     useEffect(() => {
         // drafts have no releases to follow
         if (!watching)
             return;
-        return client.watch((next) => setRelease(next.release), { interval });
+        // where the page is, the client knows from the hooks' reads (`x-mapled-release`): a publish between them and
+        // the watch's first answer, or while a background tab waited to be shown, is news, and the hooks read again
+        return client.watch((next) => {
+            followed.current = Math.max(next.release, followed.current ?? 0);
+            setRelease(next.release);
+        }, { interval, from: followed.current });
     }, [client, watching, interval]);
     const value = useMemo(() => ({ client, store, release, preview }), [client, store, release, preview]);
     return createElement(MapledContext.Provider, { value }, children);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapled/react",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "React helpers for Mapled — published content in a React single-page app (Vite and the like): a provider and hooks over @mapled/client, with preview and publish notifications.",
   "license": "MIT",
   "homepage": "https://mapled.io",
@@ -36,7 +36,7 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@mapled/client": "^0.1.0"
+    "@mapled/client": "^0.3.0"
   },
   "peerDependencies": {
     "react": ">=18"