for-humanity 0.11.0 → 0.13.0

package/src/component/widget/cursor-face/wg-cursor-face.tsx

@@ -1,153 +0,0 @@
-import clsx from "clsx";
-import {useLayoutEffect, useRef} from "hono/jsx";
-import {cursor_face_offset_px, cursor_face_size_px, cursor_face_storage_key} from "@/component/widget/cursor-face/_constant/cursor-face";
-import {asset_favicon_path} from "@/constant/asset";
-import "./wg-cursor-face.css";
-
-/**
- * SSR 기본 장식과 브라우저 DOM 연결을 구분하는 입력
- */
-export interface WgCursorFaceProps {
-    /**
-     * 브라우저 셸이 준비한 DOM ref·이벤트 연결 활성화
-     */
-    ready: boolean;
-}
-
-export const WgCursorFace = (props: WgCursorFaceProps) => {
-    const faceRef = useRef<HTMLImageElement | null>(null);
-    const mediaRef = useRef<MediaQueryList | null>(null);
-    const positionRef = useRef({x: 0, y: 0, frame: 0});
-
-    /**
-     * 화면 이탈·터치 전환에서 예약된 이동까지 취소
-     */
-    const handleCursorHide = () => {
-        cancelAnimationFrame(positionRef.current.frame);
-        positionRef.current.frame = 0;
-        faceRef.current?.classList.remove("wg_cursorFace__root--visible");
-    };
-
-    /**
-     * 비활성 전환에서만 숨겨 새 마우스 이동을 취소하지 않음
-     */
-    const handleCursorMediaChange = () => {
-        if (!mediaRef.current?.matches) handleCursorHide();
-    };
-
-    /**
-     * 화면 갱신마다 한 번만 반영 · transform으로 본문 재배치 방지
-     */
-    const renderCursorFace = () => {
-        if (positionRef.current.frame !== 0) return;
-        positionRef.current.frame = requestAnimationFrame(() => {
-            positionRef.current.frame = 0;
-            const face = faceRef.current;
-            if (face === null) return;
-            face.style.transform = `translate3d(
-                ${Math.max(0, Math.min(positionRef.current.x + cursor_face_offset_px, document.documentElement.clientWidth - face.width - cursor_face_offset_px))}px,
-                ${Math.max(0, Math.min(positionRef.current.y + cursor_face_offset_px, document.documentElement.clientHeight - face.height - cursor_face_offset_px))}px,
-                0
-            )`;
-            face.classList.add("wg_cursorFace__root--visible");
-        });
-    };
-
-    /**
-     * 클릭·텍스트 선택 중에도 장식 유지 · 실제 마우스 입력만 좌표 반영
-     */
-    const handleDocumentPointer = (event: PointerEvent) => {
-        if (!mediaRef.current?.matches || event.pointerType !== "mouse") {
-            handleCursorHide();
-            return;
-        }
-        positionRef.current.x = event.clientX;
-        positionRef.current.y = event.clientY;
-        renderCursorFace();
-    };
-
-    /**
-     * 새 마우스 이동 없이 화면 가장자리의 좌표 재계산
-     */
-    const handleCursorResize = () => {
-        if (faceRef.current?.classList.contains("wg_cursorFace__root--visible")) renderCursorFace();
-    };
-
-    /**
-     * 같은 탭의 문서 이동에서 마지막 좌표를 전달 · 저장 실패는 장식에만 영향
-     */
-    const handlePageHide = () => {
-        if (!faceRef.current?.classList.contains("wg_cursorFace__root--visible")) return;
-        try {
-            sessionStorage.setItem(cursor_face_storage_key, JSON.stringify({x: positionRef.current.x, y: positionRef.current.y}));
-        } catch {
-            // 저장소 차단 시 현재 페이지의 포인터 동작 유지
-        }
-    };
-
-    /**
-     * 첫 진입·BFCache 복귀의 좌표를 한 번 소비 · 외부 저장 값은 검증 후 사용
-     */
-    const handlePageShow = () => {
-        try {
-            const stored = sessionStorage.getItem(cursor_face_storage_key);
-            sessionStorage.removeItem(cursor_face_storage_key);
-            if (stored === null || !mediaRef.current?.matches) return;
-            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)
-            ) {
-                positionRef.current.x = point.x;
-                positionRef.current.y = point.y;
-                renderCursorFace();
-            }
-        } catch {
-            // 손상된 좌표는 다음 실제 마우스 입력으로 복구
-        }
-    };
-
-    /**
-     * 첫 paint 전 좌표 복원 · 해제 시 전역 이벤트와 예약 frame을 함께 정리
-     */
-    useLayoutEffect(() => {
-        if (!props.ready) return;
-        const lifetime = new AbortController();
-        const media = matchMedia("(hover: hover) and (pointer: fine) and (prefers-reduced-motion: no-preference)");
-        mediaRef.current = media;
-        handlePageShow();
-        document.addEventListener("pointermove", handleDocumentPointer, {passive: true, signal: lifetime.signal});
-        document.addEventListener("pointerdown", handleDocumentPointer, {passive: true, signal: lifetime.signal});
-        document.documentElement.addEventListener("pointerleave", handleCursorHide, {signal: lifetime.signal});
-        addEventListener("blur", handleCursorHide, {signal: lifetime.signal});
-        addEventListener("resize", handleCursorResize, {signal: lifetime.signal});
-        addEventListener("pagehide", handlePageHide, {signal: lifetime.signal});
-        addEventListener("pageshow", handlePageShow, {signal: lifetime.signal});
-        media.addEventListener("change", handleCursorMediaChange, {signal: lifetime.signal});
-        return () => {
-            lifetime.abort();
-            mediaRef.current = null;
-            handleCursorHide();
-        };
-    }, [props.ready]);
-
-    return (
-        <img
-            ref={props.ready ? faceRef : undefined}
-            className={clsx("wg_cursorFace__root")}
-            src={asset_favicon_path}
-            width={cursor_face_size_px}
-            height={cursor_face_size_px}
-            alt=""
-            aria-hidden="true"
-            draggable={false}
-            data-cursor-face=""
-        />
-    );
-};

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

