for-humanity 0.12.0 → 0.13.1

package/src/component/widget/navigation/wg-navigation.css

@@ -1,282 +0,0 @@
-.wg_navigation__brandRow {
-    display: flex;
-
-    /* 두 스크롤 영역 바깥 · 목록과 목차 위에서 이름 고정 */
-    position: sticky;
-    top: 0;
-    z-index: var(--app-z-index-sticky);
-    align-self: start;
-    min-width: 0;
-    height: var(--app-size-brand);
-    padding-block: var(--app-space-page-top) var(--app-space-group);
-    background: var(--app-color-ground);
-    gap: var(--app-space-inline);
-    align-items: start;
-}
-
-.wg_navigation__brand {
-    display: block;
-    flex: 1;
-    min-width: 0;
-    overflow: hidden;
-    color: var(--app-color-text-strong);
-    font-family: var(--app-font-brand);
-    font-size: var(--app-font-size-title);
-    font-weight: var(--app-font-weight-mark);
-    line-height: var(--app-line-height-title);
-    letter-spacing: var(--app-letter-spacing-brand);
-    text-decoration: none;
-    text-overflow: ellipsis;
-    white-space: nowrap;
-
-    &:hover {
-        text-decoration: underline;
-    }
-
-    &:focus-visible {
-        /* 브랜드도 hover와 같은 밑줄로 키보드 위치 표시 */
-        outline: none;
-        text-decoration: underline;
-    }
-}
-
-.wg_navigation__menuIcon {
-    width: 20px;
-    height: 20px;
-    fill: none;
-    stroke: currentcolor;
-    stroke-linecap: round;
-    stroke-width: 1.5;
-}
-
-.wg_navigation__menuToggle {
-    display: none;
-    align-items: center;
-    justify-content: center;
-    flex: none;
-    width: var(--app-size-menu-button);
-    height: var(--app-size-menu-button);
-    padding: 0;
-    border: 0;
-    border-radius: var(--app-radius-box);
-    background: transparent;
-    color: var(--app-color-text-strong);
-    cursor: pointer;
-
-    &:hover {
-        background: var(--app-color-accent-soft);
-    }
-
-    &:focus-visible {
-        outline: var(--app-outline-focus);
-        outline-offset: var(--app-outline-focus-offset);
-    }
-}
-
-.wg_navigation__menuToggle--visible {
-    display: flex;
-}
-
-/* sticky 틀 안에서 문서 목록과 목차의 스크롤 높이를 독립 유지 */
-.wg_navigation__sidebar {
-    grid-area: nav;
-    position: sticky;
-    top: 0;
-    align-self: start;
-    min-width: 0;
-    height: 100dvh;
-    margin-inline-end: var(--app-space-sidebar-gap);
-}
-
-.wg_navigation__documents {
-    /* 모든 배치에서 남은 탐색 높이를 문서 목록 전체에 사용 */
-    flex: 1;
-    min-height: 0;
-}
-
-.wg_navigation__outline {
-    display: flex;
-    flex-direction: column;
-    flex: 1;
-    min-height: 0;
-
-    &:where(:has(.wg_navigation__headings:empty)) {
-        display: none;
-    }
-}
-
-.wg_navigation__headings {
-    flex: 1;
-    min-height: 0;
-}
-
-.wg_navigation__navigation {
-    display: flex;
-    flex-direction: column;
-    height: calc(100dvh - var(--app-size-brand));
-    min-width: 0;
-    min-height: 0;
-}
-
-.wg_navigation__tocRail {
-    /* body의 오른쪽 grid 열 · 문서 스크롤과 독립된 뷰포트 기준 sticky */
-    grid-area: outline;
-    position: sticky;
-    top: 0;
-    align-self: start;
-    min-width: 0;
-    height: 100dvh;
-    margin-inline-start: var(--app-space-sidebar-gap);
-    padding-top: var(--app-size-brand);
-
-    & > .wg_navigation__outline {
-        height: 100%;
-    }
-
-    &:where(:has(.wg_navigation__headings:empty)) {
-        display: none;
-    }
-}
-
-.wg_navigation__scroll {
-    overflow-y: auto;
-    overscroll-behavior-y: contain;
-    scroll-padding-block: var(--app-size-navigation-fade);
-}
-
-.wg_navigation__scroll--ready {
-    /* 흐림으로 넘침을 알릴 때만 손잡이 숨김 · JS 없으면 네이티브 손잡이 유지 */
-    scrollbar-width: none;
-}
-
-.wg_navigation__scroll--above {
-    mask-image: linear-gradient(to bottom, transparent, #000 var(--app-size-navigation-fade));
-}
-
-.wg_navigation__scroll--below {
-    mask-image: linear-gradient(to bottom, #000 calc(100% - var(--app-size-navigation-fade)), transparent);
-}
-
-.wg_navigation__scroll--above.wg_navigation__scroll--below {
-    mask-image: linear-gradient(to bottom, transparent, #000 var(--app-size-navigation-fade), #000 calc(100% - var(--app-size-navigation-fade)), transparent);
-}
-
-.wg_navigation__drawer {
-    /* 네이티브 모달의 top layer · 뷰포트 왼쪽에 고정 */
-    position: fixed;
-    inset: 0 auto 0 0;
-    width: min(var(--app-size-drawer), calc(100% - var(--app-space-gutter) * 2));
-    max-width: none;
-    height: 100dvh;
-    max-height: 100dvh;
-    margin: 0;
-    padding: 0 var(--app-space-gutter) var(--app-space-group);
-    border: 0;
-    border-right: 1px solid var(--app-color-border-layout);
-    background: var(--app-color-ground);
-    color: var(--app-color-text);
-    overflow: hidden;
-
-    &::backdrop {
-        background: var(--app-color-backdrop);
-    }
-}
-
-.wg_navigation__drawerHeader {
-    /* 두 스크롤 영역 바깥에서 닫기 버튼 유지 */
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    gap: var(--app-space-inline);
-    min-height: var(--app-size-mobile-header);
-    margin-bottom: var(--app-space-block);
-    background: var(--app-color-ground);
-}
-
-.wg_navigation__drawerTitle {
-    margin: 0;
-    font-size: var(--app-font-size-part);
-    font-weight: var(--app-font-weight-strong);
-}
-
-.wg_navigation__drawerClose {
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    flex: none;
-    width: var(--app-size-menu-button);
-    height: var(--app-size-menu-button);
-    padding: 0;
-    border: 0;
-    border-radius: var(--app-radius-box);
-    background: transparent;
-    color: var(--app-color-text-strong);
-    cursor: pointer;
-
-    &:hover {
-        background: var(--app-color-accent-soft);
-    }
-
-    &:focus-visible {
-        outline: var(--app-outline-focus);
-        outline-offset: var(--app-outline-focus-offset);
-    }
-}
-
-.wg_navigation__drawerContent {
-    min-width: 0;
-    height: calc(100% - var(--app-size-mobile-header) - var(--app-space-block));
-
-    & > .wg_navigation__navigation {
-        height: 100%;
-    }
-}
-
-/* 강제 색상 환경은 흐림 대신 시스템 손잡이로 넘침 표시 */
-@media (forced-colors: active) {
-    .wg_navigation__scroll {
-        mask-image: none;
-        scrollbar-width: thin;
-        scrollbar-color: auto;
-    }
-}
-
-/* 와이드 화면에서만 현재 문서 목차 표시 */
-@media (width < 1360px) {
-    .wg_navigation__tocRail {
-        display: none;
-    }
-}
-
-@media (width < 1024px) {
-    .wg_navigation__sidebar {
-        position: static;
-        height: auto;
-        margin-block-end: var(--app-space-block);
-        margin-inline-end: 0;
-        border-bottom: 1px solid var(--app-color-border-layout);
-    }
-
-    .wg_navigation__sidebar > .wg_navigation__navigation {
-        height: auto;
-    }
-
-    .wg_navigation__sidebar > .wg_navigation__navigation > .wg_navigation__documents {
-        max-height: none;
-    }
-
-    .wg_navigation__sidebar--navigationReady {
-        /* 본문을 스크롤해도 메뉴 진입 유지 · 스크립트 없는 긴 목록에는 적용하지 않음 */
-        position: sticky;
-        top: 0;
-        z-index: var(--app-z-index-sticky);
-        background: var(--app-color-ground);
-    }
-
-    .wg_navigation__brandRow {
-        position: static;
-        height: var(--app-size-mobile-header);
-        padding-block: 0;
-        align-items: center;
-    }
-}

package/src/component/widget/navigation/wg-navigation.tsx

@@ -1,420 +0,0 @@
-import clsx from "clsx";
-import {type DOMAttributes, Fragment, useLayoutEffect, useRef, useState} from "hono/jsx";
-import {flushSync} from "hono/jsx/dom";
-import {navigation_mobile_query, navigation_wide_query} from "@/component/widget/navigation/_constant/navigation";
-import {restoreNavigationScroll} from "@/component/widget/navigation/_function/restore-navigation-scroll";
-import type {NavigationData} from "@/component/widget/navigation/_type/navigation-data";
-import type {NavigationFocusSnapshot} from "@/component/widget/navigation/_type/navigation-focus-snapshot";
-import {WgNavigationNav} from "@/component/widget/navigation/_wg-navigation-nav";
-import {WgNavigationScroll} from "@/component/widget/navigation/_wg-navigation-scroll";
-import {WgNavigationToc} from "@/component/widget/navigation/_wg-navigation-toc";
-import {copy_nav_close, copy_nav_open, copy_nav_title} from "@/constant/copy";
-import type {createNavigationStores} from "@/store/navigation/create-navigation-stores";
-import type {NavigationLayout, NavigationPosition} from "@/store/navigation/navigation-state";
-import {navigation_scroll_storage_key, navigation_storage_version} from "@/store/navigation/navigation-storage";
-import {toNavigationScrollState} from "@/store/navigation/to-navigation-scroll-state";
-import {revealHashTarget} from "@/util/dom/reveal-hash-target";
-import "./wg-navigation.css";
-
-/**
- * 같은 Hono 탐색을 서버에서는 기본 링크로, 브라우저에서는 사용자 저장 상태로 렌더
- */
-export interface WgNavigationProps {
-    /**
-     * 서버가 정리한 문서 목록과 현재 페이지 목차
-     */
-    data: NavigationData;
-    /**
-     * 브라우저 진입점만 제공 · 없으면 저장소와 전역 DOM을 읽지 않음
-     */
-    stores?: ReturnType<typeof createNavigationStores>;
-}
-
-export const WgNavigation = (props: WgNavigationProps) => {
-    const [layout, setLayout] = useState<NavigationLayout>(() => {
-        if (props.stores === undefined) return "desktop";
-        if (matchMedia(navigation_mobile_query).matches) return "drawer";
-        return matchMedia(navigation_wide_query).matches ? "wide" : "desktop";
-    });
-    const [drawerOpen, setDrawerOpen] = useState(false);
-    const navigationRef = useRef<HTMLDivElement | null>(null);
-    const documentsRef = useRef<HTMLDivElement | null>(null);
-    const drawerNavigationRef = useRef<HTMLDivElement | null>(null);
-    const drawerDocumentsRef = useRef<HTMLDivElement | null>(null);
-    const outlineRef = useRef<HTMLDivElement | null>(null);
-    const dialogRef = useRef<HTMLDialogElement | null>(null);
-    const openButtonRef = useRef<HTMLButtonElement | null>(null);
-    const brandRef = useRef<HTMLAnchorElement | null>(null);
-    const mobileRef = useRef<MediaQueryList | null>(null);
-    const wideRef = useRef<MediaQueryList | null>(null);
-    const layoutRef = useRef(layout);
-    const focusRef = useRef<NavigationFocusSnapshot | null>(null);
-    const restorePendingRef = useRef(true);
-
-    /**
-     * 저장된 배치와 현재 CSS 조건을 구분 · 조건 변경 직후 잘린 좌표를 이전 배치에 저장하지 않음
-     */
-    const getNavigationLayout = (): NavigationLayout => {
-        if (mobileRef.current === null || wideRef.current === null) return layoutRef.current;
-        if (mobileRef.current.matches) return "drawer";
-        return wideRef.current.matches ? "wide" : "desktop";
-    };
-
-    /**
-     * Hono의 이전 노드 정리가 새 배치 참조를 비우지 않도록 두 배치의 DOM 참조를 별도로 유지
-     */
-    const getNavigationPort = () => {
-        return layoutRef.current === "drawer" ? drawerNavigationRef.current : navigationRef.current;
-    };
-
-    /**
-     * 배치별 DOM은 분리하되 좌표 저장과 복원은 현재 표시되는 한 영역을 소비
-     */
-    const getDocumentsPort = () => {
-        return layoutRef.current === "drawer" ? drawerDocumentsRef.current : documentsRef.current;
-    };
-
-    /**
-     * 모든 링크의 URL·표시명으로 사이트 공통 문서 목록의 동일성 판정
-     */
-    const getNavigationSignature = () => {
-        const navigation = getNavigationPort();
-        if (navigation === null) return undefined;
-        return [...navigation.querySelectorAll<HTMLAnchorElement>(".wg_navigationNav__root a[href]")].map((link) => `${link.pathname}:${link.textContent}`).join("\n");
-    };
-
-    /**
-     * 닫기·이동보다 먼저 실제 좌표 보존 · 숨긴 모달과 아직 복원하지 않은 배치는 저장하지 않음
-     */
-    const saveScroll = () => {
-        const documents = getDocumentsPort();
-        if (
-            props.stores === undefined ||
-            documents === null ||
-            outlineRef.current === null ||
-            restorePendingRef.current ||
-            layoutRef.current !== getNavigationLayout() ||
-            (layoutRef.current === "drawer" && dialogRef.current?.open !== true)
-        ) {
-            return;
-        }
-        const signature = getNavigationSignature();
-        if (signature === undefined) return;
-        const navigationPosition: NavigationPosition = {
-            navigation: signature,
-            pathname: location.pathname,
-            documents: documents.scrollTop,
-            outline: outlineRef.current.scrollTop,
-        };
-        props.stores.scroll.setState((state) => ({
-            positions: {
-                ...state.positions,
-                [layoutRef.current]: navigationPosition,
-            },
-        }));
-    };
-
-    /**
-     * 연결된 영역에서 첫 paint 전 복원 · 문서는 페이지 간 공유하고 목차는 같은 경로에서만 재사용
-     */
-    const restoreScroll = () => {
-        layoutRef.current = getNavigationLayout();
-        const documents = getDocumentsPort();
-        const navigation = getNavigationPort();
-        if (props.stores === undefined || documents === null || outlineRef.current === null || navigation === null) return;
-        if (layoutRef.current === "drawer" && dialogRef.current?.open !== true) return;
-        const signature = getNavigationSignature();
-        if (signature === undefined) return;
-        const position = props.stores.scroll.getState().positions[layoutRef.current];
-        documents.scrollTop = 0;
-        outlineRef.current.scrollTop = 0;
-        if (position === undefined) {
-            restoreNavigationScroll({key: navigation_scroll_storage_key, version: navigation_storage_version, layout: layoutRef.current, toState: toNavigationScrollState});
-        } else if (position.navigation === signature) {
-            documents.scrollTop = position.documents;
-            if (position.pathname === location.pathname) outlineRef.current.scrollTop = position.outline;
-        }
-        navigation.dataset.navigationLayout = layoutRef.current;
-        restorePendingRef.current = false;
-        saveScroll();
-        // 좌표 설정의 비동기 scroll 이벤트를 기다리지 않고 첫 paint의 넘침 표시를 맞춘다
-        documents.dispatchEvent(new Event("scroll"));
-        outlineRef.current.dispatchEvent(new Event("scroll"));
-    };
-
-    /**
-     * 네이티브 close가 이전 열기 이벤트보다 늦게 도착해도 새 모달을 잠금 해제하지 않음
-     */
-    const handleDrawerClose = (_event: Event) => {
-        if (dialogRef.current?.open === true) return;
-        document.body.classList.remove("wg_shell__root--drawerOpen");
-        setDrawerOpen(false);
-    };
-
-    /**
-     * 네이티브 포커스 복원을 유지하면서 링크의 기본 이동보다 먼저 배경 잠금 해제
-     */
-    const closeNavigation = () => {
-        saveScroll();
-        dialogRef.current?.close();
-        document.body.classList.remove("wg_shell__root--drawerOpen");
-        setDrawerOpen(false);
-    };
-
-    /**
-     * 모바일에서만 네이티브 모달을 열고 독립된 드로어 좌표를 즉시 복원
-     */
-    const handleOpenButtonClick: DOMAttributes["onClick"] = (_event) => {
-        if (getNavigationLayout() !== "drawer" || dialogRef.current === null || dialogRef.current.open) return;
-        dialogRef.current.showModal();
-        document.body.classList.add("wg_shell__root--drawerOpen");
-        setDrawerOpen(true);
-        restoreScroll();
-    };
-
-    const handleCloseButtonClick: DOMAttributes["onClick"] = (_event) => {
-        closeNavigation();
-    };
-
-    /**
-     * Escape의 네이티브 포커스 복원을 쓰되 좌표는 닫힌 모달이 되기 전에 보존
-     */
-    const handleDrawerCancel = (event: Event) => {
-        event.preventDefault();
-        closeNavigation();
-    };
-
-    /**
-     * 대화상자 내부 빈 공간은 유지하고 경계 밖 배경만 닫기
-     */
-    const handleDrawerClick: DOMAttributes["onClick"] = (event) => {
-        if (dialogRef.current === null || event.target !== dialogRef.current) return;
-        const bounds = dialogRef.current.getBoundingClientRect();
-        if (event.clientX < bounds.left || event.clientX > bounds.right || event.clientY < bounds.top || event.clientY > bounds.bottom) closeNavigation();
-    };
-
-    /**
-     * 보조키·새 탭 링크는 모달 유지 · 기본 문서 이동만 닫고 같은 문서 제목에 키보드 위치 전달
-     */
-    const handleNavigationClick: DOMAttributes["onClick"] = (event) => {
-        saveScroll();
-        if (
-            dialogRef.current?.open !== true ||
-            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 !== null) {
-                target.tabIndex = -1;
-                target.focus({preventScroll: true});
-            }
-        }
-    };
-
-    /**
-     * 같은 목록을 한 배치에만 렌더 · 전환 전 포커스를 기억하고 새 배치가 연결된 뒤 좌표 복원
-     */
-    const handleLayoutChange = () => {
-        const nextLayout = getNavigationLayout();
-        if (nextLayout === layoutRef.current) return;
-        if (document.activeElement instanceof HTMLElement) {
-            focusRef.current = {
-                navigation: document.activeElement.closest("[data-navigation]") !== null,
-                drawer: document.activeElement === openButtonRef.current || document.activeElement.closest("[data-navigation-drawer]") !== null,
-                href: document.activeElement.getAttribute("href"),
-            };
-        }
-        if (nextLayout !== "drawer") closeNavigation();
-        restorePendingRef.current = true;
-        layoutRef.current = nextLayout;
-        flushSync(() => setLayout(nextLayout));
-    };
-
-    /**
-     * BFCache의 이전 메모리가 다음 문서의 좌표를 덮지 않도록 렌더까지 동기 갱신 후 복원
-     */
-    const handlePageShow = (event: PageTransitionEvent) => {
-        if (!event.persisted || props.stores === undefined) return;
-        restorePendingRef.current = true;
-        flushSync(() => props.stores?.scroll.persist.rehydrate());
-        handleLayoutChange();
-        restoreScroll();
-    };
-
-    /**
-     * Hono 탐색이 전역 구독의 설치·정리를 소유 · 서버 렌더에서는 실행하지 않음
-     */
-    useLayoutEffect(() => {
-        if (props.stores === undefined) return;
-        mobileRef.current = matchMedia(navigation_mobile_query);
-        wideRef.current = matchMedia(navigation_wide_query);
-        mobileRef.current.addEventListener("change", handleLayoutChange);
-        wideRef.current.addEventListener("change", handleLayoutChange);
-        addEventListener("pagehide", saveScroll);
-        addEventListener("pageshow", handlePageShow);
-        return () => {
-            mobileRef.current?.removeEventListener("change", handleLayoutChange);
-            wideRef.current?.removeEventListener("change", handleLayoutChange);
-            mobileRef.current = null;
-            wideRef.current = null;
-            removeEventListener("pagehide", saveScroll);
-            removeEventListener("pageshow", handlePageShow);
-            document.body.classList.remove("wg_shell__root--drawerOpen");
-        };
-    }, [props.stores]);
-
-    /**
-     * 최초 mount와 반응형 재연결의 paint 전 좌표·포커스 복원 · Hono의 fragment 연결 시점 보정
-     */
-    useLayoutEffect(() => {
-        if (props.stores === undefined) return;
-        let active = true;
-        const restoreNavigation = () => {
-            if (!active) return;
-            restoreScroll();
-            if (focusRef.current === null) return;
-            const navigation = getNavigationPort();
-            if (layout === "drawer") {
-                if (focusRef.current.navigation) openButtonRef.current?.focus({preventScroll: true});
-            } else if (focusRef.current.navigation && navigation !== null) {
-                const href = focusRef.current.href;
-                const target = [...navigation.querySelectorAll<HTMLElement>("a[href]")].find((element) => element.getAttribute("href") === href);
-                target?.focus({preventScroll: true});
-            } else if (focusRef.current.drawer) {
-                brandRef.current?.focus({preventScroll: true});
-            }
-            focusRef.current = null;
-        };
-        if (getDocumentsPort()?.isConnected) {
-            restoreNavigation();
-        } else {
-            // Hono는 최초 layout effect에서 아직 fragment를 사용하므로 연결 후 microtask도 같은 첫 paint 앞에 둔다
-            queueMicrotask(restoreNavigation);
-        }
-        return () => {
-            active = false;
-        };
-    }, [layout, props.stores]);
-
-    return (
-        <Fragment>
-            {/**
-             * 데스크톱 문서 사이드바 · 모바일에서는 고정 브랜드와 연결된 메뉴 버튼
-             */}
-            <div className={clsx("wg_navigation__sidebar", props.stores !== undefined && "wg_navigation__sidebar--navigationReady")}>
-                {/**
-                 * 어느 문서에서도 홈으로 이동 · 모달 진입은 브라우저 동작이 연결된 뒤 표시
-                 */}
-                <div className={clsx("wg_navigation__brandRow")}>
-                    <a
-                        ref={props.stores === undefined ? undefined : brandRef}
-                        className={clsx("wg_navigation__brand")}
-                        href="/"
-                        aria-current={props.data.home ? "page" : undefined}
-                    >
-                        {props.data.title}
-                    </a>
-                    {/**
-                     * 네이티브 모달의 열림 상태와 접근 가능한 진입 이름
-                     */}
-                    <button
-                        ref={props.stores === undefined ? undefined : openButtonRef}
-                        className={clsx("wg_navigation__menuToggle", props.stores !== undefined && layout === "drawer" && "wg_navigation__menuToggle--visible")}
-                        type="button"
-                        aria-label={copy_nav_open}
-                        aria-controls="fh-navigation-drawer"
-                        aria-expanded={String(drawerOpen)}
-                        data-navigation-open=""
-                        onClick={handleOpenButtonClick}
-                    >
-                        <svg className={clsx("wg_navigation__menuIcon")} viewBox="0 0 24 24" aria-hidden="true" focusable="false">
-                            <path d="M4 6h16M4 12h16M4 18h16" />
-                        </svg>
-                    </button>
-                </div>
-                {/**
-                 * JavaScript 없이도 전체 문서 링크를 표시 · 브라우저 모바일에서는 드로어가 같은 목록을 소유
-                 */}
-                {layout !== "drawer" && (
-                    <div ref={props.stores === undefined ? undefined : navigationRef} className={clsx("wg_navigation__navigation")} data-navigation="">
-                        <WgNavigationScroll portRef={documentsRef} kind="documents" ready={props.stores !== undefined} onScroll={saveScroll} onClick={handleNavigationClick}>
-                            <WgNavigationNav groups={props.data.groups} />
-                        </WgNavigationScroll>
-                    </div>
-                )}
-            </div>
-            {/**
-             * 와이드 화면 전용 목차 · 드로어에는 문서 목록만 표시
-             */}
-            <aside className={clsx("wg_navigation__tocRail")} data-navigation-rail="">
-                <div className={clsx("wg_navigation__outline")} data-navigation-outline="">
-                    <WgNavigationScroll portRef={outlineRef} kind="outline" ready={props.stores !== undefined} onScroll={saveScroll} onClick={handleNavigationClick}>
-                        {props.data.outline.length > 0 && <WgNavigationToc groups={props.data.outline} />}
-                    </WgNavigationScroll>
-                </div>
-            </aside>
-            {/**
-             * 브라우저 top layer의 포커스·Escape·배경 클릭 동작과 모바일 문서 목록
-             */}
-            {/**
-             * biome-ignore lint/a11y/useKeyWithClickEvents: 배경 클릭의 키보드 대응은 네이티브 dialog의 cancel과 별도 닫기 버튼이 제공한다
-             */}
-            <dialog
-                ref={props.stores === undefined ? undefined : dialogRef}
-                className={clsx("wg_navigation__drawer")}
-                id="fh-navigation-drawer"
-                aria-labelledby="fh-navigation-title"
-                data-navigation-drawer=""
-                onClose={handleDrawerClose}
-                onCancel={handleDrawerCancel}
-                onClick={handleDrawerClick}
-            >
-                {/**
-                 * 목록 스크롤과 독립된 대화상자 이름·닫기 동작
-                 */}
-                <div className={clsx("wg_navigation__drawerHeader")}>
-                    <h2 className={clsx("wg_navigation__drawerTitle")} id="fh-navigation-title">
-                        {copy_nav_title}
-                    </h2>
-                    {/**
-                     * 네이티브 close로 열기 버튼에 포커스 복원
-                     */}
-                    <button className={clsx("wg_navigation__drawerClose")} type="button" aria-label={copy_nav_close} data-navigation-close="" onClick={handleCloseButtonClick}>
-                        <svg className={clsx("wg_navigation__menuIcon")} viewBox="0 0 24 24" aria-hidden="true" focusable="false">
-                            <path d="m6 6 12 12M18 6 6 18" />
-                        </svg>
-                    </button>
-                </div>
-                {/**
-                 * 모바일에만 한 번 렌더하는 문서 탐색 · 다른 배치와 저장 좌표 분리
-                 */}
-                <div className={clsx("wg_navigation__drawerContent")} data-navigation-content="">
-                    {layout === "drawer" && (
-                        <div ref={props.stores === undefined ? undefined : drawerNavigationRef} className={clsx("wg_navigation__navigation")} data-navigation="">
-                            <WgNavigationScroll
-                                portRef={drawerDocumentsRef}
-                                kind="documents"
-                                ready={props.stores !== undefined}
-                                onScroll={saveScroll}
-                                onClick={handleNavigationClick}
-                            >
-                                <WgNavigationNav groups={props.data.groups} />
-                            </WgNavigationScroll>
-                        </div>
-                    )}
-                </div>
-            </dialog>
-        </Fragment>
-    );
-};