for-humanity 0.13.0 → 0.14.0

package/dist/{load-site-CbpLEhwu.js → load-site-CBJGMNfH.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
@@ -105,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, 변경한 내용은 새 캐시 키 사용
@@ -136,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);
@@ -151,6 +177,69 @@ 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;
+			const urls = property === "srcSet" ? value.split(",").map((entry) => entry.trim().split(/\s+/)[0]) : [value];
+			for (const url of urls) {
+				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 접미사
@@ -212,11 +301,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 +325,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
 /**
 * 문서 상대 경로의 코드 스니펫 삽입
 *
@@ -255,6 +347,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);
@@ -286,49 +386,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 +457,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 +501,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
@@ -513,6 +609,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]}`;
@@ -626,21 +740,29 @@ var remarkUnknownDirectives = () => (tree, file) => {
 *
 *   - 코드와 문서 머리 생성 후 제목 ID와 가름 수집
 *   - 플러그인 HTML 조각은 마지막 rehype-raw에서 해석
-*   - Shiki inline style: token.css의 --app-code-* 참조
+*   - 코드 상자의 색상은 prose CSS 소유, Shiki 토큰 색상은 --app-code-* 참조
 */
 var createProcessor = (options) => {
-	return unified().use(remarkParse).use(remarkFrontmatter, ["yaml"]).use(remarkGfm).use(remarkSnippets, { root: options.root }).use(remarkSmartypants).use(remarkDirective).use(remarkBlocks).use(remarkParts).use(remarkMermaid, {
+	const files = options.files ?? /* @__PURE__ */ new Map();
+	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: options.files ?? /* @__PURE__ */ new Map()
-	}).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, {
+		files
+	}).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: options.files ?? /* @__PURE__ */ new Map()
+		files,
+		scope: options.scope
 	}).use(rehypeStringify, { allowDangerousHtml: true });
 };
 //#endregion
@@ -659,6 +781,32 @@ var loadMermaidAssets = (kitRoot) => {
 	};
 };
 //#endregion
+//#region src/app/_function/read-content-scope.ts
+/**
+* 공개 폴더 필수, 내부 폴더 선택, 범위 폴더의 symlink 별칭 금지
+*/
+var readContentScope = (params) => {
+	if (!existsSync(params.root) || !statSync(params.root).isDirectory()) throw new Error(`content 문서 루트가 없습니다: ${params.root}`);
+	const root = realpathSync(params.root);
+	const publicRoot = join(root, params.content.public);
+	const privateRoot = join(root, params.content.private);
+	for (const path of [publicRoot, privateRoot]) {
+		if (!existsSync(path)) {
+			if (path === privateRoot) continue;
+			throw new Error(`공개 문서 폴더가 없습니다: ${path}. content/public 구조 또는 content 설정을 확인하세요`);
+		}
+		const actual = realpathSync(path);
+		const location = relative(root, actual);
+		if (!statSync(path).isDirectory() || actual !== path || location === ".." || location.startsWith(`..${sep}`) || isAbsolute(location)) throw new Error(`문서 폴더는 content 내부의 실제 폴더여야 합니다: ${path}`);
+	}
+	return {
+		root,
+		publicRoot,
+		privateRoot,
+		includePrivate: params.includePrivate
+	};
+};
+//#endregion
 //#region src/constant/doc.ts
 /**
 * 기존 frontmatter type의 호환 값. 모두 같은 Markdown 렌더링
@@ -707,15 +855,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");
@@ -727,9 +883,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,
@@ -759,7 +920,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;
 		}
@@ -782,6 +943,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: []
@@ -808,11 +973,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 +1030,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 +1048,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 +1112,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 +1176,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 +1558,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 +1572,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 +1602,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 +1751,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 +1824,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 +1846,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 +1870,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 +1964,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 +2051,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 +2114,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 +2356,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 +2404,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
 	};
 };
@@ -2321,18 +2449,26 @@ var loadSite = async (params) => {
 		...brand.files
 	]);
 	if (params.stylePaths === void 0) files.set(stylePaths[0], join(params.kitRoot, "dist/cli.css"));
+	const scope = readContentScope({
+		root: params.root,
+		content: params.site.content,
+		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 = {