@jsenv/navi 0.30.36 → 0.30.37

package/dist/dev/jsenv_navi.js

@@ -30518,8 +30518,9 @@ const SCOPED_MANY_OPTIONS = new Set([
  *   policy as that verb, and is a write of its own for a dependent:
  *   `{ resource: ORDER, on: ["cancel"] }`. Its `rerunOn` says which reads of
  *   this resource it reruns (`{ GET_RANGE: true }`); a read it leaves out
- *   follows `rerunOn` for its verb. A name a verb takes, or one the resource
- *   already exposes (`withParams`, `store`…), throws. A `.scopedOne()` or
+ *   follows `rerunOn` for its verb. A verb's name in any case (`post`,
+ *   `get_many`…), or one the resource already exposes (`withParams`, `store`…),
+ *   throws. A `.scopedOne()` or
  *   `.scopedMany()` takes `writes` too, `.scopedMany()` with the plural verbs.
  * @param {{ GET?: { ms?: number, max?: number }, GET_MANY?: { ms?: number, max?: number } }} [restCallbacks.keep] -
  *   how long an answer of a read is trusted, coming back to the same params
@@ -32084,12 +32085,15 @@ ${name}.many("${propertyName}") source location: ${declarationSite}`,
 
   // expose one action per write named in `writes`
   if (writes) {
+    const membersExposed = Object.keys(stateFacade).filter(
+      (key) => !VERB_KEYS.includes(key),
+    );
     for (const [writeName, write] of Object.entries(writes)) {
       assertWriteCanBeNamed(
         name,
         writeName,
         write,
-        stateFacade,
+        membersExposed,
         namedWriteVerbs,
       );
       const { verb: writeVerb, callback, rerunOn: writeRerunOn } = write;
@@ -32402,7 +32406,7 @@ const assertWriteCanBeNamed = (
   name,
   writeName,
   write,
-  stateFacade,
+  membersExposed,
   namedWriteVerbs,
 ) => {
   const where = `resource(${name}) writes.${writeName}`;
@@ -32411,9 +32415,9 @@ const assertWriteCanBeNamed = (
       `${where}: "${writeName}" is a verb's name — a write named in "writes" takes a name of its own (cancel, archive…)`,
     );
   }
-  if (Object.hasOwn(stateFacade, writeName)) {
+  if (membersExposed.includes(writeName)) {
     throw new Error(
-      `${where}: the resource already exposes "${writeName}" — pick another name`,
+      `${where}: the resource already exposes "${writeName}" — a write takes a name none of its members has: ${membersExposed.join(", ")}`,
     );
   }
   if (!write || typeof write !== "object") {
@@ -92780,8 +92784,19 @@ const useItemStore = ({
   // was asked for, and the window keeps growing meanwhile: dropping what the
   // page did not cover empties items on screen.
   const staleRanksRef = useRef(null);
+  // A run standing for no item has no rank to mark: its count is what is from
+  // before, and no window frames anything that would ask for it again.
+  const countStaleRef = useRef(false);
+  const markHeldStale = () => {
+    staleRanksRef.current = new Set(pages.byIndex.keys());
+    countStaleRef.current = pages.count === 0;
+  };
   if (staleRanksRef.current === null) {
-    staleRanksRef.current = restored ? new Set(pages.byIndex.keys()) : new Set();
+    if (restored) {
+      markHeldStale();
+    } else {
+      staleRanksRef.current = new Set();
+    }
   }
   const takeInPage = ({
     pageItems,
@@ -92820,6 +92835,7 @@ const useItemStore = ({
       i++;
     }
     pages.count = pageCount;
+    countStaleRef.current = false;
     // Which rank holds which id, kept by the source so a list drawing
     // this collection again finds it drawn (see readComposition above).
     if (itemsAction.writeComposition) {
@@ -92855,7 +92871,7 @@ const useItemStore = ({
   const invalidationRef = useRef(invalidation);
   if (invalidationRef.current !== invalidation) {
     invalidationRef.current = invalidation;
-    staleRanksRef.current = new Set(pages.byIndex.keys());
+    markHeldStale();
   }
   // The one request in flight, with the means to call it off: a page asked for
   // a window the list has left is work the server and the browser are doing for
@@ -93053,7 +93069,8 @@ const useItemStore = ({
           rank++;
         }
       }
-      const revalidating = staleFrom !== -1;
+      const countStale = countStaleRef.current;
+      const revalidating = staleFrom !== -1 || countStale;
       // The list is held on an item nothing on screen leads to: the items it holds
       // do not contain it, so no window it could draw will ever bring it. Only
       // asking for it by name does.
@@ -93069,6 +93086,10 @@ const useItemStore = ({
         const from = typeof wanted.index === "number" ? rankOfIndex(wanted.index) - Math.floor(budget / 2) : 0;
         start = from < 0 ? 0 : from;
         end = start + budget - 1;
+      } else if (countStale) {
+        // Nothing drawn to anchor on: the first page, like the very first ask.
+        start = 0;
+        end = budget - 1;
       } else if (revalidating) {
         // The items from before that the window draws, and the missing ones
         // with them: one ask.
@@ -93270,6 +93291,7 @@ const useItemStore = ({
               staleRanksRef.current.delete(rank);
               rank++;
             }
+            countStaleRef.current = false;
             setRefreshing(false);
             return;
           }