for-humanity 0.14.0 → 0.14.1

package/dist/{load-site-CBJGMNfH.js → load-site-BpLDY-YA.js}

@@ -1,5 +1,5 @@
 import { S as copy_nav_toc_label, T as copy_warn_unknown_status, a as copy_error_doc_id_clash, b as copy_nav_open, c as copy_error_doc_parent_missing, g as copy_error_unknown_directive, h as copy_error_snippet, i as copy_error_doc_id, l as copy_error_frontmatter, o as copy_error_doc_parent_cycle, r as copy_error_directive_syntax, s as copy_error_doc_parent_group, t as copy_error_asset, u as copy_error_home_clash, v as copy_nav_aria_label, w as copy_warn_broken_link, x as copy_nav_title, y as copy_nav_close } from "./copy-C1uzvEnr.js";
-import { t as logger } from "./logger-Dv1i9xSV.js";
+import { t as logger } from "./logger-CLH67K3L.js";
 import { t as groupPathSchema } from "./group-path-XAThmzvC.js";
 import { t as toChangeQueue } from "./to-change-queue-DbEnZGNK.js";
 import { readFile, readdir } from "node:fs/promises";
@@ -21,7 +21,7 @@ import { SKIP, visit } from "unist-util-visit";
 import { createHash } from "node:crypto";
 import Slugger from "github-slugger";
 import { toString } from "hast-util-to-string";
-import { dropRightWhile, dropWhile, minBy, takeWhile, uniqBy } from "es-toolkit/array";
+import { dropRightWhile, dropWhile, minBy, takeWhile, uniqBy, zip } from "es-toolkit/array";
 import { transformerMetaHighlight, transformerNotationDiff, transformerNotationErrorLevel, transformerNotationHighlight, transformerNotationWordHighlight } from "@shikijs/transformers";
 import { toString as toString$1 } from "mdast-util-to-string";
 import { escape, escapeRegExp } from "es-toolkit/string";
