studio-engine 0.109.0.rc1 → 0.109.0.rc2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a916913ae747d410986fa4bc0f8abef5379e749678542100a0c396a954ff05e
-  data.tar.gz: 8816f7f0bc15437c3f509ce93c38e9d4d52b2425c81ed1f63a48f8022e21d0e9
+  metadata.gz: 19c0cd3c18b09bb009d42eea9911cb5eef64299aa74ba800f7bdd011da66623b
+  data.tar.gz: b22bc36fc79bac82a01ff679bbd9e7d9a49ea92f4d5b71fb52d1efc95e75bd0b
 SHA512:
-  metadata.gz: 105b1f39b9c67041a6bae67a769f65ecb54f75abad1cea11088df3d69e98c83c75fd5c705eb17c8384a513f6d58488ffb36633a6af6955ca242bc504c4881670
-  data.tar.gz: 2dd6e01fc32d25b69558452f39351c5e3bc5e98b35da3064ea12eb10f8a4f1aba9fcee8f39cbe57cb325109ab64e5624c65ed50d035156e050dcf152ff8ef2e6
+  metadata.gz: dd07af40833cdeb4acdaab8e37bffc7f021b9369c14c3b5f6d83c417e7344ada891143924f662cda4bcf6b389098b21eb9c85a860c99134798417273caf7b715
+  data.tar.gz: e4a4fc94d72ffcb463a1e37117dcd53f2d2897aea9ee070852a732cf1bace6b31ec35f3c0bdaa128528dcebd63c5d008a98142a024eb4415eabda0ccc5a02a69

data/CHANGELOG.md

@@ -4,6 +4,19 @@ The format is [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This pro
 
 ## Unreleased
 
+### Changed
+
+- **A held navbar eases its collapse again.** 0.108.0 held the header's
+  footprint so the page never moves, and with it let the header follow the
+  scroll position exactly. On a hard flick that crossed the whole ramp in a
+  frame or two, the header then snapped full to compact (or back) in one frame,
+  which read as a jerk on the hub's `/deployments`. The `--nav-max-step` cap
+  (5px of header travel per frame) now applies to held headers too, so a flick
+  plays as a short animation of about 8-9 frames. The page still never moves:
+  the hold keeps the document's height whatever `--nav-p` is. After a hard
+  flick to the top, page background shows between the header and the content
+  for those frames while the header grows back. A slow scroll is unchanged.
+
 ## 0.109.0 — 2026-10-15
 
 ### Added

data/app/assets/tailwind/studio_engine/engine.css

@@ -630,9 +630,10 @@ body.modal-open .studio-app-banner {
          single frame on a flick — measured 39px in turf-monster, the full
          178 -> 139. navCollapse() converts this to --nav-p units off
          --nav-ramp's 3x relation to the collapse total, so one number covers
-         every band. It binds only a header OUT of the page's flow: a header
-         in flow is held (studio/nav_collapse, the hold), so the page cannot
-         move, and its progress follows the scroll exactly. */
+         every band. It eases every header, held or not: a held header cannot
+         move the page (studio/nav_collapse, the hold), so for it the cap only
+         shapes the header's own motion, and a flick plays as a short animation
+         rather than a one-frame jump. */
       --nav-max-step: 5px;
       --nav-pad: calc(1.5rem - 1rem * var(--nav-p, 0));                 /* py-6 -> py-2 */
       --nav-logo-size: calc(3rem - 1rem * var(--nav-p, 0));             /* 48px -> 32px */

data/app/javascript/studio/nav_collapse.js

@@ -35,12 +35,17 @@
 //   finger moved it, and only the header itself changes size. A header that
 //   is not in flow (fixed or absolute) is left alone: it never moved the page.
 //
-//   (Held, the two guards below exist only for an UNHELD header. The document
-//   no longer shortens, so the short-page flap cannot happen, and the per-frame
-//   cap, which slowed the header so the page it dragged would not jump, now
-//   only makes the header lag the scroll. Worse, a lagging header opens a gap
-//   above the content on a fast scroll back to the top. Held, the progress is
-//   the scroll position, every frame.)
+//   (Held, the short-page guard below is off: the document no longer
+//   shortens, so the flap it prevents cannot happen. The per-frame CAP stays
+//   on. It was written to stop a flick dragging the page, and the hold already
+//   does that; what it buys a held header is the header's own motion. With the
+//   cap off, a flick that crossed the ramp in one frame snapped the header
+//   from full to compact in one frame, which read as a jerk on the hub's
+//   /deployments (2026-10-15). Capped, the header eases over a few frames, and
+//   the page under it still holds, because the hold keeps the document's
+//   height whatever --nav-p is. Easing open after a flick to the top leaves
+//   page background between the header and the content for those frames, the
+//   space the header is growing back into.)
 //
 //   passive + rAF: the listener never blocks the compositor and coalesces a
 //   burst of scroll events (iOS momentum fires far above 60Hz) into one write
@@ -85,7 +90,7 @@ export const DEFAULT_MAX_STEP = 5;
 //   innerHeight   window.innerHeight
 //   reduce        prefers-reduced-motion matches
 //   held          the header holds its footprint (see the hold above): no
-//                 short-page guard, no per-frame cap
+//                 short-page guard; the per-frame cap still eases the header
 //
 // Answers { p, settling }: the progress to publish, and whether the frame
 // clamp left it short of where the scroll position wants it (so the caller
@@ -107,8 +112,6 @@ export function collapseFrame({ y, p, ramp, maxPx, scrollHeight, innerHeight, re
   } else {
     var t = Math.min(1, y / ramp);
     target = t * t * (3 - 2 * t);
-    // Held, the progress IS the scroll position: nothing to cap.
-    if (held) snap = true;
   }
 
   // THE RATE LIMIT: how far the collapse may travel in ONE frame.
@@ -139,7 +142,7 @@ export function collapseFrame({ y, p, ramp, maxPx, scrollHeight, innerHeight, re
   if (snap) {
     // A guard refusal and a reduced-motion state are DECISIONS, not
     // motion; ramping them would animate the very thing each exists to
-    // avoid. A held header follows the scroll exactly.
+    // avoid.
     next = target;
   } else {
     var maxStep = (3 * maxPx) / ramp;

data/lib/studio/version.rb

@@ -1,3 +1,3 @@
 module Studio
-  VERSION = "0.109.0.rc1"
+  VERSION = "0.109.0.rc2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: studio-engine
 version: !ruby/object:Gem::Version
-  version: 0.109.0.rc1
+  version: 0.109.0.rc2
 platform: ruby
 authors:
 - Alex McRitchie