studio-engine 0.4.3 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9666cf8a5b997901079ee936e2ff49cf5b6b653b67e13de85a6588f6bddd93f7
-  data.tar.gz: 62a8338512f0cdf2f01f37bccaff8e2f41bad93233a4f3c62fe1f0eafda61d37
+  metadata.gz: 288a5cb85deb7c2c43a77b24e4d5bc1b958fd5652e2860bbe88a12d43c22f21e
+  data.tar.gz: 1c6ee3b69613649611963e56ba681d066dfeda518bc1010e764ac560e9c308af
 SHA512:
-  metadata.gz: 873809f43ebcaacb718b8ecec8d45ab933b38f88c706786fa0aa03e89d78c6e41b079579acca0f920d754448d23d1f7a2d899b21483808d20b445077e6b576d7
-  data.tar.gz: 17b0fb9f7997e3b4d5ba8b87188576360b23bfdb5657d29088fab2d0f805fd91b52c38c6472a6892f5225aefdf559a1f73b7484c902f6867bdb93919705d4138
+  metadata.gz: c930ecdf8f851eaaff0d14db9661dc434132a877a08deec34745e66817e77292dbc95fd1d661769c566d74180cae623f3cfeb76f94ce7690bf4ca71a1e0fe649
+  data.tar.gz: b3e2862a52d75a9bc7e122865dd1e9222859a17dbbf19f837f50f5e44a90e25bb1a01ec92afe77621a827cbfccda370e6235e8b60ae05ce01855c5f76a8e55ec

data/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 The format is [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html) — `MAJOR.MINOR.PATCH`. Both consumer Rails apps pin to a tag in their `Gemfile`; bumping the tag is a release.
 
+## v0.4.4 (2026-05-20)
+
+Sticky-navbar scroll fixes — bounce-free for every consuming app, no migration required.
+
+### Fixed
+- **Navbar scroll-collapse bounce.** A `position: sticky` navbar that shrinks on scroll changes layout above the fold; Chrome/Firefox scroll-anchoring then compensates by moving `scrollY`, which re-crosses the collapse threshold and oscillates. `_head.html.erb` now ships `body { overflow-anchor: none }`, so the navbar resize no longer drags `scrollY`. Every app that renders `layouts/studio/head` gets this automatically.
+- **Navbar unscroll threshold `20 → 5`** in `_navbar.html.erb` — widens the hysteresis dead zone (5/60) so a height change can't push `scrollY` back across the lower bound.
+
+### Added
+- **`--nav-h` CSS variable.** `_head.html.erb` ships a `ResizeObserver` that publishes the page header's live height to `--nav-h` on `:root` — updated on every resize (including the collapse animation) and re-attached after Turbo navigations. Fixed/sticky elements below the navbar can position off `var(--nav-h)` instead of hardcoded px (e.g. `style="top: var(--nav-h)"`). Auto-detects the page `<header>`; no markup changes needed.
+
 ## v0.4.3 (2026-05-19)
 
 Tier-3 fix from the turf-monster pre-prod opsec audit (OPSEC-016).

data/app/views/layouts/_navbar.html.erb

@@ -18,7 +18,7 @@
   logo_path = Studio.logo_for("Navbar Logo")
 %>
 
-<header x-data="{ scrolled: false }" <%= '@scroll.window="scrolled = scrolled ? (window.scrollY > 20) : (window.scrollY > 60)"'.html_safe unless is_preview %>
+<header x-data="{ scrolled: false }" <%= '@scroll.window="scrolled = scrolled ? (window.scrollY > 5) : (window.scrollY > 60)"'.html_safe unless is_preview %>
         class="<%= is_preview ? 'bg-page' : 'sticky top-0 z-50 bg-page transition-shadow duration-300' %>"
         :class="scrolled && 'shadow-lg border-b border-subtle is-scrolled'">
   <style>

data/app/views/layouts/studio/_head.html.erb

@@ -73,6 +73,38 @@
   });
 </script>
 
+<style>
+  /* studio-engine: a sticky navbar that shrinks on scroll changes layout
+     above the fold — Chrome/Firefox scroll-anchoring then compensates by
+     moving scrollY, which re-crosses the collapse threshold and bounces.
+     Disabling anchoring document-wide stops scrollY being dragged by the
+     navbar resize. */
+  body { overflow-anchor: none; }
+</style>
+<script>
+  // studio-engine: publish the sticky header's live height as the --nav-h
+  // CSS variable so fixed/sticky elements below the navbar can position off
+  // it (e.g. top: var(--nav-h)) without hardcoded px. Tracks every resize,
+  // including scroll-collapse animations, and re-attaches after Turbo nav.
+  (function () {
+    if (!window.ResizeObserver) return;
+    var ro = null;
+    function publish(header) {
+      document.documentElement.style.setProperty('--nav-h', header.offsetHeight + 'px');
+    }
+    function attach() {
+      var header = document.querySelector('header');
+      if (!header) return;
+      if (ro) ro.disconnect();
+      ro = new ResizeObserver(function () { publish(header); });
+      ro.observe(header);
+      publish(header);
+    }
+    document.addEventListener('DOMContentLoaded', attach);
+    document.addEventListener('turbo:load', attach);
+  })();
+</script>
+
 <%= stylesheet_link_tag "tailwind", "data-turbo-track": "reload" %>
 <%= stylesheet_link_tag "application", "data-turbo-track": "reload" %>
 <%= javascript_importmap_tags %>

data/lib/studio/version.rb

@@ -1,3 +1,3 @@
 module Studio
-  VERSION = "0.4.3"
+  VERSION = "0.4.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: studio-engine
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.4.4
 platform: ruby
 authors:
 - Alex McRitchie
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-20 00:00:00.000000000 Z
+date: 2026-05-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails