@jsenv/navi 0.29.310 → 0.29.312

package/docs/actions.md

@@ -325,10 +325,17 @@ Which instance that is depends on whether the control carries a value:
   what it runs **is** the instance it was handed. `useActionStatus` on that
   instance sees the click, the run, the data.
 - a control that **carries a value** — an input, a form — runs the child
-  instance bound to that value. Those params are not the caller's, so neither
-  is the status: the instance the caller holds stays idle while the control's
-  run moves. Read the effect where it lands (the store, for a resource verb),
-  or listen to the run itself, below.
+  instance bound to that value: the value merged over the params the caller
+  bound, and a value that is not an object **replaces them outright**. A
+  checkbox handed `ACTION.bindParams({ id })` runs `ACTION(true)`, and `id`
+  is gone — the call fails wherever it needed it, far from the binding that
+  lost it. Bind params to a control that holds a value only when the value
+  completes them (a form's object over a bound `{ id }`); when it would
+  replace them, pass a function and keep the params in its closure:
+  `action={() => ACTION({ id, sure: true })}`. Those params are not the
+  caller's, so neither is the status: the instance the caller holds stays idle
+  while the control's run moves. Read the effect where it lands (the store,
+  for a resource verb), or listen to the run itself, below.
 
 Every control with an `action` reports the run it performs, whichever instance
 that is:

package/docs/data_states.md

@@ -57,7 +57,11 @@ consequence: the component stays, so it is still there to offer the way out.
 
 A component that delegates nothing needs no `<Loading>` above it. One that
 delegates its wait does, since that is where the suspension lands, and navi says
-so rather than leaving the subtree blank.
+so rather than leaving the subtree blank. Inside a popup that boundary is the
+popup's own — `{ loading: true }`, or a `<Loading>` inside the popup — never
+the one above the page: a suspension landing there takes the popup away with
+the page it copies, and the popup does not open at all (see
+[popup_open.md](./popup_open.md#a-popup-that-loads-data)).
 
 ## `data` and `loading` are independent
 

package/package.json

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