@mandujs/mcp 0.36.3 → 0.37.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. package/package.json +4 -4
  2. package/src/activity-adapter.ts +23 -23
  3. package/src/adapters/index.ts +20 -20
  4. package/src/adapters/monitor-adapter.ts +100 -100
  5. package/src/adapters/tool-adapter.ts +90 -90
  6. package/src/executor/index.ts +22 -22
  7. package/src/executor/tool-executor.ts +148 -148
  8. package/src/hooks/config-watcher.ts +173 -173
  9. package/src/hooks/index.ts +23 -23
  10. package/src/hooks/mcp-hooks.ts +227 -227
  11. package/src/index.ts +0 -0
  12. package/src/logging/index.ts +15 -15
  13. package/src/logging/mcp-transport.ts +134 -134
  14. package/src/profiles.ts +34 -34
  15. package/src/registry/index.ts +13 -13
  16. package/src/registry/mcp-tool-registry.ts +298 -298
  17. package/src/resources/skills/guides.ts +1136 -1136
  18. package/src/resources/skills/index.ts +12 -12
  19. package/src/resources/skills/mandu-composition/SKILL.md +91 -91
  20. package/src/resources/skills/mandu-composition/metadata.json +13 -13
  21. package/src/resources/skills/mandu-composition/rules/_sections.md +26 -26
  22. package/src/resources/skills/mandu-composition/rules/_template.md +77 -77
  23. package/src/resources/skills/mandu-composition/rules/comp-arch-avoid-boolean-props.md +146 -146
  24. package/src/resources/skills/mandu-composition/rules/comp-arch-compound-components.md +164 -164
  25. package/src/resources/skills/mandu-composition/rules/comp-island-event.md +161 -161
  26. package/src/resources/skills/mandu-composition/rules/comp-island-slot-split.md +167 -167
  27. package/src/resources/skills/mandu-composition/rules/comp-pattern-children.md +149 -149
  28. package/src/resources/skills/mandu-composition/rules/comp-state-context-interface.md +148 -148
  29. package/src/resources/skills/mandu-composition/rules/comp-state-lift-state.md +150 -150
  30. package/src/resources/skills/mandu-deployment/SKILL.md +92 -92
  31. package/src/resources/skills/mandu-deployment/_sections.md +41 -41
  32. package/src/resources/skills/mandu-deployment/_template.md +38 -38
  33. package/src/resources/skills/mandu-deployment/metadata.json +13 -13
  34. package/src/resources/skills/mandu-deployment/rules/db-provider-supabase.md +300 -300
  35. package/src/resources/skills/mandu-deployment/rules/deploy-build-bun.md +109 -109
  36. package/src/resources/skills/mandu-deployment/rules/deploy-build-output.md +115 -115
  37. package/src/resources/skills/mandu-deployment/rules/deploy-cicd-github.md +219 -219
  38. package/src/resources/skills/mandu-deployment/rules/deploy-docker-bun.md +150 -150
  39. package/src/resources/skills/mandu-deployment/rules/deploy-docker-compose.md +223 -223
  40. package/src/resources/skills/mandu-deployment/rules/deploy-platform-fly.md +152 -152
  41. package/src/resources/skills/mandu-deployment/rules/deploy-platform-render.md +179 -179
  42. package/src/resources/skills/mandu-deployment/rules/deploy-platform-vercel.md +140 -140
  43. package/src/resources/skills/mandu-fs-routes/SKILL.md +82 -82
  44. package/src/resources/skills/mandu-fs-routes/metadata.json +12 -12
  45. package/src/resources/skills/mandu-fs-routes/rules/_sections.md +36 -36
  46. package/src/resources/skills/mandu-fs-routes/rules/_template.md +69 -69
  47. package/src/resources/skills/mandu-fs-routes/rules/routes-api-methods.md +65 -65
  48. package/src/resources/skills/mandu-fs-routes/rules/routes-dynamic-param.md +93 -93
  49. package/src/resources/skills/mandu-fs-routes/rules/routes-naming-page.md +55 -55
  50. package/src/resources/skills/mandu-guard/SKILL.md +129 -129
  51. package/src/resources/skills/mandu-guard/metadata.json +12 -12
  52. package/src/resources/skills/mandu-guard/rules/_sections.md +36 -36
  53. package/src/resources/skills/mandu-guard/rules/_template.md +82 -82
  54. package/src/resources/skills/mandu-guard/rules/guard-config-rules.md +100 -100
  55. package/src/resources/skills/mandu-guard/rules/guard-layer-direction.md +76 -76
  56. package/src/resources/skills/mandu-guard/rules/guard-preset-mandu.md +81 -81
  57. package/src/resources/skills/mandu-guard/rules/guard-validate-import.md +80 -80
  58. package/src/resources/skills/mandu-hydration/SKILL.md +91 -91
  59. package/src/resources/skills/mandu-hydration/metadata.json +12 -12
  60. package/src/resources/skills/mandu-hydration/rules/_sections.md +31 -31
  61. package/src/resources/skills/mandu-hydration/rules/_template.md +72 -72
  62. package/src/resources/skills/mandu-hydration/rules/hydration-data-event.md +109 -109
  63. package/src/resources/skills/mandu-hydration/rules/hydration-directive-use-client.md +55 -55
  64. package/src/resources/skills/mandu-hydration/rules/hydration-island-setup.md +113 -113
  65. package/src/resources/skills/mandu-hydration/rules/hydration-priority-visible.md +68 -68
  66. package/src/resources/skills/mandu-performance/SKILL.md +85 -85
  67. package/src/resources/skills/mandu-performance/metadata.json +14 -14
  68. package/src/resources/skills/mandu-performance/rules/_sections.md +31 -31
  69. package/src/resources/skills/mandu-performance/rules/_template.md +64 -64
  70. package/src/resources/skills/mandu-performance/rules/perf-async-defer-await.md +103 -103
  71. package/src/resources/skills/mandu-performance/rules/perf-async-parallel.md +95 -95
  72. package/src/resources/skills/mandu-performance/rules/perf-bun-file.md +124 -124
  73. package/src/resources/skills/mandu-performance/rules/perf-bun-serve.md +125 -125
  74. package/src/resources/skills/mandu-performance/rules/perf-bundle-imports.md +80 -80
  75. package/src/resources/skills/mandu-performance/rules/perf-bundle-island-lazy.md +145 -145
  76. package/src/resources/skills/mandu-performance/rules/perf-cache-react.md +98 -98
  77. package/src/resources/skills/mandu-performance/rules/perf-render-transitions.md +154 -154
  78. package/src/resources/skills/mandu-security/SKILL.md +87 -87
  79. package/src/resources/skills/mandu-security/metadata.json +13 -13
  80. package/src/resources/skills/mandu-security/rules/_sections.md +31 -31
  81. package/src/resources/skills/mandu-security/rules/_template.md +74 -74
  82. package/src/resources/skills/mandu-security/rules/sec-auth-guard.md +127 -127
  83. package/src/resources/skills/mandu-security/rules/sec-env-management.md +133 -133
  84. package/src/resources/skills/mandu-security/rules/sec-input-validate.md +148 -148
  85. package/src/resources/skills/mandu-security/rules/sec-protect-csrf.md +146 -146
  86. package/src/resources/skills/mandu-security/rules/sec-protect-headers.md +138 -138
  87. package/src/resources/skills/mandu-slot/SKILL.md +85 -85
  88. package/src/resources/skills/mandu-slot/metadata.json +12 -12
  89. package/src/resources/skills/mandu-slot/rules/_sections.md +36 -36
  90. package/src/resources/skills/mandu-slot/rules/_template.md +63 -63
  91. package/src/resources/skills/mandu-slot/rules/slot-basic-structure.md +38 -38
  92. package/src/resources/skills/mandu-slot/rules/slot-ctx-response.md +56 -56
  93. package/src/resources/skills/mandu-slot/rules/slot-guard-auth.md +59 -59
  94. package/src/resources/skills/mandu-slot/rules/slot-http-methods.md +64 -64
  95. package/src/resources/skills/mandu-styling/SKILL.md +154 -154
  96. package/src/resources/skills/mandu-styling/_sections.md +43 -43
  97. package/src/resources/skills/mandu-styling/_template.md +32 -32
  98. package/src/resources/skills/mandu-styling/metadata.json +15 -15
  99. package/src/resources/skills/mandu-styling/rules/style-component-compound.md +235 -235
  100. package/src/resources/skills/mandu-styling/rules/style-component-slots.md +255 -255
  101. package/src/resources/skills/mandu-styling/rules/style-component-tokens.md +205 -205
  102. package/src/resources/skills/mandu-styling/rules/style-island-animations.md +272 -272
  103. package/src/resources/skills/mandu-styling/rules/style-island-scoping.md +167 -167
  104. package/src/resources/skills/mandu-styling/rules/style-island-variants.md +221 -221
  105. package/src/resources/skills/mandu-styling/rules/style-perf-critical.md +209 -209
  106. package/src/resources/skills/mandu-styling/rules/style-perf-purge.md +192 -192
  107. package/src/resources/skills/mandu-styling/rules/style-setup-modules.md +162 -162
  108. package/src/resources/skills/mandu-styling/rules/style-setup-panda.md +164 -164
  109. package/src/resources/skills/mandu-styling/rules/style-setup-tailwind.md +170 -170
  110. package/src/resources/skills/mandu-styling/rules/style-tailwind-v4-gotchas.md +179 -179
  111. package/src/resources/skills/mandu-styling/rules/style-theme-darkmode.md +229 -229
  112. package/src/resources/skills/mandu-testing/SKILL.md +99 -99
  113. package/src/resources/skills/mandu-testing/metadata.json +13 -13
  114. package/src/resources/skills/mandu-testing/rules/_sections.md +26 -26
  115. package/src/resources/skills/mandu-testing/rules/_template.md +65 -65
  116. package/src/resources/skills/mandu-testing/rules/test-component-island.md +195 -195
  117. package/src/resources/skills/mandu-testing/rules/test-e2e-playwright.md +196 -196
  118. package/src/resources/skills/mandu-testing/rules/test-mock-fetch.md +219 -219
  119. package/src/resources/skills/mandu-testing/rules/test-slot-unit.md +192 -192
  120. package/src/resources/skills/mandu-ui/SKILL.md +117 -117
  121. package/src/resources/skills/mandu-ui/_sections.md +23 -23
  122. package/src/resources/skills/mandu-ui/_template.md +32 -32
  123. package/src/resources/skills/mandu-ui/metadata.json +13 -13
  124. package/src/resources/skills/mandu-ui/rules/ui-accessibility-aria.md +232 -232
  125. package/src/resources/skills/mandu-ui/rules/ui-accessibility-focus.md +238 -238
  126. package/src/resources/skills/mandu-ui/rules/ui-composition-patterns.md +259 -259
  127. package/src/resources/skills/mandu-ui/rules/ui-island-integration.md +258 -258
  128. package/src/resources/skills/mandu-ui/rules/ui-radix-patterns.md +213 -213
  129. package/src/resources/skills/mandu-ui/rules/ui-shadcn-setup.md +209 -209
  130. package/src/resources/skills/recipes.ts +932 -932
  131. package/src/server.ts +3 -3
  132. package/src/tools/ate-exemplar.ts +92 -92
  133. package/src/tools/ate-flakes.ts +90 -90
  134. package/src/tools/ate-mutate.ts +103 -103
  135. package/src/tools/ate-mutation-report.ts +64 -64
  136. package/src/tools/ate-oracle-pending.ts +49 -49
  137. package/src/tools/ate-oracle-replay.ts +44 -44
  138. package/src/tools/ate-oracle-verdict.ts +70 -70
  139. package/src/tools/ate-prompt.ts +146 -146
  140. package/src/tools/brain.ts +3 -3
  141. package/src/tools/deploy-plan.ts +378 -378
  142. package/src/tools/deploy-preview.ts +316 -316
  143. package/src/tools/design.ts +825 -825
  144. package/src/tools/docs.ts +350 -350
  145. package/src/tools/kitchen.ts +109 -23
  146. package/src/tools/lint.ts +226 -226
  147. package/src/tools/loop-close.ts +175 -175
  148. package/src/tools/negotiate.ts +263 -263
  149. package/src/tools/run-tests.ts +424 -424
  150. package/src/tools/runtime.ts +1 -1
  151. package/src/tools/slot-validation.ts +199 -199
  152. package/src/tx-lock.ts +73 -73
  153. package/src/utils/runtime-control.ts +52 -52
