for-humanity 0.12.0 → 0.13.0

package/dist/run-site-command-C80YoNOe.js

@@ -0,0 +1,129 @@
+import { d as copy_error_missing_build, n as copy_error_config } from "./copy-C1uzvEnr.js";
+import { t as logger } from "./logger-Dv1i9xSV.js";
+import { n as site_config_absent, t as siteConfigSchema } from "./site-config-bllORGpm.js";
+import { n as font_cache_control, r as asset_font_dir, t as loadSite } from "./load-site-CbpLEhwu.js";
+import { n as config_file_names, t as toErrorMessage } from "./to-error-message-pF6_7wGK.js";
+import { copyFile, mkdir, rm, writeFile } from "node:fs/promises";
+import { z } from "zod";
+import { existsSync } from "node:fs";
+import { dirname, join, relative, resolve } from "node:path";
+import { toSSG } from "hono/ssg";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { createJiti } from "jiti";
+//#region src/app/_function/read-site-config.ts
+/**
+* 문서 루트의 설정 조회, TypeScript 실행과 스키마 검증
+*
+*   - 중복 파일 거부, 실제 적용되는 설정의 모호성 방지
+*   - Node의 기본 TypeScript 지원 여부와 무관하게 같은 설정 실행
+*/
+var readSiteConfig = async (root) => {
+	const files = config_file_names.map((name) => join(root, name)).filter((file) => existsSync(file));
+	if (files.length > 1) throw new Error(`${copy_error_config}: 설정 파일은 하나만 사용하세요 (${config_file_names.join(", ")})`);
+	const file = files[0];
+	if (file === void 0) return siteConfigSchema.parse(site_config_absent);
+	const input = file.endsWith(".mjs") ? await import(pathToFileURL(file).href) : await createJiti(import.meta.url, {
+		interopDefault: false,
+		tryNative: false
+	}).import(file);
+	const parsed = z.object({ default: siteConfigSchema }).safeParse(input);
+	if (!parsed.success) throw new Error(`${copy_error_config}: ${parsed.error.issues.map((issue) => `${issue.path.join(".")} ${issue.message}`).join(", ")}`);
+	return parsed.data.default;
+};
+//#endregion
+//#region src/entry/preview/to-preview-config.ts
+/**
+* 빌드된 사이트 전용 Vite 설정. 소비 프로젝트의 설정과 환경 파일 자동 로드 제외
+*/
+var toPreviewConfig = (params) => {
+	const outDir = resolve(params.root, "dist");
+	if (!existsSync(join(outDir, "index.html"))) throw new Error(`${copy_error_missing_build}: ${outDir}`);
+	return {
+		configFile: false,
+		envDir: false,
+		root: params.root,
+		publicDir: false,
+		appType: "mpa",
+		build: { outDir },
+		preview: {
+			port: params.port,
+			strictPort: true,
+			host: "localhost"
+		},
+		plugins: [{
+			name: "for-humanity:preview",
+			configurePreviewServer: (server) => {
+				server.middlewares.use((request, response, next) => {
+					if (request.url?.startsWith(`${asset_font_dir}/`)) response.setHeader("Cache-Control", font_cache_control);
+					next();
+				});
+				return () => {
+					server.middlewares.use((request, response, next) => {
+						response.removeHeader("Cache-Control");
+						if (request.url !== void 0 && request.url.split("?")[0] === request.originalUrl?.split("?")[0]) request.url = request.url.replace(/\/?(?=\?|$)/, "/index.html");
+						next();
+					});
+				};
+			}
+		}]
+	};
+};
+//#endregion
+//#region src/entry/cli/_function/run-site-command.ts
+/**
+* 사이트 명령 실행과 실패 시 종료 코드 1
+*/
+var runSiteCommand = async (params) => {
+	try {
+		if (params.args._.length > 1) throw new Error("문서 폴더는 하나만 지정하세요");
+		const kitRoot = fileURLToPath(new URL("../", import.meta.url));
+		const docsRoot = resolve(params.args.dir);
+		const outDir = join(docsRoot, "dist");
+		const siteConfig = await readSiteConfig(docsRoot);
+		if (params.command === "preview") {
+			(await (await import("vite")).preview(toPreviewConfig({
+				root: docsRoot,
+				port: siteConfig.port
+			}))).printUrls();
+			return;
+		}
+		if (params.command === "dev") {
+			await (await import("./start-dev-server-C4_Lu1nZ.js")).startDevServer({
+				root: docsRoot,
+				kitRoot,
+				site: siteConfig,
+				source: false
+			});
+			return;
+		}
+		const snapshot = await loadSite({
+			root: docsRoot,
+			kitRoot,
+			site: siteConfig
+		});
+		await rm(outDir, {
+			recursive: true,
+			force: true
+		});
+		const result = await toSSG(snapshot.pages, {
+			writeFile,
+			mkdir
+		}, { dir: outDir });
+		if (!result.success) throw result.error;
+		const crawling = snapshot.crawling === void 0 ? void 0 : await toSSG(snapshot.crawling, {
+			writeFile,
+			mkdir
+		}, { dir: outDir });
+		if (crawling?.success === false) throw crawling.error;
+		for (const [url, file] of snapshot.files) {
+			await mkdir(dirname(join(outDir, url)), { recursive: true });
+			await copyFile(file, join(outDir, url));
+		}
+		logger.success(`${crawling === void 0 ? result.files.length : result.files.length + crawling.files.length} files, ${snapshot.files.size} assets → ${relative(process.cwd(), outDir)}`);
+	} catch (error) {
+		logger.error(toErrorMessage(error));
+		process.exitCode = 1;
+	}
+};
+//#endregion
+export { runSiteCommand };

