@jsenv/navi 0.29.92 → 0.29.94

package/docs/AI_INSTRUCTIONS.md

@@ -146,8 +146,9 @@ consistency across the app, not from any single call site.
   `canSendWhileUnchanged` because a submit "does nothing".
 - `distributeChildStates` on a group — the way down asked once for ALL the
   children, when they cannot be placed one at a time (four seats where who sits
-  down decides who moves). The mirror of `aggregateChildStates`; see
-  control_object.md. Read it before writing a `uiAction` whose only job is to
+  down decides who moves), and asked again whenever one of them speaks, so the
+  other views of the same answer follow. The mirror of `aggregateChildStates`;
+  see control_object.md. Read it before writing a `uiAction` whose only job is to
   translate. Two neighbouring questions have answers already: a yes/no shown as
   two rows needs no translation (`List.Item value={true}` beside
   `value={false}` IS a boolean control), and a cross that means "back to the

package/docs/control_object.md

@@ -164,6 +164,19 @@ distributeChildStates: (groupValue, children) => new Map([[child, state], …])
 the mirror of `aggregateChildStates`, which already sees every child. A child
 the Map does not name is left where it is. Given both, the plural one wins.
 
+**It closes the loop, which the per-child one does not.** A group with a plural
+distribute holds ONE answer its children are views OF — a list saying who plays,
+four seats saying who sits where — rather than a value that IS what they said.
+So when one view speaks, the answer moves and **the other views are placed
+again**; the one that just acted is left where the user put it. Without that, a
+seat keeps showing somebody the list no longer holds, and nothing says so.
+
+This is the same rule as "a child arriving after the value did is placed from
+what the group holds", for a child that was there when the value moved without
+it. It matters most inside a picker's popup, where nothing else would bring the
+value back down: a picker's value IS what the control in its popup holds, so the
+façade never echoes it back.
+
 A group with an `aggregateChildStates` of its own is outside all of this: what
 it returns is taken as the truth, `undefined` included. That is the one way such
 a group says **"I have nothing to say yet"** — return `undefined` while the

package/package.json

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