@@ -1,209 +1,209 @@
1
- ---
2
- title: Critical CSS Extraction
3
- impact: MEDIUM
4
- impactDescription: Improves First Contentful Paint
5
- tags: styling, performance, critical, fcp
6
- ---
7
-
8
- ## Critical CSS Extraction
9
-
10
- **Impact: MEDIUM (Improves First Contentful Paint)**
11
-
12
- 초기 렌더링에 필요한 CSS만 인라인으로 포함하여 FCP를 개선하세요.
13
-
14
- ## Tailwind의 자동 최적화
15
-
16
- Tailwind CSS는 JIT 컴파일로 사용된 클래스만 생성합니다.
17
-
18
- ```typescript
19
- // tailwind.config.ts
20
- export default {
21
- content: [
22
- "./app/**/*.{ts,tsx}", // 실제 사용되는 파일만 스캔
23
- ],
24
- // ...
25
- };
26
- ```
27
-
28
- ## Above-the-fold CSS 분리
29
-
30
- ```tsx
31
- // app/layout.tsx
32
- export default function RootLayout({ children }) {
33
- return (
34
- <html>
35
- <head>
36
- {/* Critical CSS: 인라인 */}
37
- <style
38
- dangerouslySetInnerHTML={{
39
- __html: `
40
- /* Above-the-fold 스타일만 */
41
- body { margin: 0; font-family: system-ui; }
42
- .header { height: 64px; background: white; }
43
- .hero { min-height: 50vh; }
44
- `,
45
- }}
46
- />
47
-
48
- {/* Non-critical CSS: 비동기 로드 */}
49
- <link
50
- rel="preload"
51
- href="/styles/main.css"
52
- as="style"
53
- onLoad="this.onload=null;this.rel='stylesheet'"
54
- />
55
- <noscript>
56
- <link rel="stylesheet" href="/styles/main.css" />
57
- </noscript>
58
- </head>
59
- <body>{children}</body>
60
- </html>
61
- );
62
- }
63
- ```
64
-
65
- ## Lightning CSS 통합
66
-
67
- ```bash
68
- bun add -d lightningcss
69
- ```
70
-
71
- ```typescript
72
- // scripts/build-css.ts
73
- import { transform, browserslistToTargets } from "lightningcss";
74
- import browserslist from "browserslist";
75
-
76
- const targets = browserslistToTargets(browserslist(">= 0.25%"));
77
-
78
- const css = await Bun.file("app/globals.css").text();
79
-
80
- const { code } = transform({
81
- filename: "globals.css",
82
- code: Buffer.from(css),
83
- minify: true,
84
- targets,
85
- // Critical CSS 추출
86
- analyzeDependencies: true,
87
- });
88
-
89
- await Bun.write("dist/styles.css", code);
90
- ```
91
-
92
- ## PostCSS 설정
93
-
94
- ```javascript
95
- // postcss.config.js
96
- export default {
97
- plugins: {
98
- tailwindcss: {},
99
- autoprefixer: {},
100
- ...(process.env.NODE_ENV === "production"
101
- ? {
102
- cssnano: {
103
- preset: [
104
- "default",
105
- {
106
- discardComments: { removeAll: true },
107
- },
108
- ],
109
- },
110
- }
111
- : {}),
112
- },
113
- };
114
- ```
115
-
116
- ## CSS Layer 우선순위
117
-
118
- ```css
119
- /* globals.css */
120
- @layer reset, base, components, utilities;
121
-
122
- /* Critical: reset과 base만 인라인 */
123
- @layer reset {
124
- *,
125
- *::before,
126
- *::after {
127
- box-sizing: border-box;
128
- }
129
- }
130
-
131
- @layer base {
132
- body {
133
- @apply bg-background text-foreground;
134
- }
135
- }
136
-
137
- /* Non-critical: 별도 파일 */
138
- @layer components {
139
- /* ... */
140
- }
141
-
142
- @layer utilities {
143
- /* ... */
144
- }
145
- ```
146
-
147
- ## Font 최적화
148
-
149
- ```tsx
150
- // 폰트 preload로 FOIT/FOUT 방지
151
- <link
152
- rel="preload"
153
- href="/fonts/inter-var.woff2"
154
- as="font"
155
- type="font/woff2"
156
- crossOrigin="anonymous"
157
- />
158
-
159
- // 폰트 display 설정
160
- <style>
161
- {`
162
- @font-face {
163
- font-family: 'Inter';
164
- src: url('/fonts/inter-var.woff2') format('woff2');
165
- font-display: swap;
166
- }
167
- `}
168
- </style>
169
- ```
170
-
171
- ## 성능 측정
172
-
173
- ```typescript
174
- // 빌드 후 CSS 크기 확인
175
- import { gzipSync } from "bun";
176
-
177
- const css = await Bun.file("dist/styles.css").text();
178
- const gzipped = gzipSync(Buffer.from(css));
179
-
180
- console.log("CSS size:", css.length, "bytes");
181
- console.log("Gzipped:", gzipped.length, "bytes");
182
-
183
- // 목표: < 14KB (TCP 첫 라운드트립)
184
- ```
185
-
186
- ## Inline Critical + Lazy Load 패턴
187
-
188
- ```tsx
189
- // components/StyleLoader.tsx
190
- "use client";
191
-
192
- import { useEffect } from "react";
193
-
194
- export function StyleLoader({ href }: { href: string }) {
195
- useEffect(() => {
196
- const link = document.createElement("link");
197
- link.rel = "stylesheet";
198
- link.href = href;
199
- document.head.appendChild(link);
200
- }, [href]);
201
-
202
- return null;
203
- }
204
-
205
- // 사용
206
- <StyleLoader href="/styles/non-critical.css" />
207
- ```
208
-
209
- Reference: [web.dev Critical CSS](https://web.dev/articles/extract-critical-css)
1
+ ---
2
+ title: Critical CSS Extraction
3
+ impact: MEDIUM
4
+ impactDescription: Improves First Contentful Paint
5
+ tags: styling, performance, critical, fcp
6
+ ---
7
+
8
+ ## Critical CSS Extraction
9
+
10
+ **Impact: MEDIUM (Improves First Contentful Paint)**
11
+
12
+ 초기 렌더링에 필요한 CSS만 인라인으로 포함하여 FCP를 개선하세요.
13
+
14
+ ## Tailwind의 자동 최적화
15
+
16
+ Tailwind CSS는 JIT 컴파일로 사용된 클래스만 생성합니다.
17
+
18
+ ```typescript
19
+ // tailwind.config.ts
20
+ export default {
21
+ content: [
22
+ "./app/**/*.{ts,tsx}", // 실제 사용되는 파일만 스캔
23
+ ],
24
+ // ...
25
+ };
26
+ ```
27
+
28
+ ## Above-the-fold CSS 분리
29
+
30
+ ```tsx
31
+ // app/layout.tsx
32
+ export default function RootLayout({ children }) {
33
+ return (
34
+ <html>
35
+ <head>
36
+ {/* Critical CSS: 인라인 */}
37
+ <style
38
+ dangerouslySetInnerHTML={{
39
+ __html: `
40
+ /* Above-the-fold 스타일만 */
41
+ body { margin: 0; font-family: system-ui; }
42
+ .header { height: 64px; background: white; }
43
+ .hero { min-height: 50vh; }
44
+ `,
45
+ }}
46
+ />
47
+
48
+ {/* Non-critical CSS: 비동기 로드 */}
49
+ <link
50
+ rel="preload"
51
+ href="/styles/main.css"
52
+ as="style"
53
+ onLoad="this.onload=null;this.rel='stylesheet'"
54
+ />
55
+ <noscript>
56
+ <link rel="stylesheet" href="/styles/main.css" />
57
+ </noscript>
58
+ </head>
59
+ <body>{children}</body>
60
+ </html>
61
+ );
62
+ }
63
+ ```
64
+
65
+ ## Lightning CSS 통합
66
+
67
+ ```bash
68
+ bun add -d lightningcss
69
+ ```
70
+
71
+ ```typescript
72
+ // scripts/build-css.ts
73
+ import { transform, browserslistToTargets } from "lightningcss";
74
+ import browserslist from "browserslist";
75
+
76
+ const targets = browserslistToTargets(browserslist(">= 0.25%"));
77
+
78
+ const css = await Bun.file("app/globals.css").text();
79
+
80
+ const { code } = transform({
81
+ filename: "globals.css",
82
+ code: Buffer.from(css),
83
+ minify: true,
84
+ targets,
85
+ // Critical CSS 추출
86
+ analyzeDependencies: true,
87
+ });
88
+
89
+ await Bun.write("dist/styles.css", code);
90
+ ```
91
+
92
+ ## PostCSS 설정
93
+
94
+ ```javascript
95
+ // postcss.config.js
96
+ export default {
97
+ plugins: {
98
+ tailwindcss: {},
99
+ autoprefixer: {},
100
+ ...(process.env.NODE_ENV === "production"
101
+ ? {
102
+ cssnano: {
103
+ preset: [
104
+ "default",
105
+ {
106
+ discardComments: { removeAll: true },
107
+ },
108
+ ],
109
+ },
110
+ }
111
+ : {}),
112
+ },
113
+ };
114
+ ```
115
+
116
+ ## CSS Layer 우선순위
117
+
118
+ ```css
119
+ /* globals.css */
120
+ @layer reset, base, components, utilities;
121
+
122
+ /* Critical: reset과 base만 인라인 */
123
+ @layer reset {
124
+ *,
125
+ *::before,
126
+ *::after {
127
+ box-sizing: border-box;
128
+ }
129
+ }
130
+
131
+ @layer base {
132
+ body {
133
+ @apply bg-background text-foreground;
134
+ }
135
+ }
136
+
137
+ /* Non-critical: 별도 파일 */
138
+ @layer components {
139
+ /* ... */
140
+ }
141
+
142
+ @layer utilities {
143
+ /* ... */
144
+ }
145
+ ```
146
+
147
+ ## Font 최적화
148
+
149
+ ```tsx
150
+ // 폰트 preload로 FOIT/FOUT 방지
151
+ <link
152
+ rel="preload"
153
+ href="/fonts/inter-var.woff2"
154
+ as="font"
155
+ type="font/woff2"
156
+ crossOrigin="anonymous"
157
+ />
158
+
159
+ // 폰트 display 설정
160
+ <style>
161
+ {`
162
+ @font-face {
163
+ font-family: 'Inter';
164
+ src: url('/fonts/inter-var.woff2') format('woff2');
165
+ font-display: swap;
166
+ }
167
+ `}
168
+ </style>
169
+ ```
170
+
171
+ ## 성능 측정
172
+
173
+ ```typescript
174
+ // 빌드 후 CSS 크기 확인
175
+ import { gzipSync } from "bun";
176
+
177
+ const css = await Bun.file("dist/styles.css").text();
178
+ const gzipped = gzipSync(Buffer.from(css));
179
+
180
+ console.log("CSS size:", css.length, "bytes");
181
+ console.log("Gzipped:", gzipped.length, "bytes");
182
+
183
+ // 목표: < 14KB (TCP 첫 라운드트립)
184
+ ```
185
+
186
+ ## Inline Critical + Lazy Load 패턴
187
+
188
+ ```tsx
189
+ // components/StyleLoader.tsx
190
+ "use client";
191
+
192
+ import { useEffect } from "react";
193
+
194
+ export function StyleLoader({ href }: { href: string }) {
195
+ useEffect(() => {
196
+ const link = document.createElement("link");
197
+ link.rel = "stylesheet";
198
+ link.href = href;
199
+ document.head.appendChild(link);
200
+ }, [href]);
201
+
202
+ return null;
203
+ }
204
+
205
+ // 사용
206
+ <StyleLoader href="/styles/non-critical.css" />
207
+ ```
208
+
209
+ Reference: [web.dev Critical CSS](https://web.dev/articles/extract-critical-css)