@diabolic/hangover 0.1.5 → 0.1.7

package/dist/hangover.css

@@ -59,6 +59,12 @@
 .hangoverDropdown--dark .hangoverDropdown-list:hover::-webkit-scrollbar-thumb, .hangoverDropdown--dark .hangoverDropdown-list:focus-within::-webkit-scrollbar-thumb {
   background: rgba(255, 255, 255, 0.18);
 }
+.hangoverDropdown--dark .hangoverDropdown-column.forNavigation:hover, .hangoverDropdown--dark .hangoverDropdown-column.forNavigation:focus-within {
+  scrollbar-color: rgba(255, 255, 255, 0.18) transparent;
+}
+.hangoverDropdown--dark .hangoverDropdown-column.forNavigation:hover::-webkit-scrollbar-thumb, .hangoverDropdown--dark .hangoverDropdown-column.forNavigation:focus-within::-webkit-scrollbar-thumb {
+  background: rgba(255, 255, 255, 0.18);
+}
 
 @keyframes hangoverDropdownIn {
   from {
@@ -147,7 +153,28 @@
   box-sizing: border-box;
   flex-shrink: 0;
   flex: none;
-  transition: width 330ms ease, min-width 330ms ease;
+  overflow-y: auto;
+  overscroll-behavior: none;
+  scrollbar-width: none;
+  scrollbar-color: transparent transparent;
+  transition: width 330ms ease, min-width 330ms ease, scrollbar-color 330ms ease;
+}
+.hangoverDropdown-column.forNavigation:hover, .hangoverDropdown-column.forNavigation:focus-within {
+  scrollbar-color: rgba(0, 0, 0, 0.18) transparent;
+}
+.hangoverDropdown-column.forNavigation::-webkit-scrollbar {
+  width: 4px;
+}
+.hangoverDropdown-column.forNavigation::-webkit-scrollbar-track {
+  background: transparent;
+}
+.hangoverDropdown-column.forNavigation::-webkit-scrollbar-thumb {
+  background: transparent;
+  border-radius: 2px;
+  transition: background 330ms ease;
+}
+.hangoverDropdown-column.forNavigation:hover::-webkit-scrollbar-thumb, .hangoverDropdown-column.forNavigation:focus-within::-webkit-scrollbar-thumb {
+  background: rgba(0, 0, 0, 0.18);
 }
 .hangoverDropdown-column.forNavigation .hangoverDropdown-nav-item {
   transition: width 330ms ease, padding 330ms ease, justify-content 330ms ease, gap 330ms ease, background 330ms ease;

package/dist/index.cjs.js

@@ -450,9 +450,39 @@ function DropdownNavItem({
     t
   } = useDropdownContext();
   const isActive = activeNavId === id;
+  const buttonRef = react.useRef(null);
   react.useEffect(() => {
     registerNavLabel(id, typeof children === 'string' ? children : '');
   }, [id, children, registerNavLabel]);
+
+  // When this item becomes active (e.g. via scroll-spy on the right column),
+  // keep it visible inside the scrollable nav column.
+  react.useEffect(() => {
+    if (!isActive) return;
+    const el = buttonRef.current;
+    if (!el) return;
+    const container = el.closest('.hangoverDropdown-column.forNavigation');
+    if (!container) return;
+
+    // Leave a gap-sized breathing space so the active item never sits flush
+    // against the top/bottom edge of the nav column.
+    const navList = el.parentElement;
+    const gap = navList ? parseFloat(getComputedStyle(navList).rowGap || getComputedStyle(navList).gap) || 0 : 0;
+    const containerRect = container.getBoundingClientRect();
+    const elRect = el.getBoundingClientRect();
+    let delta = 0;
+    if (elRect.top < containerRect.top + gap) {
+      delta = elRect.top - containerRect.top - gap;
+    } else if (elRect.bottom > containerRect.bottom - gap) {
+      delta = elRect.bottom - containerRect.bottom + gap;
+    }
+    if (delta !== 0) {
+      container.scrollTo({
+        top: container.scrollTop + delta,
+        behavior: 'smooth'
+      });
+    }
+  }, [isActive]);
   function handleClick() {
     fireEvent('navChange', {
       id
@@ -498,6 +528,7 @@ function DropdownNavItem({
   }
   return /*#__PURE__*/jsxRuntime.jsxs("button", {
     type: "button",
+    ref: buttonRef,
     className: `hangoverDropdown-nav-item${isActive ? ' isActive' : ''}`,
     onClick: () => {
       handleClick();
@@ -648,6 +679,7 @@ function DropdownContent({
     t
   } = useDropdownContext();
   const searchInputRef = react.useRef(null);
+  const bottomPadRef = react.useRef(0);
 
   // Scroll spy: update active nav based on scroll position
   react.useEffect(() => {
@@ -696,6 +728,66 @@ function DropdownContent({
     if (displayMode !== 'tab') return;
     if (contentRef.current) contentRef.current.scrollTop = 0;
   }, [displayMode, activeNavId, contentRef]);
+
+  // Scroll mode: reserve enough space at the bottom of the list so the last
+  // section (even a short single-entry one) can be scrolled all the way to the
+  // top. Without this, a short last section can never reach the top because the
+  // container has already hit its maximum scroll position.
+  react.useEffect(() => {
+    if (displayMode !== 'scroll') return;
+    const list = contentRef.current;
+    if (!list) return;
+    let rafId = null;
+    function computeBottomSpace() {
+      rafId = null;
+      const sections = list.querySelectorAll('[data-section-for]');
+      const lastSection = sections[sections.length - 1];
+      if (!lastSection) {
+        if (bottomPadRef.current !== 0) {
+          list.style.paddingBottom = '';
+          bottomPadRef.current = 0;
+        }
+        return;
+      }
+
+      // Derive the natural content height by subtracting our own reserved
+      // space, so recomputes never compound. Using real geometry for the last
+      // section's top keeps this margin-safe (bottom padding sits after it, so
+      // it never shifts the section's top position).
+      const available = list.clientHeight;
+      const naturalScrollHeight = list.scrollHeight - bottomPadRef.current;
+      const listTop = list.getBoundingClientRect().top;
+      const lastTopWithinContent = lastSection.getBoundingClientRect().top - listTop + list.scrollTop;
+      const spaceBelowLastTop = naturalScrollHeight - lastTopWithinContent;
+      const pad = Math.max(0, Math.round(available - spaceBelowLastTop));
+
+      // Only touch the DOM when the reserved space actually changes by a whole
+      // pixel — this ignores sub-pixel/floating jitter from the observer and
+      // keeps the value stable.
+      if (Math.abs(pad - bottomPadRef.current) < 1) return;
+      bottomPadRef.current = pad;
+      list.style.paddingBottom = `${pad}px`;
+    }
+
+    // Coalesce bursts of observer callbacks into a single measurement per frame.
+    function scheduleBottomSpace() {
+      if (rafId !== null) return;
+      rafId = requestAnimationFrame(computeBottomSpace);
+    }
+    scheduleBottomSpace();
+
+    // Observe both the container (viewport resize) and every section (group
+    // expand/collapse, late reflows) so the reserved space stays accurate.
+    const observer = new ResizeObserver(scheduleBottomSpace);
+    observer.observe(list);
+    list.querySelectorAll('[data-section-for]').forEach(section => {
+      observer.observe(section);
+    });
+    return () => {
+      if (rafId !== null) cancelAnimationFrame(rafId);
+      observer.disconnect();
+    };
+  }, [displayMode, contentRef, children, searchQuery]);
   function handleSearch(e) {
     fireEvent('search', {
       query: e.target.value

package/dist/index.esm.js

@@ -446,9 +446,39 @@ function DropdownNavItem({
     t
   } = useDropdownContext();
   const isActive = activeNavId === id;
+  const buttonRef = useRef(null);
   useEffect(() => {
     registerNavLabel(id, typeof children === 'string' ? children : '');
   }, [id, children, registerNavLabel]);
+
+  // When this item becomes active (e.g. via scroll-spy on the right column),
+  // keep it visible inside the scrollable nav column.
+  useEffect(() => {
+    if (!isActive) return;
+    const el = buttonRef.current;
+    if (!el) return;
+    const container = el.closest('.hangoverDropdown-column.forNavigation');
+    if (!container) return;
+
+    // Leave a gap-sized breathing space so the active item never sits flush
+    // against the top/bottom edge of the nav column.
+    const navList = el.parentElement;
+    const gap = navList ? parseFloat(getComputedStyle(navList).rowGap || getComputedStyle(navList).gap) || 0 : 0;
+    const containerRect = container.getBoundingClientRect();
+    const elRect = el.getBoundingClientRect();
+    let delta = 0;
+    if (elRect.top < containerRect.top + gap) {
+      delta = elRect.top - containerRect.top - gap;
+    } else if (elRect.bottom > containerRect.bottom - gap) {
+      delta = elRect.bottom - containerRect.bottom + gap;
+    }
+    if (delta !== 0) {
+      container.scrollTo({
+        top: container.scrollTop + delta,
+        behavior: 'smooth'
+      });
+    }
+  }, [isActive]);
   function handleClick() {
     fireEvent('navChange', {
       id
@@ -494,6 +524,7 @@ function DropdownNavItem({
   }
   return /*#__PURE__*/jsxs("button", {
     type: "button",
+    ref: buttonRef,
     className: `hangoverDropdown-nav-item${isActive ? ' isActive' : ''}`,
     onClick: () => {
       handleClick();
@@ -644,6 +675,7 @@ function DropdownContent({
     t
   } = useDropdownContext();
   const searchInputRef = useRef(null);
+  const bottomPadRef = useRef(0);
 
   // Scroll spy: update active nav based on scroll position
   useEffect(() => {
@@ -692,6 +724,66 @@ function DropdownContent({
     if (displayMode !== 'tab') return;
     if (contentRef.current) contentRef.current.scrollTop = 0;
   }, [displayMode, activeNavId, contentRef]);
+
+  // Scroll mode: reserve enough space at the bottom of the list so the last
+  // section (even a short single-entry one) can be scrolled all the way to the
+  // top. Without this, a short last section can never reach the top because the
+  // container has already hit its maximum scroll position.
+  useEffect(() => {
+    if (displayMode !== 'scroll') return;
+    const list = contentRef.current;
+    if (!list) return;
+    let rafId = null;
+    function computeBottomSpace() {
+      rafId = null;
+      const sections = list.querySelectorAll('[data-section-for]');
+      const lastSection = sections[sections.length - 1];
+      if (!lastSection) {
+        if (bottomPadRef.current !== 0) {
+          list.style.paddingBottom = '';
+          bottomPadRef.current = 0;
+        }
+        return;
+      }
+
+      // Derive the natural content height by subtracting our own reserved
+      // space, so recomputes never compound. Using real geometry for the last
+      // section's top keeps this margin-safe (bottom padding sits after it, so
+      // it never shifts the section's top position).
+      const available = list.clientHeight;
+      const naturalScrollHeight = list.scrollHeight - bottomPadRef.current;
+      const listTop = list.getBoundingClientRect().top;
+      const lastTopWithinContent = lastSection.getBoundingClientRect().top - listTop + list.scrollTop;
+      const spaceBelowLastTop = naturalScrollHeight - lastTopWithinContent;
+      const pad = Math.max(0, Math.round(available - spaceBelowLastTop));
+
+      // Only touch the DOM when the reserved space actually changes by a whole
+      // pixel — this ignores sub-pixel/floating jitter from the observer and
+      // keeps the value stable.
+      if (Math.abs(pad - bottomPadRef.current) < 1) return;
+      bottomPadRef.current = pad;
+      list.style.paddingBottom = `${pad}px`;
+    }
+
+    // Coalesce bursts of observer callbacks into a single measurement per frame.
+    function scheduleBottomSpace() {
+      if (rafId !== null) return;
+      rafId = requestAnimationFrame(computeBottomSpace);
+    }
+    scheduleBottomSpace();
+
+    // Observe both the container (viewport resize) and every section (group
+    // expand/collapse, late reflows) so the reserved space stays accurate.
+    const observer = new ResizeObserver(scheduleBottomSpace);
+    observer.observe(list);
+    list.querySelectorAll('[data-section-for]').forEach(section => {
+      observer.observe(section);
+    });
+    return () => {
+      if (rafId !== null) cancelAnimationFrame(rafId);
+      observer.disconnect();
+    };
+  }, [displayMode, contentRef, children, searchQuery]);
   function handleSearch(e) {
     fireEvent('search', {
       query: e.target.value

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diabolic/hangover",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "A headless-style, compound React dropdown/field-picker component library",
   "license": "MIT",
   "author": "bugrakaan",