@@ -1,9 +0,0 @@
-/**
- * 영어 문서 이름의 정렬 locale
- */
-export const locale_doc_name = "en";
-
-/**
- * 한국어 문서 묶음의 정렬 locale
- */
-export const locale_doc_group = "ko";

package/src/component/widget/navigation/_constant/navigation-data-schema.ts

@@ -1,33 +0,0 @@
-import {array, boolean, lazy, minLength, number, object, optional, string, type ZodMiniType} from "zod/mini";
-import type {NavigationData, NavigationDoc, NavigationGroup} from "@/component/widget/navigation/_type/navigation-data";
-
-const navigationDocSchema: ZodMiniType<NavigationDoc> = object({
-    id: string(),
-    name: string(),
-    label: string(),
-    active: boolean(),
-    children: lazy(() => array(navigationDocSchema)),
-});
-const navigationGroupSchema: ZodMiniType<NavigationGroup> = object({
-    name: string(),
-    path: array(string()),
-    docs: array(navigationDocSchema),
-    groups: lazy(() => array(navigationGroupSchema)),
-});
-const headingSchema = object({depth: number(), slug: string(), text: string()});
-
-/**
- * HTML에 포함된 JSON을 읽는 브라우저 경계 · 손상된 자료에는 서버 HTML 유지
- */
-export const navigationDataSchema: ZodMiniType<NavigationData> = object({
-    title: string(),
-    groups: array(navigationGroupSchema),
-    outline: array(
-        object({
-            part: optional(string()),
-            sections: array(object({heading: headingSchema, part: optional(string()), subs: array(object({heading: headingSchema}))})).check(minLength(1)),
-        }),
-    ),
-    home: boolean(),
-    cursorFace: boolean(),
-});

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

@@ -1,9 +0,0 @@
-/**
- * 모바일 탐색 전환 · wg-shell.css의 폭 조건과 일치
- */
-export const navigation_mobile_query = "(width < 1024px)";
-
-/**
- * 양쪽 200px 탐색·간격 120px·최소 800px 본문과 스크롤바가 들어가는 3열 기준
- */
-export const navigation_wide_query = "(width >= 1360px)";

package/src/component/widget/navigation/_constant/reading-line.ts

@@ -1,4 +0,0 @@
-/**
- * 읽는 선의 반올림 여유 · 경계의 제목을 현재 절에 포함
- */
-export const reading_line_slack_px = 1;

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

