@ehfuse/overlay-scrollbar 1.5.7 → 1.5.9

package/dist/src/hooks/useScrollbarConfig.d.ts

@@ -0,0 +1,53 @@
+/**
+ * useScrollbarConfig.ts
+ * 스크롤바 설정 계산 로직
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+import { ThumbConfig, TrackConfig, ArrowsConfig, DragScrollConfig, AutoHideConfig } from "../types";
+interface UseScrollbarConfigProps {
+    thumb: ThumbConfig;
+    track: TrackConfig;
+    arrows: ArrowsConfig;
+    dragScroll: DragScrollConfig;
+    autoHide: AutoHideConfig;
+}
+export declare const useScrollbarConfig: ({ thumb, track, arrows, dragScroll, autoHide, }: UseScrollbarConfigProps) => {
+    finalThumbConfig: {
+        width: number;
+        minHeight: number;
+        radius: number;
+        color: string;
+        opacity: number;
+        hoverColor: string;
+        hoverOpacity: number;
+    };
+    finalTrackConfig: {
+        width: number;
+        color: string;
+        visible: boolean;
+        alignment: "center" | "right";
+        radius: number;
+        margin: number;
+    };
+    finalArrowsConfig: {
+        visible: boolean;
+        step: number;
+        color: string;
+        opacity: number;
+        hoverColor: string;
+        hoverOpacity: number;
+    };
+    finalDragScrollConfig: {
+        enabled: boolean;
+        excludeClasses: string[];
+        excludeSelectors: string[];
+    };
+    finalAutoHideConfig: {
+        enabled: boolean;
+        delay: number;
+        delayOnWheel: number;
+    };
+};
+export {};
+//# sourceMappingURL=useScrollbarConfig.d.ts.map

package/dist/src/hooks/useScrollbarConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollbarConfig.d.ts","sourceRoot":"","sources":["../../../src/hooks/useScrollbarConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACH,WAAW,EACX,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACjB,MAAM,UAAU,CAAC;AAElB,UAAU,uBAAuB;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,EAAE,cAAc,CAAC;CAC5B;AAED,eAAO,MAAM,kBAAkB,GAAI,iDAMhC,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoEzB,CAAC"}

package/dist/src/hooks/useScrollbarInitialization.d.ts

@@ -0,0 +1,21 @@
+/**
+ * useScrollbarInitialization.ts
+ * 스크롤바 초기화 관련 로직 (ResizeObserver, MutationObserver, CSS 주입 등)
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+import { AutoHideConfig } from "../types";
+interface UseScrollbarInitializationProps {
+    containerRef: React.RefObject<HTMLDivElement>;
+    contentRef: React.RefObject<HTMLDivElement>;
+    cachedScrollContainerRef: React.MutableRefObject<HTMLElement | null>;
+    updateScrollbar: () => void;
+    setScrollbarVisible: (visible: boolean) => void;
+    isScrollable: () => boolean;
+    autoHide: AutoHideConfig;
+}
+export declare const useScrollbarInitialization: ({ containerRef, contentRef, cachedScrollContainerRef, updateScrollbar, setScrollbarVisible, isScrollable, autoHide, }: UseScrollbarInitializationProps) => {
+    isInitialized: boolean;
+};
+export {};
+//# sourceMappingURL=useScrollbarInitialization.d.ts.map

package/dist/src/hooks/useScrollbarInitialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollbarInitialization.d.ts","sourceRoot":"","sources":["../../../src/hooks/useScrollbarInitialization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,UAAU,+BAA+B;IACrC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC9C,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC5C,wBAAwB,EAAE,KAAK,CAAC,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACrE,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,mBAAmB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,QAAQ,EAAE,cAAc,CAAC;CAC5B;AAED,eAAO,MAAM,0BAA0B,GAAI,uHAQxC,+BAA+B;;CA6HjC,CAAC"}

package/dist/src/hooks/useScrollbarUpdate.d.ts

@@ -0,0 +1,27 @@
+/**
+ * useScrollbarUpdate.ts
+ * 스크롤바 업데이트 관련 로직
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+import { ThumbConfig, TrackConfig, ArrowsConfig, AutoHideConfig } from "../types";
+interface UseScrollbarUpdateProps {
+    wrapperRef: React.RefObject<HTMLDivElement>;
+    scrollbarRef: React.RefObject<HTMLDivElement>;
+    contentRef: React.RefObject<HTMLDivElement>;
+    findScrollableElement: () => HTMLElement | null;
+    clearHideTimer: () => void;
+    setScrollbarVisible: (visible: boolean) => void;
+    thumb: ThumbConfig;
+    track: TrackConfig;
+    arrows: ArrowsConfig;
+    autoHide: AutoHideConfig;
+}
+export declare const useScrollbarUpdate: ({ wrapperRef, scrollbarRef, contentRef, findScrollableElement, clearHideTimer, setScrollbarVisible, thumb, track, arrows, autoHide, }: UseScrollbarUpdateProps) => {
+    thumbHeight: number;
+    thumbTop: number;
+    hasScrollableContent: boolean;
+    updateScrollbar: () => void;
+};
+export {};
+//# sourceMappingURL=useScrollbarUpdate.d.ts.map

package/dist/src/hooks/useScrollbarUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollbarUpdate.d.ts","sourceRoot":"","sources":["../../../src/hooks/useScrollbarUpdate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACH,WAAW,EACX,WAAW,EACX,YAAY,EACZ,cAAc,EACjB,MAAM,UAAU,CAAC;AAElB,UAAU,uBAAuB;IAC7B,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC5C,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC9C,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC5C,qBAAqB,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAChD,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,mBAAmB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;CAC5B;AAED,eAAO,MAAM,kBAAkB,GAAI,uIAWhC,uBAAuB;;;;;CAiHzB,CAAC"}

package/dist/src/hooks/useThumbDrag.d.ts

@@ -0,0 +1,25 @@
+/**
+ * useThumbDrag.ts
+ * 썸 드래그 관련 로직
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+interface UseThumbDragProps {
+    findScrollableElement: () => HTMLElement | null;
+    thumbHeight: number;
+    clearHideTimer: () => void;
+    setScrollbarVisible: (visible: boolean) => void;
+    updateScrollbar: () => void;
+    setHideTimer: (delay: number) => void;
+    hideDelay: number;
+    isScrollable: () => boolean;
+    maintainFocus: () => void;
+}
+export declare const useThumbDrag: ({ findScrollableElement, thumbHeight, clearHideTimer, setScrollbarVisible, updateScrollbar, setHideTimer, hideDelay, isScrollable, maintainFocus, }: UseThumbDragProps) => {
+    isDragging: boolean;
+    isThumbHovered: boolean;
+    setIsThumbHovered: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    handleThumbMouseDown: (event: React.MouseEvent) => void;
+};
+export {};
+//# sourceMappingURL=useThumbDrag.d.ts.map

package/dist/src/hooks/useThumbDrag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThumbDrag.d.ts","sourceRoot":"","sources":["../../../src/hooks/useThumbDrag.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,UAAU,iBAAiB;IACvB,qBAAqB,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,mBAAmB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,aAAa,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,eAAO,MAAM,YAAY,GAAI,qJAU1B,iBAAiB;;;;kCAOJ,KAAK,CAAC,UAAU;CA2F/B,CAAC"}

package/dist/src/hooks/useTrackClick.d.ts

@@ -0,0 +1,20 @@
+/**
+ * useTrackClick.ts
+ * 트랙 클릭 관련 로직
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+interface UseTrackClickProps {
+    scrollbarRef: React.RefObject<HTMLDivElement>;
+    findScrollableElement: () => HTMLElement | null;
+    updateScrollbar: () => void;
+    setScrollbarVisible: (visible: boolean) => void;
+    setHideTimer: (delay: number) => void;
+    hideDelay: number;
+    maintainFocus: () => void;
+}
+export declare const useTrackClick: ({ scrollbarRef, findScrollableElement, updateScrollbar, setScrollbarVisible, setHideTimer, hideDelay, maintainFocus, }: UseTrackClickProps) => {
+    handleTrackClick: (event: React.MouseEvent) => void;
+};
+export {};
+//# sourceMappingURL=useTrackClick.d.ts.map

package/dist/src/hooks/useTrackClick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrackClick.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTrackClick.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,UAAU,kBAAkB;IACxB,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC9C,qBAAqB,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAChD,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,mBAAmB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,eAAO,MAAM,aAAa,GAAI,wHAQ3B,kBAAkB;8BAGL,KAAK,CAAC,UAAU;CA+C/B,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * types.ts
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+import { ReactNode } from "react";
+export interface ThumbConfig {
+    width?: number;
+    minHeight?: number;
+    radius?: number;
+    color?: string;
+    opacity?: number;
+    hoverColor?: string;
+    hoverOpacity?: number;
+}
+export interface TrackConfig {
+    width?: number;
+    color?: string;
+    visible?: boolean;
+    alignment?: "center" | "right";
+    radius?: number;
+    margin?: number;
+}
+export interface ArrowsConfig {
+    visible?: boolean;
+    step?: number;
+    color?: string;
+    opacity?: number;
+    hoverColor?: string;
+    hoverOpacity?: number;
+}
+export interface DragScrollConfig {
+    enabled?: boolean;
+    excludeClasses?: string[];
+    excludeSelectors?: string[];
+}
+export interface AutoHideConfig {
+    enabled?: boolean;
+    delay?: number;
+    delayOnWheel?: number;
+}
+export interface OverlayScrollbarProps {
+    className?: string;
+    style?: React.CSSProperties;
+    containerStyle?: React.CSSProperties;
+    contentStyle?: React.CSSProperties;
+    children: ReactNode;
+    onScroll?: (event: Event) => void;
+    thumb?: ThumbConfig;
+    track?: TrackConfig;
+    arrows?: ArrowsConfig;
+    dragScroll?: DragScrollConfig;
+    autoHide?: AutoHideConfig;
+    showScrollbar?: boolean;
+    detectInnerScroll?: boolean;
+}
+export interface OverlayScrollbarRef {
+    getScrollContainer: () => HTMLDivElement | null;
+    scrollTo: (options: ScrollToOptions) => void;
+    scrollTop: number;
+    scrollHeight: number;
+    clientHeight: number;
+}
+export declare const DEFAULT_THUMB_CONFIG: ThumbConfig;
+export declare const DEFAULT_TRACK_CONFIG: TrackConfig;
+export declare const DEFAULT_ARROWS_CONFIG: ArrowsConfig;
+export declare const DEFAULT_DRAG_SCROLL_CONFIG: DragScrollConfig;
+export declare const DEFAULT_AUTO_HIDE_CONFIG: AutoHideConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlC,MAAM,WAAW,WAAW;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,WAAW;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,YAAY;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,gBAAgB;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAGD,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,cAAc,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IACrC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IACnC,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAGlC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAG1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAGD,MAAM,WAAW,mBAAmB;IAChC,kBAAkB,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;IAChD,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACxB;AAGD,eAAO,MAAM,oBAAoB,EAAE,WAAgB,CAAC;AACpD,eAAO,MAAM,oBAAoB,EAAE,WAAgB,CAAC;AACpD,eAAO,MAAM,qBAAqB,EAAE,YAAiB,CAAC;AACtD,eAAO,MAAM,0BAA0B,EAAE,gBAAqB,CAAC;AAC/D,eAAO,MAAM,wBAAwB,EAAE,cAAmB,CAAC"}

package/dist/src/utils/dragScrollUtils.d.ts

@@ -21,7 +21,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-import { DragScrollConfig } from "../OverlayScrollbar";
+import { DragScrollConfig } from "../types";
 /**
  * 드래그 스크롤이 허용되지 않는 요소들인지 확인
  */