@@ -210,8 +210,7 @@ var rehypeContentLinks = (options) => (tree, file) => {
 		]) {
 			const value = node.properties[property];
 			if (typeof value !== "string") continue;
-			const urls = property === "srcSet" ? value.split(",").map((entry) => entry.trim().split(/\s+/)[0]) : [value];
-			for (const url of urls) {
+			for (const url of property === "srcSet" ? value.split(",").map((entry) => entry.trim().split(/\s+/)[0]) : [value]) {
 				if (/^(?:[a-z][a-z\d+.-]*:|\/\/|#)/i.test(url)) continue;
 				const path = decodeURIComponent(url.split(/[?#]/)[0]);
 				try {
@@ -262,7 +261,7 @@ var rehypeHeadingIds = () => (tree, file) => {
 		node.children = [{
 			type: "element",
 			tagName: "span",
-			properties: { className: ["wg_prose__headingText"] },
+			properties: { className: ["wg_article__headingText"] },
 			children: node.children
 		}];
 	});
@@ -309,11 +308,10 @@ var snippet_language_by_extension = {
 *   - 빈 region은 빈 문자열, 없는 region은 undefined 반환
 */
 var toSnippetBody = (source, region) => {
-	const lines = source.replace(/\r\n/g, "\n").split("\n");
 	let inside = region === void 0;
 	let found = region === void 0;
 	const kept = [];
-	for (const line of lines) {
+	for (const line of source.replace(/\r\n/g, "\n").split("\n")) {
 		const marker = snippet_region_pattern.exec(line);
 		if (marker !== null) {
 			if (region !== void 0 && marker[2] === region) {
@@ -367,10 +365,9 @@ var remarkSnippets = (options) => (tree, file) => {
 			return;
 		}
 		const extension = extname(actual).toLowerCase();
-		const lang = snippet_language_by_extension[extension] === void 0 ? extension.slice(1) : snippet_language_by_extension[extension];
 		parent.children.splice(index, 1, {
 			type: "code",
-			lang,
+			lang: snippet_language_by_extension[extension] === void 0 ? extension.slice(1) : snippet_language_by_extension[extension],
 			meta: meta === void 0 ? null : meta,
 			value: body
 		});
@@ -389,26 +386,26 @@ var shikiTransformers = [
 		name: "for-humanity:code-metadata",
 		root(root) {
 			this.pre.properties.style = void 0;
-			this.addClassToHast(this.pre, "wg_prose__code");
+			this.addClassToHast(this.pre, "wg_article__code");
 			if (this.options.meta?.__raw === void 0) return;
-			if (/\bline-numbers\b/.test(this.options.meta.__raw)) this.addClassToHast(this.pre, "wg_prose__lineNumbers");
+			if (/\bline-numbers\b/.test(this.options.meta.__raw)) this.addClassToHast(this.pre, "wg_article__lineNumbers");
 			const isBad = /\bbad\b/.test(this.options.meta.__raw);
 			const isGood = /\bgood\b/.test(this.options.meta.__raw);
-			if (isBad) this.addClassToHast(this.pre, "wg_prose__code--bad");
-			if (isGood) this.addClassToHast(this.pre, "wg_prose__code--good");
+			if (isBad) this.addClassToHast(this.pre, "wg_article__code--bad");
+			if (isGood) this.addClassToHast(this.pre, "wg_article__code--good");
 			const title = /\[([^\]]+)\]/.exec(this.options.meta.__raw)?.[1];
 			if (title === void 0) return;
 			root.children = [{
 				type: "element",
 				tagName: "figure",
-				properties: { className: ["wg_prose__codeFile"] },
+				properties: { className: ["wg_article__codeFile"] },
 				children: [{
 					type: "element",
 					tagName: "figcaption",
 					properties: { className: [
-						"wg_prose__codeFileTitle",
-						...isBad ? ["wg_prose__codeFileTitle--bad"] : [],
-						...isGood ? ["wg_prose__codeFileTitle--good"] : []
+						"wg_article__codeFileTitle",
+						...isBad ? ["wg_article__codeFileTitle--bad"] : [],
+						...isGood ? ["wg_article__codeFileTitle--good"] : []
 					] },
 					children: [{
 						type: "text",
@@ -416,7 +413,7 @@ var shikiTransformers = [
 					}, {
 						type: "element",
 						tagName: "span",
-						properties: { className: ["wg_prose__codeFileLang"] },
+						properties: { className: ["wg_article__codeFileLang"] },
 						children: [{
 							type: "text",
 							value: this.options.lang
@@ -428,22 +425,7 @@ var shikiTransformers = [
 	}
 ];
 //#endregion
-//#region src/component/widget/mermaid/_function/remark-mermaid.ts
-/**
-* Mermaid 원문과 브라우저 렌더 영역. JavaScript 비활성 환경에서도 원문 유지
-*/
-var remarkMermaid = (options) => (tree) => {
-	visit(tree, "code", (node, index, parent) => {
-		if (node.lang !== "mermaid" || parent === void 0 || index === void 0) return;
-		if (options.assets !== void 0) for (const [url, path] of options.assets.files) options.files.set(url, path);
-		parent.children[index] = {
-			type: "html",
-			value: `<figure class="wg_mermaid__root" data-mermaid${options.assets === void 0 ? "" : ` data-mermaid-module="${options.assets.entry}"`}><div class="wg_mermaid__result" hidden></div><pre class="wg_mermaid__source"><code data-mermaid-source>${node.value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;")}</code></pre><p class="wg_mermaid__error" role="status" hidden></p></figure>`
-		};
-	});
-};
-//#endregion
-//#region src/component/widget/prose/_constant/section.ts
+//#region src/component/widget/article/_constant/section.ts
 /**
 * 목차 대상 제목 깊이. h2 절, h3 소제목
 */
@@ -452,7 +434,7 @@ var section_heading_depth = {
 	sub: 3
 };
 //#endregion
-//#region src/component/widget/prose/_function/rehype-head.ts
+//#region src/component/widget/article/_function/rehype-head.ts
 /**
 * name 제목과 첫 절 앞 본문의 공통 머리. README는 원문의 h1 사용
 */
@@ -462,13 +444,13 @@ var rehypeHead = () => (tree, file) => {
 	const head = {
 		type: "element",
 		tagName: "header",
-		properties: { className: ["wg_prose__head"] },
+		properties: { className: ["wg_article__head"] },
 		children: tree.children.slice(0, leadEnd).filter((node) => node.type !== "doctype")
 	};
 	if (file.data.fh?.frontmatter !== void 0) head.children.unshift({
 		type: "element",
 		tagName: "h1",
-		properties: { className: ["wg_prose__title"] },
+		properties: { className: ["wg_article__title"] },
 		children: [{
 			type: "text",
 			value: file.data.fh.frontmatter.name
@@ -478,7 +460,7 @@ var rehypeHead = () => (tree, file) => {
 	tree.children = [head, ...tree.children.slice(leadEnd)];
 };
 //#endregion
-//#region src/component/widget/prose/_function/rehype-sections/_to-section-headings.ts
+//#region src/component/widget/article/_function/rehype-sections/_to-section-headings.ts
 /**
 * 목차 대상 h2, h3. 중첩 블록까지 문서 순서 수집
 *
@@ -492,7 +474,7 @@ var toSectionHeadings = (node) => {
 	});
 };
 //#endregion
-//#region src/component/widget/prose/_function/rehype-sections/rehype-sections.ts
+//#region src/component/widget/article/_function/rehype-sections/rehype-sections.ts
 /**
 * h2, h3의 가름 메타데이터 수집. 작성한 제목은 그대로 유지
 *
@@ -506,7 +488,7 @@ var rehypeSections = () => (tree, file) => {
 	});
 };
 //#endregion
-//#region src/component/widget/prose/_function/rehype-tables.ts
+//#region src/component/widget/article/_function/rehype-tables.ts
 /**
 * 넓은 표의 내부 가로 스크롤 래퍼
 */
@@ -516,14 +498,14 @@ var rehypeTables = () => (tree) => {
 		parent.children[index] = {
 			type: "element",
 			tagName: "div",
-			properties: { className: ["wg_prose__table"] },
+			properties: { className: ["wg_article__table"] },
 			children: [node]
 		};
 		return [SKIP, index + 1];
 	});
 };
 //#endregion
-//#region src/component/widget/prose/_function/has-block-content.ts
+//#region src/component/widget/article/_function/has-block-content.ts
 /**
 * 부품 본문의 내용 판정. 참조 정의, 주석, 빈 텍스트와 빈 구조 제외
 *
@@ -538,7 +520,7 @@ var hasBlockContent = (node) => {
 	return true;
 };
 //#endregion
-//#region src/component/widget/prose/_function/remark-blocks.ts
+//#region src/component/widget/article/_function/remark-blocks.ts
 /**
 * Note, Details의 제목, 본문, 속성, 닫힘 계약
 *
@@ -558,7 +540,6 @@ var remarkBlocks = () => (tree, file) => {
 		if (!node.children.slice(1).some(hasBlockContent)) file.fail(`${copy_error_directive_syntax}: ${node.name} · 본문 필수`, node);
 		const unsupported = node.attributes ? Object.keys(node.attributes).find((key) => node.name !== "details" || key !== "open") : void 0;
 		if (unsupported !== void 0) file.fail(`${copy_error_directive_syntax}: ${node.name} · 미지원 속성 ${unsupported}`, node);
-		const open = node.attributes?.open;
 		const attributeSource = source.slice(label.position?.end.offset, node.position?.end.offset).split(/\r?\n/, 1)[0].trim();
 		if (attributeSource !== "" && (node.name !== "details" || !/^\{[ \t]*open[ \t]*\}$/.test(attributeSource))) file.fail(`${copy_error_directive_syntax}: ${node.name} · 허용 속성은 Details의 {open}, 나머지는 생략`, node);
 		const original = source.slice(node.position?.start.offset, node.position?.end.offset);
@@ -581,23 +562,23 @@ var remarkBlocks = () => (tree, file) => {
 		label.data = {
 			...label.data,
 			hName: node.name === "note" ? "strong" : "summary",
-			hProperties: { className: [node.name === "note" ? "wg_prose__noteTitle" : "wg_prose__detailsSummary"] }
+			hProperties: { className: [node.name === "note" ? "wg_article__noteTitle" : "wg_article__detailsSummary"] }
 		};
 		node.data = {
 			...node.data,
 			hName: node.name === "note" ? "aside" : "details",
 			hProperties: node.name === "note" ? {
-				className: ["wg_prose__note"],
+				className: ["wg_article__note"],
 				ariaLabel: title
 			} : {
-				className: ["wg_prose__details"],
-				open: open === ""
+				className: ["wg_article__details"],
+				open: node.attributes?.open === ""
 			}
 		};
 	});
 };
 //#endregion
-//#region src/component/widget/prose/_function/remark-links.ts
+//#region src/component/widget/article/_function/remark-links.ts
 /**
 * 상대 Markdown 링크의 사이트 URL 변환, query와 hash 원문 유지
 *
@@ -634,7 +615,7 @@ var remarkLinks = (options) => (tree, file) => {
 	});
 };
 //#endregion
-//#region src/component/widget/prose/_function/remark-parts.ts
+//#region src/component/widget/article/_function/remark-parts.ts
 /**
 * ::part[이름]의 본문 가름과 다음 h2의 data-part
 *
@@ -646,7 +627,7 @@ var remarkParts = () => (tree) => {
 		const section = tree.children.slice(index + 1).find((next) => next.type === "heading" && next.depth === section_heading_depth.section);
 		node.data = {
 			hName: "div",
-			hProperties: { className: ["wg_prose__part"] }
+			hProperties: { className: ["wg_article__part"] }
 		};
 		if (section) section.data = {
 			...section.data,
@@ -658,7 +639,7 @@ var remarkParts = () => (tree) => {
 	}
 };
 //#endregion
-//#region src/component/widget/prose/_constant/status.ts
+//#region src/component/widget/article/_constant/status.ts
 /**
 * 상태 문구 뒤 날짜 패턴. YYYY-MM-DD
 */
@@ -668,7 +649,7 @@ var status_date_pattern = String.raw`\d{4}-\d{2}-\d{2}`;
 */
 var status_candidate_pattern = new RegExp(String.raw`\([^()\n]*${status_date_pattern}\)`, "g");
 //#endregion
-//#region src/component/widget/prose/_function/remark-status.ts
+//#region src/component/widget/article/_function/remark-status.ts
 /**
 * 설정 문구의 상태 표지 변환. 괄호 제거. 제목, 링크 제외
 *
@@ -690,7 +671,7 @@ var remarkStatus = (options) => {
 			if (text === void 0 || item === void 0) return false;
 			return {
 				type: "html",
-				value: `<span class="wg_prose__pill wg_prose__pill--${item.kind}">${escape(text)}</span>`
+				value: `<span class="wg_article__pill wg_article__pill--${item.kind}">${escape(text)}</span>`
 			};
 		}], { ignore });
 		findAndReplace(tree, [status_candidate_pattern, (match, info) => {
@@ -700,22 +681,22 @@ var remarkStatus = (options) => {
 	};
 };
 //#endregion
-//#region src/component/widget/prose/_function/remark-swatch.ts
+//#region src/component/widget/article/_function/remark-swatch.ts
 /**
 * 인라인 hex 색 값의 칩 표시
 *
-*   - 문서별 색은 --wg-prose-chip-color로 전달. 고정 스타일시트 값 불가
+*   - 문서별 색은 --wg-article-chip-color로 전달. 고정 스타일시트 값 불가
 */
 var remarkSwatch = () => (tree) => {
 	visit(tree, "inlineCode", (node) => {
 		if (/^#[0-9a-f]{3,8}$/i.test(node.value.trim())) node.data = { hProperties: {
-			className: ["wg_prose__color"],
-			style: `--wg-prose-chip-color: ${node.value.trim()}`
+			className: ["wg_article__color"],
+			style: `--wg-article-chip-color: ${node.value.trim()}`
 		} };
 	});
 };
 //#endregion
-//#region src/component/widget/prose/_function/remark-unknown-directives.ts
+//#region src/component/widget/article/_function/remark-unknown-directives.ts
 /**
 * hName 없는 블록 지시문은 작성 오류
 *
@@ -734,13 +715,28 @@ var remarkUnknownDirectives = () => (tree, file) => {
 	});
 };
 //#endregion
+//#region src/component/widget/mermaid/_function/remark-mermaid.ts
+/**
+* Mermaid 원문과 브라우저 렌더 영역. JavaScript 비활성 환경에서도 원문 유지
+*/
+var remarkMermaid = (options) => (tree) => {
+	visit(tree, "code", (node, index, parent) => {
+		if (node.lang !== "mermaid" || parent === void 0 || index === void 0) return;
+		if (options.assets !== void 0) for (const [url, path] of options.assets.files) options.files.set(url, path);
+		parent.children[index] = {
+			type: "html",
+			value: `<figure class="wg_mermaid__root" data-mermaid${options.assets === void 0 ? "" : ` data-mermaid-module="${options.assets.entry}"`}><div class="wg_mermaid__result" hidden></div><pre class="wg_mermaid__source"><code data-mermaid-source>${node.value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;")}</code></pre><p class="wg_mermaid__error" role="status" hidden></p></figure>`
+		};
+	});
+};
+//#endregion
 //#region src/app/_function/create-processor/create-processor.ts
 /**
 * Markdown 변환과 문서 메타데이터 수집
 *
 *   - 코드와 문서 머리 생성 후 제목 ID와 가름 수집
 *   - 플러그인 HTML 조각은 마지막 rehype-raw에서 해석
-*   - 코드 상자의 색상은 prose CSS 소유, Shiki 토큰 색상은 --app-code-* 참조
+*   - 코드 상자의 색상은 article CSS 소유, Shiki 토큰 색상은 --app-code-* 참조
 */
 var createProcessor = (options) => {
 	const files = options.files ?? /* @__PURE__ */ new Map();
@@ -781,32 +777,6 @@ var loadMermaidAssets = (kitRoot) => {
 	};
 };
 //#endregion
-//#region src/app/_function/read-content-scope.ts
-/**
-* 공개 폴더 필수, 내부 폴더 선택, 범위 폴더의 symlink 별칭 금지
-*/
-var readContentScope = (params) => {
-	if (!existsSync(params.root) || !statSync(params.root).isDirectory()) throw new Error(`content 문서 루트가 없습니다: ${params.root}`);
-	const root = realpathSync(params.root);
-	const publicRoot = join(root, params.content.public);
-	const privateRoot = join(root, params.content.private);
-	for (const path of [publicRoot, privateRoot]) {
-		if (!existsSync(path)) {
-			if (path === privateRoot) continue;
-			throw new Error(`공개 문서 폴더가 없습니다: ${path}. content/public 구조 또는 content 설정을 확인하세요`);
-		}
-		const actual = realpathSync(path);
-		const location = relative(root, actual);
-		if (!statSync(path).isDirectory() || actual !== path || location === ".." || location.startsWith(`..${sep}`) || isAbsolute(location)) throw new Error(`문서 폴더는 content 내부의 실제 폴더여야 합니다: ${path}`);
-	}
-	return {
-		root,
-		publicRoot,
-		privateRoot,
-		includePrivate: params.includePrivate
-	};
-};
-//#endregion
 //#region src/constant/doc.ts
 /**
 * 기존 frontmatter type의 호환 값. 모두 같은 Markdown 렌더링
@@ -857,7 +827,7 @@ var docDataSchema = z.object({
 /**
 * 공개 범위의 Markdown 수집과 렌더링, 범위 미지정 시 독립 Markdown 처리
 *
-*   - 사이트 실행에서 공개·내부 문서만 수집, content 루트 안내 파일 제외
+*   - 사이트 실행에서 공개와 내부 문서만 수집, content 루트 안내 파일 제외
 *   - 머리말, 문서 식별자 중복, 플러그인 오류 시 실패
 */
 var readDocs = async (options) => {
@@ -1038,190 +1008,32 @@ var toHtml = (page) => {
 	return html`<!DOCTYPE html>${page}`;
 };
 //#endregion
-//#region src/component/widget/prose/wg-prose.tsx
-var WgProse = (props) => {
+//#region src/component/widget/article/wg-article.tsx
+var WgArticle = (props) => {
 	if (props.html !== void 0) return /* @__PURE__ */ jsx("article", {
-		className: clsx("wg_prose__root"),
+		className: clsx("wg_article__root"),
 		dangerouslySetInnerHTML: { __html: props.html }
 	});
 	return /* @__PURE__ */ jsx("article", {
-		className: clsx("wg_prose__root"),
+		className: clsx("wg_article__root"),
 		children: props.head !== void 0 && /* @__PURE__ */ jsxs("header", {
-			className: clsx("wg_prose__head"),
+			className: clsx("wg_article__head"),
 			children: [/* @__PURE__ */ jsx("h1", {
-				className: clsx("wg_prose__title"),
+				className: clsx("wg_article__title"),
 				children: props.head.title
 			}), props.head.lead !== void 0 && /* @__PURE__ */ jsx("p", {
-				className: clsx("wg_prose__lead"),
+				className: clsx("wg_article__lead"),
 				children: props.head.lead
 			})]
 		})
 	});
 };
 //#endregion
-//#region src/component/widget/navigation/_function/to-doc-groups/_to-doc-branches.ts
+//#region src/component/widget/article/_constant/heading-highlight.ts
 /**
-* 검증된 부모 관계로 문서 가지를 재귀 구성. 형제 순서와 URL 유지
-*/
-var toDocBranches = (options) => {
-	return options.docs.toSorted((a, b) => a.data.order - b.data.order || a.data.name.localeCompare(b.data.name, "en") || a.id.localeCompare(b.id, "en")).map((doc) => {
-		const children = options.children.get(doc.id);
-		return {
-			...doc,
-			children: children === void 0 ? void 0 : toDocBranches({
-				docs: children,
-				children: options.children
-			})
-		};
-	});
-};
-//#endregion
-//#region src/component/widget/navigation/_function/to-doc-groups/_to-doc-group-branches.ts
-/**
-* 각 단계의 직접 문서와 하위 묶음을 분리. 고정된 깊이 제한 없이 구성
-*/
-var toDocGroupBranches = (options) => {
-	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, "ko")).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 === void 0),
-				children: options.children
-			}),
-			groups: toDocGroupBranches({
-				docs: group.docs,
-				children: options.children,
-				path: group.path,
-				positions: options.positions,
-				unlistedPosition: options.unlistedPosition
-			})
-		};
-	});
-};
-//#endregion
-//#region src/component/widget/navigation/_function/to-doc-groups/to-doc-groups.ts
-/**
-* 메타데이터 경로로 읽는 순서를 가진 문서 계층 구성
-*
-*   - 같은 조상의 중복 지정은 최초 순서 유지
-*   - 미지정 형제 묶음은 이름순
-*/
-var toDocGroups = (options) => {
-	const positions = new Map(uniqBy(options.navigation.flatMap((path, index) => {
-		return path.map((_name, depth) => [JSON.stringify(path.slice(0, depth + 1)), index]);
-	}), (entry) => entry[0]));
-	const children = Map.groupBy(options.docs, (doc) => doc.data.parent);
-	return toDocGroupBranches({
-		docs: options.docs,
-		children,
-		path: [],
-		positions,
-		unlistedPosition: options.navigation.length
-	});
-};
-//#endregion
-//#region src/component/widget/navigation/_function/to-navigation-data/_to-navigation-document.ts
-/**
-* 본문 없는 문서 가지. 재귀에서도 현재 페이지 한 항목만 표시
-*/
-var toNavigationDocument = (options) => {
-	return {
-		id: options.doc.id,
-		name: options.doc.data.name,
-		label: options.doc.data.label,
-		active: options.doc.id === options.current,
-		children: options.doc.children === void 0 ? [] : options.doc.children.map((doc) => toNavigationDocument({
-			...options,
-			doc
-		}))
-	};
-};
-//#endregion
-//#region src/component/widget/navigation/_function/to-navigation-data/_to-navigation-group.ts
-/**
-* 전체 묶음 경로와 본문 없는 하위 가지
-*/
-var toNavigationGroup = (options) => {
-	return {
-		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
-		}))
-	};
-};
-//#endregion
-//#region src/component/widget/navigation/_function/to-toc-groups.ts
-/**
-* h2별 h3 수집. 가름 시작 절에서 목차 묶음 분리
-*
-*   - 첫 h2 앞의 h3은 목차 제외
-*/
-var toTocGroups = (outline) => {
-	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) => {
-		if (entry.heading.depth !== section_heading_depth.section) return [];
-		return [{
-			heading: entry.heading,
-			part: entry.section.part,
-			subs: takeWhile(entries.slice(index + 1), (sub) => sub.heading.depth !== section_heading_depth.section).map((sub) => {
-				return { heading: sub.heading };
-			})
-		}];
-	});
-	return sections.flatMap((section, index) => {
-		if (index > 0 && section.part === void 0) return [];
-		return [{
-			part: section.part,
-			sections: [section, ...takeWhile(sections.slice(index + 1), (next) => next.part === void 0)]
-		}];
-	});
-};
-//#endregion
-//#region src/component/widget/navigation/_function/to-navigation-data/to-navigation-data.ts
-/**
-* 현재 문서의 이름, 계층, 목차만 전송. 다른 문서 본문은 브라우저 탐색 입력에서 제외
-*/
-var toNavigationData = (options) => {
-	return {
-		title: options.site.title,
-		groups: toDocGroups({
-			docs: options.docs,
-			navigation: options.site.navigation
-		}).map((group) => toNavigationGroup({
-			group,
-			current: options.current
-		})),
-		outline: options.outline === void 0 ? [] : toTocGroups(options.outline),
-		home: options.current === void 0,
-		cursorFace: options.site.cursorFace
-	};
-};
-//#endregion
-//#region src/component/widget/navigation/_function/to-navigation-json.ts
-/**
-* 작성한 이름이 script 종료 태그나 JavaScript 줄 구분자로 해석되지 않는 JSON
+* 앵커 이동 후 제목 강조 유지 시간. 이후 CSS로 서서히 해제
 */
-var toNavigationJson = (data) => {
-	return JSON.stringify(data).replaceAll("<", "\\u003c").replaceAll("\u2028", "\\u2028").replaceAll("\u2029", "\\u2029");
-};
+var heading_highlight_hold_ms = 3e3;
 //#endregion
 //#region src/component/widget/cursor-face/_constant/cursor-face.ts
 /**
@@ -1420,7 +1232,8 @@ var WgMermaid = (props) => {
 		* 공유 툴팁 재사용, 테마나 접힘 변경에서 숨긴 안내의 다음 호버 복원
 		*/
 		const handleTooltipShow = (event) => {
-			if (event.target instanceof Element && event.target.closest("[title]") !== null) for (const tooltip of tooltips) {
+			if (!(event.target instanceof Element) || event.target.closest("[title]") === null) return;
+			for (const tooltip of tooltips) {
 				tooltip.hidden = false;
 				const bounds = tooltip.getBoundingClientRect();
 				tooltip.style.left = `${scrollX + Math.max(0, Math.min(bounds.left, document.documentElement.clientWidth - bounds.width))}px`;
@@ -1432,6 +1245,9 @@ var WgMermaid = (props) => {
 		const handleTooltipHide = () => {
 			for (const tooltip of tooltips) tooltip.hidden = true;
 		};
+		/**
+		* 보이는 다이어그램만 현재 테마로 차례 렌더. 모듈 수신 실패는 모든 영역에 오류 안내
+		*/
 		const render = toChangeQueue({
 			run: async () => {
 				const elements = [...document.querySelectorAll(".wg_mermaid__root[data-mermaid]")];
@@ -1461,10 +1277,9 @@ var WgMermaid = (props) => {
 						library.default.initialize(mode === "dark" ? render_dark_config : render_config);
 						const rendered = await library.default.render(`fh-mermaid-${crypto.getRandomValues(/* @__PURE__ */ new Uint32Array(4)).join("-")}`, source.textContent, measurement);
 						if (lifetime.signal.aborted || !element.isConnected || theme.matches !== (mode === "dark")) return;
-						const shadow = result.shadowRoot ?? result.attachShadow({ mode: "open" });
 						const canvas = document.createElement("div");
 						canvas.innerHTML = rendered.svg;
-						shadow.replaceChildren(canvas);
+						(result.shadowRoot ?? result.attachShadow({ mode: "open" })).replaceChildren(canvas);
 						rendered.bindFunctions?.(canvas);
 						canvas.addEventListener("mouseover", handleTooltipShow, { signal: lifetime.signal });
 						canvas.addEventListener("mouseout", handleTooltipHide, { signal: lifetime.signal });
@@ -1535,8 +1350,10 @@ var WgMermaid = (props) => {
 				const source = element.querySelector(".wg_mermaid__source");
 				const result = element.querySelector(".wg_mermaid__result");
 				const error = element.querySelector(".wg_mermaid__error");
-				result?.shadowRoot?.replaceChildren();
-				if (result !== null) result.hidden = true;
+				if (result !== null) {
+					result.shadowRoot?.replaceChildren();
+					result.hidden = true;
+				}
 				if (source !== null) source.hidden = false;
 				if (error !== null) error.hidden = true;
 				delete element.dataset.mermaidTheme;
@@ -1548,7 +1365,7 @@ var WgMermaid = (props) => {
 	return null;
 };
 //#endregion
-//#region src/component/widget/navigation/_constant/navigation.ts
+//#region src/component/widget/sidebar/_constant/navigation.ts
 /**
 * 모바일 탐색 전환. wg-shell.css의 폭 조건과 일치
 */
@@ -1558,66 +1375,65 @@ var navigation_mobile_query = "(width < 1024px)";
 */
 var navigation_wide_query = "(width >= 1360px)";
 //#endregion
-//#region src/component/widget/navigation/_wg-navigation-nav-list.tsx
-var WgNavigationNavList = (props) => {
-	const entries = [...props.group.docs.map((doc) => ({
-		kind: "document",
-		key: `doc:${doc.id}`,
-		doc
-	})), ...props.group.groups.map((group) => ({
-		kind: "group",
-		key: `group:${JSON.stringify(group.path)}`,
-		group
-	}))];
+//#region src/component/widget/sidebar/_wg-doc-list.tsx
+var WgDocList = (props) => {
 	return /* @__PURE__ */ jsx("ul", {
-		className: clsx("wg_navigationNavList__root"),
+		className: clsx("wg_docList__root"),
 		"aria-label": props.group.name,
-		children: entries.map((entry) => {
+		children: [...props.group.docs.map((doc) => ({
+			kind: "document",
+			key: `doc:${doc.id}`,
+			doc
+		})), ...props.group.groups.map((group) => ({
+			kind: "group",
+			key: `group:${JSON.stringify(group.path)}`,
+			group
+		}))].map((entry) => {
 			return /* @__PURE__ */ jsxs("li", {
-				className: clsx("wg_navigationNavList__item"),
+				className: clsx("wg_docList__item"),
 				children: [entry.kind === "document" && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("a", {
-					className: clsx("wg_navigationNavList__link", { "wg_navigationNavList__link--active": entry.doc.active }),
+					className: clsx("wg_docList__link", { "wg_docList__link--active": entry.doc.active }),
 					href: `/${entry.doc.id}/`,
 					title: entry.doc.label,
 					"aria-current": entry.doc.active ? "page" : void 0,
 					children: entry.doc.name
-				}), entry.doc.children.length > 0 && /* @__PURE__ */ jsx(WgNavigationNavList, { group: {
+				}), entry.doc.children.length > 0 && /* @__PURE__ */ jsx(WgDocList, { group: {
 					name: entry.doc.name,
 					path: props.group.path,
 					docs: entry.doc.children,
 					groups: []
 				} })] }), entry.kind === "group" && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("span", {
-					className: clsx("wg_navigationNavList__branch"),
+					className: clsx("wg_docList__branch"),
 					children: entry.group.name
-				}), /* @__PURE__ */ jsx(WgNavigationNavList, { group: entry.group })] })]
+				}), /* @__PURE__ */ jsx(WgDocList, { group: entry.group })] })]
 			}, entry.key);
 		})
 	});
 };
 //#endregion
-//#region src/component/widget/navigation/_wg-navigation-nav.tsx
-var WgNavigationNav = (props) => {
+//#region src/component/widget/sidebar/_wg-doc-tree.tsx
+var WgDocTree = (props) => {
 	return /* @__PURE__ */ jsx("nav", {
-		className: clsx("wg_navigationNav__root"),
+		className: clsx("wg_docTree__root"),
 		"aria-label": copy_nav_aria_label,
 		children: /* @__PURE__ */ jsx("div", {
-			className: clsx("wg_navigationNav__docs"),
+			className: clsx("wg_docTree__docs"),
 			children: props.groups.map((group) => {
 				return /* @__PURE__ */ jsxs("section", {
-					className: clsx("wg_navigationNav__docGroup"),
+					className: clsx("wg_docTree__docGroup"),
 					"aria-label": group.name,
 					children: [/* @__PURE__ */ jsx("div", {
-						className: clsx("wg_navigationNav__group"),
+						className: clsx("wg_docTree__group"),
 						children: group.name
-					}), /* @__PURE__ */ jsx(WgNavigationNavList, { group })]
+					}), /* @__PURE__ */ jsx(WgDocList, { group })]
 				}, JSON.stringify(group.path));
 			})
 		})
 	});
 };
 //#endregion
-//#region src/component/widget/navigation/_wg-navigation-scroll.tsx
-var WgNavigationScroll = (props) => {
+//#region src/component/widget/sidebar/_wg-sidebar-scroll.tsx
+var WgSidebarScroll = (props) => {
 	const [overflow, setOverflow] = useState({
 		above: false,
 		below: false
@@ -1655,9 +1471,9 @@ var WgNavigationScroll = (props) => {
 	useLayoutEffect(() => {
 		if (!props.ready || props.portRef.current === null) return;
 		const observer = new ResizeObserver(scheduleOverflow);
+		let active = true;
 		observer.observe(props.portRef.current);
 		if (props.portRef.current.firstElementChild !== null) observer.observe(props.portRef.current.firstElementChild);
-		let active = true;
 		addEventListener("pageshow", scheduleOverflow);
 		if (props.portRef.current.isConnected) updateOverflow();
 		else queueMicrotask(() => {
@@ -1679,30 +1495,79 @@ var WgNavigationScroll = (props) => {
 	}, [props.children, props.ready]);
 	return /* @__PURE__ */ jsx("div", {
 		ref: props.ready ? props.portRef : void 0,
-		className: clsx("wg_navigation__scroll", props.kind === "documents" && "wg_navigation__documents", props.kind === "outline" && "wg_navigation__headings", props.ready && "wg_navigation__scroll--ready", props.ready && overflow.above && "wg_navigation__scroll--above", props.ready && overflow.below && "wg_navigation__scroll--below"),
-		"data-navigation-scroll": props.kind,
+		className: clsx("wg_sidebar__scroll", props.kind === "documents" && "wg_sidebar__docsScroll", props.kind === "outline" && "wg_sidebar__tocScroll", props.ready && "wg_sidebar__scroll--ready", props.ready && (overflow.above || overflow.below) && "wg_sidebar__scroll--overflow", props.ready && overflow.above && "wg_sidebar__scroll--above", props.ready && overflow.below && "wg_sidebar__scroll--below"),
+		"data-sidebar-scroll": props.kind,
 		onClick: props.onClick,
 		onScroll: handlePortScroll,
 		children: props.children
 	});
 };
 //#endregion
-//#region src/util/dom/find-hash-target.ts
+//#region src/component/widget/article/_constant/anchor-shift.ts
 /**
-* URL hash 대상. 한국어 제목의 percent encoding 해석
+* 끝 구간 제목의 추가 도착 여백. 목차가 실행 중 계산해 제목에 지정
 */
-var findHashTarget = (hash) => {
-	if (!hash) return null;
+var anchor_shift_property = "--wg-article-anchor-shift";
+//#endregion
+//#region src/constant/scroll.ts
+/**
+* 사용자가 문서 스크롤을 직접 조작하는 입력. 초기 앵커 보정 중단과 목차 고정 해제 기준
+*/
+var scroll_user_input_events = [
+	"wheel",
+	"touchmove",
+	"keydown",
+	"mousedown"
+];
+//#endregion
+//#region src/util/dom/find-hash-link.ts
+/**
+* 현재 문서 안 hash 이동을 일으키는 기본 클릭의 링크
+*
+*   - 보조키, 새 창, 다운로드, 다른 문서 링크는 없음
+*/
+var findHashLink = (event) => {
+	if (event.defaultPrevented || event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return null;
+	const link = event.target instanceof Element ? event.target.closest("a[href]") : null;
+	return link instanceof HTMLAnchorElement && (link.target === "" || link.target === "_self") && !link.hasAttribute("download") && link.origin === location.origin && link.pathname === location.pathname && link.search === location.search && link.hash !== "" ? link : null;
+};
+//#endregion
+//#region src/util/dom/to-hash-id.ts
+/**
+* URL hash의 대상 id. 한국어 제목의 percent encoding 해석
+*
+*   - 빈 hash와 잘못된 encoding은 대상 없음
+*/
+var toHashId = (hash) => {
+	if (!hash) return;
 	try {
-		return document.getElementById(decodeURIComponent(hash.slice(1)));
+		return decodeURIComponent(hash.slice(1));
 	} catch (error) {
-		if (error instanceof URIError) return null;
+		if (error instanceof URIError) return;
 		throw error;
 	}
 };
 //#endregion
-//#region src/component/widget/navigation/_wg-navigation-toc.tsx
-var WgNavigationToc = (props) => {
+//#region src/util/dom/find-hash-target.ts
+/**
+* URL hash 대상 요소. 대상 id가 없으면 없음
+*/
+var findHashTarget = (hash) => {
+	const id = toHashId(hash);
+	return id === void 0 ? null : document.getElementById(id);
+};
+//#endregion
+//#region src/util/dom/is-restoring-navigation.ts
+/**
+* 브라우저가 이전 스크롤 위치를 복원하는 문서 진입. 새로고침, 뒤로가기, 앞으로가기
+*/
+var isRestoringNavigation = () => {
+	const navigation = performance.getEntriesByType("navigation")[0];
+	return navigation instanceof PerformanceNavigationTiming && (navigation.type === "reload" || navigation.type === "back_forward");
+};
+//#endregion
+//#region src/component/widget/sidebar/_wg-toc.tsx
+var WgToc = (props) => {
 	const [currentSlug, setCurrentSlug] = useState();
 	/**
 	* 연결마다 구독 설치, 초기 위치 갱신은 본문 파싱 이후 실행
@@ -1710,71 +1575,133 @@ var WgNavigationToc = (props) => {
 	useLayoutEffect(() => {
 		const headings = props.groups.flatMap((group) => group.sections).flatMap((section) => [section.heading, ...section.subs.map((sub) => sub.heading)]);
 		const frame = { id: 0 };
+		const lifetime = new AbortController();
+		const lock = { slug: isRestoringNavigation() ? void 0 : toHashId(location.hash) };
 		/**
-		* 접힌 본문 제목은 제외하고 읽는 선을 통과한 마지막 제목 선택
+		* 연속 스크롤의 프레임당 1회 현재 제목 갱신
+		*
+		*   - 접힌 본문 제목은 제외하고 읽는 선을 통과한 마지막 제목 선택
+		*   - 링크, hash로 이동한 제목은 사용자 스크롤 전까지 유지
 		*/
-		const updateCurrentHeading = () => {
-			frame.id = 0;
-			const visible = headings.flatMap((heading) => {
+		const handleReadingPositionChange = () => {
+			if (frame.id !== 0) return;
+			frame.id = requestAnimationFrame(() => {
+				frame.id = 0;
+				const visible = headings.flatMap((heading) => {
+					const target = findHashTarget(`#${heading.slug}`);
+					return target?.checkVisibility() ? [{
+						slug: heading.slug,
+						top: target.getBoundingClientRect().top - Number.parseFloat(getComputedStyle(target).scrollMarginTop)
+					}] : [];
+				});
+				setCurrentSlug(visible.find((heading) => heading.slug === lock.slug)?.slug ?? visible.findLast((heading) => heading.top <= 1)?.slug ?? visible[0]?.slug);
+			});
+		};
+		/**
+		* 문서 크기, 화면 높이 변경. 끝 구간 제목의 도착 위치를 목차 전환 위치와 맞춘 뒤 현재 제목 재계산
+		*
+		*   - 읽는 선에 닿지 못하는 끝 절이 있으면 마지막 한 화면 구간의 도착 위치를 문서 끝까지 비례 압축
+		*   - 압축한 거리만큼 제목 위 여백 추가, 앵커 이동과 목차 판정이 같은 위치 사용
+		*/
+		const handleLayoutChange = () => {
+			for (const heading of headings) findHashTarget(`#${heading.slug}`)?.style.removeProperty(anchor_shift_property);
+			const anchors = headings.flatMap((heading) => {
 				const target = findHashTarget(`#${heading.slug}`);
 				return target?.checkVisibility() ? [{
-					slug: heading.slug,
-					top: target.getBoundingClientRect().top - Number.parseFloat(getComputedStyle(target).scrollMarginTop)
+					target,
+					arrival: scrollY + target.getBoundingClientRect().top - Number.parseFloat(getComputedStyle(target).scrollMarginTop)
 				}] : [];
 			});
-			setCurrentSlug(visible.findLast((heading) => heading.top <= 1)?.slug ?? visible[0]?.slug);
+			const last = anchors.at(-1);
+			const scrollEnd = document.documentElement.scrollHeight - innerHeight;
+			if (last !== void 0 && scrollEnd > 0 && last.arrival > scrollEnd) {
+				const stretchFrom = Math.max(0, scrollEnd - innerHeight);
+				const stretchScale = (scrollEnd - stretchFrom) / (last.arrival - stretchFrom);
+				for (const anchor of anchors) if (anchor.arrival > stretchFrom) anchor.target.style.setProperty(anchor_shift_property, `${(anchor.arrival - stretchFrom) * (1 - stretchScale)}px`);
+			}
+			handleReadingPositionChange();
 		};
 		/**
-		* 연속 스크롤의 프레임당 1회 위치 조회
+		* 같은 문서 hash 링크의 도착 제목 고정. 같은 hash 재클릭 포함
 		*/
-		const handleReadingPositionChange = () => {
-			if (frame.id === 0) frame.id = requestAnimationFrame(updateCurrentHeading);
+		const handleHashLinkClick = (event) => {
+			const link = findHashLink(event);
+			if (link === null) return;
+			lock.slug = toHashId(link.hash);
+			handleReadingPositionChange();
+		};
+		/**
+		* 뒤로가기, 주소 수정의 hash 변경 도착 제목 고정
+		*/
+		const handleHashChange = () => {
+			lock.slug = toHashId(location.hash);
+			handleReadingPositionChange();
 		};
-		addEventListener("scroll", handleReadingPositionChange, { passive: true });
-		addEventListener("resize", handleReadingPositionChange);
-		addEventListener("toggle", handleReadingPositionChange, true);
-		addEventListener("pageshow", handleReadingPositionChange);
-		document.addEventListener("DOMContentLoaded", handleReadingPositionChange);
-		if (document.readyState !== "loading") updateCurrentHeading();
+		/**
+		* 사용자 스크롤 시작. 도착 제목 고정 해제
+		*
+		*   - 재계산은 실제 스크롤에서 실행, 링크를 누르는 동안 다른 제목 표시 방지
+		*/
+		const handleUserScroll = () => {
+			lock.slug = void 0;
+		};
+		const observer = new ResizeObserver(handleLayoutChange);
+		observer.observe(document.body);
+		addEventListener("scroll", handleReadingPositionChange, {
+			passive: true,
+			signal: lifetime.signal
+		});
+		addEventListener("resize", handleLayoutChange, { signal: lifetime.signal });
+		addEventListener("toggle", handleReadingPositionChange, {
+			capture: true,
+			signal: lifetime.signal
+		});
+		addEventListener("pageshow", handleReadingPositionChange, { signal: lifetime.signal });
+		addEventListener("hashchange", handleHashChange, { signal: lifetime.signal });
+		document.addEventListener("DOMContentLoaded", handleLayoutChange, { signal: lifetime.signal });
+		document.addEventListener("click", handleHashLinkClick, { signal: lifetime.signal });
+		for (const type of scroll_user_input_events) addEventListener(type, handleUserScroll, {
+			passive: true,
+			signal: lifetime.signal
+		});
+		if (document.readyState !== "loading") handleLayoutChange();
 		return () => {
 			cancelAnimationFrame(frame.id);
-			removeEventListener("scroll", handleReadingPositionChange);
-			removeEventListener("resize", handleReadingPositionChange);
-			removeEventListener("toggle", handleReadingPositionChange, true);
-			removeEventListener("pageshow", handleReadingPositionChange);
-			document.removeEventListener("DOMContentLoaded", handleReadingPositionChange);
+			lifetime.abort();
+			observer.disconnect();
+			for (const heading of headings) findHashTarget(`#${heading.slug}`)?.style.removeProperty(anchor_shift_property);
 		};
 	}, [props.groups]);
 	return /* @__PURE__ */ jsxs("nav", {
-		className: clsx("wg_navigationToc__root"),
+		className: clsx("wg_toc__root"),
 		"aria-label": copy_nav_toc_label,
 		children: [/* @__PURE__ */ jsx("div", {
-			className: clsx("wg_navigationToc__label"),
+			className: clsx("wg_toc__label"),
 			children: copy_nav_toc_label
 		}), props.groups.map((group) => {
 			return /* @__PURE__ */ jsxs("div", {
-				className: clsx("wg_navigationToc__groupSection", { "wg_navigationToc__groupSection--named": group.part !== void 0 }),
+				className: clsx("wg_toc__groupSection", { "wg_toc__groupSection--named": group.part !== void 0 }),
 				children: [group.part !== void 0 && /* @__PURE__ */ jsx("div", {
-					className: clsx("wg_navigationToc__group"),
+					className: clsx("wg_toc__group"),
 					children: group.part
 				}), /* @__PURE__ */ jsx("ul", {
-					className: clsx("wg_navigationToc__list"),
+					className: clsx("wg_toc__list"),
 					children: group.sections.map((section) => {
 						return /* @__PURE__ */ jsxs("li", {
-							className: clsx("wg_navigationToc__item"),
+							className: clsx("wg_toc__item"),
 							children: [/* @__PURE__ */ jsx("a", {
-								className: clsx("wg_navigationToc__link", { "wg_navigationToc__link--active": section.heading.slug === currentSlug }),
+								className: clsx("wg_toc__link", { "wg_toc__link--active": section.heading.slug === currentSlug }),
 								href: `#${section.heading.slug}`,
 								"data-toc-link": "",
 								"aria-current": section.heading.slug === currentSlug ? "location" : void 0,
 								children: section.heading.text
 							}), section.subs.length > 0 && /* @__PURE__ */ jsx("ul", {
-								className: clsx("wg_navigationToc__sub"),
+								className: clsx("wg_toc__sub"),
 								children: section.subs.map((sub) => {
 									return /* @__PURE__ */ jsx("li", {
-										className: clsx("wg_navigationToc__subItem"),
+										className: clsx("wg_toc__subItem"),
 										children: /* @__PURE__ */ jsx("a", {
-											className: clsx("wg_navigationToc__subLink", { "wg_navigationToc__subLink--active": sub.heading.slug === currentSlug }),
+											className: clsx("wg_toc__subLink", { "wg_toc__subLink--active": sub.heading.slug === currentSlug }),
 											href: `#${sub.heading.slug}`,
 											"data-toc-sub-link": "",
 											"aria-current": sub.heading.slug === currentSlug ? "location" : void 0,
@@ -1803,8 +1730,8 @@ var revealHashTarget = (hash) => {
 	return target;
 };
 //#endregion
-//#region src/component/widget/navigation/wg-navigation.tsx
-var WgNavigation = (props) => {
+//#region src/component/widget/sidebar/wg-sidebar.tsx
+var WgSidebar = (props) => {
 	const [layout, setLayout] = useState(() => {
 		if (props.stores === void 0) return "desktop";
 		if (matchMedia("(width < 1024px)").matches) return "drawer";
@@ -1834,12 +1761,6 @@ var WgNavigation = (props) => {
 		return wideRef.current.matches ? "wide" : "desktop";
 	};
 	/**
-	* 배치별 DOM 참조 분리, 이전 노드 정리 시 새 배치 참조 유지
-	*/
-	const getNavigationPort = () => {
-		return layoutRef.current === "drawer" ? drawerNavigationRef.current : navigationRef.current;
-	};
-	/**
 	* 배치별 DOM은 분리하되 좌표 저장과 복원은 현재 표시되는 한 영역을 소비
 	*/
 	const getDocumentsPort = () => {
@@ -1954,8 +1875,8 @@ var WgNavigation = (props) => {
 		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,
+			navigation: document.activeElement.closest("[data-sidebar-docs]") !== null,
+			drawer: document.activeElement === openButtonRef.current || document.activeElement.closest("[data-sidebar-drawer]") !== null,
 			href: document.activeElement.getAttribute("href")
 		};
 		if (nextLayout !== "drawer") closeNavigation();
@@ -2000,11 +1921,14 @@ var WgNavigation = (props) => {
 	useLayoutEffect(() => {
 		if (props.stores === void 0) return;
 		let active = true;
+		/**
+		* 연결된 배치의 좌표 복원 후 전환 전 포커스를 같은 링크나 진입 버튼으로 이동
+		*/
 		const restoreNavigation = () => {
 			if (!active) return;
 			restoreScroll();
 			if (focusRef.current === null) return;
-			const navigation = getNavigationPort();
+			const navigation = layoutRef.current === "drawer" ? drawerNavigationRef.current : navigationRef.current;
 			if (layout === "drawer") {
 				if (focusRef.current.navigation) openButtonRef.current?.focus({ preventScroll: true });
 			} else if (focusRef.current.navigation && navigation !== null) {
@@ -2021,26 +1945,25 @@ var WgNavigation = (props) => {
 	}, [layout, props.stores]);
 	return /* @__PURE__ */ jsxs(Fragment, { children: [
 		/* @__PURE__ */ jsxs("div", {
-			className: clsx("wg_navigation__sidebar", props.stores !== void 0 && "wg_navigation__sidebar--navigationReady"),
+			className: clsx("wg_sidebar__docsColumn", props.stores !== void 0 && "wg_sidebar__docsColumn--ready"),
 			children: [/* @__PURE__ */ jsxs("div", {
-				className: clsx("wg_navigation__brandRow"),
+				className: clsx("wg_sidebar__brandRow"),
 				children: [/* @__PURE__ */ jsx("a", {
 					ref: props.stores === void 0 ? void 0 : brandRef,
-					className: clsx("wg_navigation__brand"),
+					className: clsx("wg_sidebar__brand"),
 					href: "/",
 					"aria-current": props.data.home ? "page" : void 0,
 					children: props.data.title
 				}), /* @__PURE__ */ jsx("button", {
 					ref: props.stores === void 0 ? void 0 : openButtonRef,
-					className: clsx("wg_navigation__menuToggle", props.stores !== void 0 && layout === "drawer" && "wg_navigation__menuToggle--visible"),
+					className: clsx("wg_sidebar__menuToggle", props.stores !== void 0 && layout === "drawer" && "wg_sidebar__menuToggle--visible"),
 					type: "button",
 					"aria-label": copy_nav_open,
 					"aria-controls": "fh-navigation-drawer",
 					"aria-expanded": String(drawerOpen),
-					"data-navigation-open": "",
 					onClick: handleOpenButtonClick,
 					children: /* @__PURE__ */ jsx("svg", {
-						className: clsx("wg_navigation__menuIcon"),
+						className: clsx("wg_sidebar__menuIcon"),
 						viewBox: "0 0 24 24",
 						"aria-hidden": "true",
 						focusable: "false",
@@ -2049,58 +1972,56 @@ var WgNavigation = (props) => {
 				})]
 			}), layout !== "drawer" && /* @__PURE__ */ jsx("div", {
 				ref: props.stores === void 0 ? void 0 : navigationRef,
-				className: clsx("wg_navigation__navigation"),
-				"data-navigation": "",
-				"data-navigation-layout": layout,
-				children: /* @__PURE__ */ jsx(WgNavigationScroll, {
+				className: clsx("wg_sidebar__docsPanel"),
+				"data-sidebar-docs": "",
+				"data-sidebar-layout": layout,
+				children: /* @__PURE__ */ jsx(WgSidebarScroll, {
 					portRef: documentsRef,
 					kind: "documents",
 					ready: props.stores !== void 0,
 					onScroll: saveScroll,
 					onClick: handleNavigationClick,
-					children: /* @__PURE__ */ jsx(WgNavigationNav, { groups: props.data.groups })
+					children: /* @__PURE__ */ jsx(WgDocTree, { groups: props.data.groups })
 				})
 			})]
 		}),
 		/* @__PURE__ */ jsx("aside", {
-			className: clsx("wg_navigation__tocRail"),
-			"data-navigation-rail": "",
+			className: clsx("wg_sidebar__tocColumn"),
+			"data-sidebar-toc": "",
 			children: /* @__PURE__ */ jsx("div", {
-				className: clsx("wg_navigation__outline"),
-				"data-navigation-outline": "",
-				children: /* @__PURE__ */ jsx(WgNavigationScroll, {
+				className: clsx("wg_sidebar__tocPanel"),
+				children: /* @__PURE__ */ jsx(WgSidebarScroll, {
 					portRef: outlineRef,
 					kind: "outline",
 					ready: props.stores !== void 0,
 					onScroll: saveScroll,
 					onClick: handleNavigationClick,
-					children: props.data.outline.length > 0 && /* @__PURE__ */ jsx(WgNavigationToc, { groups: props.data.outline })
+					children: props.data.outline.length > 0 && /* @__PURE__ */ jsx(WgToc, { groups: props.data.outline })
 				})
 			})
 		}),
 		/* @__PURE__ */ jsxs("dialog", {
 			ref: props.stores === void 0 ? void 0 : dialogRef,
-			className: clsx("wg_navigation__drawer"),
+			className: clsx("wg_sidebar__drawer"),
 			id: "fh-navigation-drawer",
 			"aria-labelledby": "fh-navigation-title",
-			"data-navigation-drawer": "",
+			"data-sidebar-drawer": "",
 			onClose: handleDrawerClose,
 			onCancel: handleDrawerCancel,
 			onClick: handleDrawerClick,
 			children: [/* @__PURE__ */ jsxs("div", {
-				className: clsx("wg_navigation__drawerHeader"),
+				className: clsx("wg_sidebar__drawerHeader"),
 				children: [/* @__PURE__ */ jsx("h2", {
-					className: clsx("wg_navigation__drawerTitle"),
+					className: clsx("wg_sidebar__drawerTitle"),
 					id: "fh-navigation-title",
 					children: copy_nav_title
 				}), /* @__PURE__ */ jsx("button", {
-					className: clsx("wg_navigation__drawerClose"),
+					className: clsx("wg_sidebar__drawerClose"),
 					type: "button",
 					"aria-label": copy_nav_close,
-					"data-navigation-close": "",
 					onClick: handleCloseButtonClick,
 					children: /* @__PURE__ */ jsx("svg", {
-						className: clsx("wg_navigation__menuIcon"),
+						className: clsx("wg_sidebar__menuIcon"),
 						viewBox: "0 0 24 24",
 						"aria-hidden": "true",
 						focusable: "false",
@@ -2108,20 +2029,19 @@ var WgNavigation = (props) => {
 					})
 				})]
 			}), /* @__PURE__ */ jsx("div", {
-				className: clsx("wg_navigation__drawerContent"),
-				"data-navigation-content": "",
+				className: clsx("wg_sidebar__drawerContent"),
 				children: layout === "drawer" && /* @__PURE__ */ jsx("div", {
 					ref: props.stores === void 0 ? void 0 : drawerNavigationRef,
-					className: clsx("wg_navigation__navigation"),
-					"data-navigation": "",
-					"data-navigation-layout": layout,
-					children: /* @__PURE__ */ jsx(WgNavigationScroll, {
+					className: clsx("wg_sidebar__docsPanel"),
+					"data-sidebar-docs": "",
+					"data-sidebar-layout": layout,
+					children: /* @__PURE__ */ jsx(WgSidebarScroll, {
 						portRef: drawerDocumentsRef,
 						kind: "documents",
 						ready: props.stores !== void 0,
 						onScroll: saveScroll,
 						onClick: handleNavigationClick,
-						children: /* @__PURE__ */ jsx(WgNavigationNav, { groups: props.data.groups })
+						children: /* @__PURE__ */ jsx(WgDocTree, { groups: props.data.groups })
 					})
 				})
 			})]
@@ -2129,12 +2049,6 @@ var WgNavigation = (props) => {
 	] });
 };
 //#endregion
-//#region src/component/widget/prose/_constant/heading-highlight.ts
-/**
-* 앵커 이동 후 제목 강조 유지 시간. 이후 CSS로 서서히 해제
-*/
-var heading_highlight_hold_ms = 3e3;
-//#endregion
 //#region src/component/widget/shell-controls/wg-shell-controls.tsx
 var WgShellControls = (props) => {
 	const headingRef = useRef(null);
@@ -2150,7 +2064,7 @@ var WgShellControls = (props) => {
 		timerRef.current = 0;
 		arrivalRef.current?.abort();
 		arrivalRef.current = null;
-		headingRef.current?.classList.remove("wg_prose__headingText--highlighted");
+		headingRef.current?.classList.remove("wg_article__headingText--highlighted");
 		headingRef.current = null;
 	};
 	/**
@@ -2168,9 +2082,9 @@ var WgShellControls = (props) => {
 	*/
 	const highlightHeading = (target) => {
 		clearHeadingHighlight();
-		headingRef.current = target === null ? null : target.querySelector(".wg_prose__headingText");
+		headingRef.current = target === null ? null : target.querySelector(".wg_article__headingText");
 		if (headingRef.current === null) return;
-		headingRef.current.classList.add("wg_prose__headingText--highlighted");
+		headingRef.current.classList.add("wg_article__headingText--highlighted");
 		timerRef.current = window.setTimeout(clearHeadingHighlight, heading_highlight_hold_ms);
 		arrivalRef.current = new AbortController();
 		document.addEventListener("scrollend", handleHighlightArrival, { signal: arrivalRef.current.signal });
@@ -2179,12 +2093,10 @@ var WgShellControls = (props) => {
 	* 탐색 DOM이 다시 만들어져도 같은 hash의 접힌 Details 공개를 유지
 	*/
 	const handleHashClick = (event) => {
-		if (event.defaultPrevented || event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return;
-		const link = event.target instanceof Element ? event.target.closest("a[href]") : null;
-		if (link instanceof HTMLAnchorElement && (link.target === "" || link.target === "_self") && !link.hasAttribute("download") && link.origin === location.origin && link.pathname === location.pathname && link.search === location.search && link.hash) {
-			const target = revealHashTarget(link.hash);
-			if (link.hash === location.hash) highlightHeading(target);
-		}
+		const link = findHashLink(event);
+		if (link === null) return;
+		const target = revealHashTarget(link.hash);
+		if (link.hash === location.hash) highlightHeading(target);
 	};
 	/**
 	* hash 변경 시 접힌 대상을 공개하고 네이티브 스크롤, 강조 적용
@@ -2194,23 +2106,31 @@ var WgShellControls = (props) => {
 		target?.scrollIntoView();
 		highlightHeading(target);
 	};
+	/**
+	* 첫 사용자 입력. 초기 앵커 보정 중단, 부드러운 절 이동 활성화
+	*/
 	const handleUserScroll = () => {
 		userScrollRef.current?.abort();
+		document.documentElement.style.scrollBehavior = "smooth";
 	};
 	/**
 	* 초기 폰트 로드 후 앵커 보정. 해제된 인스턴스와 사용자 이동에 개입하지 않음
+	*
+	*   - 새로고침, 뒤로가기는 브라우저의 이전 위치 복원 사용
+	*   - 부드러운 절 이동은 보정 후 활성화, 복원 진입은 첫 사용자 입력까지 즉시 스크롤 유지
 	*/
 	const handlePageLoad = async () => {
 		const lifetime = lifetimeRef.current;
 		const hash = location.hash;
 		const target = revealHashTarget(hash);
+		if (isRestoringNavigation()) return;
 		await document.fonts.ready;
 		if (lifetime === null || lifetime.signal.aborted) return;
 		if (target !== null && !userScrollRef.current?.signal.aborted && hash === location.hash) {
 			target.scrollIntoView({ behavior: "instant" });
 			highlightHeading(target);
 		}
-		document.documentElement.style.removeProperty("scroll-behavior");
+		document.documentElement.style.scrollBehavior = "smooth";
 	};
 	/**
 	* 셸은 본문 앞에서 마운트. 본문 파싱 이후에만 초기 접힘 대상 조회
@@ -2226,19 +2146,13 @@ var WgShellControls = (props) => {
 		const lifetime = new AbortController();
 		lifetimeRef.current = lifetime;
 		userScrollRef.current = new AbortController();
-		document.documentElement.style.scrollBehavior = "auto";
 		document.addEventListener("click", handleHashClick, { signal: lifetime.signal });
 		addEventListener("hashchange", handleHashChange, { signal: lifetime.signal });
 		addEventListener("load", handlePageLoad, {
 			once: true,
 			signal: lifetime.signal
 		});
-		for (const type of [
-			"wheel",
-			"touchmove",
-			"keydown",
-			"mousedown"
-		]) addEventListener(type, handleUserScroll, {
+		for (const type of scroll_user_input_events) addEventListener(type, handleUserScroll, {
 			once: true,
 			passive: true,
 			signal: lifetime.signal
@@ -2259,8 +2173,8 @@ var WgShellControls = (props) => {
 	}, []);
 	return /* @__PURE__ */ jsxs(Fragment, { children: [
 		/* @__PURE__ */ jsx("div", {
-			className: clsx("wg_shellControls__navigation"),
-			children: /* @__PURE__ */ jsx(WgNavigation, {
+			className: clsx("wg_shellControls__sidebar"),
+			children: /* @__PURE__ */ jsx(WgSidebar, {
 				data: props.data,
 				stores: props.stores
 			})
@@ -2270,6 +2184,159 @@ var WgShellControls = (props) => {
 	] });
 };
 //#endregion
+//#region src/component/widget/sidebar/_function/to-doc-groups/_to-doc-branches.ts
+/**
+* 검증된 부모 관계로 문서 가지를 재귀 구성. 형제 순서와 URL 유지
+*/
+var toDocBranches = (options) => {
+	return options.docs.toSorted((a, b) => a.data.order - b.data.order || a.data.name.localeCompare(b.data.name, "en") || a.id.localeCompare(b.id, "en")).map((doc) => {
+		const children = options.children.get(doc.id);
+		return {
+			...doc,
+			children: children === void 0 ? void 0 : toDocBranches({
+				docs: children,
+				children: options.children
+			})
+		};
+	});
+};
+//#endregion
+//#region src/component/widget/sidebar/_function/to-doc-groups/_to-doc-group-branches.ts
+/**
+* 각 단계의 직접 문서와 하위 묶음을 분리. 고정된 깊이 제한 없이 구성
+*/
+var toDocGroupBranches = (options) => {
+	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, "ko")).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 === void 0),
+				children: options.children
+			}),
+			groups: toDocGroupBranches({
+				docs: group.docs,
+				children: options.children,
+				path: group.path,
+				positions: options.positions,
+				unlistedPosition: options.unlistedPosition
+			})
+		};
+	});
+};
+//#endregion
+//#region src/component/widget/sidebar/_function/to-doc-groups/to-doc-groups.ts
+/**
+* 메타데이터 경로로 읽는 순서를 가진 문서 계층 구성
+*
+*   - 같은 조상의 중복 지정은 최초 순서 유지
+*   - 미지정 형제 묶음은 이름순
+*/
+var toDocGroups = (options) => {
+	const positions = new Map(uniqBy(options.navigation.flatMap((path, index) => {
+		return path.map((_name, depth) => [JSON.stringify(path.slice(0, depth + 1)), index]);
+	}), (entry) => entry[0]));
+	return toDocGroupBranches({
+		docs: options.docs,
+		children: Map.groupBy(options.docs, (doc) => doc.data.parent),
+		path: [],
+		positions,
+		unlistedPosition: options.navigation.length
+	});
+};
+//#endregion
+//#region src/component/widget/sidebar/_function/to-navigation-data/_to-navigation-document.ts
+/**
+* 본문 없는 문서 가지. 재귀에서도 현재 페이지 한 항목만 표시
+*/
+var toNavigationDocument = (options) => {
+	return {
+		id: options.doc.id,
+		name: options.doc.data.name,
+		label: options.doc.data.label,
+		active: options.doc.id === options.current,
+		children: options.doc.children === void 0 ? [] : options.doc.children.map((doc) => toNavigationDocument({
+			...options,
+			doc
+		}))
+	};
+};
+//#endregion
+//#region src/component/widget/sidebar/_function/to-navigation-data/_to-navigation-group.ts
+/**
+* 전체 묶음 경로와 본문 없는 하위 가지
+*/
+var toNavigationGroup = (options) => {
+	return {
+		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
+		}))
+	};
+};
+//#endregion
+//#region src/component/widget/sidebar/_function/to-navigation-data/to-navigation-data.ts
+/**
+* 현재 문서의 이름, 계층, 목차만 전송. 다른 문서 본문은 브라우저 탐색 입력에서 제외
+*
+*   - 목차는 h2별 h3 수집, 가름 시작 절에서 목차 묶음 분리
+*   - 첫 h2 앞의 h3은 목차 제외
+*/
+var toNavigationData = (options) => {
+	const entries = options.outline === void 0 ? [] : zip(options.outline.headings.filter((heading) => heading.depth === section_heading_depth.section || heading.depth === section_heading_depth.sub), options.outline.sections);
+	const sections = entries.flatMap(([heading, section], index) => {
+		if (heading.depth !== section_heading_depth.section) return [];
+		return [{
+			heading,
+			part: section.part,
+			subs: takeWhile(entries.slice(index + 1), ([sub]) => sub.depth !== section_heading_depth.section).map(([sub]) => {
+				return { heading: sub };
+			})
+		}];
+	});
+	return {
+		title: options.site.title,
+		groups: toDocGroups({
+			docs: options.docs,
+			navigation: options.site.navigation
+		}).map((group) => toNavigationGroup({
+			group,
+			current: options.current
+		})),
+		outline: sections.flatMap((section, index) => {
+			if (index > 0 && section.part === void 0) return [];
+			return [{
+				part: section.part,
+				sections: [section, ...takeWhile(sections.slice(index + 1), (next) => next.part === void 0)]
+			}];
+		}),
+		home: options.current === void 0,
+		cursorFace: options.site.cursorFace
+	};
+};
+//#endregion
+//#region src/component/widget/sidebar/_function/to-navigation-json.ts
+/**
+* 작성한 이름이 script 종료 태그나 JavaScript 줄 구분자로 해석되지 않는 JSON
+*/
+var toNavigationJson = (data) => {
+	return JSON.stringify(data).replaceAll("<", "\\u003c").replaceAll("\u2028", "\\u2028").replaceAll("\u2029", "\\u2029");
+};
+//#endregion
 //#region src/component/widget/shell/wg-shell.tsx
 var WgShell = (props) => {
 	const navigationData = toNavigationData({
@@ -2350,7 +2417,7 @@ var PgDoc = (props) => {
 		title: props.doc.data.name,
 		current: props.doc.id,
 		outline: props.doc.outline,
-		children: /* @__PURE__ */ jsx(WgProse, { html: props.doc.html })
+		children: /* @__PURE__ */ jsx(WgArticle, { html: props.doc.html })
 	});
 };
 //#endregion
@@ -2361,7 +2428,7 @@ var PgHome = (props) => {
 		docs: props.docs,
 		assets: props.assets,
 		outline: props.home?.outline,
-		children: [props.home !== void 0 && /* @__PURE__ */ jsx(WgProse, { html: props.home.html }), props.home === void 0 && /* @__PURE__ */ jsx(WgProse, { head: {
+		children: [props.home !== void 0 && /* @__PURE__ */ jsx(WgArticle, { html: props.home.html }), props.home === void 0 && /* @__PURE__ */ jsx(WgArticle, { head: {
 			title: props.site.title,
 			lead: "문서 폴더에 README.md를 추가하면 이곳에 홈 화면으로 표시됩니다."
 		} })]
@@ -2449,11 +2516,25 @@ var loadSite = async (params) => {
 		...brand.files
 	]);
 	if (params.stylePaths === void 0) files.set(stylePaths[0], join(params.kitRoot, "dist/cli.css"));
-	const scope = readContentScope({
-		root: params.root,
-		content: params.site.content,
+	if (!existsSync(params.root) || !statSync(params.root).isDirectory()) throw new Error(`content 문서 루트가 없습니다: ${params.root}`);
+	const root = realpathSync(params.root);
+	const publicRoot = join(root, params.site.content.public);
+	const privateRoot = join(root, params.site.content.private);
+	for (const path of [publicRoot, privateRoot]) {
+		if (!existsSync(path)) {
+			if (path === privateRoot) continue;
+			throw new Error(`공개 문서 폴더가 없습니다: ${path}. content/public 구조 또는 content 설정을 확인하세요`);
+		}
+		const actual = realpathSync(path);
+		const location = relative(root, actual);
+		if (!statSync(path).isDirectory() || actual !== path || location === ".." || location.startsWith(`..${sep}`) || isAbsolute(location)) throw new Error(`문서 폴더는 content 내부의 실제 폴더여야 합니다: ${path}`);
+	}
+	const scope = {
+		root,
+		publicRoot,
+		privateRoot,
 		includePrivate: params.includePrivate === true
-	});
+	};
 	const processor = createProcessor({
 		site: params.site,
 		root: scope.root,