@jsenv/navi 0.30.25 → 0.30.26

package/docs/actions.md

@@ -229,6 +229,10 @@ delay to hide it:
 
 A "check now" wired to `run()` therefore checks nothing, silently.
 
+`run()`, `rerun()` and `prerun()` answer the way the callback does: a promise when it is asynchronous, even
+when `run()` joins an answer the instance already holds, so `ACTION.run().catch(…)`
+holds in every state; the data itself, synchronously, when it is synchronous.
+
 ### Aborting saves resources, it does not undo
 
 `abort()` cancels what can still be cancelled — a `fetch` wired to the

package/docs/dynamic_import.md

@@ -112,6 +112,24 @@ render.**
    };
    ```
 
+   The binding `actionRunEffect` returns holds the state's question: while the
+   state says no, it has nothing to ask, and a reader on it waits forever. That
+   is right when the state is the only thing that asks. When something else asks
+   too (a reader with `run: true` that does not follow that state, the code of a
+   section every profile with cups draws, asked ahead because mine has some),
+   the effect runs the action and the readers read the question that always
+   stands, `true` for a param-less action. Both are the same instance, so the
+   code is fetched once:
+
+   ```jsx
+   const PALMARES_CODE_ACTION = createAction(() =>
+     import("./palmares.jsx").then((m) => m.Palmares),
+   );
+   actionRunEffect(PALMARES_CODE_ACTION, () => myCupsSignal.value.length > 0);
+   const PALMARES_CODE = PALMARES_CODE_ACTION.bindParams(true);
+   // useAsyncData(PALMARES_CODE, { run: hasPalmares, loading: true })
+   ```
+
 3. **Nothing above the component asks** → `useAsyncData` with a function, the
    fallback: the component's own existence is the only thing that asks, so the
    request is its own, for the life of the instance.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/navi",
-  "version": "0.30.25",
+  "version": "0.30.26",
   "type": "module",
   "description": "Library of components including navigation to create frontend applications",
   "repository": {