@@ -1,59 +0,0 @@
-import type {NavigationLayout} from "@/store/navigation/navigation-state";
-import type {toNavigationScrollState} from "@/store/navigation/to-navigation-scroll-state";
-
-/**
- * 초기 HTML과 저장 스토어가 같은 좌표 형태를 소비하는 복원 경계
- */
-interface RestoreNavigationScrollOptions {
-    /**
-     * persist 키 · 이전 배치별 키의 접두사도 동일
-     */
-    key: string;
-    /**
-     * 수용할 저장 형태 버전
-     */
-    version: number;
-    /**
-     * 현재 표시 중인 화면 배치
-     */
-    layout: NavigationLayout;
-    /**
-     * persist와 같은 저장 자료 검증
-     */
-    toState: typeof toNavigationScrollState;
-}
-
-/**
- * 탐색 진입점에서 첫 paint 전 복원 · 기존 배치별 저장 자료도 한 번 수용
- */
-export const restoreNavigationScroll = (options: RestoreNavigationScrollOptions) => {
-    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;
-    // module을 기다리는 동안 breakpoint가 바뀌었는지 구분 · 자료가 없어도 적용 배치는 기록
-    navigation.dataset.navigationLayout = options.layout;
-
-    try {
-        const value = sessionStorage.getItem(options.key);
-        const stored: unknown = value === null ? undefined : JSON.parse(value);
-        const state =
-            typeof stored === "object" && stored !== null && "version" in stored && stored.version === options.version && "state" in stored
-                ? options.toState(stored.state)
-                : {positions: {}};
-        const legacy = sessionStorage.getItem(`${options.key}:${options.layout === "drawer" ? "drawer" : "desktop"}`);
-        const previous =
-            state.positions[options.layout] === undefined && legacy !== null
-                ? options.toState({positions: {[options.layout]: JSON.parse(legacy)}}).positions[options.layout]
-                : undefined;
-        const position = state.positions[options.layout] ?? previous;
-        const signature = [...navigation.querySelectorAll<HTMLAnchorElement>(".wg_navigationNav__root a[href]")].map((link) => `${link.pathname}:${link.textContent}`).join("\n");
-        if (position === undefined || position.navigation !== signature) return;
-
-        documents.scrollTop = position.documents;
-        // 공통 문서 목록은 페이지 간 공유 · 목차는 같은 페이지에서만 재사용
-        if (position.pathname === location.pathname) outline.scrollTop = position.outline;
-    } catch {
-        // 차단·손상된 저장소는 복원만 생략 · 기본 링크와 스크롤 유지
-    }
-};

package/src/component/widget/navigation/_function/to-doc-groups/_to-doc-branches.ts

@@ -1,15 +0,0 @@
-import {locale_doc_name} from "@/component/widget/navigation/_constant/locale";
-import type {DocBranch} from "@/component/widget/navigation/_type/doc-branch";
-import type {Doc} from "@/type/doc";
-
-/**
- * 검증된 부모 관계로 문서 가지를 재귀 구성 · 형제 순서와 URL 유지
- */
-export const toDocBranches = (options: {docs: readonly Doc[]; children: ReadonlyMap<Doc["data"]["parent"], Doc[]>}): DocBranch[] => {
-    return options.docs
-        .toSorted((a, b) => a.data.order - b.data.order || a.data.name.localeCompare(b.data.name, locale_doc_name) || a.id.localeCompare(b.id, locale_doc_name))
-        .map((doc) => {
-            const children = options.children.get(doc.id);
-            return {...doc, children: children === undefined ? undefined : toDocBranches({docs: children, children: options.children})};
-        });
-};

package/src/component/widget/navigation/_function/to-doc-groups/_to-doc-group-branches.ts

