@quantabit/scroll-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 QuantaBit Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# @quantabit/scroll-sdk
+
+> Universal scroll utilities: BackToTop, ScrollProgress, and hooks
+
+## Features
+
+- **BackToTop** — Auto-showing floating button
+- **ScrollProgress** — Page reading progress bar
+- **useScrollPosition** — Track scroll position and progress %
+- **useInfiniteScroll** — Infinite scroll with loading state
+- **useScrollDirection** — Detect 'up' or 'down' scrolling
+- **Scroll Utils** — scrollToTop, scrollToElement, scrollToBottom
+
+## Quick Start
+
+```jsx
+import { BackToTop, ScrollProgress, useScrollDirection } from '@quantabit/scroll-sdk';
+
+function App() {
+  const direction = useScrollDirection();
+  return (
+    <>
+      <ScrollProgress color="#3b82f6" />
+      <BackToTop threshold={300} />
+    </>
+  );
+}
+```
+
+## License
+
+MIT © QuantaBit Team
+
+
+
+---
+
+## 🌐 Brand & Links
+- Official Mainnet: [QuantaBit Chain](https://qbitchain.io/)
+- Developer Platform: [Developer Platform](https://developer.quantabit.io/)
+- Open Platform: [Open Platform](https://open.quantabit.io/)
+- Payment Platform: [Pay Platform](https://pay.qbitwallet.io/)
+- Feedback: [Feedback](https://xwin.live/qbit)

package/dist/index.cjs

@@ -0,0 +1,222 @@
+'use strict';
+
+var React = require('react');
+
+function useScrollPosition(throttleMs = 100) {
+  const [pos, setPos] = React.useState({
+    x: 0,
+    y: 0,
+    progress: 0
+  });
+  const timer = React.useRef(null);
+  React.useEffect(() => {
+    const handler = () => {
+      if (timer.current) return;
+      timer.current = setTimeout(() => {
+        const y = window.scrollY;
+        const maxY = document.documentElement.scrollHeight - window.innerHeight;
+        setPos({
+          x: window.scrollX,
+          y,
+          progress: maxY > 0 ? Math.min(1, y / maxY) : 0
+        });
+        timer.current = null;
+      }, throttleMs);
+    };
+    window.addEventListener('scroll', handler, {
+      passive: true
+    });
+    return () => window.removeEventListener('scroll', handler);
+  }, [throttleMs]);
+  return pos;
+}
+
+function scrollToTop(smooth = true) {
+  window.scrollTo({
+    top: 0,
+    behavior: smooth ? 'smooth' : 'auto'
+  });
+}
+function scrollToBottom(smooth = true) {
+  window.scrollTo({
+    top: document.body.scrollHeight,
+    behavior: smooth ? 'smooth' : 'auto'
+  });
+}
+function scrollToElement(selector, offset = 0, smooth = true) {
+  const el = document.querySelector(selector);
+  if (!el) return;
+  const y = el.getBoundingClientRect().top + window.scrollY - offset;
+  window.scrollTo({
+    top: y,
+    behavior: smooth ? 'smooth' : 'auto'
+  });
+}
+
+function BackToTop({
+  threshold = 300,
+  size = 44,
+  className = '',
+  style = {}
+}) {
+  const {
+    y
+  } = useScrollPosition();
+  if (y < threshold) return null;
+  return /*#__PURE__*/React.createElement("button", {
+    className: `qs-back-to-top ${className}`,
+    onClick: () => scrollToTop(),
+    "aria-label": "Back to top",
+    style: {
+      position: 'fixed',
+      bottom: 24,
+      right: 24,
+      zIndex: 9000,
+      width: size,
+      height: size,
+      borderRadius: '50%',
+      border: 'none',
+      cursor: 'pointer',
+      background: 'rgba(24,24,27,0.9)',
+      color: '#fff',
+      display: 'flex',
+      alignItems: 'center',
+      justifyContent: 'center',
+      boxShadow: '0 4px 16px rgba(0,0,0,0.15)',
+      transition: 'all 0.3s',
+      animation: 'qs-fade-in 0.3s ease-out',
+      ...style
+    }
+  }, /*#__PURE__*/React.createElement("svg", {
+    width: "18",
+    height: "18",
+    viewBox: "0 0 24 24",
+    fill: "none",
+    stroke: "currentColor",
+    strokeWidth: "2.5"
+  }, /*#__PURE__*/React.createElement("path", {
+    d: "M18 15l-6-6-6 6",
+    strokeLinecap: "round",
+    strokeLinejoin: "round"
+  })));
+}
+
+function ScrollProgress({
+  color = '#3b82f6',
+  height = 3,
+  zIndex = 10000,
+  className = ''
+}) {
+  const {
+    progress
+  } = useScrollPosition(16);
+  return /*#__PURE__*/React.createElement("div", {
+    className: `qs-progress ${className}`,
+    style: {
+      position: 'fixed',
+      top: 0,
+      left: 0,
+      right: 0,
+      height,
+      zIndex,
+      background: 'transparent',
+      pointerEvents: 'none'
+    }
+  }, /*#__PURE__*/React.createElement("div", {
+    style: {
+      height: '100%',
+      width: `${progress * 100}%`,
+      background: color,
+      transition: 'width 50ms linear',
+      borderRadius: '0 2px 2px 0'
+    }
+  }));
+}
+
+function useInfiniteScroll(callback, options = {}) {
+  const {
+    threshold = 200,
+    enabled = true
+  } = options;
+  const loading = React.useRef(false);
+  const handleScroll = React.useCallback(() => {
+    if (!enabled || loading.current) return;
+    const {
+      scrollHeight,
+      scrollTop,
+      clientHeight
+    } = document.documentElement;
+    if (scrollHeight - scrollTop - clientHeight < threshold) {
+      loading.current = true;
+      Promise.resolve(callback()).finally(() => {
+        loading.current = false;
+      });
+    }
+  }, [callback, threshold, enabled]);
+  React.useEffect(() => {
+    window.addEventListener('scroll', handleScroll, {
+      passive: true
+    });
+    return () => window.removeEventListener('scroll', handleScroll);
+  }, [handleScroll]);
+}
+
+function useScrollDirection(threshold = 10) {
+  const [dir, setDir] = React.useState('none');
+  const lastY = React.useRef(0);
+  React.useEffect(() => {
+    const handler = () => {
+      const y = window.scrollY;
+      if (Math.abs(y - lastY.current) > threshold) {
+        setDir(y > lastY.current ? 'down' : 'up');
+      }
+      lastY.current = y;
+    };
+    window.addEventListener('scroll', handler, {
+      passive: true
+    });
+    return () => window.removeEventListener('scroll', handler);
+  }, [threshold]);
+  return dir;
+}
+
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+const messages = {
+  en: {
+    "scroll.top": "Back to top"
+  },
+  zh: {
+    "scroll.top": "回到顶部"
+  },
+  ja: {
+    "scroll.top": "トップに戻る"
+  },
+  ko: {
+    "scroll.top": "위로 가기"
+  }
+};
+let currentLang = 'en';
+function setLanguage(l) {
+  if (SUPPORTED_LANGUAGES.includes(l)) currentLang = l;
+}
+function getLanguage() {
+  return currentLang;
+}
+function t(k) {
+  return messages[currentLang]?.[k] || messages.en?.[k] || k;
+}
+
+exports.BackToTop = BackToTop;
+exports.SUPPORTED_LANGUAGES = SUPPORTED_LANGUAGES;
+exports.ScrollProgress = ScrollProgress;
+exports.getLanguage = getLanguage;
+exports.messages = messages;
+exports.scrollToBottom = scrollToBottom;
+exports.scrollToElement = scrollToElement;
+exports.scrollToTop = scrollToTop;
+exports.setLanguage = setLanguage;
+exports.t = t;
+exports.useInfiniteScroll = useInfiniteScroll;
+exports.useScrollDirection = useScrollDirection;
+exports.useScrollPosition = useScrollPosition;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/hooks/useScrollPosition.js","../src/utils/scroll.js","../src/components/BackToTop.jsx","../src/components/ScrollProgress.jsx","../src/hooks/useInfiniteScroll.js","../src/hooks/useScrollDirection.js","../src/i18n/index.js"],"sourcesContent":["import{useState,useEffect,useRef}from'react';\nexport function useScrollPosition(throttleMs=100){\n  const[pos,setPos]=useState({x:0,y:0,progress:0});\n  const timer=useRef(null);\n  useEffect(()=>{const handler=()=>{if(timer.current)return;timer.current=setTimeout(()=>{const y=window.scrollY;const maxY=document.documentElement.scrollHeight-window.innerHeight;setPos({x:window.scrollX,y,progress:maxY>0?Math.min(1,y/maxY):0});timer.current=null;},throttleMs);};\n  window.addEventListener('scroll',handler,{passive:true});return()=>window.removeEventListener('scroll',handler);},[throttleMs]);\n  return pos;\n}\n","export function scrollToTop(smooth=true){window.scrollTo({top:0,behavior:smooth?'smooth':'auto'});}\nexport function scrollToBottom(smooth=true){window.scrollTo({top:document.body.scrollHeight,behavior:smooth?'smooth':'auto'});}\nexport function scrollToElement(selector,offset=0,smooth=true){const el=document.querySelector(selector);if(!el)return;const y=el.getBoundingClientRect().top+window.scrollY-offset;window.scrollTo({top:y,behavior:smooth?'smooth':'auto'});}\n","import React from 'react';\nimport { useScrollPosition } from '../hooks/useScrollPosition';\nimport { scrollToTop } from '../utils/scroll';\nexport function BackToTop({ threshold=300, size=44, className='', style={} }) {\n  const { y } = useScrollPosition();\n  if (y < threshold) return null;\n  return (\n    <button className={`qs-back-to-top ${className}`} onClick={()=>scrollToTop()} aria-label=\"Back to top\"\n      style={{ position:'fixed', bottom:24, right:24, zIndex:9000, width:size, height:size, borderRadius:'50%',\n        border:'none', cursor:'pointer', background:'rgba(24,24,27,0.9)', color:'#fff',\n        display:'flex', alignItems:'center', justifyContent:'center',\n        boxShadow:'0 4px 16px rgba(0,0,0,0.15)', transition:'all 0.3s',\n        animation:'qs-fade-in 0.3s ease-out', ...style }}>\n      <svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2.5\">\n        <path d=\"M18 15l-6-6-6 6\" strokeLinecap=\"round\" strokeLinejoin=\"round\"/>\n      </svg>\n    </button>\n  );\n}\n","import React from 'react';\nimport { useScrollPosition } from '../hooks/useScrollPosition';\nexport function ScrollProgress({ color='#3b82f6', height=3, zIndex=10000, className='' }) {\n  const { progress } = useScrollPosition(16);\n  return (\n    <div className={`qs-progress ${className}`} style={{ position:'fixed', top:0, left:0, right:0, height, zIndex, background:'transparent', pointerEvents:'none' }}>\n      <div style={{ height:'100%', width:`${progress*100}%`, background:color, transition:'width 50ms linear', borderRadius:'0 2px 2px 0' }} />\n    </div>\n  );\n}\n","import{useEffect,useRef,useCallback}from'react';\nexport function useInfiniteScroll(callback,options={}){\n  const{threshold=200,enabled=true}=options;\n  const loading=useRef(false);\n  const handleScroll=useCallback(()=>{if(!enabled||loading.current)return;const{scrollHeight,scrollTop,clientHeight}=document.documentElement;if(scrollHeight-scrollTop-clientHeight<threshold){loading.current=true;Promise.resolve(callback()).finally(()=>{loading.current=false;});}\n  },[callback,threshold,enabled]);\n  useEffect(()=>{window.addEventListener('scroll',handleScroll,{passive:true});return()=>window.removeEventListener('scroll',handleScroll);},[handleScroll]);\n}\n","import{useState,useEffect,useRef}from'react';\nexport function useScrollDirection(threshold=10){\n  const[dir,setDir]=useState('none');\n  const lastY=useRef(0);\n  useEffect(()=>{const handler=()=>{const y=window.scrollY;if(Math.abs(y-lastY.current)>threshold){setDir(y>lastY.current?'down':'up');}lastY.current=y;};\n  window.addEventListener('scroll',handler,{passive:true});return()=>window.removeEventListener('scroll',handler);},[threshold]);\n  return dir;\n}\n","export const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];\nexport const messages = {\n  en: {\n  \"scroll.top\": \"Back to top\"\n},\n  zh: {\n  \"scroll.top\": \"回到顶部\"\n},\n  ja: {\n  \"scroll.top\": \"トップに戻る\"\n},\n  ko: {\n  \"scroll.top\": \"위로 가기\"\n}\n};\nlet currentLang = 'en';\nexport function setLanguage(l) { if (SUPPORTED_LANGUAGES.includes(l)) currentLang = l; }\nexport function getLanguage() { return currentLang; }\nexport function t(k) { return messages[currentLang]?.[k] || messages.en?.[k] || k; }\n"],"names":["useScrollPosition","throttleMs","pos","setPos","useState","x","y","progress","timer","useRef","useEffect","handler","current","setTimeout","window","scrollY","maxY","document","documentElement","scrollHeight","innerHeight","scrollX","Math","min","addEventListener","passive","removeEventListener","scrollToTop","smooth","scrollTo","top","behavior","scrollToBottom","body","scrollToElement","selector","offset","el","querySelector","getBoundingClientRect","BackToTop","threshold","size","className","style","React","createElement","onClick","position","bottom","right","zIndex","width","height","borderRadius","border","cursor","background","color","display","alignItems","justifyContent","boxShadow","transition","animation","viewBox","fill","stroke","strokeWidth","d","strokeLinecap","strokeLinejoin","ScrollProgress","left","pointerEvents","useInfiniteScroll","callback","options","enabled","loading","handleScroll","useCallback","scrollTop","clientHeight","Promise","resolve","finally","useScrollDirection","dir","setDir","lastY","abs","SUPPORTED_LANGUAGES","messages","en","zh","ja","ko","currentLang","setLanguage","l","includes","getLanguage","t","k"],"mappings":"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"}

package/dist/index.esm.js

@@ -0,0 +1,208 @@
+import React, { useState, useRef, useEffect, useCallback } from 'react';
+
+function useScrollPosition(throttleMs = 100) {
+  const [pos, setPos] = useState({
+    x: 0,
+    y: 0,
+    progress: 0
+  });
+  const timer = useRef(null);
+  useEffect(() => {
+    const handler = () => {
+      if (timer.current) return;
+      timer.current = setTimeout(() => {
+        const y = window.scrollY;
+        const maxY = document.documentElement.scrollHeight - window.innerHeight;
+        setPos({
+          x: window.scrollX,
+          y,
+          progress: maxY > 0 ? Math.min(1, y / maxY) : 0
+        });
+        timer.current = null;
+      }, throttleMs);
+    };
+    window.addEventListener('scroll', handler, {
+      passive: true
+    });
+    return () => window.removeEventListener('scroll', handler);
+  }, [throttleMs]);
+  return pos;
+}
+
+function scrollToTop(smooth = true) {
+  window.scrollTo({
+    top: 0,
+    behavior: smooth ? 'smooth' : 'auto'
+  });
+}
+function scrollToBottom(smooth = true) {
+  window.scrollTo({
+    top: document.body.scrollHeight,
+    behavior: smooth ? 'smooth' : 'auto'
+  });
+}
+function scrollToElement(selector, offset = 0, smooth = true) {
+  const el = document.querySelector(selector);
+  if (!el) return;
+  const y = el.getBoundingClientRect().top + window.scrollY - offset;
+  window.scrollTo({
+    top: y,
+    behavior: smooth ? 'smooth' : 'auto'
+  });
+}
+
+function BackToTop({
+  threshold = 300,
+  size = 44,
+  className = '',
+  style = {}
+}) {
+  const {
+    y
+  } = useScrollPosition();
+  if (y < threshold) return null;
+  return /*#__PURE__*/React.createElement("button", {
+    className: `qs-back-to-top ${className}`,
+    onClick: () => scrollToTop(),
+    "aria-label": "Back to top",
+    style: {
+      position: 'fixed',
+      bottom: 24,
+      right: 24,
+      zIndex: 9000,
+      width: size,
+      height: size,
+      borderRadius: '50%',
+      border: 'none',
+      cursor: 'pointer',
+      background: 'rgba(24,24,27,0.9)',
+      color: '#fff',
+      display: 'flex',
+      alignItems: 'center',
+      justifyContent: 'center',
+      boxShadow: '0 4px 16px rgba(0,0,0,0.15)',
+      transition: 'all 0.3s',
+      animation: 'qs-fade-in 0.3s ease-out',
+      ...style
+    }
+  }, /*#__PURE__*/React.createElement("svg", {
+    width: "18",
+    height: "18",
+    viewBox: "0 0 24 24",
+    fill: "none",
+    stroke: "currentColor",
+    strokeWidth: "2.5"
+  }, /*#__PURE__*/React.createElement("path", {
+    d: "M18 15l-6-6-6 6",
+    strokeLinecap: "round",
+    strokeLinejoin: "round"
+  })));
+}
+
+function ScrollProgress({
+  color = '#3b82f6',
+  height = 3,
+  zIndex = 10000,
+  className = ''
+}) {
+  const {
+    progress
+  } = useScrollPosition(16);
+  return /*#__PURE__*/React.createElement("div", {
+    className: `qs-progress ${className}`,
+    style: {
+      position: 'fixed',
+      top: 0,
+      left: 0,
+      right: 0,
+      height,
+      zIndex,
+      background: 'transparent',
+      pointerEvents: 'none'
+    }
+  }, /*#__PURE__*/React.createElement("div", {
+    style: {
+      height: '100%',
+      width: `${progress * 100}%`,
+      background: color,
+      transition: 'width 50ms linear',
+      borderRadius: '0 2px 2px 0'
+    }
+  }));
+}
+
+function useInfiniteScroll(callback, options = {}) {
+  const {
+    threshold = 200,
+    enabled = true
+  } = options;
+  const loading = useRef(false);
+  const handleScroll = useCallback(() => {
+    if (!enabled || loading.current) return;
+    const {
+      scrollHeight,
+      scrollTop,
+      clientHeight
+    } = document.documentElement;
+    if (scrollHeight - scrollTop - clientHeight < threshold) {
+      loading.current = true;
+      Promise.resolve(callback()).finally(() => {
+        loading.current = false;
+      });
+    }
+  }, [callback, threshold, enabled]);
+  useEffect(() => {
+    window.addEventListener('scroll', handleScroll, {
+      passive: true
+    });
+    return () => window.removeEventListener('scroll', handleScroll);
+  }, [handleScroll]);
+}
+
+function useScrollDirection(threshold = 10) {
+  const [dir, setDir] = useState('none');
+  const lastY = useRef(0);
+  useEffect(() => {
+    const handler = () => {
+      const y = window.scrollY;
+      if (Math.abs(y - lastY.current) > threshold) {
+        setDir(y > lastY.current ? 'down' : 'up');
+      }
+      lastY.current = y;
+    };
+    window.addEventListener('scroll', handler, {
+      passive: true
+    });
+    return () => window.removeEventListener('scroll', handler);
+  }, [threshold]);
+  return dir;
+}
+
+const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];
+const messages = {
+  en: {
+    "scroll.top": "Back to top"
+  },
+  zh: {
+    "scroll.top": "回到顶部"
+  },
+  ja: {
+    "scroll.top": "トップに戻る"
+  },
+  ko: {
+    "scroll.top": "위로 가기"
+  }
+};
+let currentLang = 'en';
+function setLanguage(l) {
+  if (SUPPORTED_LANGUAGES.includes(l)) currentLang = l;
+}
+function getLanguage() {
+  return currentLang;
+}
+function t(k) {
+  return messages[currentLang]?.[k] || messages.en?.[k] || k;
+}
+
+export { BackToTop, SUPPORTED_LANGUAGES, ScrollProgress, getLanguage, messages, scrollToBottom, scrollToElement, scrollToTop, setLanguage, t, useInfiniteScroll, useScrollDirection, useScrollPosition };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/hooks/useScrollPosition.js","../src/utils/scroll.js","../src/components/BackToTop.jsx","../src/components/ScrollProgress.jsx","../src/hooks/useInfiniteScroll.js","../src/hooks/useScrollDirection.js","../src/i18n/index.js"],"sourcesContent":["import{useState,useEffect,useRef}from'react';\nexport function useScrollPosition(throttleMs=100){\n  const[pos,setPos]=useState({x:0,y:0,progress:0});\n  const timer=useRef(null);\n  useEffect(()=>{const handler=()=>{if(timer.current)return;timer.current=setTimeout(()=>{const y=window.scrollY;const maxY=document.documentElement.scrollHeight-window.innerHeight;setPos({x:window.scrollX,y,progress:maxY>0?Math.min(1,y/maxY):0});timer.current=null;},throttleMs);};\n  window.addEventListener('scroll',handler,{passive:true});return()=>window.removeEventListener('scroll',handler);},[throttleMs]);\n  return pos;\n}\n","export function scrollToTop(smooth=true){window.scrollTo({top:0,behavior:smooth?'smooth':'auto'});}\nexport function scrollToBottom(smooth=true){window.scrollTo({top:document.body.scrollHeight,behavior:smooth?'smooth':'auto'});}\nexport function scrollToElement(selector,offset=0,smooth=true){const el=document.querySelector(selector);if(!el)return;const y=el.getBoundingClientRect().top+window.scrollY-offset;window.scrollTo({top:y,behavior:smooth?'smooth':'auto'});}\n","import React from 'react';\nimport { useScrollPosition } from '../hooks/useScrollPosition';\nimport { scrollToTop } from '../utils/scroll';\nexport function BackToTop({ threshold=300, size=44, className='', style={} }) {\n  const { y } = useScrollPosition();\n  if (y < threshold) return null;\n  return (\n    <button className={`qs-back-to-top ${className}`} onClick={()=>scrollToTop()} aria-label=\"Back to top\"\n      style={{ position:'fixed', bottom:24, right:24, zIndex:9000, width:size, height:size, borderRadius:'50%',\n        border:'none', cursor:'pointer', background:'rgba(24,24,27,0.9)', color:'#fff',\n        display:'flex', alignItems:'center', justifyContent:'center',\n        boxShadow:'0 4px 16px rgba(0,0,0,0.15)', transition:'all 0.3s',\n        animation:'qs-fade-in 0.3s ease-out', ...style }}>\n      <svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2.5\">\n        <path d=\"M18 15l-6-6-6 6\" strokeLinecap=\"round\" strokeLinejoin=\"round\"/>\n      </svg>\n    </button>\n  );\n}\n","import React from 'react';\nimport { useScrollPosition } from '../hooks/useScrollPosition';\nexport function ScrollProgress({ color='#3b82f6', height=3, zIndex=10000, className='' }) {\n  const { progress } = useScrollPosition(16);\n  return (\n    <div className={`qs-progress ${className}`} style={{ position:'fixed', top:0, left:0, right:0, height, zIndex, background:'transparent', pointerEvents:'none' }}>\n      <div style={{ height:'100%', width:`${progress*100}%`, background:color, transition:'width 50ms linear', borderRadius:'0 2px 2px 0' }} />\n    </div>\n  );\n}\n","import{useEffect,useRef,useCallback}from'react';\nexport function useInfiniteScroll(callback,options={}){\n  const{threshold=200,enabled=true}=options;\n  const loading=useRef(false);\n  const handleScroll=useCallback(()=>{if(!enabled||loading.current)return;const{scrollHeight,scrollTop,clientHeight}=document.documentElement;if(scrollHeight-scrollTop-clientHeight<threshold){loading.current=true;Promise.resolve(callback()).finally(()=>{loading.current=false;});}\n  },[callback,threshold,enabled]);\n  useEffect(()=>{window.addEventListener('scroll',handleScroll,{passive:true});return()=>window.removeEventListener('scroll',handleScroll);},[handleScroll]);\n}\n","import{useState,useEffect,useRef}from'react';\nexport function useScrollDirection(threshold=10){\n  const[dir,setDir]=useState('none');\n  const lastY=useRef(0);\n  useEffect(()=>{const handler=()=>{const y=window.scrollY;if(Math.abs(y-lastY.current)>threshold){setDir(y>lastY.current?'down':'up');}lastY.current=y;};\n  window.addEventListener('scroll',handler,{passive:true});return()=>window.removeEventListener('scroll',handler);},[threshold]);\n  return dir;\n}\n","export const SUPPORTED_LANGUAGES = ['en', 'zh', 'ja', 'ko'];\nexport const messages = {\n  en: {\n  \"scroll.top\": \"Back to top\"\n},\n  zh: {\n  \"scroll.top\": \"回到顶部\"\n},\n  ja: {\n  \"scroll.top\": \"トップに戻る\"\n},\n  ko: {\n  \"scroll.top\": \"위로 가기\"\n}\n};\nlet currentLang = 'en';\nexport function setLanguage(l) { if (SUPPORTED_LANGUAGES.includes(l)) currentLang = l; }\nexport function getLanguage() { return currentLang; }\nexport function t(k) { return messages[currentLang]?.[k] || messages.en?.[k] || k; }\n"],"names":["useScrollPosition","throttleMs","pos","setPos","useState","x","y","progress","timer","useRef","useEffect","handler","current","setTimeout","window","scrollY","maxY","document","documentElement","scrollHeight","innerHeight","scrollX","Math","min","addEventListener","passive","removeEventListener","scrollToTop","smooth","scrollTo","top","behavior","scrollToBottom","body","scrollToElement","selector","offset","el","querySelector","getBoundingClientRect","BackToTop","threshold","size","className","style","React","createElement","onClick","position","bottom","right","zIndex","width","height","borderRadius","border","cursor","background","color","display","alignItems","justifyContent","boxShadow","transition","animation","viewBox","fill","stroke","strokeWidth","d","strokeLinecap","strokeLinejoin","ScrollProgress","left","pointerEvents","useInfiniteScroll","callback","options","enabled","loading","handleScroll","useCallback","scrollTop","clientHeight","Promise","resolve","finally","useScrollDirection","dir","setDir","lastY","abs","SUPPORTED_LANGUAGES","messages","en","zh","ja","ko","currentLang","setLanguage","l","includes","getLanguage","t","k"],"mappings":"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"}

package/dist/styles.css

@@ -0,0 +1,2 @@
+@keyframes qs-fade-in{0%{opacity:0;transform:translateY(10px)}to{opacity:1;transform:translateY(0)}}.qs-back-to-top:hover{box-shadow:0 8px 24px rgba(0,0,0,.2)!important;transform:scale(1.1)!important}
+/*# sourceMappingURL=styles.css.map */

package/dist/styles.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["scroll.css"],"names":[],"mappings":"AAAA,sBAAwB,GAAK,SAAS,CAAC,0BAA0B,CAAE,GAAG,SAAS,CAAC,uBAAuB,CAAE,CACzG,sBAAyD,8CAAgD,CAAjF,8BAAmF","file":"styles.css","sourcesContent":["@keyframes qs-fade-in { from{opacity:0;transform:translateY(10px)} to{opacity:1;transform:translateY(0)} }\n.qs-back-to-top:hover { transform:scale(1.1) !important; box-shadow:0 8px 24px rgba(0,0,0,0.2) !important; }\n"]}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@quantabit/scroll-sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Universal scroll utilities: BackToTop, ScrollProgress, infinite scroll, scroll direction hooks",
+  "main": "dist/index.cjs",
+  "module": "dist/index.esm.js",
+  "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs"
+    },
+    "./styles": "./dist/styles.css",
+    "./styles.css": "./dist/styles.css"
+  },
+  "files": [
+    "dist",
+    "types",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "jest --passWithNoTests",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/quantabit-chain/qbit-sdk.git",
+    "directory": "packages/scroll-sdk"
+  },
+  "homepage": "https://github.com/quantabit-chain/qbit-sdk/tree/main/packages/scroll-sdk",
+  "bugs": {
+    "url": "https://github.com/quantabit-chain/qbit-sdk/issues"
+  },
+  "keywords": [
+    "scroll",
+    "back-to-top",
+    "infinite-scroll",
+    "progress",
+    "react",
+    "quantabit"
+  ],
+  "author": "QuantaBit Team",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "dependencies": {
+    "@quantabit/sdk-config": "^1.0.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": [
+    "*.css"
+  ],
+  "qbit": {
+    "privacy": {
+      "level": "functional",
+      "dataCollection": "Feature-related data for personalization. Requires user consent.",
+      "gdprCompliant": true,
+      "ccpaCompliant": true
+    }
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @quantabit/scroll-sdk TypeScript Type Definitions
+ * 
+ * Auto-generated type stubs. Enhance with specific types as the SDK matures.
+ */
+
+import { FC, ReactNode } from 'react';
+
+// ============ Components ============
+
+export interface BackToTopProps {
+  className?: string;
+  style?: React.CSSProperties;
+  [key: string]: any;
+}
+
+export declare const BackToTop: FC<BackToTopProps>;
+
+export interface ScrollProgressProps {
+  className?: string;
+  style?: React.CSSProperties;
+  [key: string]: any;
+}
+
+export declare const ScrollProgress: FC<ScrollProgressProps>;
+
+// ============ Hooks ============
+
+export interface UseScrollPositionReturn {
+  data: any;
+  loading: boolean;
+  error: string | null;
+  [key: string]: any;
+}
+
+export declare function useScrollPosition(...args: any[]): UseScrollPositionReturn;
+
+export interface UseInfiniteScrollReturn {
+  data: any;
+  loading: boolean;
+  error: string | null;
+  [key: string]: any;
+}
+
+export declare function useInfiniteScroll(...args: any[]): UseInfiniteScrollReturn;
+
+export interface UseScrollDirectionReturn {
+  data: any;
+  loading: boolean;
+  error: string | null;
+  [key: string]: any;
+}
+
+export declare function useScrollDirection(...args: any[]): UseScrollDirectionReturn;
+
+// ============ Functions & Utilities ============
+
+export declare function scrollToTop(...args: any[]): any;
+export declare function scrollToElement(...args: any[]): any;
+export declare function scrollToBottom(...args: any[]): any;
+export declare const messages: Record<string, Record<string, string>>;
+export declare const SUPPORTED_LANGUAGES: string[];
+export declare function setLanguage(lang: string): void;
+export declare function getLanguage(): string;
+export declare function t(key: string, params?: Record<string, any>): string;
+