@ehfuse/overlay-scrollbar 1.6.0 → 1.6.2

package/README.md

@@ -100,6 +100,7 @@ interface AutoHideConfig {
     enabled?: boolean; // Enable auto-hide (default: true)
     delay?: number; // Auto-hide delay (default: 1500ms)
     delayOnWheel?: number; // Quick hide after wheel (default: 700ms)
+    initialDelay?: number; // Delay before showing scrollbar on mount (default: 200ms)
 }
 ```
 

package/dist/OverlayScrollbar.d.ts

@@ -0,0 +1,86 @@
+/**
+ * OverlayScrollbar.tsx
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ *
+ * 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.
+ */
+import React, { 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" | "outside";
+    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;
+    initialDelay?: 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;
+}
+declare const OverlayScrollbar: React.ForwardRefExoticComponent<OverlayScrollbarProps & React.RefAttributes<OverlayScrollbarRef>>;
+export default OverlayScrollbar;
+export { OverlayScrollbar };
+//# sourceMappingURL=OverlayScrollbar.d.ts.map

package/dist/OverlayScrollbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayScrollbar.d.ts","sourceRoot":"","sources":["../src/OverlayScrollbar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,EAMV,SAAS,EAIZ,MAAM,OAAO,CAAC;AAIf,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,SAAS,CAAC;IACjC,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;IACtB,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;AASD,QAAA,MAAM,gBAAgB,mGA6oDrB,CAAC;AAEF,eAAe,gBAAgB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/components/ScrollbarArrows.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ScrollbarArrows.tsx
+ * 스크롤바 화살표 버튼 컴포넌트
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+import React from "react";
+interface ScrollbarArrowsProps {
+    adjustedTrackWidth: number;
+    finalThumbWidth: number;
+    scrollbarVisible: boolean;
+    hoveredArrow: "up" | "down" | null;
+    finalArrowsConfig: {
+        color: string;
+        opacity: number;
+        hoverColor: string;
+        hoverOpacity: number;
+    };
+    finalTrackConfig: {
+        alignment: string;
+        margin: number;
+    };
+    setHoveredArrow: (arrow: "up" | "down" | null) => void;
+    handleUpArrowClick: (e: React.MouseEvent) => void;
+    handleDownArrowClick: (e: React.MouseEvent) => void;
+}
+export declare const ScrollbarArrows: React.FC<ScrollbarArrowsProps>;
+export {};
+//# sourceMappingURL=ScrollbarArrows.d.ts.map

package/dist/components/ScrollbarArrows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollbarArrows.d.ts","sourceRoot":"","sources":["../../src/components/ScrollbarArrows.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,oBAAoB;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACnC,iBAAiB,EAAE;QACf,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,gBAAgB,EAAE;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,eAAe,EAAE,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACvD,kBAAkB,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;IAClD,oBAAoB,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;CACvD;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA8E1D,CAAC"}

package/dist/components/ScrollbarThumb.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ScrollbarThumb.tsx
+ * 스크롤바 썸 컴포넌트
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+import React from "react";
+interface ScrollbarThumbProps {
+    thumbRef: React.RefObject<HTMLDivElement>;
+    thumbTop: number;
+    thumbHeight: number;
+    thumbMinHeight: number;
+    showArrows: boolean;
+    finalThumbWidth: number;
+    adjustedTrackWidth: number;
+    isDragging: boolean;
+    isThumbHovered: boolean;
+    finalThumbConfig: {
+        width: number;
+        color: string;
+        opacity: number;
+        hoverColor: string;
+        hoverOpacity: number;
+        radius: number;
+    };
+    finalTrackConfig: {
+        alignment: string;
+        margin: number;
+    };
+    handleThumbMouseDown: (e: React.MouseEvent) => void;
+    setIsThumbHovered: (hovered: boolean) => void;
+}
+export declare const ScrollbarThumb: React.FC<ScrollbarThumbProps>;
+export {};
+//# sourceMappingURL=ScrollbarThumb.d.ts.map

package/dist/components/ScrollbarThumb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollbarThumb.d.ts","sourceRoot":"","sources":["../../src/components/ScrollbarThumb.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,mBAAmB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,gBAAgB,EAAE;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,oBAAoB,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;IACpD,iBAAiB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD;AAED,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAkDxD,CAAC"}

package/dist/components/ScrollbarTrack.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ScrollbarTrack.tsx
+ * 스크롤바 트랙 컴포넌트
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+import React from "react";
+interface ScrollbarTrackProps {
+    scrollbarRef: React.RefObject<HTMLDivElement>;
+    adjustedTrackWidth: number;
+    scrollbarVisible: boolean;
+    isDragging: boolean;
+    showArrows: boolean;
+    finalThumbWidth: number;
+    finalTrackConfig: {
+        visible: boolean;
+        alignment: string;
+        margin: number;
+        color: string;
+        radius: number;
+        width: number;
+    };
+    clearHideTimer: () => void;
+    setScrollbarVisible: (visible: boolean) => void;
+    setHideTimer: (delay: number) => void;
+    autoHideDelay: number;
+    handleTrackClick: (e: React.MouseEvent) => void;
+    children: React.ReactNode;
+}
+export declare const ScrollbarTrack: React.FC<ScrollbarTrackProps>;
+export {};
+//# sourceMappingURL=ScrollbarTrack.d.ts.map

package/dist/components/ScrollbarTrack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollbarTrack.d.ts","sourceRoot":"","sources":["../../src/components/ScrollbarTrack.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,mBAAmB;IACzB,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC9C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,mBAAmB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;IAChD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B;AAED,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA+ExD,CAAC"}

package/dist/hooks/useArrowNavigation.d.ts

@@ -0,0 +1,27 @@
+/**
+ * useArrowNavigation.ts
+ * 화살표 네비게이션 관련 로직
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+import { ArrowsConfig } from "../types";
+interface UseArrowNavigationProps {
+    arrows: ArrowsConfig;
+    containerRef: React.RefObject<HTMLDivElement>;
+    contentRef: React.RefObject<HTMLDivElement>;
+    updateScrollbar: () => void;
+    setScrollbarVisible: (visible: boolean) => void;
+    setHideTimer: (delay: number) => void;
+    hideDelay: number;
+    maintainFocus: () => void;
+}
+export declare const useArrowNavigation: ({ arrows, containerRef, contentRef, updateScrollbar, setScrollbarVisible, setHideTimer, hideDelay, maintainFocus, }: UseArrowNavigationProps) => {
+    activeArrow: "up" | "down" | null;
+    setActiveArrow: import("react").Dispatch<import("react").SetStateAction<"up" | "down" | null>>;
+    hoveredArrow: "up" | "down" | null;
+    setHoveredArrow: import("react").Dispatch<import("react").SetStateAction<"up" | "down" | null>>;
+    handleUpArrowClick: (event: React.MouseEvent) => void;
+    handleDownArrowClick: (event: React.MouseEvent) => void;
+};
+export {};
+//# sourceMappingURL=useArrowNavigation.d.ts.map

package/dist/hooks/useArrowNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useArrowNavigation.d.ts","sourceRoot":"","sources":["../../src/hooks/useArrowNavigation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,UAAU,uBAAuB;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC9C,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC5C,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,kBAAkB,GAAI,qHAShC,uBAAuB;;;;;gCAUV,KAAK,CAAC,UAAU;kCAiChB,KAAK,CAAC,UAAU;CA2C/B,CAAC"}

package/dist/hooks/useAutoHide.d.ts

@@ -0,0 +1,19 @@
+/**
+ * useAutoHide.ts
+ * 스크롤바 자동 숨김 관련 로직
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+import { AutoHideConfig } from "../types";
+interface UseAutoHideProps {
+    autoHide: AutoHideConfig;
+    isScrollable: () => boolean;
+    setScrollbarVisible: (visible: boolean) => void;
+}
+export declare const useAutoHide: ({ autoHide, isScrollable, setScrollbarVisible, }: UseAutoHideProps) => {
+    clearHideTimer: () => void;
+    setHideTimer: (delay: number) => void;
+    hideTimeoutRef: import("react").MutableRefObject<NodeJS.Timeout | null>;
+};
+export {};
+//# sourceMappingURL=useAutoHide.d.ts.map

package/dist/hooks/useAutoHide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAutoHide.d.ts","sourceRoot":"","sources":["../../src/hooks/useAutoHide.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,UAAU,gBAAgB;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,mBAAmB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACnD;AAED,eAAO,MAAM,WAAW,GAAI,kDAIzB,gBAAgB;;0BAaH,MAAM;;CAiBrB,CAAC"}

package/dist/hooks/useDragScroll.d.ts

@@ -0,0 +1,23 @@
+/**
+ * useDragScroll.ts
+ * 드래그 스크롤 관련 로직
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+import { DragScrollConfig } from "../types";
+interface UseDragScrollProps {
+    dragScroll: DragScrollConfig;
+    findScrollableElement: () => HTMLElement | null;
+    clearHideTimer: () => void;
+    setScrollbarVisible: (visible: boolean) => void;
+    updateScrollbar: () => void;
+    setHideTimer: (delay: number) => void;
+    hideDelay: number;
+    isScrollable: () => boolean;
+}
+export declare const useDragScroll: ({ dragScroll, findScrollableElement, clearHideTimer, setScrollbarVisible, updateScrollbar, setHideTimer, hideDelay, isScrollable, }: UseDragScrollProps) => {
+    isDragScrolling: boolean;
+    handleDragScrollStart: (event: React.MouseEvent) => void;
+};
+export {};
+//# sourceMappingURL=useDragScroll.d.ts.map

package/dist/hooks/useDragScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDragScroll.d.ts","sourceRoot":"","sources":["../../src/hooks/useDragScroll.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C,UAAU,kBAAkB;IACxB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,qBAAqB,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAChD,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;CAC/B;AAED,eAAO,MAAM,aAAa,GAAI,qIAS3B,kBAAkB;;mCAeL,KAAK,CAAC,UAAU;CAsH/B,CAAC"}

package/dist/hooks/useKeyboardNavigation.d.ts

@@ -0,0 +1,18 @@
+/**
+ * useKeyboardNavigation.ts
+ * 키보드 네비게이션 관련 로직 (방향키, PageUp/PageDown/Home/End)
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+interface UseKeyboardNavigationProps {
+    containerRef: React.RefObject<HTMLDivElement>;
+    findScrollableElement: () => HTMLElement | null;
+    updateScrollbar: () => void;
+    clearHideTimer: () => void;
+    setScrollbarVisible: (visible: boolean) => void;
+    setHideTimer: (delay: number) => void;
+    hideDelay: number;
+}
+export declare const useKeyboardNavigation: ({ containerRef, findScrollableElement, updateScrollbar, clearHideTimer, setScrollbarVisible, setHideTimer, hideDelay, }: UseKeyboardNavigationProps) => void;
+export {};
+//# sourceMappingURL=useKeyboardNavigation.d.ts.map

package/dist/hooks/useKeyboardNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardNavigation.d.ts","sourceRoot":"","sources":["../../src/hooks/useKeyboardNavigation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,UAAU,0BAA0B;IAChC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC9C,qBAAqB,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAChD,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,mBAAmB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,qBAAqB,GAAI,yHAQnC,0BAA0B,SA+F5B,CAAC"}

package/dist/hooks/useScrollEvents.d.ts

@@ -0,0 +1,20 @@
+/**
+ * useScrollEvents.ts
+ * 스크롤 이벤트 관련 로직
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+import { AutoHideConfig } from "../types";
+interface UseScrollEventsProps {
+    containerRef: React.RefObject<HTMLDivElement>;
+    findScrollableElement: () => HTMLElement | null;
+    updateScrollbar: () => void;
+    clearHideTimer: () => void;
+    setScrollbarVisible: (visible: boolean) => void;
+    setHideTimer: (delay: number) => void;
+    autoHide: AutoHideConfig;
+    onScroll?: (event: Event) => void;
+}
+export declare const useScrollEvents: ({ containerRef, findScrollableElement, updateScrollbar, clearHideTimer, setScrollbarVisible, setHideTimer, autoHide, onScroll, }: UseScrollEventsProps) => void;
+export {};
+//# sourceMappingURL=useScrollEvents.d.ts.map

package/dist/hooks/useScrollEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollEvents.d.ts","sourceRoot":"","sources":["../../src/hooks/useScrollEvents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,UAAU,oBAAoB;IAC1B,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC9C,qBAAqB,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAChD,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,mBAAmB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC;AAED,eAAO,MAAM,eAAe,GAAI,kIAS7B,oBAAoB,SA+JtB,CAAC"}

package/dist/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" | "outside";
+        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/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/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/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/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/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/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/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/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/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/index.d.ts

@@ -1,4 +1,9 @@
-export { default } from "./src/OverlayScrollbar";
-export { default as OverlayScrollbar } from "./src/OverlayScrollbar";
-export type { OverlayScrollbarRef, OverlayScrollbarProps, ThumbConfig, TrackConfig, ArrowsConfig, DragScrollConfig, AutoHideConfig, } from "./src/types";
+/**
+ * src/index.ts
+ *
+ * @copyright 2025 KIM YOUNG JIN (ehfuse@gmail.com)
+ */
+export { default } from "./OverlayScrollbar";
+export { default as OverlayScrollbar } from "./OverlayScrollbar";
+export type { OverlayScrollbarRef, OverlayScrollbarProps, ThumbConfig, TrackConfig, ArrowsConfig, DragScrollConfig, AutoHideConfig, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACrE,YAAY,EACR,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACjB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,YAAY,EACR,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACjB,MAAM,SAAS,CAAC"}