@@ -1,70 +0,0 @@
-import {locale_doc_group} from "@/component/widget/navigation/_constant/locale";
-import {toDocBranches} from "@/component/widget/navigation/_function/to-doc-groups/_to-doc-branches";
-import type {DocGroup} from "@/component/widget/navigation/_type/doc-group";
-import type {Doc} from "@/type/doc";
-
-/**
- * 같은 부모의 문서를 다음 경로 단계로 묶는 재귀 입력
- */
-interface DocGroupBranchesOptions {
-    /**
-     * 부모 경로에 속한 문서
-     */
-    docs: readonly Doc[];
-    /**
-     * 검증된 부모 id별 문서 · 자손을 각 단계에서 다시 수집하지 않음
-     */
-    children: ReadonlyMap<Doc["data"]["parent"], Doc[]>;
-    /**
-     * 부모까지의 경로 · 최상위는 빈 배열
-     */
-    path: DocGroup["path"];
-    /**
-     * 전체 경로의 JSON 키와 navigation 위치
-     */
-    positions: ReadonlyMap<string, number>;
-    /**
-     * 미지정 경로를 지정한 묶음 뒤에 놓는 위치
-     */
-    unlistedPosition: number;
-}
-
-/**
- * 각 단계의 직접 문서와 하위 묶음을 분리 · 고정된 깊이 제한 없이 구성
- */
-export const toDocGroupBranches = (options: DocGroupBranchesOptions): DocGroup[] => {
-    return [
-        ...Map.groupBy(
-            options.docs.filter((doc) => doc.data.group.length > options.path.length),
-            (doc) => doc.data.group[options.path.length],
-        ),
-    ]
-        .map(([name, docs]) => {
-            const path = [...options.path, name];
-
-            return {
-                name,
-                path,
-                docs,
-                position: options.positions.get(JSON.stringify(path)) ?? options.unlistedPosition,
-            };
-        })
-        .toSorted((a, b) => a.position - b.position || a.name.localeCompare(b.name, locale_doc_group))
-        .map((group) => {
-            return {
-                name: group.name,
-                path: group.path,
-                docs: toDocBranches({
-                    docs: group.docs.filter((doc) => doc.data.group.length === group.path.length && doc.data.parent === undefined),
-                    children: options.children,
-                }),
-                groups: toDocGroupBranches({
-                    docs: group.docs,
-                    children: options.children,
-                    path: group.path,
-                    positions: options.positions,
-                    unlistedPosition: options.unlistedPosition,
-                }),
-            };
-        });
-};

package/src/component/widget/navigation/_function/to-doc-groups/to-doc-groups.ts

@@ -1,15 +0,0 @@
-import {toDocGroupBranches} from "@/component/widget/navigation/_function/to-doc-groups/_to-doc-group-branches";
-import type {Doc} from "@/type/doc";
-import type {SiteConfig} from "@/type/site-config";
-
-/**
- * 메타데이터 경로로 읽는 순서를 가진 문서 계층 구성
- * navigation의 첫 지정을 조상에도 적용 · 미지정 형제 묶음은 이름순
- */
-export const toDocGroups = (options: {docs: readonly Doc[]; navigation: SiteConfig["navigation"]}) => {
-    // 같은 조상을 지정한 경로는 최초 navigation 위치를 우선
-    const positions = new Map(options.navigation.flatMap((path, index) => path.map((_name, depth) => [JSON.stringify(path.slice(0, depth + 1)), index] as const)).toReversed());
-
-    const children = Map.groupBy(options.docs, (doc) => doc.data.parent);
-    return toDocGroupBranches({docs: options.docs, children, path: [], positions, unlistedPosition: options.navigation.length});
-};

package/src/component/widget/navigation/_function/to-navigation-data/_to-navigation-document.ts

@@ -1,13 +0,0 @@
-import type {DocBranch} from "@/component/widget/navigation/_type/doc-branch";
-import type {NavigationDoc} from "@/component/widget/navigation/_type/navigation-data";
-
-/**
- * 본문 없는 문서 가지 · 재귀에서도 현재 페이지 한 항목만 표시
- */
-export const toNavigationDocument = (options: {doc: DocBranch; current?: string}): NavigationDoc => ({
-    id: options.doc.id,
-    name: options.doc.data.name,
-    label: options.doc.data.label,
-    active: options.doc.id === options.current,
-    children: options.doc.children === undefined ? [] : options.doc.children.map((doc) => toNavigationDocument({...options, doc})),
-});

package/src/component/widget/navigation/_function/to-navigation-data/_to-navigation-group.ts

@@ -1,13 +0,0 @@
-import {toNavigationDocument} from "@/component/widget/navigation/_function/to-navigation-data/_to-navigation-document";
-import type {DocGroup} from "@/component/widget/navigation/_type/doc-group";
-import type {NavigationGroup} from "@/component/widget/navigation/_type/navigation-data";
-
-/**
- * 전체 묶음 경로와 본문 없는 하위 가지
- */
-export const toNavigationGroup = (options: {group: DocGroup; current?: string}): NavigationGroup => ({
-    name: options.group.name,
-    path: options.group.path,
-    docs: options.group.docs.map((doc) => toNavigationDocument({doc, current: options.current})),
-    groups: options.group.groups.map((group) => toNavigationGroup({...options, group})),
-});

