//#region src/hooks/useScrollRestoration/index.d.ts
interface UseScrollRestorationOptions {
  id?: string;
  enabled?: boolean;
  behavior?: ScrollOptions['behavior'];
  retry?: number;
}
interface UseScrollRestorationReturnType<T extends HTMLElement> {
  ref: React.RefObject<T | null>;
}
/**
 * @description 브라우저 또는 특정 엘리먼트의 이전 스크롤 위치를 저장하고 복원하는 커스텀 훅입니다.
 *
 * @remarks
 * - 콘텐츠가 비동기적으로 로드되는 경우 혹은 이미지 로드로 인해 저장된 스크롤 위치보다 페이지 높이가 작을 수 있습니다.
 * - 이런 경우 자동으로 재시도하며, `지수 백오프(exponential backoff)` 방식으로 재시도 간격이 증가합니다.
 * - 재시도 간격: 100ms → 200ms → 400ms → 800ms → 1600ms
 * - 기본 최대 재시도 횟수는 `5회`이며, `retry` 옵션으로 조정할 수 있습니다.
 *
 * @remarks
 * - 한 컴포넌트 내에서 여러 번 훅을 사용할 경우, 각 인스턴스를 구분하려면 `id` 옵션을 명시적으로 부여하세요.
 * - 별도의 `id`를 지정하지 않으면, `ref`가 있는 경우 `'element'`, 없는 경우는 `'window'`로 기본값이 설정됩니다.
 * - id를 부여하지 않은 경우, 중복 key로 인해 스크롤 복원 동작이 정상적으로 동작하지 않을 수 있으니 주의가 필요합니다.
 *
 * @remarks
 * - 스크롤 위치 저장은 새로고침, 페이지 이동(뒤로/앞으로가기), 훅의 언마운트 시점에 이루어집니다.
 * - 따라서, 컴포넌트가 언마운트되지 않고 유지되는 구조에서 해당 훅을 호출 시 스크롤 복원 동작이 정상적으로 동작하지 않을 수 있으니 주의가 필요합니다. (예: Layout 컴포넌트)
 *
 * @remarks
 * - URL에 hash fragment(#section)가 있는 경우 스크롤 복원을 하지 않습니다.
 * - 이는 hash 스크롤이라는 명확한 사용자 의도를 존중하고, 브라우저의 표준 동작과 충돌을 방지하기 위함입니다.
 *
 * @template T - 스크롤 복원 대상 엘리먼트 타입
 * @param {UseScrollRestorationOptions} options - 스크롤 복원 옵션
 * @param {string} options.id - 스크롤 복원 식별자 (다중 인스턴스 사용 시 필수)
 * @param {boolean} [options.enabled=true] - 스크롤 복원 활성화 여부
 * @param {number} [options.retry=5] - 스크롤 복원 재시도 횟수 (지수 백오프 적용)
 * @param {ScrollOptions['behavior']} [options.behavior='instant'] - 스크롤 복원 동작 옵션
 * @returns {{ ref: React.RefObject<T> }} 스크롤 복원 대상 엘리먼트 ref 객체
 *
 * @example
 * ```ts
 * // window 스크롤 복원
 * useScrollRestoration();
 * ```
 *
 * @example
 * ```tsx
 * // 특정 엘리먼트 스크롤 복원
 * const { ref } = useScrollRestoration<HTMLDivElement>();
 * return <div ref={ref}>...</div>;
 * ```
 *
 * @example
 * ```ts
 * // 다중 인스턴스 스크롤 복원
 * useScrollRestoration();
 * const { ref: ref1 } = useScrollRestoration<HTMLDivElement>({ id: 'sidebar1' });
 * const { ref: ref2 } = useScrollRestoration<HTMLDivElement>({ id: 'sidebar2' });
 *
 * return (
 *   <div>
 *     <div ref={ref1}>...</div>
 *     <div ref={ref2}>...</div>
 *   </div>
 * );
 * ```
 */
declare function useScrollRestoration<T extends HTMLElement>({
  id,
  enabled,
  behavior,
  retry
}?: UseScrollRestorationOptions): UseScrollRestorationReturnType<T>;
//#endregion
export { useScrollRestoration };
//# sourceMappingURL=index.d.ts.map