package/dist/src/utils/dragScrollUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dragScrollUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/dragScrollUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAuMvD;;GAEG;AACH;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC3B,SAAS,OAAO,EAChB,SAAS,gBAAgB,KAC1B,OAuDF,CAAC;AAyCF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,iBAAiB,OAAO,KAAG,OA8BxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC7B,gBAAgB,OAAO,EACvB,eAAe,OAAO,GAAG,IAAI,KAC9B,OAKF,CAAC"}
+{"version":3,"file":"dragScrollUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/dragScrollUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAuM5C;;GAEG;AACH;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC3B,SAAS,OAAO,EAChB,SAAS,gBAAgB,KAC1B,OAuDF,CAAC;AAyCF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,iBAAiB,OAAO,KAAG,OA8BxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC7B,gBAAgB,OAAO,EACvB,eAAe,OAAO,GAAG,IAAI,KAC9B,OAKF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ehfuse/overlay-scrollbar",
-    "version": "1.5.7",
+    "version": "1.5.9",
     "description": "A React component that provides a custom overlay scrollbar with smooth animations and auto-hide functionality",
     "type": "module",
     "main": "dist/index.js",
@@ -12,9 +12,9 @@
         "LICENSE"
     ],
     "scripts": {
-        "build": "rollup -c",
+        "build": "node build.js",
         "prepublishOnly": "npm run build",
-        "dev": "rollup -c -w",
+        "dev": "node build.js",
         "test": "echo \"Error: no test specified\" && exit 1"
     },
     "keywords": [
@@ -42,14 +42,10 @@
         "react-dom": ">=16.8.0"
     },
     "devDependencies": {
-        "@rollup/plugin-node-resolve": "^15.2.3",
-        "@rollup/plugin-typescript": "^11.1.5",
         "@types/node": "^20.19.17",
         "@types/react": "^18.2.31",
         "@types/react-dom": "^18.2.14",
-        "rollup": "^4.1.4",
-        "rollup-plugin-dts": "^6.1.0",
-        "rollup-plugin-peer-deps-external": "^2.2.4",
+        "esbuild": "^0.27.0",
         "tslib": "^2.8.1",
         "typescript": "^5.9.3"
     }