package/src/component/widget/navigation/_function/to-navigation-data/to-navigation-data.ts

@@ -1,18 +0,0 @@
-import {toDocGroups} from "@/component/widget/navigation/_function/to-doc-groups/to-doc-groups";
-import {toNavigationGroup} from "@/component/widget/navigation/_function/to-navigation-data/_to-navigation-group";
-import {toTocGroups} from "@/component/widget/navigation/_function/to-toc-groups";
-import type {NavigationData} from "@/component/widget/navigation/_type/navigation-data";
-import type {Doc} from "@/type/doc";
-import type {DocOutline} from "@/type/doc-outline";
-import type {SiteConfig} from "@/type/site-config";
-
-/**
- * 현재 문서의 이름·계층·목차만 전송 · 다른 문서 본문은 브라우저 탐색 입력에서 제외
- */
-export const toNavigationData = (options: {site: SiteConfig; docs: Doc[]; current?: string; outline?: DocOutline}): NavigationData => ({
-    title: options.site.title,
-    groups: toDocGroups({docs: options.docs, navigation: options.site.navigation}).map((group) => toNavigationGroup({group, current: options.current})),
-    outline: options.outline === undefined ? [] : toTocGroups(options.outline),
-    home: options.current === undefined,
-    cursorFace: options.site.cursorFace,
-});

package/src/component/widget/navigation/_function/to-navigation-json.ts

@@ -1,8 +0,0 @@
-import type {NavigationData} from "@/component/widget/navigation/_type/navigation-data";
-
-/**
- * 작성한 이름이 script 종료 태그나 JavaScript 줄 구분자로 해석되지 않는 JSON
- */
-export const toNavigationJson = (data: NavigationData) => {
-    return JSON.stringify(data).replaceAll("<", "\\u003c").replaceAll("\u2028", "\\u2028").replaceAll("\u2029", "\\u2029");
-};

package/src/component/widget/navigation/_function/to-toc-groups.ts

@@ -1,38 +0,0 @@
-import {takeWhile} from "es-toolkit/array";
-import type {TocGroup, TocSection} from "@/component/widget/navigation/_type/toc-group";
-import {section_heading_depth} from "@/component/widget/prose/_constant/section";
-import type {DocOutline} from "@/type/doc-outline";
-
-/**
- * h2별 h3 수집 · 가름 시작 절에서 목차 묶음 분리
- * 첫 h2 앞의 h3은 목차 제외
- */
-export const toTocGroups = (outline: DocOutline): TocGroup[] => {
-    const entries = outline.headings
-        .filter((heading) => heading.depth === section_heading_depth.section || heading.depth === section_heading_depth.sub)
-        .map((heading, index) => ({heading, section: outline.sections[index]}));
-    const sections = entries.flatMap((entry, index): TocSection[] =>
-        entry.heading.depth === section_heading_depth.section
-            ? [
-                  {
-                      heading: entry.heading,
-                      part: entry.section.part,
-                      subs: takeWhile(entries.slice(index + 1), (sub) => sub.heading.depth !== section_heading_depth.section).map((sub) => ({
-                          heading: sub.heading,
-                      })),
-                  },
-              ]
-            : [],
-    );
-
-    return sections.flatMap((section, index) =>
-        index === 0 || section.part !== undefined
-            ? [
-                  {
-                      part: section.part,
-                      sections: [section, ...takeWhile(sections.slice(index + 1), (next) => next.part === undefined)],
-                  },
-              ]
-            : [],
-    );
-};

package/src/component/widget/navigation/_type/doc-branch.ts

@@ -1,11 +0,0 @@
-import type {Doc} from "@/type/doc";
-
-/**
- * 문서 탐색의 클릭 가능한 가지 · 원래 URL과 본문을 유지
- */
-export interface DocBranch extends Doc {
-    /**
-     * 같은 부모 아래의 문서 · order·제목·id 순, 말단 문서는 생략
-     */
-    children?: DocBranch[];
-}

package/src/component/widget/navigation/_type/doc-group.ts