package/dist/site-config-bllORGpm.js

@@ -0,0 +1,90 @@
+import { C as copy_site_title_default, f as copy_error_navigation_clash, m as copy_error_site_url } from "./copy-C1uzvEnr.js";
+import { t as groupPathSchema } from "./group-path-XAThmzvC.js";
+import { z } from "zod";
+//#region src/constant/site.ts
+/**
+* 설정 파일 부재 시 입력. 스키마 기본값 적용
+*/
+var site_config_absent = {};
+/**
+* 탐색 순서 생략 시 모든 묶음을 이름순 배치
+*/
+var site_navigation_default = [];
+/**
+* dev, preview 서버 기본 포트
+*/
+var site_port_default = 4321;
+/**
+* 포트 번호 상한. TCP
+*/
+var site_port_max = 65535;
+//#endregion
+//#region src/constant/status.ts
+/**
+* 상태 표지 종류. verified 초록, unverified amber
+*/
+var status_kind = {
+	verified: "verified",
+	unverified: "unverified"
+};
+/**
+* 기본 상태 문구. 확인됨은 뒤의 날짜 포함
+*/
+var status_default_phrases = [{
+	phrase: "확인됨",
+	kind: status_kind.verified,
+	date: true
+}, {
+	phrase: "확인되지 않았다",
+	kind: status_kind.unverified
+}];
+//#endregion
+//#region src/type/site-config.ts
+/**
+* 사이트 설정의 입력 검증과 기본값 적용
+*/
+var siteConfigSchema = z.object({
+	/**
+	* 사이드바 이름과 탭 제목
+	*/
+	title: z.string().default(copy_site_title_default),
+	/**
+	* HTML 설명 메타데이터. 선택
+	*/
+	description: z.string().optional(),
+	/**
+	* 공개 사이트 루트 URL. 지정할 때만 robots.txt와 sitemap.xml 생성
+	*/
+	url: z.url({ protocol: /^https?$/ }).transform((value) => new URL(value)).refine((value) => value.username === "" && value.password === "" && value.pathname === "/" && value.search === "" && value.hash === "", copy_error_site_url).transform((value) => value.origin).optional(),
+	/**
+	* dev, preview 서버 포트. 같은 기계에서 문서 프로젝트 둘을 나란히 띄울 때 한쪽에 지정
+	*/
+	port: z.int().min(1).max(site_port_max).default(site_port_default),
+	/**
+	* 데스크톱 커서 옆 픽셀 얼굴. 기본 꺼짐. favicon 은 설정과 무관
+	*/
+	cursorFace: z.boolean().default(false),
+	/**
+	* 탐색 묶음 경로의 읽는 순서. 미지정 형제 묶음은 뒤에서 이름순
+	*/
+	navigation: z.array(groupPathSchema).refine((groups) => new Set(groups.map((path) => JSON.stringify(path))).size === groups.length, copy_error_navigation_clash).default(site_navigation_default.map((name) => [name])),
+	/**
+	* 본문에서 상태 표지로 표시할 문구
+	*/
+	status: z.array(z.object({
+		/**
+		* 찾을 문구 원문
+		*/
+		phrase: z.string().min(1).refine((phrase) => phrase.trim().length > 0),
+		/**
+		* 상태 표지의 색 종류
+		*/
+		kind: z.enum(status_kind),
+		/**
+		* 문구 뒤의 YYYY-MM-DD 날짜 포함 여부
+		*/
+		date: z.boolean().optional()
+	})).default(status_default_phrases)
+});
+//#endregion
+export { site_config_absent as n, siteConfigSchema as t };

