for-humanity 0.13.1 → 0.14.1

package/dist/{load-site-B-u5-jv0.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";
@@ -106,6 +106,23 @@ var asset_media_extensions = /* @__PURE__ */ new Set([
 	".zip"
 ]);
 //#endregion
+//#region src/util/file/assert-content-path.ts
+/**
+* 파일 경로와 symlink 대상의 공개 범위 검사
+*/
+var assertContentPath = (params) => {
+	for (const path of [resolve(params.path), ...existsSync(params.path) ? [realpathSync(params.path)] : []]) {
+		const location = relative(params.scope.root, path);
+		const internal = relative(params.scope.privateRoot, path);
+		if (location === ".." || location.startsWith(`..${sep}`) || isAbsolute(location) || location.split(sep).some((part) => [
+			"dist",
+			".git",
+			"node_modules"
+		].includes(part))) throw new Error(`문서 범위 밖의 참조: ${params.path}`);
+		if (!params.scope.includePrivate && internal !== ".." && !internal.startsWith(`..${sep}`) && !isAbsolute(internal)) throw new Error(`공개 문서에서 private 자료를 참조할 수 없습니다: ${params.path}`);
+	}
+};
+//#endregion
 //#region src/util/file/to-asset-path.ts
 /**
 * 파일명에 내용 지문 추가. 같은 내용은 같은 URL, 변경한 내용은 새 캐시 키 사용
@@ -137,6 +154,14 @@ var rehypeAssets = (options) => (tree, file) => {
 			return;
 		}
 		const target = resolve(dirname(file.path), path);
+		if (options.scope !== void 0) try {
+			assertContentPath({
+				scope: options.scope,
+				path: target
+			});
+		} catch (error) {
+			file.fail(error instanceof Error ? error.message : String(error), node);
+		}
 		const location = relative(options.root, target);
 		if (location === ".." || location.startsWith(`..${sep}`) || isAbsolute(location)) file.fail(`${copy_error_asset}: 문서 폴더 밖 · ${url}`, node);
 		if (!existsSync(target)) file.fail(`${copy_error_asset}: 파일이 없다 · ${url}`, node);
@@ -152,6 +177,68 @@ var rehypeAssets = (options) => (tree, file) => {
 	});
 };
 //#endregion
+//#region src/util/file/to-content-id.ts
+/**
+* 폴더 이름과 독립적인 공개 URL, 내부 문서의 private 접두사
+*/
+var toContentId = (params) => {
+	if (relative(params.scope.root, params.path).toLowerCase() === "readme.md") return "";
+	for (const [root, prefix] of [[params.scope.publicRoot, ""], [params.scope.privateRoot, "private/"]]) {
+		const location = relative(root, params.path);
+		if (location === ".." || location.startsWith(`..${sep}`) || isAbsolute(location)) continue;
+		const id = location.replace(/\.mdx?$/i, "").split(sep).join("/").toLowerCase();
+		if (prefix === "" && id.split("/")[0] === "private") throw new Error(`private URL은 내부 문서 전용입니다: ${params.path}`);
+		return `${prefix}${id}`;
+	}
+	throw new Error(`공개 또는 내부 문서 폴더에 없는 Markdown 참조: ${params.path}`);
+};
+//#endregion
+//#region src/app/_function/create-processor/_rehype-content-links.ts
+/**
+* 원시 HTML의 내부 참조 차단과 Markdown 링크의 사이트 URL 변환
+*/
+var rehypeContentLinks = (options) => (tree, file) => {
+	const scope = options.scope;
+	if (scope === void 0) return;
+	visit(tree, "element", (node) => {
+		for (const property of [
+			"href",
+			"src",
+			"poster",
+			"data",
+			"srcSet"
+		]) {
+			const value = node.properties[property];
+			if (typeof value !== "string") continue;
+			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 {
+					if (path.startsWith("/")) {
+						const pathname = new URL(path, "https://content.invalid").pathname.toLowerCase();
+						if (!scope.includePrivate && (pathname === "/private" || pathname.startsWith("/private/"))) throw new Error(`공개 문서에서 private URL을 참조할 수 없습니다: ${url}`);
+						continue;
+					}
+					const target = resolve(dirname(file.path), path);
+					assertContentPath({
+						scope,
+						path: target
+					});
+					if (property === "href" && /\.mdx?$/i.test(path)) {
+						const id = toContentId({
+							scope,
+							path: target
+						});
+						node.properties[property] = `${id === "" ? "/" : `/${id}/`}${url.slice(url.split(/[?#]/)[0].length)}`;
+					}
+				} catch (error) {
+					file.fail(error instanceof Error ? error.message : String(error), node);
+				}
+			}
+		}
+	});
+};
+//#endregion
 //#region src/app/_function/create-processor/_rehype-heading-ids.ts
 /**
 * 제목 id와 목차 수집. 같은 제목은 -1, -2 접미사
@@ -174,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
 		}];
 	});
@@ -221,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) {
@@ -259,6 +345,14 @@ var remarkSnippets = (options) => (tree, file) => {
 		if (match === null) return;
 		const [, path = "", region, meta] = match;
 		const target = resolve(dirname(file.path), path);
+		if (options.scope !== void 0) try {
+			assertContentPath({
+				scope: options.scope,
+				path: target
+			});
+		} catch (error) {
+			file.fail(error instanceof Error ? error.message : String(error), node);
+		}
 		const location = relative(options.root, target);
 		if (location === ".." || location.startsWith(`..${sep}`) || isAbsolute(location)) file.fail(`${copy_error_snippet}: 문서 폴더 밖 · ${path}`, node);
 		if (!existsSync(target)) file.fail(`${copy_error_snippet}: 파일이 없다 · ${path}`, node);
@@ -271,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
 		});
@@ -293,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",
@@ -320,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
@@ -332,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 소제목
 */
