@bbki.ng/bb-msg-history 0.11.1 → 0.12.0

package/dist/component.d.ts

@@ -5,6 +5,9 @@ export declare class BBMsgHistory extends HTMLElement {
     private _lastAuthor;
     private _lastGroupTimestamp;
     private _scrollButtonVisible;
+    private _userHasScrolledManually;
+    private _isProgrammaticScroll;
+    private _lastScrollTop;
     static get observedAttributes(): string[];
     constructor();
     attributeChangedCallback(name: string): void;

package/dist/component.js

@@ -6,17 +6,20 @@ import { buildMessageRowHtml, setupTooltipForElement } from './utils/message-bui
 import { buildScrollButtonHtml } from './utils/scroll-button.js';
 export class BBMsgHistory extends HTMLElement {
     static get observedAttributes() {
-        return ['theme', 'loading', 'hide-scroll-bar', 'infinite'];
+        return ['theme', 'loading', 'hide-scroll-bar', 'infinite', 'hide-scroll-button'];
     }
     constructor() {
         super();
         this._userAuthors = new Map();
         this._lastAuthor = '';
         this._scrollButtonVisible = false;
+        this._userHasScrolledManually = false;
+        this._isProgrammaticScroll = false;
+        this._lastScrollTop = 0;
         this.attachShadow({ mode: 'open' });
     }
     attributeChangedCallback(name) {
-        if (name === 'theme' || name === 'loading' || name === 'hide-scroll-bar' || name === 'infinite') {
+        if (name === 'theme' || name === 'loading' || name === 'hide-scroll-bar' || name === 'infinite' || name === 'hide-scroll-button') {
             this.render();
         }
     }
@@ -115,15 +118,27 @@ export class BBMsgHistory extends HTMLElement {
         }
         // Smooth scroll to bottom (skip in infinite mode)
         if (!this.hasAttribute('infinite')) {
+            // Mark this as a programmatic scroll so the scroll handler ignores it
+            this._isProgrammaticScroll = true;
             container.scrollTo({
                 top: container.scrollHeight,
                 behavior: 'smooth',
             });
+            // Reset the flag after smooth scroll animation completes (~300ms)
+            setTimeout(() => {
+                this._isProgrammaticScroll = false;
+            }, 300);
             // Hide scroll button since we're scrolling to bottom
             const scrollButton = this.shadowRoot.querySelector('.scroll-to-bottom');
             if (scrollButton && this._scrollButtonVisible) {
                 this._scrollButtonVisible = false;
                 scrollButton.classList.remove('visible');
+                // Dispatch hide event
+                this.dispatchEvent(new CustomEvent('bb-scrollbuttonhide', {
+                    bubbles: true,
+                    composed: true,
+                    detail: { visible: false }
+                }));
             }
         }
     }
@@ -224,12 +239,13 @@ export class BBMsgHistory extends HTMLElement {
           <div class="loading-spinner"></div>
         </div>`
             : '';
+        const hideScrollButton = this.hasAttribute('hide-scroll-button');
         this.shadowRoot.innerHTML = `
       <style>${MAIN_STYLES}${LOADING_STYLES}</style>
       <div class="history" role="log" aria-live="polite" aria-label="Message history">
         ${messagesHtml}
       </div>
-      ${buildScrollButtonHtml()}
+      ${hideScrollButton ? '' : buildScrollButtonHtml()}
       ${loadingOverlay}
     `;
         this._setupAfterRender();
@@ -267,10 +283,18 @@ export class BBMsgHistory extends HTMLElement {
     _setupAfterRender() {
         requestAnimationFrame(() => {
             const container = this.shadowRoot.querySelector('.history');
-            const scrollButton = this.shadowRoot.querySelector('.scroll-to-bottom');
+            const hideScrollButton = this.hasAttribute('hide-scroll-button');
+            const scrollButton = hideScrollButton
+                ? null
+                : this.shadowRoot.querySelector('.scroll-to-bottom');
             const isInfinite = this.hasAttribute('infinite');
-            if (container && !isInfinite) {
+            if (container && !isInfinite && !hideScrollButton) {
+                // Mark as programmatic scroll to prevent triggering user scroll detection
+                this._isProgrammaticScroll = true;
                 container.scrollTop = container.scrollHeight;
+                requestAnimationFrame(() => {
+                    this._isProgrammaticScroll = false;
+                });
                 this._setupScrollTracking(container, scrollButton, { skipInitialCheck: true });
             }
             if (scrollButton && !isInfinite) {
@@ -306,15 +330,34 @@ export class BBMsgHistory extends HTMLElement {
     }
     _setupScrollTracking(container, button, options) {
         const checkScrollPosition = () => {
+            // Ignore programmatic scrolls - they don't indicate user intent
+            if (this._isProgrammaticScroll)
+                return;
+            // Mark that user has manually scrolled
+            if (!this._userHasScrolledManually) {
+                this._userHasScrolledManually = true;
+            }
+            const currentScrollTop = container.scrollTop;
+            const isScrollingUp = currentScrollTop < this._lastScrollTop;
+            this._lastScrollTop = currentScrollTop;
             const threshold = 50; // pixels from bottom
             const isAtBottom = container.scrollHeight - container.scrollTop - container.clientHeight < threshold;
             const hasOverflow = container.scrollHeight > container.clientHeight;
-            const shouldShow = !isAtBottom && hasOverflow;
+            // Only show button when: user has scrolled, is not at bottom, is scrolling up
+            const shouldShow = !isAtBottom && hasOverflow && this._userHasScrolledManually && isScrollingUp;
             if (shouldShow !== this._scrollButtonVisible) {
                 this._scrollButtonVisible = shouldShow;
                 button.classList.toggle('visible', shouldShow);
+                // Dispatch custom event
+                this.dispatchEvent(new CustomEvent(shouldShow ? 'bb-scrollbuttonshow' : 'bb-scrollbuttonhide', {
+                    bubbles: true,
+                    composed: true,
+                    detail: { visible: shouldShow }
+                }));
             }
         };
+        // Initialize last scroll position
+        this._lastScrollTop = container.scrollTop;
         // Check initial state unless skipped
         if (!options?.skipInitialCheck) {
             checkScrollPosition();

package/dist/const/styles.js

@@ -71,6 +71,11 @@ export const MAIN_STYLES = `
     display: none;
   }
 
+  /* Hide scroll button when explicitly disabled */
+  :host([hide-scroll-button]) .scroll-to-bottom {
+    display: none;
+  }
+
   /* Scroll to bottom button */
   .scroll-to-bottom {
     position: absolute;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bbki.ng/bb-msg-history",
-  "version": "0.11.1",
+  "version": "0.12.0",
   "description": "A chat-style message history web component",
   "main": "dist/index.js",
   "type": "module",

package/src/component.ts

@@ -12,9 +12,12 @@ export class BBMsgHistory extends HTMLElement {
   private _lastAuthor = '';
   private _lastGroupTimestamp: string | undefined;
   private _scrollButtonVisible = false;
+  private _userHasScrolledManually = false;
+  private _isProgrammaticScroll = false;
+  private _lastScrollTop = 0;
 
   static get observedAttributes() {
-    return ['theme', 'loading', 'hide-scroll-bar', 'infinite'];
+    return ['theme', 'loading', 'hide-scroll-bar', 'infinite', 'hide-scroll-button'];
   }
 
   constructor() {
@@ -23,7 +26,7 @@ export class BBMsgHistory extends HTMLElement {
   }
 
   attributeChangedCallback(name: string) {
-    if (name === 'theme' || name === 'loading' || name === 'hide-scroll-bar' || name === 'infinite') {
+    if (name === 'theme' || name === 'loading' || name === 'hide-scroll-bar' || name === 'infinite' || name === 'hide-scroll-button') {
       this.render();
     }
   }
@@ -149,16 +152,33 @@ export class BBMsgHistory extends HTMLElement {
 
     // Smooth scroll to bottom (skip in infinite mode)
     if (!this.hasAttribute('infinite')) {
+      // Mark this as a programmatic scroll so the scroll handler ignores it
+      this._isProgrammaticScroll = true;
+
       container.scrollTo({
         top: container.scrollHeight,
         behavior: 'smooth',
       });
 
+      // Reset the flag after smooth scroll animation completes (~300ms)
+      setTimeout(() => {
+        this._isProgrammaticScroll = false;
+      }, 300);
+
       // Hide scroll button since we're scrolling to bottom
       const scrollButton = this.shadowRoot!.querySelector('.scroll-to-bottom') as HTMLButtonElement;
       if (scrollButton && this._scrollButtonVisible) {
         this._scrollButtonVisible = false;
         scrollButton.classList.remove('visible');
+
+        // Dispatch hide event
+        this.dispatchEvent(
+          new CustomEvent('bb-scrollbuttonhide', {
+            bubbles: true,
+            composed: true,
+            detail: { visible: false }
+          })
+        );
       }
     }
   }
@@ -282,12 +302,14 @@ export class BBMsgHistory extends HTMLElement {
         </div>`
       : '';
 
+    const hideScrollButton = this.hasAttribute('hide-scroll-button');
+
     this.shadowRoot!.innerHTML = `
       <style>${MAIN_STYLES}${LOADING_STYLES}</style>
       <div class="history" role="log" aria-live="polite" aria-label="Message history">
         ${messagesHtml}
       </div>
-      ${buildScrollButtonHtml()}
+      ${hideScrollButton ? '' : buildScrollButtonHtml()}
       ${loadingOverlay}
     `;
 
@@ -334,12 +356,20 @@ export class BBMsgHistory extends HTMLElement {
   private _setupAfterRender(): void {
     requestAnimationFrame(() => {
       const container = this.shadowRoot!.querySelector('.history') as HTMLElement;
-      const scrollButton = this.shadowRoot!.querySelector('.scroll-to-bottom') as HTMLButtonElement;
+      const hideScrollButton = this.hasAttribute('hide-scroll-button');
+      const scrollButton = hideScrollButton
+        ? null
+        : (this.shadowRoot!.querySelector('.scroll-to-bottom') as HTMLButtonElement);
       const isInfinite = this.hasAttribute('infinite');
 
-      if (container && !isInfinite) {
+      if (container && !isInfinite && !hideScrollButton) {
+        // Mark as programmatic scroll to prevent triggering user scroll detection
+        this._isProgrammaticScroll = true;
         container.scrollTop = container.scrollHeight;
-        this._setupScrollTracking(container, scrollButton, { skipInitialCheck: true });
+        requestAnimationFrame(() => {
+          this._isProgrammaticScroll = false;
+        });
+        this._setupScrollTracking(container, scrollButton!, { skipInitialCheck: true });
       }
 
       if (scrollButton && !isInfinite) {
@@ -382,18 +412,43 @@ export class BBMsgHistory extends HTMLElement {
     options?: { skipInitialCheck?: boolean }
   ): void {
     const checkScrollPosition = () => {
+      // Ignore programmatic scrolls - they don't indicate user intent
+      if (this._isProgrammaticScroll) return;
+
+      // Mark that user has manually scrolled
+      if (!this._userHasScrolledManually) {
+        this._userHasScrolledManually = true;
+      }
+
+      const currentScrollTop = container.scrollTop;
+      const isScrollingUp = currentScrollTop < this._lastScrollTop;
+      this._lastScrollTop = currentScrollTop;
+
       const threshold = 50; // pixels from bottom
       const isAtBottom =
         container.scrollHeight - container.scrollTop - container.clientHeight < threshold;
       const hasOverflow = container.scrollHeight > container.clientHeight;
-      const shouldShow = !isAtBottom && hasOverflow;
+      // Only show button when: user has scrolled, is not at bottom, is scrolling up
+      const shouldShow = !isAtBottom && hasOverflow && this._userHasScrolledManually && isScrollingUp;
 
       if (shouldShow !== this._scrollButtonVisible) {
         this._scrollButtonVisible = shouldShow;
         button.classList.toggle('visible', shouldShow);
+
+        // Dispatch custom event
+        this.dispatchEvent(
+          new CustomEvent(shouldShow ? 'bb-scrollbuttonshow' : 'bb-scrollbuttonhide', {
+            bubbles: true,
+            composed: true,
+            detail: { visible: shouldShow }
+          })
+        );
       }
     };
 
+    // Initialize last scroll position
+    this._lastScrollTop = container.scrollTop;
+
     // Check initial state unless skipped
     if (!options?.skipInitialCheck) {
       checkScrollPosition();

package/src/const/styles.ts

@@ -72,6 +72,11 @@ export const MAIN_STYLES = `
     display: none;
   }
 
+  /* Hide scroll button when explicitly disabled */
+  :host([hide-scroll-button]) .scroll-to-bottom {
+    display: none;
+  }
+
   /* Scroll to bottom button */
   .scroll-to-bottom {
     position: absolute;