package/dist/site.js

@@ -0,0 +1 @@
+export { t as loadSite } from "./load-site-CbpLEhwu.js";

package/dist/start-dev-server-C4_Lu1nZ.js

@@ -0,0 +1,176 @@
+import { p as copy_error_prefix } from "./copy-C1uzvEnr.js";
+import { t as toChangeQueue } from "./to-change-queue-DbEnZGNK.js";
+import { n as config_file_names, t as toErrorMessage } from "./to-error-message-pF6_7wGK.js";
+import { z } from "zod";
+import { realpathSync } from "node:fs";
+import { extname, isAbsolute, join, relative, sep } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { createServer } from "vite";
+import devServer from "@hono/vite-dev-server";
+import { debounce, escapeRegExp } from "es-toolkit";
+//#region src/entry/dev/_constant/dev.ts
+/**
+* 생성물과 설치 파일의 변경 제외, 재빌드 반복 방지
+*/
+var dev_ignored_paths = [
+	"**/dist/**",
+	"**/node_modules/**",
+	"**/.git/**",
+	"**/.cache/**"
+];
+//#endregion
+//#region src/entry/dev/to-dev-config.ts
+/**
+* 단일 Vite 서버의 Hono 연결과 문서 갱신 설정
+*
+*   - 소비 프로젝트의 Vite 설정과 환경 파일은 자동 실행하지 않음
+*   - 마지막 정상 스냅샷 유지, 준비 중 새 변경과 서버 종료 이후 결과 제외
+*/
+var toDevConfig = (params) => {
+	const root = realpathSync(params.root);
+	const kitRoot = realpathSync(params.kitRoot);
+	let currentSite;
+	let dispose;
+	let prepare;
+	let ready;
+	const viteEnvPath = fileURLToPath(new URL("./dist/client/env.mjs", import.meta.resolve("vite/package.json")));
+	const viteClientPaths = [/^\/@vite\/(client|env)(?:\?|$)/, ...[`/${relative(kitRoot, viteEnvPath)}`, `/@fs/${viteEnvPath.replace(/^\//, "")}`].map((path) => new RegExp(`^${escapeRegExp(path.replaceAll("\\", "/"))}(?:\\?|$)`))];
+	return {
+		configFile: false,
+		envDir: false,
+		root: kitRoot,
+		cacheDir: join(kitRoot, "node_modules/.vite/for-humanity"),
+		publicDir: false,
+		appType: "custom",
+		resolve: { alias: { "@": join(kitRoot, "src") } },
+		oxc: { jsx: { importSource: "hono/jsx" } },
+		optimizeDeps: params.source ? {
+			entries: ["src/entry/browser/browser.tsx"],
+			include: ["hono/jsx/dom/jsx-runtime", "hono/jsx/dom/jsx-dev-runtime"]
+		} : { noDiscovery: true },
+		server: {
+			port: params.site.port,
+			strictPort: true,
+			host: "localhost",
+			fs: {
+				allow: [kitRoot],
+				deny: [
+					".env",
+					".env.*",
+					"*.{crt,pem}",
+					"**/.git/**",
+					"**/*.md",
+					"**/*.mdx",
+					"**/for-humanity.config.*",
+					...params.source ? [`${root.replaceAll("\\", "/")}/**`] : []
+				]
+			}
+		},
+		plugins: [{
+			name: "for-humanity:documents",
+			enforce: "pre",
+			resolveId: function(id, importer, options) {
+				if (!options.ssr && /^hono\/jsx\/jsx-(dev-)?runtime$/.test(id)) return this.resolve(id.replace("hono/jsx/", "hono/jsx/dom/"), importer, { skipSelf: true });
+			},
+			configureServer: (server) => {
+				const state = {
+					generation: 0,
+					closed: false
+				};
+				const refresh = toChangeQueue({
+					run: async () => {
+						if (state.closed) return;
+						const generation = state.generation;
+						const module = params.source ? await server.ssrLoadModule("/src/app/load-site.ts") : await import(pathToFileURL(join(kitRoot, "dist/site.js")).href);
+						const nextSite = await z.custom((value) => typeof value === "function").parse(module.loadSite)({
+							...params,
+							root,
+							kitRoot,
+							browser: params.source ? {
+								kind: "module",
+								path: "/src/entry/browser/browser.tsx"
+							} : void 0,
+							stylePaths: params.source ? z.array(z.string()).parse((await server.ssrLoadModule("/src/entry/dev/_constant/style.ts")).style_paths) : void 0
+						});
+						if (state.closed || generation !== state.generation) return;
+						currentSite = nextSite;
+						if (generation > 0) server.hot.send({ type: "full-reload" });
+					},
+					onError: (error) => server.config.logger.error(`${copy_error_prefix}: ${toErrorMessage(error)}`)
+				});
+				const reload = debounce(refresh, 150);
+				/**
+				* 문서와 소스 변경 시 스냅샷 갱신, 기존 CSS 수정은 Vite HMR 사용
+				*/
+				const handleChange = (event, file) => {
+					const documentPath = relative(root, file);
+					const segments = documentPath.split(sep);
+					const isDocument = documentPath !== ".." && !isAbsolute(documentPath) && !documentPath.startsWith(`..${sep}`) && !segments.some((part) => [
+						"dist",
+						"node_modules",
+						".git",
+						".cache"
+					].includes(part));
+					const extension = extname(file);
+					const isSource = params.source && file.startsWith(`${join(kitRoot, "src")}${sep}`) && ([".ts", ".tsx"].includes(extension) || extension === ".css" && event !== "change");
+					if (ready === void 0 || !isDocument && !isSource || config_file_names.some((name) => documentPath === name)) return;
+					state.generation += 1;
+					reload();
+				};
+				server.watcher.add(root);
+				server.watcher.on("all", handleChange);
+				dispose = () => {
+					state.closed = true;
+					reload.cancel();
+					server.watcher.off("all", handleChange);
+				};
+				prepare = refresh;
+			},
+			closeBundle: () => dispose?.()
+		}, devServer({
+			exclude: params.source ? [
+				...viteClientPaths,
+				/^\/@id\//,
+				/^\/node_modules\/\.vite\//,
+				/^\/@fs\//,
+				/^\/src\/(component|page|style|store|constant|type|util)\//,
+				/^\/src\/entry\/browser\//
+			] : viteClientPaths,
+			ignoreWatching: dev_ignored_paths,
+			handleHotUpdate: (context) => context.file.endsWith(".css") ? void 0 : [],
+			loadModule: async () => {
+				ready ??= prepare?.();
+				await ready;
+				if (currentSite === void 0) throw new Error("문서 준비에 실패했습니다. 위 오류를 수정하면 다시 반영합니다.");
+				const app = currentSite.app;
+				return { fetch: async (request, env) => app.fetch(request, env) };
+			}
+		})]
+	};
+};
+//#endregion
+//#region src/entry/dev/start-dev-server.ts
+/**
+* 개발 서버 시작과 프로세스 종료 시 파일 감시, 통신 정리
+*/
+var startDevServer = async (params) => {
+	const server = await createServer(toDevConfig(params));
+	try {
+		await server.listen();
+		server.printUrls();
+	} catch (error) {
+		await server.close();
+		throw error;
+	}
+	/**
+	* 실행기 종료 신호에서 Vite 자원 해제 후 종료
+	*/
+	const handleExit = async () => {
+		await server.close();
+		process.exit(0);
+	};
+	process.once("SIGINT", handleExit);
+	process.once("SIGTERM", handleExit);
+};
+//#endregion
+export { startDevServer };