@@ -356,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 사용
 */
@@ -366,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
@@ -382,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. 중첩 블록까지 문서 순서 수집
 *
@@ -396,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의 가름 메타데이터 수집. 작성한 제목은 그대로 유지
 *
@@ -410,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
 /**
 * 넓은 표의 내부 가로 스크롤 래퍼
 */
@@ -420,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
 /**
 * 부품 본문의 내용 판정. 참조 정의, 주석, 빈 텍스트와 빈 구조 제외
 *
@@ -442,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의 제목, 본문, 속성, 닫힘 계약
 *
@@ -462,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);
@@ -485,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 원문 유지
 *
@@ -513,6 +590,24 @@ var remarkLinks = (options) => (tree, file) => {
 		if (node.type !== "link" && node.type !== "definition") return;
 		const match = /^(?![a-z]+:|\/|#)([^#?]+)(\.mdx?)([?#].*|)$/i.exec(node.url);
 		if (match) {
+			if (options.scope !== void 0) {
+				const target = resolve(dirname(file.path), decodeURIComponent(`${match[1]}${match[2]}`));
+				try {
+					assertContentPath({
+						scope: options.scope,
+						path: target
+					});
+					const id = toContentId({
+						scope: options.scope,
+						path: target
+					});
+					if (!existsSync(target)) file.message(`${copy_warn_broken_link}: ${node.url}`, node);
+					node.url = `${id === "" ? "/" : `/${id}/`}${match[3]}`;
+				} catch (error) {
+					file.fail(error instanceof Error ? error.message : String(error), node);
+				}
+				return;
+			}
 			if (!existsSync(resolve(dirname(file.path), `${match[1]}${match[2]}`))) file.message(`${copy_warn_broken_link}: ${node.url}`, node);
 			const target = posix.join(here, `${match[1]}${match[2]}`).toLowerCase();
 			node.url = target === "readme.md" ? `/${match[3]}` : `/${target.slice(0, -match[2].length)}/${match[3]}`;
@@ -520,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
 *
@@ -532,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,
@@ -544,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
 */
