for-humanity 0.13.0 → 0.13.1

package/dist/{load-site-CbpLEhwu.js → load-site-B-u5-jv0.js}

@@ -1,4 +1,4 @@
-import { S as copy_nav_toc_label, T as copy_warn_unknown_status, _ as copy_home_missing, 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 { 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 groupPathSchema } from "./group-path-XAThmzvC.js";
 import { t as toChangeQueue } from "./to-change-queue-DbEnZGNK.js";
@@ -21,10 +21,12 @@ 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 { 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";
 import { findAndReplace } from "mdast-util-find-and-replace";
+import { isEqual } from "es-toolkit/predicate";
 import { VFile } from "vfile";
 import { parse } from "yaml";
 import { Hono } from "hono";
@@ -33,7 +35,6 @@ import { ssgParams } from "hono/ssg";
 import clsx from "clsx";
 import { jsx, jsxs } from "hono/jsx/jsx-runtime";
 import { createHead, escapeHtml } from "unhead/server";
-import { takeWhile } from "es-toolkit/array";
 import { Fragment, useEffect, useLayoutEffect, useRef, useState } from "hono/jsx";
 import { flushSync } from "hono/jsx/dom";
 //#region src/app/_constant/crawling.ts
@@ -212,11 +213,12 @@ var snippet_language_by_extension = {
 	".yml": "yaml"
 };
 //#endregion
-//#region src/app/_function/create-processor/_remark-snippets.ts
+//#region src/app/_function/create-processor/_to-snippet-body.ts
 /**
 * region 지정 시 해당 범위만 추출, 미지정 시 전체 사용
 *
 *   - region 경계 줄과 공통 들여쓰기 제거
+*   - 빈 region은 빈 문자열, 없는 region은 undefined 반환
 */
 var toSnippetBody = (source, region) => {
 	const lines = source.replace(/\r\n/g, "\n").split("\n");
@@ -235,12 +237,14 @@ var toSnippetBody = (source, region) => {
 		if (inside) kept.push(line);
 	}
 	if (!found) return;
-	while (kept.length > 0 && kept[0]?.trim() === "") kept.shift();
-	while (kept.length > 0 && kept.at(-1)?.trim() === "") kept.pop();
-	const indents = kept.filter((line) => line.trim() !== "").map((line) => line.length - line.trimStart().length);
-	const indent = indents.length === 0 ? 0 : Math.min(...indents);
-	return kept.map((line) => line.slice(Math.min(indent, line.length - line.trimStart().length))).join("\n");
+	const content = dropRightWhile(dropWhile(kept, (line) => line.trim() === ""), (line) => line.trim() === "");
+	const leastIndentedLine = minBy(content.filter((line) => line.trim() !== ""), (line) => line.length - line.trimStart().length);
+	if (leastIndentedLine === void 0) return "";
+	const indent = leastIndentedLine.length - leastIndentedLine.trimStart().length;
+	return content.map((line) => line.slice(Math.min(indent, line.length - line.trimStart().length))).join("\n");
 };
+//#endregion
+//#region src/app/_function/create-processor/_remark-snippets.ts
 /**
 * 문서 상대 경로의 코드 스니펫 삽입
 *
@@ -286,49 +290,43 @@ var shikiTransformers = [
 	transformerNotationWordHighlight({ matchAlgorithm: "v3" }),
 	transformerMetaHighlight(),
 	{
-		name: "for-humanity:line-numbers",
-		pre(node) {
-			const meta = this.options.meta?.__raw;
-			if (typeof meta === "string" && /\bline-numbers\b/.test(meta)) this.addClassToHast(node, "wg_prose__lineNumbers");
-		}
-	},
-	{
-		name: "for-humanity:code-tone",
-		pre(node) {
-			const meta = this.options.meta?.__raw;
-			if (typeof meta !== "string") return;
-			for (const word of ["bad", "good"]) if (new RegExp(`\\b${word}\\b`).test(meta)) this.addClassToHast(node, `wg_prose__code--${word}`);
-		}
-	},
-	{
-		name: "for-humanity:code-title",
+		name: "for-humanity:code-metadata",
 		root(root) {
-			const meta = this.options.meta?.__raw;
-			const title = typeof meta === "string" ? /\[([^\]]+)\]/.exec(meta)?.[1] : void 0;
+			this.pre.properties.style = void 0;
+			this.addClassToHast(this.pre, "wg_prose__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");
+			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");
+			const title = /\[([^\]]+)\]/.exec(this.options.meta.__raw)?.[1];
 			if (title === void 0) return;
-			const tones = typeof meta === "string" ? ["bad", "good"].filter((word) => new RegExp(`\\b${word}\\b`).test(meta)) : [];
-			const caption = {
+			root.children = [{
 				type: "element",
-				tagName: "figcaption",
-				properties: { className: ["wg_prose__codeFileTitle"] },
+				tagName: "figure",
+				properties: { className: ["wg_prose__codeFile"] },
 				children: [{
-					type: "text",
-					value: title
-				}, {
 					type: "element",
-					tagName: "span",
-					properties: { className: ["wg_prose__codeFileLang"] },
+					tagName: "figcaption",
+					properties: { className: [
+						"wg_prose__codeFileTitle",
+						...isBad ? ["wg_prose__codeFileTitle--bad"] : [],
+						...isGood ? ["wg_prose__codeFileTitle--good"] : []
+					] },
 					children: [{
 						type: "text",
-						value: this.options.lang
+						value: title
+					}, {
+						type: "element",
+						tagName: "span",
+						properties: { className: ["wg_prose__codeFileLang"] },
+						children: [{
+							type: "text",
+							value: this.options.lang
+						}]
 					}]
-				}]
-			};
-			root.children = [{
-				type: "element",
-				tagName: "figure",
-				properties: { className: ["wg_prose__codeFile", ...tones.map((tone) => `wg_prose__codeFile--${tone}`)] },
-				children: [caption, ...root.children.filter((child) => child.type !== "doctype")]
+				}, ...root.children.filter((child) => child.type !== "doctype")]
 			}];
 		}
 	}
@@ -363,25 +361,25 @@ var section_heading_depth = {
 * name 제목과 첫 절 앞 본문의 공통 머리. README는 원문의 h1 사용
 */
 var rehypeHead = () => (tree, file) => {
-	const frontmatter = file.data.fh?.frontmatter;
 	const firstSection = tree.children.findIndex((node) => node.type === "element" && node.tagName === `h${section_heading_depth.section}`);
 	const leadEnd = firstSection === -1 ? tree.children.length : firstSection;
-	if (frontmatter === void 0 && leadEnd === 0) return;
-	tree.children = [{
+	const head = {
 		type: "element",
 		tagName: "header",
 		properties: { className: ["wg_prose__head"] },
-		children: [...tree.children.slice(0, leadEnd).filter((node) => node.type !== "doctype")]
-	}, ...tree.children.slice(leadEnd)];
-	if (frontmatter !== void 0 && tree.children[0].type === "element") tree.children[0].children.unshift({
+		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: {},
+		properties: { className: ["wg_prose__title"] },
 		children: [{
 			type: "text",
-			value: frontmatter.name
+			value: file.data.fh.frontmatter.name
 		}]
 	});
+	else if (leadEnd === 0) return;
+	tree.children = [head, ...tree.children.slice(leadEnd)];
 };
 //#endregion
 //#region src/component/widget/prose/_function/rehype-sections/_to-section-headings.ts
@@ -407,7 +405,9 @@ var toSectionHeadings = (node) => {
 */
 var rehypeSections = () => (tree, file) => {
 	if (file.data.fh === void 0) return;
-	file.data.fh.sections = toSectionHeadings(tree).map((heading) => ({ part: typeof heading.properties.dataPart === "string" ? heading.properties.dataPart : void 0 }));
+	file.data.fh.sections = toSectionHeadings(tree).map((heading) => {
+		return { part: typeof heading.properties.dataPart === "string" ? heading.properties.dataPart : void 0 };
+	});
 };
 //#endregion
 //#region src/component/widget/prose/_function/rehype-tables.ts
@@ -626,12 +626,13 @@ var remarkUnknownDirectives = () => (tree, file) => {
 *
 *   - 코드와 문서 머리 생성 후 제목 ID와 가름 수집
 *   - 플러그인 HTML 조각은 마지막 rehype-raw에서 해석
-*   - Shiki inline style: token.css의 --app-code-* 참조
+*   - 코드 상자의 색상은 prose 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, {
 		assets: options.mermaid,
-		files: options.files ?? /* @__PURE__ */ new Map()
+		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, {
 		theme: createCssVariablesTheme({
 			name: "for-humanity",
@@ -640,7 +641,7 @@ var createProcessor = (options) => {
 		transformers: shikiTransformers
 	}).use(rehypeHead).use(rehypeHeadingIds).use(rehypeSections).use(rehypeTables).use(rehypeRaw).use(rehypeAssets, {
 		root: options.root,
-		files: options.files ?? /* @__PURE__ */ new Map()
+		files
 	}).use(rehypeStringify, { allowDangerousHtml: true });
 };
 //#endregion
@@ -759,7 +760,7 @@ var readDocs = async (options) => {
 			const parent = docsById.get(parentId);
 			if (parent === void 0) throw new Error(`${copy_error_doc_parent_missing}: ${doc.id} → ${parentId}`);
 			if (ancestors.has(parent.id)) throw new Error(`${copy_error_doc_parent_cycle}: ${[...ancestors, parent.id].join(" → ")}`);
-			if (JSON.stringify(parent.data.group) !== JSON.stringify(doc.data.group)) throw new Error(`${copy_error_doc_parent_group}: ${doc.id} → ${parent.id}`);
+			if (!isEqual(parent.data.group, doc.data.group)) throw new Error(`${copy_error_doc_parent_group}: ${doc.id} → ${parent.id}`);
 			ancestors.add(parent.id);
 			parentId = parent.data.parent;
 		}
@@ -808,11 +809,13 @@ var readHome = async (options) => {
 var toCrawlingApp = (params) => {
 	const app = new Hono();
 	app.get(crawling_robots_path, (c) => c.text(`User-agent: *\nAllow: /\n\nSitemap: ${params.url}${crawling_sitemap_path}\n`));
-	app.get(crawling_sitemap_path, (_c) => new Response(html`<?xml version="1.0" encoding="UTF-8"?>
+	app.get(crawling_sitemap_path, (_c) => {
+		return new Response(html`<?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url><loc>${params.url}/</loc></url>
 ${params.store.docs.map((doc) => html`<url><loc>${params.url}/${doc.id.split("/").map(encodeURIComponent).join("/")}/</loc></url>`)}
-</urlset>`.toString(), { headers: { "Content-Type": "application/xml; charset=utf-8" } }));
+</urlset>`.toString(), { headers: { "Content-Type": "application/xml; charset=utf-8" } });
+	});
 	return app;
 };
 //#endregion
@@ -863,6 +866,14 @@ var toHttpApp = (options) => {
 	return app;
 };
 //#endregion
+//#region src/app/_function/to-page-app/_to-html.ts
+/**
+* Hono JSX 페이지의 HTML 문서 선언, 서버와 정적 출력의 공통 직렬화
+*/
+var toHtml = (page) => {
+	return html`<!DOCTYPE html>${page}`;
+};
+//#endregion
 //#region src/component/widget/prose/wg-prose.tsx
 var WgProse = (props) => {
 	if (props.html !== void 0) return /* @__PURE__ */ jsx("article", {
@@ -873,7 +884,13 @@ var WgProse = (props) => {
 		className: clsx("wg_prose__root"),
 		children: props.head !== void 0 && /* @__PURE__ */ jsxs("header", {
 			className: clsx("wg_prose__head"),
-			children: [/* @__PURE__ */ jsx("h1", { children: props.head.title }), props.head.lead !== void 0 && /* @__PURE__ */ jsx("p", { children: props.head.lead })]
+			children: [/* @__PURE__ */ jsx("h1", {
+				className: clsx("wg_prose__title"),
+				children: props.head.title
+			}), props.head.lead !== void 0 && /* @__PURE__ */ jsx("p", {
+				className: clsx("wg_prose__lead"),
+				children: props.head.lead
+			})]
 		})
 	});
 };
@@ -931,10 +948,13 @@ var toDocGroupBranches = (options) => {
 /**
 * 메타데이터 경로로 읽는 순서를 가진 문서 계층 구성
 *
-*   - navigation의 첫 지정을 조상에도 적용. 미지정 형제 묶음은 이름순
+*   - 같은 조상의 중복 지정은 최초 순서 유지
+*   - 미지정 형제 묶음은 이름순
 */
 var toDocGroups = (options) => {
-	const positions = new Map(options.navigation.flatMap((path, index) => path.map((_name, depth) => [JSON.stringify(path.slice(0, depth + 1)), index])).toReversed());
+	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,
@@ -992,15 +1012,23 @@ var toTocGroups = (outline) => {
 		heading,
 		section: outline.sections[index]
 	}));
-	const sections = entries.flatMap((entry, index) => entry.heading.depth === section_heading_depth.section ? [{
-		heading: entry.heading,
-		part: entry.section.part,
-		subs: takeWhile(entries.slice(index + 1), (sub) => sub.heading.depth !== section_heading_depth.section).map((sub) => ({ heading: sub.heading }))
-	}] : []);
-	return sections.flatMap((section, index) => index === 0 || section.part !== void 0 ? [{
-		part: section.part,
-		sections: [section, ...takeWhile(sections.slice(index + 1), (next) => next.part === void 0)]
-	}] : []);
+	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
@@ -1366,30 +1394,6 @@ var navigation_mobile_query = "(width < 1024px)";
 */
 var navigation_wide_query = "(width >= 1360px)";
 //#endregion
-//#region src/component/widget/navigation/_function/restore-navigation-scroll.ts
-/**
-* 탐색 진입점에서 첫 paint 전 복원. 기존 배치별 저장 자료도 한 번 수용
-*/
-var restoreNavigationScroll = (options) => {
-	const navigation = document.querySelector("[data-navigation]");
-	const documents = document.querySelector("[data-navigation-scroll=\"documents\"]");
-	const outline = document.querySelector("[data-navigation-scroll=\"outline\"]");
-	if (!navigation || !documents || !outline) return;
-	navigation.dataset.navigationLayout = options.layout;
-	try {
-		const value = sessionStorage.getItem(options.key);
-		const stored = value === null ? void 0 : JSON.parse(value);
-		const state = typeof stored === "object" && stored !== null && "version" in stored && stored.version === options.version && "state" in stored ? options.toState(stored.state) : { positions: {} };
-		const legacy = sessionStorage.getItem(`${options.key}:${options.layout === "drawer" ? "drawer" : "desktop"}`);
-		const previous = state.positions[options.layout] === void 0 && legacy !== null ? options.toState({ positions: { [options.layout]: JSON.parse(legacy) } }).positions[options.layout] : void 0;
-		const position = state.positions[options.layout] ?? previous;
-		const signature = [...navigation.querySelectorAll(".wg_navigationNav__root a[href]")].map((link) => `${link.pathname}:${link.textContent}`).join("\n");
-		if (position === void 0 || position.navigation !== signature) return;
-		documents.scrollTop = position.documents;
-		if (position.pathname === location.pathname) outline.scrollTop = position.outline;
-	} catch {}
-};
-//#endregion
 //#region src/component/widget/navigation/_wg-navigation-nav-list.tsx
 var WgNavigationNavList = (props) => {
 	const entries = [...props.group.docs.map((doc) => ({
@@ -1404,24 +1408,26 @@ var WgNavigationNavList = (props) => {
 	return /* @__PURE__ */ jsx("ul", {
 		className: clsx("wg_navigationNavList__root"),
 		"aria-label": props.group.name,
-		children: entries.map((entry) => /* @__PURE__ */ jsxs("li", {
-			className: clsx("wg_navigationNavList__item"),
-			children: [entry.kind === "document" && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("a", {
-				className: clsx("wg_navigationNavList__link", { "wg_navigationNavList__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: {
-				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"),
-				children: entry.group.name
-			}), /* @__PURE__ */ jsx(WgNavigationNavList, { group: entry.group })] })]
-		}, entry.key))
+		children: entries.map((entry) => {
+			return /* @__PURE__ */ jsxs("li", {
+				className: clsx("wg_navigationNavList__item"),
+				children: [entry.kind === "document" && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("a", {
+					className: clsx("wg_navigationNavList__link", { "wg_navigationNavList__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: {
+					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"),
+					children: entry.group.name
+				}), /* @__PURE__ */ jsx(WgNavigationNavList, { group: entry.group })] })]
+			}, entry.key);
+		})
 	});
 };
 //#endregion
@@ -1432,14 +1438,16 @@ var WgNavigationNav = (props) => {
 		"aria-label": copy_nav_aria_label,
 		children: /* @__PURE__ */ jsx("div", {
 			className: clsx("wg_navigationNav__docs"),
-			children: props.groups.map((group) => /* @__PURE__ */ jsxs("section", {
-				className: clsx("wg_navigationNav__docGroup"),
-				"aria-label": group.name,
-				children: [/* @__PURE__ */ jsx("div", {
-					className: clsx("wg_navigationNav__group"),
-					children: group.name
-				}), /* @__PURE__ */ jsx(WgNavigationNavList, { group })]
-			}, JSON.stringify(group.path)))
+			children: props.groups.map((group) => {
+				return /* @__PURE__ */ jsxs("section", {
+					className: clsx("wg_navigationNav__docGroup"),
+					"aria-label": group.name,
+					children: [/* @__PURE__ */ jsx("div", {
+						className: clsx("wg_navigationNav__group"),
+						children: group.name
+					}), /* @__PURE__ */ jsx(WgNavigationNavList, { group })]
+				}, JSON.stringify(group.path));
+			})
 		})
 	});
 };
@@ -1579,72 +1587,46 @@ var WgNavigationToc = (props) => {
 		children: [/* @__PURE__ */ jsx("div", {
 			className: clsx("wg_navigationToc__label"),
 			children: copy_nav_toc_label
-		}), props.groups.map((group) => /* @__PURE__ */ jsxs("div", {
-			className: clsx("wg_navigationToc__groupSection", { "wg_navigationToc__groupSection--named": group.part !== void 0 }),
-			children: [group.part !== void 0 && /* @__PURE__ */ jsx("div", {
-				className: clsx("wg_navigationToc__group"),
-				children: group.part
-			}), /* @__PURE__ */ jsx("ul", {
-				className: clsx("wg_navigationToc__list"),
-				children: group.sections.map((section) => /* @__PURE__ */ jsxs("li", {
-					className: clsx("wg_navigationToc__item"),
-					children: [/* @__PURE__ */ jsx("a", {
-						className: clsx("wg_navigationToc__link", { "wg_navigationToc__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"),
-						children: section.subs.map((sub) => /* @__PURE__ */ jsx("li", {
-							className: clsx("wg_navigationToc__subItem"),
-							children: /* @__PURE__ */ jsx("a", {
-								className: clsx("wg_navigationToc__subLink", { "wg_navigationToc__subLink--active": sub.heading.slug === currentSlug }),
-								href: `#${sub.heading.slug}`,
-								"data-toc-sub-link": "",
-								"aria-current": sub.heading.slug === currentSlug ? "location" : void 0,
-								children: sub.heading.text
-							})
-						}, sub.heading.slug))
-					})]
-				}, section.heading.slug))
-			})]
-		}, group.sections[0].heading.slug))]
+		}), props.groups.map((group) => {
+			return /* @__PURE__ */ jsxs("div", {
+				className: clsx("wg_navigationToc__groupSection", { "wg_navigationToc__groupSection--named": group.part !== void 0 }),
+				children: [group.part !== void 0 && /* @__PURE__ */ jsx("div", {
+					className: clsx("wg_navigationToc__group"),
+					children: group.part
+				}), /* @__PURE__ */ jsx("ul", {
+					className: clsx("wg_navigationToc__list"),
+					children: group.sections.map((section) => {
+						return /* @__PURE__ */ jsxs("li", {
+							className: clsx("wg_navigationToc__item"),
+							children: [/* @__PURE__ */ jsx("a", {
+								className: clsx("wg_navigationToc__link", { "wg_navigationToc__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"),
+								children: section.subs.map((sub) => {
+									return /* @__PURE__ */ jsx("li", {
+										className: clsx("wg_navigationToc__subItem"),
+										children: /* @__PURE__ */ jsx("a", {
+											className: clsx("wg_navigationToc__subLink", { "wg_navigationToc__subLink--active": sub.heading.slug === currentSlug }),
+											href: `#${sub.heading.slug}`,
+											"data-toc-sub-link": "",
+											"aria-current": sub.heading.slug === currentSlug ? "location" : void 0,
+											children: sub.heading.text
+										})
+									}, sub.heading.slug);
+								})
+							})]
+						}, section.heading.slug);
+					})
+				})]
+			}, group.sections[0].heading.slug);
+		})]
 	});
 };
 //#endregion
-//#region src/store/navigation/navigation-storage.ts
-/**
-* 같은 탭에서 문서 이동 후 탐색 위치 복원. 데스크톱과 드로어는 별도 저장
-*/
-var navigation_scroll_storage_key = "for-humanity:navigation-scroll";
-//#endregion
-//#region src/store/navigation/to-navigation-scroll-state.ts
-/**
-* 알 수 없는 저장 형태, 음수, 무한 좌표 제외. 초기 HTML과 Zustand에 같은 검증 적용
-*/
-var toNavigationScrollState = (value) => {
-	/**
-	* 한 배치의 완전한 좌표만 복원 대상으로 수용
-	*/
-	const toPosition = (position) => {
-		if (typeof position !== "object" || position === null || !("navigation" in position) || typeof position.navigation !== "string" || !("pathname" in position) || typeof position.pathname !== "string" || !("documents" in position) || typeof position.documents !== "number" || !Number.isFinite(position.documents) || position.documents < 0 || !("outline" in position) || typeof position.outline !== "number" || !Number.isFinite(position.outline) || position.outline < 0) return;
-		return {
-			navigation: position.navigation,
-			pathname: position.pathname,
-			documents: position.documents,
-			outline: position.outline
-		};
-	};
-	if (typeof value !== "object" || value === null || !("positions" in value) || typeof value.positions !== "object" || value.positions === null) return { positions: {} };
-	const positions = {
-		wide: toPosition("wide" in value.positions ? value.positions.wide : void 0),
-		desktop: toPosition("desktop" in value.positions ? value.positions.desktop : void 0),
-		drawer: toPosition("drawer" in value.positions ? value.positions.drawer : void 0)
-	};
-	return { positions: Object.fromEntries(Object.entries(positions).filter((entry) => entry[1] !== void 0)) };
-};
-//#endregion
 //#region src/util/dom/reveal-hash-target.ts
 /**
 * 접힌 내용의 hash 대상과 상위 Details 공개
@@ -1678,6 +1660,7 @@ var WgNavigation = (props) => {
 	const layoutRef = useRef(layout);
 	const focusRef = useRef(null);
 	const restorePendingRef = useRef(true);
+	const navigationSignature = JSON.stringify(props.data.groups, (key, value) => key === "active" ? void 0 : value);
 	/**
 	* 저장된 배치와 현재 CSS 조건을 구분. 조건 변경 직후 잘린 좌표를 이전 배치에 저장하지 않음
 	*/
@@ -1699,31 +1682,23 @@ var WgNavigation = (props) => {
 		return layoutRef.current === "drawer" ? drawerDocumentsRef.current : documentsRef.current;
 	};
 	/**
-	* 모든 링크의 URL, 표시명으로 사이트 공통 문서 목록의 동일성 판정
-	*/
-	const getNavigationSignature = () => {
-		const navigation = getNavigationPort();
-		if (navigation === null) return void 0;
-		return [...navigation.querySelectorAll(".wg_navigationNav__root a[href]")].map((link) => `${link.pathname}:${link.textContent}`).join("\n");
-	};
-	/**
 	* 닫기, 이동보다 먼저 실제 좌표 보존. 숨긴 모달과 아직 복원하지 않은 배치는 저장하지 않음
 	*/
 	const saveScroll = () => {
 		const documents = getDocumentsPort();
-		if (props.stores === void 0 || documents === null || outlineRef.current === null || restorePendingRef.current || layoutRef.current !== getNavigationLayout() || layoutRef.current === "drawer" && dialogRef.current?.open !== true) return;
-		const signature = getNavigationSignature();
-		if (signature === void 0) return;
-		const navigationPosition = {
-			navigation: signature,
-			pathname: location.pathname,
-			documents: documents.scrollTop,
-			outline: outlineRef.current.scrollTop
-		};
-		props.stores.scroll.setState((state) => ({ positions: {
-			...state.positions,
-			[layoutRef.current]: navigationPosition
-		} }));
+		const outline = outlineRef.current;
+		if (props.stores === void 0 || documents === null || outline === null || restorePendingRef.current || layoutRef.current !== getNavigationLayout() || layoutRef.current === "drawer" && dialogRef.current?.open !== true) return;
+		props.stores.scroll.setState((state) => {
+			return { positions: {
+				...state.positions,
+				[layoutRef.current]: {
+					navigation: navigationSignature,
+					pathname: location.pathname,
+					documents: documents.scrollTop,
+					outline: outline.scrollTop
+				}
+			} };
+		});
 	};
 	/**
 	* 연결된 영역에서 첫 paint 전 복원. 문서는 페이지 간 공유하고 목차는 같은 경로에서만 재사용
@@ -1731,25 +1706,16 @@ var WgNavigation = (props) => {
 	const restoreScroll = () => {
 		layoutRef.current = getNavigationLayout();
 		const documents = getDocumentsPort();
-		const navigation = getNavigationPort();
-		if (props.stores === void 0 || documents === null || outlineRef.current === null || navigation === null) return;
+		if (props.stores === void 0 || documents === null || outlineRef.current === null) return;
 		if (layoutRef.current === "drawer" && dialogRef.current?.open !== true) return;
-		const signature = getNavigationSignature();
-		if (signature === void 0) return;
 		const position = props.stores.scroll.getState().positions[layoutRef.current];
-		documents.scrollTop = 0;
-		outlineRef.current.scrollTop = 0;
-		if (position === void 0) restoreNavigationScroll({
-			key: navigation_scroll_storage_key,
-			version: 1,
-			layout: layoutRef.current,
-			toState: toNavigationScrollState
-		});
-		else if (position.navigation === signature) {
+		if (position?.navigation === navigationSignature) {
 			documents.scrollTop = position.documents;
-			if (position.pathname === location.pathname) outlineRef.current.scrollTop = position.outline;
+			outlineRef.current.scrollTop = position.pathname === location.pathname ? position.outline : 0;
+		} else {
+			documents.scrollTop = 0;
+			outlineRef.current.scrollTop = 0;
 		}
-		navigation.dataset.navigationLayout = layoutRef.current;
 		restorePendingRef.current = false;
 		saveScroll();
 		documents.dispatchEvent(new Event("scroll"));
@@ -1834,12 +1800,12 @@ var WgNavigation = (props) => {
 		flushSync(() => setLayout(nextLayout));
 	};
 	/**
-	* BFCache 복귀 시 저장 좌표로 동기 렌더 후 복원
+	* BFCache 복귀 시 persist의 최신 저장 좌표를 다시 읽어 복원
 	*/
 	const handlePageShow = (event) => {
 		if (!event.persisted || props.stores === void 0) return;
 		restorePendingRef.current = true;
-		flushSync(() => props.stores?.scroll.persist.rehydrate());
+		props.stores.scroll.persist.rehydrate();
 		handleLayoutChange();
 		restoreScroll();
 	};
@@ -1921,6 +1887,7 @@ var WgNavigation = (props) => {
 				ref: props.stores === void 0 ? void 0 : navigationRef,
 				className: clsx("wg_navigation__navigation"),
 				"data-navigation": "",
+				"data-navigation-layout": layout,
 				children: /* @__PURE__ */ jsx(WgNavigationScroll, {
 					portRef: documentsRef,
 					kind: "documents",
@@ -1983,6 +1950,7 @@ var WgNavigation = (props) => {
 					ref: props.stores === void 0 ? void 0 : drawerNavigationRef,
 					className: clsx("wg_navigation__navigation"),
 					"data-navigation": "",
+					"data-navigation-layout": layout,
 					children: /* @__PURE__ */ jsx(WgNavigationScroll, {
 						portRef: drawerDocumentsRef,
 						kind: "documents",
@@ -2224,25 +2192,19 @@ var PgDoc = (props) => {
 //#endregion
 //#region src/page/home/pg-home.tsx
 var PgHome = (props) => {
-	return /* @__PURE__ */ jsx(WgShell, {
+	return /* @__PURE__ */ jsxs(WgShell, {
 		site: props.site,
 		docs: props.docs,
 		assets: props.assets,
 		outline: props.home?.outline,
-		children: props.home === void 0 ? /* @__PURE__ */ jsx(WgProse, { head: {
+		children: [props.home !== void 0 && /* @__PURE__ */ jsx(WgProse, { html: props.home.html }), props.home === void 0 && /* @__PURE__ */ jsx(WgProse, { head: {
 			title: props.site.title,
-			lead: copy_home_missing
-		} }) : /* @__PURE__ */ jsx(WgProse, { html: props.home.html })
+			lead: "문서 폴더에 README.md를 추가하면 이곳에 홈 화면으로 표시됩니다."
+		} })]
 	});
 };
 //#endregion
-//#region src/app/_function/to-page-app.tsx
-/**
-* Hono JSX 페이지에 HTML 문서 선언 추가. 서버와 정적 출력에서 같은 렌더러 사용
-*/
-var toHtml = (page) => {
-	return html`<!DOCTYPE html>${page}`;
-};
+//#region src/app/_function/to-page-app/to-page-app.tsx
 /**
 * 첫 화면 /. 문서 /:slug{.+}/. 하위 폴더 id 지원
 *
@@ -2278,14 +2240,16 @@ var toPageApp = (options) => {
 var toFontCss = (options) => {
 	const files = /* @__PURE__ */ new Map();
 	return {
-		css: [...readFileSync(options.css, "utf8").matchAll(/@font-face\s*\{[^}]*\}/g)].map((match) => match[0].replace(/font-display:\s*[^;]+;/g, `font-display: ${font_display_strategy};`).replace(/url\(([^)]+)\)/g, (_match, relativeUrl) => {
-			const file = join(dirname(options.css), relativeUrl);
-			const extension = extname(file);
-			const hash = createHash("sha256").update(readFileSync(file)).digest("hex").slice(0, 12);
-			const url = `${options.fontDir}/${basename(file, extension)}.${hash}${extension}`;
-			files.set(url, file);
-			return `url(${url})`;
-		})).join("\n"),
+		css: [...readFileSync(options.css, "utf8").matchAll(/@font-face\s*\{[^}]*\}/g)].map((match) => {
+			return match[0].replace(/font-display:\s*[^;]+;/g, `font-display: ${font_display_strategy};`).replace(/url\(([^)]+)\)/g, (_match, relativeUrl) => {
+				const file = join(dirname(options.css), relativeUrl);
+				const extension = extname(file);
+				const hash = createHash("sha256").update(readFileSync(file)).digest("hex").slice(0, 12);
+				const url = `${options.fontDir}/${basename(file, extension)}.${hash}${extension}`;
+				files.set(url, file);
+				return `url(${url})`;
+			});
+		}).join("\n"),
 		files
 	};
 };