for-humanity 0.4.4 → 0.6.0

package/src/client.ts

@@ -1,335 +0,0 @@
-/*
- * 브라우저 동작 · 모바일 탐색, 커서 장식, 읽는 절, hash 위치 보정
- * 서버 HTML의 data-* 연결 · React hydration 없음
- */
-
-import {heading_highlight_hold_ms} from "@/component/widget/prose/_constant/heading-highlight";
-import {cursor_face_offset_px, cursor_face_storage_key} from "@/component/widget/shell/_constant/cursor-face";
-import {reading_line_slack_px} from "@/component/widget/shell/_constant/reading-line";
-import {bindMobileNavigation} from "@/component/widget/shell/_function/bind-mobile-navigation";
-import {bindNavigationScroll} from "@/component/widget/shell/_function/bind-navigation-scroll";
-import {findHashTarget} from "@/util/dom/find-hash-target";
-import {revealHashTarget} from "@/util/dom/reveal-hash-target";
-
-bindMobileNavigation();
-bindNavigationScroll();
-
-const cursorFace = document.querySelector<HTMLImageElement>("[data-cursor-face]");
-
-if (cursorFace) {
-    const cursorMedia = matchMedia("(hover: hover) and (pointer: fine) and (prefers-reduced-motion: no-preference)");
-    const position = {x: 0, y: 0, frame: 0};
-
-    /**
-     * 터치 전환과 화면 이탈 시 예약된 이동도 취소해 장식이 다시 나타나지 않게 함
-     */
-    const handleCursorHide = () => {
-        cancelAnimationFrame(position.frame);
-        position.frame = 0;
-        cursorFace.classList.remove("wg_shell__cursorFace--visible");
-    };
-
-    /**
-     * 비활성 전환에서만 숨김 · 활성화 알림이 새 마우스 이동을 취소하지 않도록 함
-     */
-    const handleCursorMediaChange = () => {
-        if (!cursorMedia.matches) {
-            handleCursorHide();
-        }
-    };
-
-    /**
-     * 이동·화면 크기 변경·문서 진입에 같은 위치 계산 적용 · 화면 갱신마다 한 번만 반영
-     */
-    const renderCursorFace = () => {
-        if (position.frame !== 0) {
-            return;
-        }
-
-        position.frame = requestAnimationFrame(() => {
-            position.frame = 0;
-
-            // 포인터 좌표는 실행 중에만 결정 · transform으로 문서 재배치 방지
-            cursorFace.style.transform = `translate3d(
-                ${Math.max(0, Math.min(position.x + cursor_face_offset_px, document.documentElement.clientWidth - cursorFace.width - cursor_face_offset_px))}px,
-                ${Math.max(0, Math.min(position.y + cursor_face_offset_px, document.documentElement.clientHeight - cursorFace.height - cursor_face_offset_px))}px,
-                0
-            )`;
-            cursorFace.classList.add("wg_shell__cursorFace--visible");
-        });
-    };
-
-    /**
-     * 누른 상태도 마우스 입력으로 처리 · 클릭·텍스트 선택 중에도 얼굴 유지
-     */
-    const handleDocumentPointer = (event: PointerEvent) => {
-        const isMouse = cursorMedia.matches && event.pointerType === "mouse";
-
-        if (!isMouse) {
-            handleCursorHide();
-
-            return;
-        }
-
-        position.x = event.clientX;
-        position.y = event.clientY;
-        renderCursorFace();
-    };
-
-    /**
-     * 이미 보이는 얼굴을 새 화면 크기에 맞춰 이동 · 추가 마우스 이동 불필요
-     */
-    const handleCursorResize = () => {
-        if (cursorFace.classList.contains("wg_shell__cursorFace--visible")) {
-            renderCursorFace();
-        }
-    };
-
-    /**
-     * 전체 페이지 이동에서도 마지막 좌표 유지 · 저장 실패는 기본 마우스 동작에 영향 없음
-     */
-    const handlePageHide = () => {
-        if (!cursorFace.classList.contains("wg_shell__cursorFace--visible")) {
-            return;
-        }
-
-        try {
-            sessionStorage.setItem(cursor_face_storage_key, JSON.stringify({x: position.x, y: position.y}));
-        } catch {
-            // 저장소가 막힌 환경에서도 클릭·선택과 현재 페이지의 장식 유지
-        }
-    };
-
-    /**
-     * 첫 진입과 BFCache 복귀에서 좌표를 한 번 소비 · 이전 문서의 위치가 남지 않도록 삭제
-     */
-    const handlePageShow = () => {
-        try {
-            const stored = sessionStorage.getItem(cursor_face_storage_key);
-
-            sessionStorage.removeItem(cursor_face_storage_key);
-
-            if (stored !== null && cursorMedia.matches) {
-                const point: unknown = JSON.parse(stored);
-                // 속성 타입의 좁히기를 유지하도록 저장소 검증과 사용을 같은 분기에 둠
-                if (
-                    typeof point === "object" &&
-                    point !== null &&
-                    "x" in point &&
-                    "y" in point &&
-                    typeof point.x === "number" &&
-                    typeof point.y === "number" &&
-                    Number.isFinite(point.x) &&
-                    Number.isFinite(point.y)
-                ) {
-                    position.x = point.x;
-                    position.y = point.y;
-                    renderCursorFace();
-                }
-            }
-        } catch {
-            // 저장 실패나 잘못된 좌표는 무시하고 다음 실제 마우스 입력에서 표시
-        }
-    };
-
-    handlePageShow();
-
-    document.addEventListener("pointermove", handleDocumentPointer, {passive: true});
-    document.addEventListener("pointerdown", handleDocumentPointer, {passive: true});
-    document.documentElement.addEventListener("pointerleave", handleCursorHide);
-    addEventListener("blur", handleCursorHide);
-    addEventListener("resize", handleCursorResize);
-    addEventListener("pagehide", handlePageHide);
-    addEventListener("pageshow", handlePageShow);
-    cursorMedia.addEventListener("change", handleCursorMediaChange);
-}
-
-const hashTarget = revealHashTarget(location.hash);
-
-// 값 조립이 아닌 현재 강조의 수명 상태 · 새 이동은 이전 타이머를 취소
-let highlightedHeading: HTMLElement | null = null;
-let highlightTimer = 0;
-let highlightScroll: AbortController | null = null;
-
-/**
- * 강조 해제와 도착 감시 정리 · 다음 앵커의 오래된 타이머 개입 방지
- */
-const clearHeadingHighlight = () => {
-    clearTimeout(highlightTimer);
-    highlightScroll?.abort();
-    highlightScroll = null;
-    highlightedHeading?.classList.remove("wg_prose__headingText--highlighted");
-    highlightedHeading = null;
-};
-
-/**
- * 도착한 제목만 잠시 강조 · 같은 대상 재클릭도 유지 시간 재시작
- */
-const highlightHeading = (target: HTMLElement | null) => {
-    clearHeadingHighlight();
-    highlightedHeading = target === null ? null : target.querySelector<HTMLElement>(".wg_prose__headingText");
-
-    if (highlightedHeading === null) {
-        return;
-    }
-
-    highlightedHeading.classList.add("wg_prose__headingText--highlighted");
-    highlightTimer = window.setTimeout(clearHeadingHighlight, heading_highlight_hold_ms);
-    highlightScroll = new AbortController();
-
-    // 부드러운 스크롤이 끝난 뒤에도 3초 확보 · 움직이지 않거나 scrollend가 없으면 위 타이머 사용
-    document.addEventListener("scrollend", handleHighlightArrival, {signal: highlightScroll.signal});
-};
-
-/**
- * 본문 스크롤의 첫 도착에서 유지 시간 갱신 · 사이드바 스크롤은 제외
- */
-const handleHighlightArrival = (event: Event) => {
-    if (event.target !== document) {
-        return;
-    }
-
-    clearTimeout(highlightTimer);
-    highlightScroll?.abort();
-    highlightScroll = null;
-    highlightTimer = window.setTimeout(clearHeadingHighlight, heading_highlight_hold_ms);
-};
-
-/**
- * 같은 hash를 다시 눌러도 접힌 대상 공개 · 기본 링크 이동 유지
- */
-const handleHashClick = (event: MouseEvent) => {
-    if (event.defaultPrevented || event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {
-        return;
-    }
-
-    if (
-        event.currentTarget instanceof HTMLAnchorElement &&
-        (event.currentTarget.target === "" || event.currentTarget.target === "_self") &&
-        !event.currentTarget.hasAttribute("download") &&
-        event.currentTarget.origin === location.origin &&
-        event.currentTarget.pathname === location.pathname &&
-        event.currentTarget.search === location.search &&
-        event.currentTarget.hash
-    ) {
-        const target = revealHashTarget(event.currentTarget.hash);
-
-        if (event.currentTarget.hash === location.hash) {
-            highlightHeading(target);
-        }
-    }
-};
-
-/**
- * hash 변경의 숨은 대상 공개와 위치 보정
- */
-const handleHashChange = () => {
-    const target = revealHashTarget(location.hash);
-
-    target?.scrollIntoView();
-    highlightHeading(target);
-};
-
-for (const link of document.querySelectorAll<HTMLAnchorElement>("a[href]")) {
-    link.addEventListener("click", handleHashClick);
-}
-
-addEventListener("hashchange", handleHashChange);
-
-// 목차 링크와 실제 제목 연결
-const tocSections = [...document.querySelectorAll<HTMLAnchorElement>("[data-toc-link]")].flatMap((link) => {
-    const heading = findHashTarget(link.hash);
-    const item = link.parentElement;
-
-    if (!heading || !item) {
-        return [];
-    }
-
-    return [
-        {
-            heading,
-            link,
-            item,
-            list: item.parentElement,
-            subs: [...item.querySelectorAll<HTMLAnchorElement>("[data-toc-sub-link]")].flatMap((sub) => {
-                const subHeading = findHashTarget(sub.hash);
-                const subItem = sub.parentElement;
-
-                return subHeading && subItem ? [{heading: subHeading, link: sub, item: subItem}] : [];
-            }),
-        },
-    ];
-});
-const firstSection = tocSections.at(0);
-
-if (firstSection) {
-    /**
-     * 읽는 선 기준 절·소제목 표시
-     * 기준: 제목의 scroll-margin-top + reading_line_slack_px
-     */
-    const markActive = () => {
-        // scroll-margin-top 계산값: CSS px
-        const line = Number.parseFloat(getComputedStyle(firstSection.heading).scrollMarginTop) + reading_line_slack_px;
-        // 접힌 Details 안 제목은 좌표가 남아도 현재 위치에서 제외
-        const current = tocSections.findLast((section) => section.heading.checkVisibility() && section.heading.getBoundingClientRect().top <= line) ?? firstSection;
-        const sub = current.subs.findLast((item) => item.heading.checkVisibility() && item.heading.getBoundingClientRect().top <= line);
-        const currentIndex = tocSections.indexOf(current);
-        const currentSubIndex = sub === undefined ? -1 : current.subs.indexOf(sub);
-
-        for (const [index, section] of tocSections.entries()) {
-            const active = section === current && sub === undefined;
-            section.link.classList.toggle("wg_shellToc__link--active", active);
-            if (active) {
-                section.link.setAttribute("aria-current", "location");
-            } else {
-                section.link.removeAttribute("aria-current");
-            }
-            section.item.classList.toggle("wg_shellToc__item--trail", section.list === current.list && index < currentIndex);
-            section.item.classList.toggle("wg_shellToc__item--current", section === current);
-
-            for (const [subIndex, item] of section.subs.entries()) {
-                item.link.classList.toggle("wg_shellToc__subLink--active", item === sub);
-                if (item === sub) {
-                    item.link.setAttribute("aria-current", "location");
-                } else {
-                    item.link.removeAttribute("aria-current");
-                }
-                item.item.classList.toggle("wg_shellToc__subItem--trail", section === current && subIndex < currentSubIndex);
-                item.item.classList.toggle("wg_shellToc__subItem--current", item === sub);
-            }
-        }
-    };
-
-    addEventListener("scroll", markActive, {passive: true});
-    addEventListener("resize", markActive);
-    addEventListener("toggle", markActive, true);
-    markActive();
-}
-
-const userScroll = new AbortController();
-
-for (const type of ["wheel", "touchmove", "keydown", "mousedown"]) {
-    addEventListener(type, () => userScroll.abort(), {once: true, passive: true});
-}
-
-/**
- * 글꼴 로드 후 hash 위치 보정 · 사용자 입력 시 자동 이동 취소
- * 초기 smooth scroll과 보정의 충돌 방지 · 보정 후 CSS 동작 복원
- */
-const settleHashScroll = async () => {
-    await document.fonts.ready;
-
-    if (hashTarget && !userScroll.signal.aborted) {
-        hashTarget.scrollIntoView({behavior: "instant"});
-        highlightHeading(hashTarget);
-    }
-
-    document.documentElement.style.removeProperty("scroll-behavior");
-};
-
-// 글꼴 요청 완료 시점 보장 · load 후 fonts.ready
-if (document.readyState === "complete") {
-    settleHashScroll();
-} else {
-    addEventListener("load", settleHashScroll, {once: true});
-}

package/src/component/widget/shell/_constant/navigation.ts

@@ -1,9 +0,0 @@
-/**
- * 모바일 탐색 전환 · wg-shell.css의 폭 조건과 일치
- */
-export const navigation_mobile_query = "(width < 1024px)";
-
-/**
- * 같은 탭에서 문서 이동 후 탐색 위치 복원 · 데스크톱과 드로어는 별도 저장
- */
-export const navigation_scroll_storage_key = "for-humanity:navigation-scroll";

package/src/component/widget/shell/_function/bind-mobile-navigation.ts

@@ -1,147 +0,0 @@
-import {navigation_mobile_query} from "@/component/widget/shell/_constant/navigation";
-import {revealHashTarget} from "@/util/dom/reveal-hash-target";
-
-/**
- * 같은 문서 탐색을 데스크톱 사이드바와 모바일 모달 사이에서 이동
- * 닫기·크기 변경에서 스크롤과 포커스 복원 · 초기화 실패 시 기본 목록 유지
- */
-export const bindMobileNavigation = () => {
-    const navigation = document.querySelector<HTMLElement>("[data-navigation]");
-    const dialog = document.querySelector<HTMLDialogElement>("[data-navigation-drawer]");
-    const content = document.querySelector<HTMLElement>("[data-navigation-content]");
-    const openButton = document.querySelector<HTMLButtonElement>("[data-navigation-open]");
-    const closeButton = document.querySelector<HTMLButtonElement>("[data-navigation-close]");
-    const sidebar = navigation?.parentElement;
-
-    if (!navigation || !dialog || !content || !openButton || !closeButton || !sidebar) {
-        return;
-    }
-
-    const mobile = matchMedia(navigation_mobile_query);
-
-    /**
-     * Escape 등 네이티브 닫기에서도 배경 스크롤과 버튼의 상태 복원
-     */
-    const handleClose = () => {
-        // 닫기 직후 다시 연 모달에 이전 close 이벤트가 개입하지 않도록 함
-        if (dialog.open) {
-            return;
-        }
-
-        document.body.classList.remove("wg_shell__root--drawerOpen");
-        openButton.setAttribute("aria-expanded", "false");
-    };
-
-    /**
-     * 기본 링크 이동보다 먼저 잠금 해제 · 네이티브 close가 열기 버튼으로 포커스 복원
-     */
-    const closeNavigation = () => {
-        dialog.close();
-        handleClose();
-    };
-
-    /**
-     * 네이티브 모달로 외부 포커스 차단 · 모바일에서만 열기
-     */
-    const handleOpen = () => {
-        if (!mobile.matches || dialog.open) {
-            return;
-        }
-
-        dialog.showModal();
-        document.body.classList.add("wg_shell__root--drawerOpen");
-        openButton.setAttribute("aria-expanded", "true");
-    };
-
-    /**
-     * 대화상자 바깥 배경 클릭만 닫기 · 내부의 빈 공간은 유지
-     */
-    const handleBackdropClick = (event: MouseEvent) => {
-        const bounds = dialog.getBoundingClientRect();
-
-        if (event.target === dialog && (event.clientX < bounds.left || event.clientX > bounds.right || event.clientY < bounds.top || event.clientY > bounds.bottom)) {
-            closeNavigation();
-        }
-    };
-
-    /**
-     * 링크의 기본 이동은 유지 · 목차는 닫은 뒤 실제 제목에 키보드 위치 전달
-     */
-    const handleNavigationClick = (event: MouseEvent) => {
-        if (
-            !dialog.open ||
-            event.defaultPrevented ||
-            event.button !== 0 ||
-            event.metaKey ||
-            event.ctrlKey ||
-            event.shiftKey ||
-            event.altKey ||
-            !(event.target instanceof Element)
-        ) {
-            return;
-        }
-
-        const link = event.target.closest("a[href]");
-
-        if (!(link instanceof HTMLAnchorElement) || (link.target !== "" && link.target !== "_self") || link.hasAttribute("download")) {
-            return;
-        }
-
-        closeNavigation();
-
-        if (link.origin === location.origin && link.pathname === location.pathname && link.search === location.search && link.hash) {
-            const target = revealHashTarget(link.hash);
-
-            if (target) {
-                target.tabIndex = -1;
-                target.focus({preventScroll: true});
-            }
-        }
-    };
-
-    /**
-     * 반응형 전환에도 목록 중복 없음 · 열린 모달을 데스크톱으로 가져가기 전에 닫기
-     */
-    const handleLayoutChange = () => {
-        const focused = document.activeElement;
-
-        if (mobile.matches) {
-            openButton.classList.add("wg_shell__menuToggle--visible");
-
-            if (navigation.parentElement !== content) {
-                content.append(navigation);
-            }
-
-            if (focused instanceof HTMLElement && navigation.contains(focused)) {
-                openButton.focus({preventScroll: true});
-            }
-
-            return;
-        }
-
-        closeNavigation();
-
-        // 첫 desktop 연결에서 같은 DOM을 재삽입하면 내부 스크롤이 0으로 초기화됨
-        if (navigation.parentElement !== sidebar) {
-            sidebar.append(navigation);
-        }
-
-        if (focused instanceof HTMLElement && navigation.contains(focused)) {
-            focused.focus({preventScroll: true});
-        } else if (focused === openButton || (focused instanceof HTMLElement && dialog.contains(focused))) {
-            sidebar.querySelector<HTMLAnchorElement>(".wg_shell__brand")?.focus({preventScroll: true});
-        }
-
-        // CSS의 폭 조건이 먼저 버튼을 숨겨 포커스가 사라지지 않도록 복원 후 숨김
-        openButton.classList.remove("wg_shell__menuToggle--visible");
-    };
-
-    openButton.addEventListener("click", handleOpen);
-    closeButton.addEventListener("click", closeNavigation);
-    dialog.addEventListener("close", handleClose);
-    dialog.addEventListener("click", handleBackdropClick);
-    navigation.addEventListener("click", handleNavigationClick);
-    mobile.addEventListener("change", handleLayoutChange);
-    handleLayoutChange();
-    sidebar.classList.add("wg_shell__sidebar--navigationReady");
-};

package/src/component/widget/shell/_function/bind-navigation-overflow.ts

@@ -1,47 +0,0 @@
-/**
- * 실제 남은 내용이 있는 위·아래 끝만 흐림 표시 · 스크롤·글꼴·화면 크기 추적
- * HTML 직후 직렬화해 실행하므로 import나 바깥 변수 없이 브라우저 DOM만 사용
- * 관찰자는 문서 수명 동안 유지 · BFCache 복귀에서도 같은 탐색 DOM 추적
- */
-export const bindNavigationOverflow = () => {
-    const ports = [...document.querySelectorAll<HTMLElement>("[data-navigation-scroll]")];
-    const frame = {id: 0};
-    // 소수 픽셀 반올림으로 끝에서 흐림이 남는 것을 방지
-    const edgeTolerance = 1;
-
-    /**
-     * 콘텐츠가 잘리는 끝만 표시 · 네이티브 스크롤은 그대로 사용
-     */
-    const updateOverflow = () => {
-        frame.id = 0;
-
-        for (const port of ports) {
-            port.classList.add("wg_shell__scroll--ready");
-            port.classList.toggle("wg_shell__scroll--above", port.scrollTop > edgeTolerance);
-            port.classList.toggle("wg_shell__scroll--below", port.scrollHeight - port.clientHeight - port.scrollTop > edgeTolerance);
-        }
-    };
-
-    /**
-     * 연속 스크롤과 크기 변경은 프레임당 한 번만 반영
-     */
-    const scheduleOverflow = () => {
-        if (frame.id === 0) {
-            frame.id = requestAnimationFrame(updateOverflow);
-        }
-    };
-
-    const observer = new ResizeObserver(scheduleOverflow);
-
-    for (const port of ports) {
-        port.addEventListener("scroll", scheduleOverflow, {passive: true});
-        observer.observe(port);
-
-        if (port.firstElementChild) {
-            observer.observe(port.firstElementChild);
-        }
-    }
-
-    addEventListener("pageshow", scheduleOverflow);
-    updateOverflow();
-};

package/src/component/widget/shell/_function/bind-navigation-scroll.ts

@@ -1,84 +0,0 @@
-import {navigation_mobile_query, navigation_scroll_storage_key} from "@/component/widget/shell/_constant/navigation";
-import {restoreNavigationScroll} from "@/component/widget/shell/_function/restore-navigation-scroll";
-
-/**
- * 문서 목록과 페이지 목차의 위치를 따로 저장 · TOC 길이가 목록 위치를 바꾸지 않음
- * 첫 데스크톱 복원은 HTML에서 완료 · 늦은 module 실행에서 다시 이동하지 않음
- */
-export const bindNavigationScroll = () => {
-    const navigation = document.querySelector<HTMLElement>("[data-navigation]");
-    const documents = document.querySelector<HTMLElement>('[data-navigation-scroll="documents"]');
-    const outline = document.querySelector<HTMLElement>('[data-navigation-scroll="outline"]');
-    const dialog = document.querySelector<HTMLDialogElement>("[data-navigation-drawer]");
-    const openButton = document.querySelector<HTMLButtonElement>("[data-navigation-open]");
-
-    if (!navigation || !documents || !outline || !dialog || !openButton) {
-        return;
-    }
-
-    const mobile = matchMedia(navigation_mobile_query);
-    const layout = {mobile: mobile.matches};
-    const ports = [documents, outline];
-    const positions = new Map<string, Map<HTMLElement, number>>();
-    const signature = [...navigation.querySelectorAll<HTMLAnchorElement>(".wg_shellNav__root a[href]")].map((link) => `${link.pathname}:${link.textContent}`).join("\n");
-
-    /**
-     * 숨김·닫기보다 먼저 마지막 위치 보존 · 저장소 차단 시에도 드로어 재열기 유지
-     */
-    const saveScroll = () => {
-        if (layout.mobile !== mobile.matches || (mobile.matches && !dialog.open)) {
-            return;
-        }
-
-        const key = `${navigation_scroll_storage_key}:${mobile.matches ? "drawer" : "desktop"}`;
-        positions.set(key, new Map(ports.map((port) => [port, port.scrollTop])));
-
-        try {
-            sessionStorage.setItem(key, JSON.stringify({navigation: signature, pathname: location.pathname, documents: documents.scrollTop, outline: outline.scrollTop}));
-        } catch {
-            // 현재 페이지 안의 위치는 메모리에 유지 · 저장 실패가 링크 이동을 막지 않음
-        }
-    };
-
-    /**
-     * 열기·반응형 DOM 이동 완료 후 화면별 위치 복원
-     */
-    const restoreScroll = () => {
-        layout.mobile = mobile.matches;
-
-        if (mobile.matches && !dialog.open) {
-            return;
-        }
-
-        const key = `${navigation_scroll_storage_key}:${mobile.matches ? "drawer" : "desktop"}`;
-        const saved = positions.get(key);
-
-        if (saved === undefined) {
-            restoreNavigationScroll(key);
-        } else {
-            for (const port of ports) {
-                const top = saved.get(port);
-
-                if (top !== undefined) {
-                    port.scrollTop = top;
-                }
-            }
-        }
-
-        saveScroll();
-    };
-
-    for (const port of ports) {
-        port.addEventListener("scroll", saveScroll, {passive: true});
-    }
-
-    // 캡처 단계에서 모바일의 기본 닫기보다 먼저 저장
-    navigation.addEventListener("click", saveScroll, {capture: true});
-    dialog.addEventListener("cancel", saveScroll);
-    dialog.querySelector("[data-navigation-close]")?.addEventListener("click", saveScroll, {capture: true});
-    dialog.addEventListener("click", saveScroll, {capture: true});
-    openButton.addEventListener("click", restoreScroll);
-    mobile.addEventListener("change", restoreScroll);
-    addEventListener("pagehide", saveScroll);
-    saveScroll();
-};

package/src/component/widget/shell/_function/restore-navigation-scroll.ts

@@ -1,47 +0,0 @@
-/**
- * 탐색 HTML 직후와 드로어 열기에서 저장 위치 복원 · 첫 paint 전 실행
- * HTML에 함수 본문을 직렬화하므로 import나 바깥 변수 없이 브라우저 DOM만 사용
- * @param storageKey 탭·화면 모드별 저장 키
- */
-export const restoreNavigationScroll = (storageKey: string) => {
-    const navigation = document.querySelector<HTMLElement>("[data-navigation]");
-    const documents = document.querySelector<HTMLElement>('[data-navigation-scroll="documents"]');
-    const outline = document.querySelector<HTMLElement>('[data-navigation-scroll="outline"]');
-
-    if (!navigation || !documents || !outline) {
-        return;
-    }
-
-    try {
-        const value = sessionStorage.getItem(storageKey);
-
-        if (value === null) {
-            return;
-        }
-
-        const stored: unknown = JSON.parse(value);
-        const signature = [...navigation.querySelectorAll<HTMLAnchorElement>(".wg_shellNav__root a[href]")].map((link) => `${link.pathname}:${link.textContent}`).join("\n");
-
-        if (typeof stored !== "object" || stored === null || !("navigation" in stored) || stored.navigation !== signature) {
-            return;
-        }
-
-        if ("documents" in stored && typeof stored.documents === "number" && Number.isFinite(stored.documents) && stored.documents >= 0) {
-            documents.scrollTop = stored.documents;
-        }
-
-        // 문서 목록은 공통 위치 · 목차는 같은 페이지에 다시 들어왔을 때만 복원
-        if (
-            "pathname" in stored &&
-            stored.pathname === location.pathname &&
-            "outline" in stored &&
-            typeof stored.outline === "number" &&
-            Number.isFinite(stored.outline) &&
-            stored.outline >= 0
-        ) {
-            outline.scrollTop = stored.outline;
-        }
-    } catch {
-        // 차단·손상된 저장소는 복원만 생략 · 기본 링크와 스크롤 유지
-    }
-};