@jsenv/navi 0.29.510 → 0.29.512

package/dist/dev/jsenv_navi.js

@@ -41814,7 +41814,11 @@ const RouteTravel = ({
       // by CSS until then, so an empty hand here costs nothing: there is
       // nothing to stop, only nowhere to put them yet.
       animations: null,
-      ended: false
+      ended: false,
+      // The box as it set off, kept rather than read from the ref: the
+      // navigation a travel asks for can take the box down (see the update
+      // callback), and the name it wears is still given back to it.
+      element: elementRef.current
     };
     travelRef.current = travel;
     // A press landing on a playing travel lands on the document root: the box
@@ -41830,7 +41834,7 @@ const RouteTravel = ({
     });
     // Whether the document's offset is this row's business at all (see
     // pagesScrollTheDocument), asked once and before anything is swapped.
-    travel.scrollsDocument = pagesScrollTheDocument(elementRef.current);
+    travel.scrollsDocument = pagesScrollTheDocument(travel.element);
     if (travel.scrollsDocument) {
       // One of the tabs is about to be swapped out from under that scrollport,
       // and whatever the browser does with the offset meanwhile — clamping it
@@ -41847,7 +41851,7 @@ const RouteTravel = ({
     // at the same moment and for the same reason: whoever names something for
     // a movement between two pages decides on it now (see
     // transition_destination.js).
-    nameForTravel(elementRef.current);
+    nameForTravel(travel.element);
     holdTransitionDestination(travel, page.route.buildUrl(page.params));
     document.documentElement.setAttribute(TRAVEL_ATTRIBUTE, direction);
     document.documentElement.setAttribute(TRAVEL_AXIS_ATTRIBUTE, axis);
@@ -41859,7 +41863,7 @@ const RouteTravel = ({
     // The box as it stands before anything moves, and the band the furniture
     // around it leaves free: rendering is held, so both are still the page
     // being left (see transition_window.js).
-    const stateBefore = measureTransitionWindowState(elementRef.current);
+    const stateBefore = measureTransitionWindowState(travel.element);
     // The hold a navigation already took, if this travel is the answer to one:
     // taking another would be taking a hold on a page that is holding still.
     const releaseRendering = takeoverRoutingRenderingHold();
@@ -41897,6 +41901,19 @@ const RouteTravel = ({
         } = travel.page;
         arriveAtScrollPosition(route.buildUrl(params));
       }
+      // The box itself may be gone: rendered inside one of the pages of its
+      // row rather than around them, it went down with the page being left,
+      // and there is no box left for the page arriving to be photographed in.
+      // The navigation stands — it is what was asked for — and the movement
+      // is dropped.
+      if (!travel.element.isConnected) {
+        {
+          warnBoxTakenDown(travel.page);
+        }
+        travel.viewTransition.skipTransition();
+        endTravel(travel);
+        return;
+      }
       // The page arriving is in the DOM and the transition has not started
       // playing: the one moment both boxes can be known. After the scroll,
       // which is what the box is measured through: the two states are at the
@@ -41904,7 +41921,7 @@ const RouteTravel = ({
       // (see transition_window.js).
       // The bars stay live under the pictures for a travel: only the box is
       // photographed (see the TRAVEL_ATTRIBUTE css).
-      holdTransitionWindow(travel, elementRef.current, stateBefore, {
+      holdTransitionWindow(travel, travel.element, stateBefore, {
         furnitureLive: true
       });
     });
@@ -42251,7 +42268,7 @@ const RouteTravel = ({
       // Given back, so another box may wear it: kept, two of them on a page
       // would both answer to it and the browser refuses the whole transition
       // rather than pick.
-      unnameAfterTravel(elementRef.current);
+      unnameAfterTravel(travel.element);
       document.documentElement.removeAttribute(TRAVEL_ATTRIBUTE);
       document.documentElement.removeAttribute(TRAVEL_AXIS_ATTRIBUTE);
       document.documentElement.removeAttribute(DRAGGED_ATTRIBUTE);
@@ -42813,6 +42830,17 @@ const currentPageIndex = pages => {
 // A transition skipped by another one starting is an outcome, not a failure.
 const ignoreSkipped = () => {};
 
+// Said once, whatever the number of swipes: a box in the wrong place is one
+// fact about the application, and repeating it every time would bury it.
+let boxTakenDownWarned = false;
+const warnBoxTakenDown = page => {
+  if (boxTakenDownWarned) {
+    return;
+  }
+  boxTakenDownWarned = true;
+  console.warn(`[navi] RouteTravel: the page ${page.route.buildUrl(page.params)} is not rendered under this box — the navigation took the box down with the page it was in, so the travel is dropped. The box must outlive every page of its row: around those <Route>s (a layout route), or around one <Route> whose params are the tabs, never inside one of the pages.`);
+};
+
 // The name is lent to the box that is travelling and taken back afterwards.
 // There is one transition in a document at a time, so one box wears it at a
 // time — and the others, unnamed, are simply not captured: they stay live
@@ -60533,6 +60561,7 @@ const css$Y = /* css */`@layer navi {
     --navi-fixed-bar-border-width: 1px;
     --navi-fixed-bar-border-color: var(--navi-separator-color-default);
     --navi-fixed-bar-padding: 0px;
+    --navi-fixed-bar-shadow: none;
   }
 }
 
@@ -60597,6 +60626,45 @@ const css$Y = /* css */`@layer navi {
         var(--navi-fixed-bar-border-color);
   }
 }
+
+.navi_fixed_bar_shadow {
+  border-radius: inherit;
+  box-shadow: var(--navi-fixed-bar-shadow);
+  pointer-events: none;
+  position: absolute;
+  inset: 0;
+}
+
+.navi_fixed_bar[data-area="top"] > .navi_fixed_bar_shadow {
+  bottom: calc(-1 * var(--navi-fixed-bar-border-width));
+  clip-path: inset(0 0 -100vh);
+}
+
+.navi_fixed_bar[data-area="bottom"] > .navi_fixed_bar_shadow {
+  top: calc(-1 * var(--navi-fixed-bar-border-width));
+  clip-path: inset(-100vh 0 0);
+}
+
+.navi_fixed_bar[data-area="left"] > .navi_fixed_bar_shadow {
+  right: calc(-1 * var(--navi-fixed-bar-border-width));
+  clip-path: inset(0 -100vw 0 0);
+}
+
+.navi_fixed_bar[data-area="right"] > .navi_fixed_bar_shadow {
+  left: calc(-1 * var(--navi-fixed-bar-border-width));
+  clip-path: inset(0 0 0 -100vw);
+}
+
+@supports (view-transition-name: match-element) {
+  :root[data-navi-route-travel] .navi_fixed_bar_shadow {
+    view-transition-name: match-element;
+    view-transition-class: navi_fixed_bar_shadow;
+  }
+}
+
+:root[data-navi-route-travel-turned]::view-transition-group(.navi_fixed_bar_shadow) {
+  display: block;
+}
 `;
 const FixedBarStyleCSSVars = {
   // width/height go through the vars the size calc reads: written as plain
@@ -60608,7 +60676,8 @@ const FixedBarStyleCSSVars = {
   padding: "--navi-fixed-bar-padding",
   background: "--navi-fixed-bar-background",
   borderWidth: "--navi-fixed-bar-border-width",
-  borderColor: "--navi-fixed-bar-border-color"
+  borderColor: "--navi-fixed-bar-border-color",
+  shadow: ["--navi-fixed-bar-shadow", "boxShadow"]
 };
 
 /**
@@ -60622,6 +60691,7 @@ const FixedBarStyleCSSVars = {
  *   border?: boolean,
  *   borderWidth?: string|number,
  *   borderColor?: string,
+ *   shadow?: string,
  * }>}
  * @param {"top"|"bottom"|"left"|"right"} [props.area="top"] - Which edge of
  *   the window it is pinned to. One bar per edge: a second one does not stack
@@ -60644,6 +60714,11 @@ const FixedBarStyleCSSVars = {
  * @param {string|number} [props.padding=0] - Along the bar only: left/right on
  *   a top or bottom bar, top/bottom on a side one. Across it, the size is
  *   `height`/`width`.
+ * @param {string} [props.shadow] - What the bar casts over the content, in
+ *   `box-shadow` syntax, cut at the bar's box on every side but the content's.
+ *   Takes no room. Prefer it to a `boxShadow` or a `filter` on the bar: those
+ *   are covered by the pages while a `RouteTravel` plays, this one stays over
+ *   them.
  */
 const FixedBar = ({
   children,
@@ -60707,12 +60782,14 @@ const FixedBar = ({
       setFixedBarSpace(area, barElement, null);
     };
   }, [area, vertical]);
-  return jsx(Box, {
+  return jsxs(Box, {
     baseClassName: "navi_fixed_bar",
     "data-area": area,
     ...props,
     styleCSSVars: FixedBarStyleCSSVars,
-    children: children
+    children: [children, jsx("span", {
+      className: "navi_fixed_bar_shadow"
+    })]
   });
 };
 
@@ -63911,8 +63988,11 @@ const COMMAND_DEFAULT_PROPS_FACTORIES = {
  *   says, for the other half of a toggle. Only for a control that does not
  *   travel with the pages.
  * @param {Function} [action] What the press runs: a button holds no value, so
- *   every press is one call. The button is busy while it runs, refuses a second
- *   press and draws the error on itself. On a button with an `href` or a
+ *   every press is one call. Inside a `<Form>` or a group it carries the value
+ *   around it, merged over the action's bound params — a value that is not an
+ *   object replaces them; in a picker's popup it carries nothing
+ *   (docs/actions.md#the-instance-a-control-runs). The button is busy while it
+ *   runs, refuses a second press and draws the error on itself. On a button with an `href` or a
  *   `route`, the same order as a Link's: it runs on the press, before the
  *   navigation, and the navigation does not wait for it (see Link's `action`).
  * @param {"GET"|"POST"|"PUT"|"PATCH"|"DELETE"} [actionVerb] What a plain