fix: vitepress-plugin-mermaid 주입 및 빌드 최적화 에러 해결

- `.vitepress/theme/index.ts` 내 수동 '<Mermaid>' 컴포넌트 import 및 `app.component` 전역 등록 코드 제거. (최신 버전의 `vitepress-plugin-mermaid`가 자체적으로 이를 주입하기 때문에 중복 발생 시 모듈을 찾을 수 없다는 리졸빙 에러 이슈 수정)
- `debug` 패키지를 개발 환경 의존성(devDependencies)에 수동으로 추가. `vitepress-plugin-mermaid` 플러그인이 Vite의 `optimizeDeps.include`에 `debug` 패키지를 강제로 포함시키지만, 최신(v11+)의 mermaid 패키지는 이를 더 이상 제공하지 않음. 이로 인해 Vite의 종속성 사전 최적화(esbuild pre-bundling) 과정이 실패하고 VitePress 코어 앱 데이터 주입 과정이 꼬이면서 발생하는 'vitepress data not properly injected in app' 에러 해결.

Author: toothlessdev

.vitepress/theme/index.ts

@@ -5,7 +5,6 @@ import DefaultTheme from "vitepress/theme";
 import Giscus from "@giscus/vue";
 import PostCardList from "@/components/PostCardList/PostCardList.vue";
 import PostLayout from "@/components/PostLayout/PostLayout.vue";
-import { MermaidPlugin } from "vitepress-plugin-mermaid";
 import "./style.css";
 
 export default {
@@ -14,6 +13,5 @@ export default {
     enhanceApp({ app, router, siteData }) {
         app.component("PostCardList", PostCardList);
         app.component("Giscus", Giscus);
-        app.use(MermaidPlugin);
     },
 } satisfies Theme;

package.json

@@ -7,6 +7,7 @@
     },
     "devDependencies": {
         "@types/node": "^24.5.2",
+        "debug": "^4.4.3",
         "fast-glob": "^3.3.3",
         "glob": "^11.0.3",
         "gray-matter": "^4.0.3",

yarn.lock

@@ -1703,6 +1703,13 @@ dayjs@^1.11.19:
   resolved "https://registry.yarnpkg.com/dayjs/-/dayjs-1.11.20.tgz#88d919fd639dc991415da5f4cb6f1b6650811938"
   integrity sha512-YbwwqR/uYpeoP4pu043q+LTDLFBLApUP6VxRihdfNTqu4ubqMlGDLd6ErXhEgsyvY0K6nCs7nggYumAN+9uEuQ==
 
+debug@^4.4.3:
+  version "4.4.3"
+  resolved "https://registry.yarnpkg.com/debug/-/debug-4.4.3.tgz#c6ae432d9bd9662582fce08709b038c58e9e3d6a"
+  integrity sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==
+  dependencies:
+    ms "^2.1.3"
+
 delaunator@5:
   version "5.1.0"
   resolved "https://registry.yarnpkg.com/delaunator/-/delaunator-5.1.0.tgz#d13271fbf3aff6753f9ea6e235557f20901046ea"
@@ -2223,6 +2230,11 @@ mlly@^1.7.4, mlly@^1.8.0:
     pkg-types "^1.3.1"
     ufo "^1.6.3"
 
+ms@^2.1.3:
+  version "2.1.3"
+  resolved "https://registry.yarnpkg.com/ms/-/ms-2.1.3.tgz#574c8138ce1d2b5861f0b44579dbadd60c6615b2"
+  integrity sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==
+
 nanoid@^3.3.11:
   version "3.3.11"
   resolved "https://registry.yarnpkg.com/nanoid/-/nanoid-3.3.11.tgz#4f4f112cefbe303202f2199838128936266d185b"