@@ -1,24 +0,0 @@
-import type {DocBranch} from "@/component/widget/navigation/_type/doc-branch";
-import type {Doc} from "@/type/doc";
-
-/**
- * 사이드바의 문서 묶음 · 같은 이름도 전체 경로로 구분
- */
-export interface DocGroup {
-    /**
-     * 현재 단계의 표시 이름
-     */
-    name: string;
-    /**
-     * 최상위부터 현재 단계까지의 경로
-     */
-    path: Doc["data"]["group"];
-    /**
-     * 현재 묶음의 부모 없는 문서 · 하위 문서는 각 문서 가지에 포함
-     */
-    docs: DocBranch[];
-    /**
-     * 현재 묶음의 하위 묶음 · navigation·이름 순
-     */
-    groups: DocGroup[];
-}

package/src/component/widget/navigation/_type/navigation-data.ts

@@ -1,75 +0,0 @@
-import type {TocGroup} from "@/component/widget/navigation/_type/toc-group";
-
-/**
- * 브라우저 문서 가지 · 본문·파일 경로를 포함하지 않는 탐색 전용 계약
- */
-export interface NavigationDoc {
-    /**
-     * 링크의 문서 id
-     */
-    id: string;
-    /**
-     * 표시 이름
-     */
-    name: string;
-    /**
-     * 링크의 보조 설명
-     */
-    label: string;
-    /**
-     * 현재 페이지 한 항목만 강조
-     */
-    active: boolean;
-    /**
-     * 클릭 가능한 하위 문서
-     */
-    children: NavigationDoc[];
-}
-
-/**
- * 클릭하지 않는 문서 묶음 · 같은 이름은 전체 경로로 구분
- */
-export interface NavigationGroup {
-    /**
-     * 묶음 이름
-     */
-    name: string;
-    /**
-     * 최상위부터 현재 묶음까지
-     */
-    path: string[];
-    /**
-     * 현재 단계의 문서
-     */
-    docs: NavigationDoc[];
-    /**
-     * 하위 묶음
-     */
-    groups: NavigationGroup[];
-}
-
-/**
- * 서버가 계산한 최소 탐색 자료 · 서버 출력과 클라이언트 JSX의 공통 입력
- */
-export interface NavigationData {
-    /**
-     * 브랜드 이름
-     */
-    title: string;
-    /**
-     * 읽는 순서의 문서 트리
-     */
-    groups: NavigationGroup[];
-    /**
-     * 현재 페이지의 목차
-     */
-    outline: TocGroup[];
-    /**
-     * README 홈 여부
-     */
-    home: boolean;
-    /**
-     * 커서 옆 픽셀 얼굴 표시 여부 · 사이트 설정 `cursorFace`
-     */
-    cursorFace: boolean;
-}

package/src/component/widget/navigation/_type/navigation-focus-snapshot.ts

@@ -1,17 +0,0 @@
-/**
- * Hono가 배치 변경에서 이전 DOM의 자식을 분리하기 전에 기억하는 키보드 위치
- */
-export interface NavigationFocusSnapshot {
-    /**
-     * 문서 탐색 안에서 새 배치로 옮길 위치인지 구분
-     */
-    navigation: boolean;
-    /**
-     * 메뉴 진입·닫기 버튼에서 데스크톱 브랜드로 돌아갈 위치인지 구분
-     */
-    drawer: boolean;
-    /**
-     * 문서 이동 링크의 안정된 식별자
-     */
-    href: string | null;
-}

package/src/component/widget/navigation/_type/toc-group.ts

@@ -1,39 +0,0 @@
-import type {DocHeading} from "@/type/doc-heading";
-
-/**
- * 목차 소제목 항목
- */
-export interface TocSub {
-    /**
-     * 제목 id와 텍스트
-     */
-    heading: DocHeading;
-}
-
-/**
- * 목차 절과 소제목 목록
- */
-export interface TocSection extends TocSub {
-    /**
-     * 이 절에서 시작하는 가름 이름
-     */
-    part?: string;
-    /**
-     * 해당 절의 소제목 · 현재 위치와 무관하게 전체 표시
-     */
-    subs: TocSub[];
-}
-
-/**
- * 가름별 목차 묶음 · 첫 묶음 이름 생략 가능
- */
-export interface TocGroup {
-    /**
-     * 묶음 위의 가름 이름
-     */
-    part?: string;
-    /**
-     * 묶음의 절 목록
-     */
-    sections: TocSection[];
-}