@@ -554,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
 /**
 * 설정 문구의 상태 표지 변환. 괄호 제거. 제목, 링크 제외
 *
@@ -576,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) => {
@@ -586,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 없는 블록 지시문은 작성 오류
 *
@@ -620,28 +715,50 @@ 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();
-	return unified().use(remarkParse).use(remarkFrontmatter, ["yaml"]).use(remarkGfm).use(remarkSnippets, { root: options.root }).use(remarkSmartypants).use(remarkDirective).use(remarkBlocks).use(remarkParts).use(remarkMermaid, {
+	return unified().use(remarkParse).use(remarkFrontmatter, ["yaml"]).use(remarkGfm).use(remarkSnippets, {
+		root: options.root,
+		scope: options.scope
+	}).use(remarkSmartypants).use(remarkDirective).use(remarkBlocks).use(remarkParts).use(remarkMermaid, {
 		assets: options.mermaid,
 		files
-	}).use(remarkStatus, { status: options.site.status }).use(remarkSwatch).use(remarkLinks, { root: options.root }).use(remarkUnknownDirectives).use(remarkReport, { root: options.root }).use(remarkRehype, { allowDangerousHtml: true }).use(rehypeShiki, {
+	}).use(remarkStatus, { status: options.site.status }).use(remarkSwatch).use(remarkLinks, {
+		root: options.root,
+		scope: options.scope
+	}).use(remarkUnknownDirectives).use(remarkReport, { root: options.root }).use(remarkRehype, { allowDangerousHtml: true }).use(rehypeShiki, {
 		theme: createCssVariablesTheme({
 			name: "for-humanity",
 			variablePrefix: "--app-code-"
 		}),
 		transformers: shikiTransformers
-	}).use(rehypeHead).use(rehypeHeadingIds).use(rehypeSections).use(rehypeTables).use(rehypeRaw).use(rehypeAssets, {
+	}).use(rehypeHead).use(rehypeHeadingIds).use(rehypeSections).use(rehypeTables).use(rehypeRaw).use(rehypeContentLinks, { scope: options.scope }).use(rehypeAssets, {
 		root: options.root,
-		files
+		files,
+		scope: options.scope
 	}).use(rehypeStringify, { allowDangerousHtml: true });
 };
 //#endregion
@@ -708,15 +825,23 @@ var docDataSchema = z.object({
 //#endregion
 //#region src/app/_function/read-docs.ts
 /**
-* Markdown 수집과 렌더링. 루트 README는 홈, AGENTS, CLAUDE는 작성 지침으로 분리
+* 공개 범위의 Markdown 수집과 렌더링, 범위 미지정 시 독립 Markdown 처리
 *
-*   - 문서 목록에서 루트 안내 파일, node_modules, dist 제외
+*   - 사이트 실행에서 공개와 내부 문서만 수집, content 루트 안내 파일 제외
 *   - 머리말, 문서 식별자 중복, 플러그인 오류 시 실패
 */
 var readDocs = async (options) => {
-	const paths = (await readdir(options.root, { recursive: true })).filter((path) => /\.mdx?$/i.test(path) && !/^(readme|agents|claude)\.md$/i.test(path) && !path.split(sep).includes("node_modules") && !path.startsWith(`dist${sep}`));
+	const roots = options.scope === void 0 ? [options.root] : [options.scope.publicRoot, ...options.scope.includePrivate && existsSync(options.scope.privateRoot) ? [options.scope.privateRoot] : []];
+	const paths = (await Promise.all(roots.map(async (root) => (await readdir(root, { recursive: true })).map((path) => relative(options.root, join(root, path)))))).flat().filter((path) => /\.mdx?$/i.test(path) && !/^(readme|agents|claude)\.md$/i.test(path) && !path.split(sep).includes("node_modules") && !path.startsWith(`dist${sep}`));
 	const docs = await Promise.all(paths.map(async (path) => {
-		const id = path.replace(/\.mdx?$/i, "").split(sep).join("/").toLowerCase();
+		if (options.scope !== void 0) assertContentPath({
+			scope: options.scope,
+			path: join(options.root, path)
+		});
+		const id = options.scope === void 0 ? path.replace(/\.mdx?$/i, "").split(sep).join("/").toLowerCase() : toContentId({
+			scope: options.scope,
+			path: join(options.root, path)
+		});
 		const segments = id.split("/");
 		if (segments.some((segment) => segment === "" || segment === "." || segment === ".." || segment === "index.html") || /[#?%*:\\]/.test(id) || /[\p{Cc}]/u.test(id) || options.reserved?.includes(segments[0]) === true || segments[0] === "_fh" || segments[0] === "/favicon.svg".slice(1)) throw new Error(`${copy_error_doc_id}: ${path}`);
 		const source = await readFile(join(options.root, path), "utf8");
@@ -728,9 +853,14 @@ var readDocs = async (options) => {
 		const frontmatter = tree.children[0];
 		const parsed = docDataSchema.safeParse(frontmatter?.type === "yaml" ? parse(frontmatter.value) : {});
 		if (!parsed.success) throw new Error(`${copy_error_frontmatter}: ${path}: ${parsed.error.issues.map((issue) => `${issue.path.join(".")} ${issue.message}`).join(", ")}`);
+		const parentPath = parsed.data.parent !== void 0 && /^\.\.?\//.test(parsed.data.parent) ? resolve(dirname(file.path), parsed.data.parent) : void 0;
+		const parent = parsed.data.parent !== void 0 && parentPath !== void 0 ? posix.join(posix.dirname(id), parsed.data.parent) : parsed.data.parent;
 		const data = {
 			...parsed.data,
-			parent: parsed.data.parent !== void 0 && /^\.\.?\//.test(parsed.data.parent) ? posix.join(posix.dirname(id), parsed.data.parent) : parsed.data.parent
+			parent: options.scope !== void 0 && parentPath !== void 0 ? toContentId({
+				scope: options.scope,
+				path: parentPath
+			}) : parent
 		};
 		const fh = {
 			frontmatter: data,
@@ -783,6 +913,10 @@ var readHome = async (options) => {
 	if (paths.length > 1) throw new Error(`${copy_error_home_clash}: ${paths.join(", ")}`);
 	if (paths.length === 0) return;
 	const path = join(options.root, paths[0]);
+	if (options.scope !== void 0) assertContentPath({
+		scope: options.scope,
+		path
+	});
 	const fh = {
 		headings: [],
 		sections: []
@@ -874,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
-/**
-* 검증된 부모 관계로 문서 가지를 재귀 구성. 형제 순서와 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
+//#region src/component/widget/article/_constant/heading-highlight.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
 /**
@@ -1256,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`;
@@ -1268,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]")];
@@ -1297,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 });
@@ -1371,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;
@@ -1384,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의 폭 조건과 일치
 */
@@ -1394,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
@@ -1491,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(() => {
@@ -1515,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();
 	/**
 	* 연결마다 구독 설치, 초기 위치 갱신은 본문 파싱 이후 실행
@@ -1546,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,
@@ -1639,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";
@@ -1670,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 = () => {
@@ -1790,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();
@@ -1836,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) {
@@ -1857,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",
@@ -1885,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",
@@ -1944,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 })
 					})
 				})
 			})]
@@ -1965,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);
@@ -1986,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;
 	};
 	/**
@@ -2004,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 });
@@ -2015,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 변경 시 접힌 대상을 공개하고 네이티브 스크롤, 강조 적용
@@ -2030,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";
 	};
 	/**
 	* 셸은 본문 앞에서 마운트. 본문 파싱 이후에만 초기 접힘 대상 조회
@@ -2062,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
@@ -2095,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
 			})
@@ -2106,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({
@@ -2186,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
@@ -2197,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를 추가하면 이곳에 홈 화면으로 표시됩니다."
 		} })]
@@ -2285,18 +2516,40 @@ var loadSite = async (params) => {
 		...brand.files
 	]);
 	if (params.stylePaths === void 0) files.set(stylePaths[0], join(params.kitRoot, "dist/cli.css"));
+	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: params.root,
+		root: scope.root,
 		files,
-		mermaid: loadMermaidAssets(params.kitRoot)
+		mermaid: loadMermaidAssets(params.kitRoot),
+		scope
 	});
 	const [docs, home] = await Promise.all([readDocs({
-		root: params.root,
+		root: scope.root,
+		scope,
 		processor,
 		reserved: params.site.url === void 0 ? void 0 : crawling_reserved_roots
 	}), readHome({
-		root: params.root,
+		root: scope.root,
+		scope,
 		processor
 	})]);
 	const store = {