package/dist/to-change-queue-DbEnZGNK.js

@@ -0,0 +1,34 @@
+//#region src/util/async/to-change-queue.ts
+/**
+* 변경 요청의 직렬 처리, 실행 중 요청은 다음 1회로 병합
+*
+*   - 활성 실행의 반환 Promise는 대기 요청까지 끝나면 완료, 중첩 요청은 즉시 반환
+*/
+var toChangeQueue = (options) => {
+	const state = {
+		requested: 0,
+		completed: 0,
+		running: false
+	};
+	return async () => {
+		state.requested += 1;
+		if (state.running) return;
+		state.running = true;
+		try {
+			while (state.completed !== state.requested) {
+				const requested = state.requested;
+				try {
+					await options.run();
+				} catch (error) {
+					options.onError(error);
+				} finally {
+					state.completed = requested;
+				}
+			}
+		} finally {
+			state.running = false;
+		}
+	};
+};
+//#endregion
+export { toChangeQueue as t };

package/dist/to-error-message-pF6_7wGK.js

@@ -0,0 +1,16 @@
+//#region src/app/_constant/config.ts
+/**
+* 문서 루트에서 지원하는 설정 파일, 둘 이상 존재하면 오류
+*/
+var config_file_names = ["for-humanity.config.ts", "for-humanity.config.mjs"];
+//#endregion
+//#region src/util/error/to-error-message.ts
+/**
+* CLI, dev 공통 오류 문구. 문법 오류의 파일과 줄 번호 포함
+*/
+var toErrorMessage = (error) => {
+	if (error instanceof Error && "file" in error && typeof error.file === "string" && "line" in error && typeof error.line === "number") return `${error.file}:${error.line}: ${error.message}`;
+	return error instanceof Error ? error.message : String(error);
+};
+//#endregion
+export { config_file_names as n, toErrorMessage as t };

package/dist/type/group-path.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+/**
+ * 탐색 묶음 경로. 기존 단일 이름과 중첩 배열을 한 번만 정규화
+ *
+ *   - 쉼표, 슬래시는 이름 그대로 유지하며 빈 경로, 단계는 거부
+ */
+export declare const groupPathSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>;

package/dist/type/site-config.d.ts

@@ -0,0 +1,57 @@
+import { z } from "zod";
+/**
+ * 사이트 설정의 입력 검증과 기본값 적용
+ */
+export declare const siteConfigSchema: z.ZodObject<{
+    title: z.ZodDefault<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodURL, z.ZodTransform<URL, string>>, z.ZodTransform<string, URL>>>;
+    port: z.ZodDefault<z.ZodInt>;
+    cursorFace: z.ZodDefault<z.ZodBoolean>;
+    navigation: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>>;
+    status: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        phrase: z.ZodString;
+        kind: z.ZodEnum<{
+            readonly verified: "verified";
+            readonly unverified: "unverified";
+        }>;
+        date: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/**
+ * 기본값을 적용한 사이트 설정
+ */
+export type ResolvedSiteConfig = z.infer<typeof siteConfigSchema>;
+/**
+ * 작성자가 지정하는 사이트 설정, 기본값 적용 전 입력
+ */
+export interface SiteConfig {
+    /**
+     * 사이드바 이름과 탭 제목, 생략 시 for humanity
+     */
+    title?: z.input<typeof siteConfigSchema>["title"];
+    /**
+     * 검색 결과에 표시할 사이트 설명
+     */
+    description?: z.input<typeof siteConfigSchema>["description"];
+    /**
+     * 공개 HTTP(S) 루트 주소, 지정 시 robots.txt와 sitemap.xml 생성
+     */
+    url?: z.input<typeof siteConfigSchema>["url"];
+    /**
+     * dev와 preview 포트, 1부터 65535까지 정수, 기본값 4321
+     */
+    port?: z.input<typeof siteConfigSchema>["port"];
+    /**
+     * 데스크톱 커서 얼굴 표시, 기본값 false
+     */
+    cursorFace?: z.input<typeof siteConfigSchema>["cursorFace"];
+    /**
+     * 탐색 묶음의 표시 순서, 문자열 또는 중첩 이름 경로
+     */
+    navigation?: z.input<typeof siteConfigSchema>["navigation"];
+    /**
+     * 상태 표지 목록, 빈 배열 지정 시 상태 표지 미표시
+     */
+    status?: z.input<typeof siteConfigSchema>["status"];
+}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "for-humanity",
-    "version": "0.12.0",
-    "description": "Documents written for humans to read: a docs kit with a sidebar, parts, sections and flowcharts, built on Hono JSX",
+    "version": "0.13.0",
+    "description": "Documents written for humans to read: a docs kit with a sidebar, parts, sections and Mermaid diagrams, built on Hono JSX",
     "keywords": [
         "docs",
         "documentation",
@@ -26,22 +26,25 @@
     },
     "files": [
         "dist",
-        "src",
+        "src/asset",
         "CHANGELOG.md"
     ],
     "engines": {
-        "node": ">=22"
+        "node": ">=22.12.0"
     },
     "scripts": {
-        "build:kit": "node script/build-kit.mjs",
-        "sync:readme": "node util/sync-readme.mjs",
-        "sync:docs": "pnpm sync:readme && node util/sync-changelog.mjs",
-        "dev": "pnpm sync:docs && pnpm build:kit && node dist/cli.js dev templates/document",
+        "build:kit": "vite build --mode node && vite build --mode browser && vite build --mode mermaid && tsc -p tsconfig.package.json",
+        "sync:readme": "tsx util/sync-readme.ts",
+        "sync:docs": "pnpm sync:readme && tsx util/sync-changelog.ts",
+        "dev": "pnpm sync:docs && pnpm build:kit && tsx src/entry/dev/dev.ts",
         "build": "pnpm sync:docs && pnpm build:kit && node dist/cli.js build templates/document",
-        "build:pages": "pnpm build && node util/prepare-pages.mjs",
+        "build:pages": "pnpm build && tsx util/prepare-pages.ts",
         "preview": "node dist/cli.js preview templates/document",
-        "test": "node script/test.mjs",
-        "test:navigation": "pnpm build:kit && node util/navigation/check-navigation.test.mjs",
+        "test": "pnpm build:kit && vitest run",
+        "test:watch": "pnpm build:kit && vitest",
+        "test:browser": "pnpm build:kit && playwright test",
+        "test:navigation": "pnpm build:kit && playwright test navigation",
+        "test:mermaid": "pnpm build:kit && playwright test mermaid",
         "lint": "biome check && stylelint \"src/**/*.css\"",
         "lint:fix": "biome check --write && stylelint \"src/**/*.css\" --fix",
         "typecheck": "tsc --noEmit",
@@ -49,15 +52,17 @@
         "prepack": "pnpm build:kit"
     },
     "dependencies": {
-        "@hono/node-server": "^2.1.3",
+        "@hono/vite-dev-server": "^0.26.1",
         "@shikijs/rehype": "^4.4.3",
         "@shikijs/transformers": "4.4.3",
-        "beautiful-mermaid": "^1.1.3",
+        "citty": "^0.2.2",
         "clsx": "^2.1.1",
+        "consola": "^3.4.2",
         "es-toolkit": "^1.52.0",
         "github-slugger": "^2.0.0",
         "hast-util-to-string": "3.0.1",
         "hono": "^4.13.12",
+        "jiti": "^2.7.0",
         "mdast-util-find-and-replace": "^3.0.2",
         "mdast-util-to-string": "^4.0.0",
         "rehype-raw": "^7.0.0",
@@ -69,24 +74,36 @@
         "remark-rehype": "^11.1.2",
         "remark-smartypants": "^3.0.3",
         "shiki": "4.4.3",
+        "unhead": "^3.4.3",
         "unified": "^11.0.5",
         "unist-util-visit": "^5.1.0",
         "vfile": "^6.0.3",
+        "vite": "^8.3.4",
         "yaml": "^2.9.1",
         "zod": "^4.6.5",
         "zustand": "^5.0.15"
     },
     "devDependencies": {
         "@biomejs/biome": "^2.5.14",
+        "@playwright/test": "1.63.0",
         "@types/hast": "^3.0.5",
         "@types/mdast": "^4.0.4",
         "@types/node": "^26.6.3",
-        "esbuild": "^0.28.2",
         "mdast-util-to-hast": "^13.2.1",
-        "playwright": "^1.63.0",
+        "mermaid": "12.2.0",
         "stylelint": "^17.15.0",
         "stylelint-config-standard": "^40.0.0",
-        "typescript": "^7.0.2"
+        "tsx": "^4.23.15",
+        "typescript": "^7.0.2",
+        "vitest": "^5.0.4"
     },
-    "packageManager": "pnpm@12.9.1+sha512.06b055fff5cd20dc12781de173ced3310ce0951bf2ec620211a16045d5444d5c93a663210764ef29a653a610459ba0368f0e74f84d80c54723cf95aae7bc0d6d"
+    "packageManager": "pnpm@12.9.1+sha512.06b055fff5cd20dc12781de173ced3310ce0951bf2ec620211a16045d5444d5c93a663210764ef29a653a610459ba0368f0e74f84d80c54723cf95aae7bc0d6d",
+    "types": "./dist/type/site-config.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/type/site-config.d.ts",
+            "import": "./dist/config.js"
+        },
+        "./*": "./*"
+    }
 }

package/src/component/widget/cursor-face/_constant/cursor-face.ts

@@ -1,14 +0,0 @@
-/**
- * 얼굴이 클릭 지점과 겹치지 않는 거리 · 화면 가장자리에도 같은 여백 적용
- */
-export const cursor_face_offset_px = 16;
-
-/**
- * 포인터 얼굴의 고정 표시 크기 · 좌표 계산과 SSR에서 같은 값 사용
- */
-export const cursor_face_size_px = 24;
-
-/**
- * 같은 탭의 문서 이동에서 커서 위치를 한 번 이어받는 저장소 키
- */
-export const cursor_face_storage_key = "fh-cursor-face";

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

@@ -1,15 +0,0 @@
-.wg_cursorFace__root {
-    /* 뷰포트 기준 · 본문 흐름과 포인터 입력에 참여하지 않는 장식 */
-    position: fixed;
-    top: 0;
-    left: 0;
-    z-index: var(--app-z-index-popper);
-    visibility: hidden;
-    pointer-events: none;
-    user-select: none;
-    image-rendering: pixelated;
-}
-
-.wg_cursorFace__root--visible {
-    visibility: visible;
-}