@mandujs/mcp 0.13.0 → 0.17.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.
- package/README.md +102 -7
- package/package.json +3 -2
- package/src/adapters/index.ts +20 -20
- package/src/adapters/monitor-adapter.ts +100 -100
- package/src/adapters/tool-adapter.ts +88 -88
- package/src/executor/error-handler.ts +250 -250
- package/src/executor/index.ts +22 -22
- package/src/executor/tool-executor.ts +148 -148
- package/src/hooks/config-watcher.ts +174 -174
- package/src/hooks/index.ts +23 -23
- package/src/hooks/mcp-hooks.ts +227 -227
- package/src/logging/index.ts +15 -15
- package/src/logging/mcp-transport.ts +134 -134
- package/src/registry/index.ts +13 -13
- package/src/registry/mcp-tool-registry.ts +298 -298
- package/src/resources/skills/guides.ts +1136 -1136
- package/src/resources/skills/index.ts +12 -12
- package/src/resources/skills/loader.ts +218 -218
- package/src/resources/skills/mandu-composition/SKILL.md +91 -91
- package/src/resources/skills/mandu-composition/metadata.json +13 -13
- package/src/resources/skills/mandu-composition/rules/_sections.md +26 -26
- package/src/resources/skills/mandu-composition/rules/_template.md +77 -77
- package/src/resources/skills/mandu-composition/rules/comp-arch-avoid-boolean-props.md +146 -146
- package/src/resources/skills/mandu-composition/rules/comp-arch-compound-components.md +164 -164
- package/src/resources/skills/mandu-composition/rules/comp-island-event.md +161 -161
- package/src/resources/skills/mandu-composition/rules/comp-island-slot-split.md +167 -167
- package/src/resources/skills/mandu-composition/rules/comp-pattern-children.md +149 -149
- package/src/resources/skills/mandu-composition/rules/comp-state-context-interface.md +148 -148
- package/src/resources/skills/mandu-composition/rules/comp-state-lift-state.md +150 -150
- package/src/resources/skills/mandu-deployment/SKILL.md +92 -92
- package/src/resources/skills/mandu-deployment/_sections.md +41 -41
- package/src/resources/skills/mandu-deployment/_template.md +38 -38
- package/src/resources/skills/mandu-deployment/metadata.json +13 -13
- package/src/resources/skills/mandu-deployment/rules/deploy-build-bun.md +109 -109
- package/src/resources/skills/mandu-deployment/rules/deploy-build-output.md +115 -115
- package/src/resources/skills/mandu-deployment/rules/deploy-cicd-github.md +219 -219
- package/src/resources/skills/mandu-deployment/rules/deploy-docker-bun.md +150 -150
- package/src/resources/skills/mandu-deployment/rules/deploy-docker-compose.md +223 -223
- package/src/resources/skills/mandu-deployment/rules/deploy-platform-fly.md +152 -152
- package/src/resources/skills/mandu-deployment/rules/deploy-platform-render.md +179 -179
- package/src/resources/skills/mandu-deployment/rules/deploy-platform-supabase.md +323 -323
- package/src/resources/skills/mandu-deployment/rules/deploy-platform-vercel.md +140 -140
- package/src/resources/skills/mandu-fs-routes/SKILL.md +82 -82
- package/src/resources/skills/mandu-fs-routes/metadata.json +12 -12
- package/src/resources/skills/mandu-fs-routes/rules/_sections.md +36 -36
- package/src/resources/skills/mandu-fs-routes/rules/_template.md +69 -69
- package/src/resources/skills/mandu-fs-routes/rules/routes-api-methods.md +65 -65
- package/src/resources/skills/mandu-fs-routes/rules/routes-dynamic-param.md +93 -93
- package/src/resources/skills/mandu-fs-routes/rules/routes-naming-page.md +55 -55
- package/src/resources/skills/mandu-guard/SKILL.md +129 -129
- package/src/resources/skills/mandu-guard/metadata.json +12 -12
- package/src/resources/skills/mandu-guard/rules/_sections.md +36 -36
- package/src/resources/skills/mandu-guard/rules/_template.md +82 -82
- package/src/resources/skills/mandu-guard/rules/guard-config-rules.md +100 -100
- package/src/resources/skills/mandu-guard/rules/guard-layer-direction.md +76 -76
- package/src/resources/skills/mandu-guard/rules/guard-preset-mandu.md +81 -81
- package/src/resources/skills/mandu-guard/rules/guard-validate-import.md +80 -80
- package/src/resources/skills/mandu-hydration/SKILL.md +91 -91
- package/src/resources/skills/mandu-hydration/metadata.json +12 -12
- package/src/resources/skills/mandu-hydration/rules/_sections.md +31 -31
- package/src/resources/skills/mandu-hydration/rules/_template.md +72 -72
- package/src/resources/skills/mandu-hydration/rules/hydration-data-event.md +109 -109
- package/src/resources/skills/mandu-hydration/rules/hydration-directive-use-client.md +55 -55
- package/src/resources/skills/mandu-hydration/rules/hydration-island-setup.md +113 -113
- package/src/resources/skills/mandu-hydration/rules/hydration-priority-visible.md +68 -68
- package/src/resources/skills/mandu-performance/SKILL.md +85 -85
- package/src/resources/skills/mandu-performance/metadata.json +14 -14
- package/src/resources/skills/mandu-performance/rules/_sections.md +31 -31
- package/src/resources/skills/mandu-performance/rules/_template.md +64 -64
- package/src/resources/skills/mandu-performance/rules/perf-async-defer-await.md +103 -103
- package/src/resources/skills/mandu-performance/rules/perf-async-parallel.md +95 -95
- package/src/resources/skills/mandu-performance/rules/perf-bun-file.md +124 -124
- package/src/resources/skills/mandu-performance/rules/perf-bun-serve.md +125 -125
- package/src/resources/skills/mandu-performance/rules/perf-bundle-imports.md +80 -80
- package/src/resources/skills/mandu-performance/rules/perf-bundle-island-lazy.md +145 -145
- package/src/resources/skills/mandu-performance/rules/perf-cache-react.md +98 -98
- package/src/resources/skills/mandu-performance/rules/perf-render-transitions.md +154 -154
- package/src/resources/skills/mandu-security/SKILL.md +87 -87
- package/src/resources/skills/mandu-security/metadata.json +13 -13
- package/src/resources/skills/mandu-security/rules/_sections.md +31 -31
- package/src/resources/skills/mandu-security/rules/_template.md +74 -74
- package/src/resources/skills/mandu-security/rules/sec-auth-guard.md +127 -127
- package/src/resources/skills/mandu-security/rules/sec-env-management.md +133 -133
- package/src/resources/skills/mandu-security/rules/sec-input-validate.md +148 -148
- package/src/resources/skills/mandu-security/rules/sec-protect-csrf.md +146 -146
- package/src/resources/skills/mandu-security/rules/sec-protect-headers.md +138 -138
- package/src/resources/skills/mandu-slot/SKILL.md +85 -85
- package/src/resources/skills/mandu-slot/metadata.json +12 -12
- package/src/resources/skills/mandu-slot/rules/_sections.md +36 -36
- package/src/resources/skills/mandu-slot/rules/_template.md +63 -63
- package/src/resources/skills/mandu-slot/rules/slot-basic-structure.md +38 -38
- package/src/resources/skills/mandu-slot/rules/slot-ctx-response.md +56 -56
- package/src/resources/skills/mandu-slot/rules/slot-guard-auth.md +59 -59
- package/src/resources/skills/mandu-slot/rules/slot-http-methods.md +64 -64
- package/src/resources/skills/mandu-styling/SKILL.md +154 -154
- package/src/resources/skills/mandu-styling/_sections.md +43 -43
- package/src/resources/skills/mandu-styling/_template.md +32 -32
- package/src/resources/skills/mandu-styling/metadata.json +15 -15
- package/src/resources/skills/mandu-styling/rules/style-component-compound.md +235 -235
- package/src/resources/skills/mandu-styling/rules/style-component-slots.md +255 -255
- package/src/resources/skills/mandu-styling/rules/style-component-tokens.md +205 -205
- package/src/resources/skills/mandu-styling/rules/style-island-animations.md +272 -272
- package/src/resources/skills/mandu-styling/rules/style-island-scoping.md +167 -167
- package/src/resources/skills/mandu-styling/rules/style-island-variants.md +221 -221
- package/src/resources/skills/mandu-styling/rules/style-perf-critical.md +209 -209
- package/src/resources/skills/mandu-styling/rules/style-perf-purge.md +192 -192
- package/src/resources/skills/mandu-styling/rules/style-setup-modules.md +162 -162
- package/src/resources/skills/mandu-styling/rules/style-setup-panda.md +164 -164
- package/src/resources/skills/mandu-styling/rules/style-setup-tailwind.md +170 -170
- package/src/resources/skills/mandu-styling/rules/style-tailwind-v4-gotchas.md +179 -179
- package/src/resources/skills/mandu-styling/rules/style-theme-darkmode.md +229 -229
- package/src/resources/skills/mandu-testing/SKILL.md +99 -99
- package/src/resources/skills/mandu-testing/metadata.json +13 -13
- package/src/resources/skills/mandu-testing/rules/_sections.md +26 -26
- package/src/resources/skills/mandu-testing/rules/_template.md +65 -65
- package/src/resources/skills/mandu-testing/rules/test-component-island.md +195 -195
- package/src/resources/skills/mandu-testing/rules/test-e2e-playwright.md +196 -196
- package/src/resources/skills/mandu-testing/rules/test-mock-fetch.md +219 -219
- package/src/resources/skills/mandu-testing/rules/test-slot-unit.md +192 -192
- package/src/resources/skills/mandu-ui/SKILL.md +117 -117
- package/src/resources/skills/mandu-ui/_sections.md +23 -23
- package/src/resources/skills/mandu-ui/_template.md +32 -32
- package/src/resources/skills/mandu-ui/metadata.json +13 -13
- package/src/resources/skills/mandu-ui/rules/ui-accessibility-aria.md +232 -232
- package/src/resources/skills/mandu-ui/rules/ui-accessibility-focus.md +238 -238
- package/src/resources/skills/mandu-ui/rules/ui-composition-patterns.md +259 -259
- package/src/resources/skills/mandu-ui/rules/ui-island-integration.md +258 -258
- package/src/resources/skills/mandu-ui/rules/ui-radix-patterns.md +213 -213
- package/src/resources/skills/mandu-ui/rules/ui-shadcn-setup.md +209 -209
- package/src/resources/skills/recipes.ts +932 -932
- package/src/tools/ate.ts +219 -0
- package/src/tools/index.ts +4 -1
- package/src/tools/project.ts +334 -334
- package/src/tools/runtime.ts +497 -497
- package/src/tools/seo.ts +417 -417
- package/src/utils/withWarnings.ts +83 -83
|
@@ -1,154 +1,154 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: Mandu Styling
|
|
3
|
-
description: Tailwind CSS v4 integration and Island styling patterns for Mandu Framework
|
|
4
|
-
metadata:
|
|
5
|
-
version: "2.0.0"
|
|
6
|
-
author: mandu
|
|
7
|
-
tailwind: "v4.1+"
|
|
8
|
-
globs:
|
|
9
|
-
- "**/*.css"
|
|
10
|
-
- "**/*.module.css"
|
|
11
|
-
- "app/globals.css"
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
# Mandu Styling Skill
|
|
15
|
-
|
|
16
|
-
Mandu Island 아키텍처에 최적화된 Tailwind CSS v4 스타일링 가이드입니다.
|
|
17
|
-
|
|
18
|
-
## 핵심 원칙
|
|
19
|
-
|
|
20
|
-
1. **Zero-Runtime**: 빌드 타임 CSS 생성 (SSR 호환)
|
|
21
|
-
2. **CSS-First**: JavaScript 설정 대신 CSS에서 테마 정의
|
|
22
|
-
3. **Island 격리**: 컴포넌트 간 스타일 충돌 방지
|
|
23
|
-
4. **Auto Integration**: Mandu가 Tailwind v4 자동 감지 및 빌드
|
|
24
|
-
|
|
25
|
-
## 권장 스택
|
|
26
|
-
|
|
27
|
-
```
|
|
28
|
-
Primary: Tailwind CSS v4 + clsx/tailwind-merge
|
|
29
|
-
Alternative: CSS Modules (최소 의존성)
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
## 빠른 시작
|
|
33
|
-
|
|
34
|
-
### 1. 설치
|
|
35
|
-
|
|
36
|
-
```bash
|
|
37
|
-
bun add -d tailwindcss@^4.1 @tailwindcss/cli@^4.1
|
|
38
|
-
bun add clsx tailwind-merge
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
### 2. app/globals.css
|
|
42
|
-
|
|
43
|
-
```css
|
|
44
|
-
@import "tailwindcss";
|
|
45
|
-
|
|
46
|
-
@theme {
|
|
47
|
-
--color-primary: hsl(222.2 47.4% 11.2%);
|
|
48
|
-
--color-primary-foreground: hsl(210 40% 98%);
|
|
49
|
-
--color-background: hsl(0 0% 100%);
|
|
50
|
-
--color-foreground: hsl(222.2 84% 4.9%);
|
|
51
|
-
--radius-md: 0.5rem;
|
|
52
|
-
--font-sans: 'Inter', system-ui, sans-serif;
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
body {
|
|
56
|
-
background-color: var(--color-background);
|
|
57
|
-
color: var(--color-foreground);
|
|
58
|
-
}
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
### 3. Mandu 자동 통합
|
|
62
|
-
|
|
63
|
-
```
|
|
64
|
-
mandu dev 실행 시:
|
|
65
|
-
├─ @import "tailwindcss" 감지
|
|
66
|
-
├─ Tailwind CLI --watch 자동 시작
|
|
67
|
-
├─ 출력: .mandu/client/globals.css
|
|
68
|
-
├─ SSR에서 <link> 자동 주입
|
|
69
|
-
└─ CSS 변경 시 HMR 핫 리로드
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
## Island 스타일링
|
|
73
|
-
|
|
74
|
-
```tsx
|
|
75
|
-
// src/client/widgets/counter/Counter.island.tsx
|
|
76
|
-
"use client";
|
|
77
|
-
|
|
78
|
-
import { cn } from "@/shared/lib/utils";
|
|
79
|
-
|
|
80
|
-
export function CounterIsland({ variant = "default" }) {
|
|
81
|
-
return (
|
|
82
|
-
<button className={cn(
|
|
83
|
-
"px-4 py-2 rounded-md font-medium transition-colors",
|
|
84
|
-
variant === "default"
|
|
85
|
-
? "bg-primary text-primary-foreground hover:bg-primary/90"
|
|
86
|
-
: "border border-primary text-primary hover:bg-primary/10"
|
|
87
|
-
)}>
|
|
88
|
-
Count: 0
|
|
89
|
-
</button>
|
|
90
|
-
);
|
|
91
|
-
}
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
## cn 유틸리티
|
|
95
|
-
|
|
96
|
-
```typescript
|
|
97
|
-
// src/client/shared/lib/utils.ts
|
|
98
|
-
import { clsx, type ClassValue } from "clsx";
|
|
99
|
-
import { twMerge } from "tailwind-merge";
|
|
100
|
-
|
|
101
|
-
export function cn(...inputs: ClassValue[]) {
|
|
102
|
-
return twMerge(clsx(inputs));
|
|
103
|
-
}
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
## Custom Utilities
|
|
107
|
-
|
|
108
|
-
```css
|
|
109
|
-
/* v4 방식: @utility 사용 */
|
|
110
|
-
@utility text-balance {
|
|
111
|
-
text-wrap: balance;
|
|
112
|
-
}
|
|
113
|
-
|
|
114
|
-
@utility scrollbar-hide {
|
|
115
|
-
-ms-overflow-style: none;
|
|
116
|
-
scrollbar-width: none;
|
|
117
|
-
&::-webkit-scrollbar { display: none; }
|
|
118
|
-
}
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
## v4 주요 변경사항
|
|
122
|
-
|
|
123
|
-
| v3 | v4 |
|
|
124
|
-
|----|-----|
|
|
125
|
-
| `@tailwind base/utilities` | `@import "tailwindcss"` |
|
|
126
|
-
| `tailwind.config.ts` | `@theme { }` in CSS |
|
|
127
|
-
| `!bg-red-500` | `bg-red-500!` |
|
|
128
|
-
| `@layer utilities` | `@utility` |
|
|
129
|
-
| `bg-[--var]` | `bg-(--var)` |
|
|
130
|
-
|
|
131
|
-
> 자세한 내용은 `rules/style-tailwind-v4-gotchas.md` 참조
|
|
132
|
-
|
|
133
|
-
## 규칙 카테고리
|
|
134
|
-
|
|
135
|
-
| Category | Description | Rules |
|
|
136
|
-
|----------|-------------|-------|
|
|
137
|
-
| Setup | Tailwind v4 설정 | 1 |
|
|
138
|
-
| Gotchas | v4 주의사항/마이그레이션 | 1 |
|
|
139
|
-
| Island | Island 스타일 패턴 | 3 |
|
|
140
|
-
| Component | 컴포넌트 스타일 | 3 |
|
|
141
|
-
| Performance | 최적화 | 2 |
|
|
142
|
-
| Theme | 테마/다크모드 | 1 |
|
|
143
|
-
|
|
144
|
-
→ 세부 규칙은 `rules/` 폴더 참조
|
|
145
|
-
|
|
146
|
-
## Browser Support
|
|
147
|
-
|
|
148
|
-
```
|
|
149
|
-
Safari 16.4+ | Chrome 111+ | Firefox 128+
|
|
150
|
-
```
|
|
151
|
-
|
|
152
|
-
> IE 및 구형 브라우저 미지원. 레거시 프로젝트는 Tailwind v3 유지 권장.
|
|
153
|
-
|
|
154
|
-
Reference: [Tailwind CSS v4](https://tailwindcss.com/docs)
|
|
1
|
+
---
|
|
2
|
+
name: Mandu Styling
|
|
3
|
+
description: Tailwind CSS v4 integration and Island styling patterns for Mandu Framework
|
|
4
|
+
metadata:
|
|
5
|
+
version: "2.0.0"
|
|
6
|
+
author: mandu
|
|
7
|
+
tailwind: "v4.1+"
|
|
8
|
+
globs:
|
|
9
|
+
- "**/*.css"
|
|
10
|
+
- "**/*.module.css"
|
|
11
|
+
- "app/globals.css"
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
# Mandu Styling Skill
|
|
15
|
+
|
|
16
|
+
Mandu Island 아키텍처에 최적화된 Tailwind CSS v4 스타일링 가이드입니다.
|
|
17
|
+
|
|
18
|
+
## 핵심 원칙
|
|
19
|
+
|
|
20
|
+
1. **Zero-Runtime**: 빌드 타임 CSS 생성 (SSR 호환)
|
|
21
|
+
2. **CSS-First**: JavaScript 설정 대신 CSS에서 테마 정의
|
|
22
|
+
3. **Island 격리**: 컴포넌트 간 스타일 충돌 방지
|
|
23
|
+
4. **Auto Integration**: Mandu가 Tailwind v4 자동 감지 및 빌드
|
|
24
|
+
|
|
25
|
+
## 권장 스택
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
Primary: Tailwind CSS v4 + clsx/tailwind-merge
|
|
29
|
+
Alternative: CSS Modules (최소 의존성)
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## 빠른 시작
|
|
33
|
+
|
|
34
|
+
### 1. 설치
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
bun add -d tailwindcss@^4.1 @tailwindcss/cli@^4.1
|
|
38
|
+
bun add clsx tailwind-merge
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
### 2. app/globals.css
|
|
42
|
+
|
|
43
|
+
```css
|
|
44
|
+
@import "tailwindcss";
|
|
45
|
+
|
|
46
|
+
@theme {
|
|
47
|
+
--color-primary: hsl(222.2 47.4% 11.2%);
|
|
48
|
+
--color-primary-foreground: hsl(210 40% 98%);
|
|
49
|
+
--color-background: hsl(0 0% 100%);
|
|
50
|
+
--color-foreground: hsl(222.2 84% 4.9%);
|
|
51
|
+
--radius-md: 0.5rem;
|
|
52
|
+
--font-sans: 'Inter', system-ui, sans-serif;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
body {
|
|
56
|
+
background-color: var(--color-background);
|
|
57
|
+
color: var(--color-foreground);
|
|
58
|
+
}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### 3. Mandu 자동 통합
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
mandu dev 실행 시:
|
|
65
|
+
├─ @import "tailwindcss" 감지
|
|
66
|
+
├─ Tailwind CLI --watch 자동 시작
|
|
67
|
+
├─ 출력: .mandu/client/globals.css
|
|
68
|
+
├─ SSR에서 <link> 자동 주입
|
|
69
|
+
└─ CSS 변경 시 HMR 핫 리로드
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
## Island 스타일링
|
|
73
|
+
|
|
74
|
+
```tsx
|
|
75
|
+
// src/client/widgets/counter/Counter.island.tsx
|
|
76
|
+
"use client";
|
|
77
|
+
|
|
78
|
+
import { cn } from "@/shared/lib/utils";
|
|
79
|
+
|
|
80
|
+
export function CounterIsland({ variant = "default" }) {
|
|
81
|
+
return (
|
|
82
|
+
<button className={cn(
|
|
83
|
+
"px-4 py-2 rounded-md font-medium transition-colors",
|
|
84
|
+
variant === "default"
|
|
85
|
+
? "bg-primary text-primary-foreground hover:bg-primary/90"
|
|
86
|
+
: "border border-primary text-primary hover:bg-primary/10"
|
|
87
|
+
)}>
|
|
88
|
+
Count: 0
|
|
89
|
+
</button>
|
|
90
|
+
);
|
|
91
|
+
}
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
## cn 유틸리티
|
|
95
|
+
|
|
96
|
+
```typescript
|
|
97
|
+
// src/client/shared/lib/utils.ts
|
|
98
|
+
import { clsx, type ClassValue } from "clsx";
|
|
99
|
+
import { twMerge } from "tailwind-merge";
|
|
100
|
+
|
|
101
|
+
export function cn(...inputs: ClassValue[]) {
|
|
102
|
+
return twMerge(clsx(inputs));
|
|
103
|
+
}
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
## Custom Utilities
|
|
107
|
+
|
|
108
|
+
```css
|
|
109
|
+
/* v4 방식: @utility 사용 */
|
|
110
|
+
@utility text-balance {
|
|
111
|
+
text-wrap: balance;
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
@utility scrollbar-hide {
|
|
115
|
+
-ms-overflow-style: none;
|
|
116
|
+
scrollbar-width: none;
|
|
117
|
+
&::-webkit-scrollbar { display: none; }
|
|
118
|
+
}
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
## v4 주요 변경사항
|
|
122
|
+
|
|
123
|
+
| v3 | v4 |
|
|
124
|
+
|----|-----|
|
|
125
|
+
| `@tailwind base/utilities` | `@import "tailwindcss"` |
|
|
126
|
+
| `tailwind.config.ts` | `@theme { }` in CSS |
|
|
127
|
+
| `!bg-red-500` | `bg-red-500!` |
|
|
128
|
+
| `@layer utilities` | `@utility` |
|
|
129
|
+
| `bg-[--var]` | `bg-(--var)` |
|
|
130
|
+
|
|
131
|
+
> 자세한 내용은 `rules/style-tailwind-v4-gotchas.md` 참조
|
|
132
|
+
|
|
133
|
+
## 규칙 카테고리
|
|
134
|
+
|
|
135
|
+
| Category | Description | Rules |
|
|
136
|
+
|----------|-------------|-------|
|
|
137
|
+
| Setup | Tailwind v4 설정 | 1 |
|
|
138
|
+
| Gotchas | v4 주의사항/마이그레이션 | 1 |
|
|
139
|
+
| Island | Island 스타일 패턴 | 3 |
|
|
140
|
+
| Component | 컴포넌트 스타일 | 3 |
|
|
141
|
+
| Performance | 최적화 | 2 |
|
|
142
|
+
| Theme | 테마/다크모드 | 1 |
|
|
143
|
+
|
|
144
|
+
→ 세부 규칙은 `rules/` 폴더 참조
|
|
145
|
+
|
|
146
|
+
## Browser Support
|
|
147
|
+
|
|
148
|
+
```
|
|
149
|
+
Safari 16.4+ | Chrome 111+ | Firefox 128+
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
> IE 및 구형 브라우저 미지원. 레거시 프로젝트는 Tailwind v3 유지 권장.
|
|
153
|
+
|
|
154
|
+
Reference: [Tailwind CSS v4](https://tailwindcss.com/docs)
|
|
@@ -1,43 +1,43 @@
|
|
|
1
|
-
# Mandu Styling - Rule Categories
|
|
2
|
-
|
|
3
|
-
## Setup
|
|
4
|
-
CSS 프레임워크 초기 설정 및 Mandu 통합 (Tailwind v4 CSS-first)
|
|
5
|
-
|
|
6
|
-
| Impact | Description |
|
|
7
|
-
|--------|-------------|
|
|
8
|
-
| CRITICAL | 프레임워크 설정 없이 스타일링 불가 |
|
|
9
|
-
|
|
10
|
-
## Gotchas
|
|
11
|
-
Tailwind CSS v4 마이그레이션 주의사항 및 Breaking Changes
|
|
12
|
-
|
|
13
|
-
| Impact | Description |
|
|
14
|
-
|--------|-------------|
|
|
15
|
-
| HIGH | v3→v4 마이그레이션 시 필수 확인 사항 |
|
|
16
|
-
|
|
17
|
-
## Island
|
|
18
|
-
Island 컴포넌트 특화 스타일링 패턴
|
|
19
|
-
|
|
20
|
-
| Impact | Description |
|
|
21
|
-
|--------|-------------|
|
|
22
|
-
| HIGH | 스타일 충돌 방지, 독립적 hydration 지원 |
|
|
23
|
-
|
|
24
|
-
## Component
|
|
25
|
-
컴포넌트 레벨 스타일링 패턴
|
|
26
|
-
|
|
27
|
-
| Impact | Description |
|
|
28
|
-
|--------|-------------|
|
|
29
|
-
| HIGH | 재사용성, 일관성, 유지보수성 향상 |
|
|
30
|
-
|
|
31
|
-
## Performance
|
|
32
|
-
CSS 빌드 및 로딩 최적화
|
|
33
|
-
|
|
34
|
-
| Impact | Description |
|
|
35
|
-
|--------|-------------|
|
|
36
|
-
| MEDIUM | 번들 크기, 초기 로딩 성능 개선 |
|
|
37
|
-
|
|
38
|
-
## Theme
|
|
39
|
-
다크모드 및 테마 시스템
|
|
40
|
-
|
|
41
|
-
| Impact | Description |
|
|
42
|
-
|--------|-------------|
|
|
43
|
-
| MEDIUM | 사용자 경험, 접근성 향상 |
|
|
1
|
+
# Mandu Styling - Rule Categories
|
|
2
|
+
|
|
3
|
+
## Setup
|
|
4
|
+
CSS 프레임워크 초기 설정 및 Mandu 통합 (Tailwind v4 CSS-first)
|
|
5
|
+
|
|
6
|
+
| Impact | Description |
|
|
7
|
+
|--------|-------------|
|
|
8
|
+
| CRITICAL | 프레임워크 설정 없이 스타일링 불가 |
|
|
9
|
+
|
|
10
|
+
## Gotchas
|
|
11
|
+
Tailwind CSS v4 마이그레이션 주의사항 및 Breaking Changes
|
|
12
|
+
|
|
13
|
+
| Impact | Description |
|
|
14
|
+
|--------|-------------|
|
|
15
|
+
| HIGH | v3→v4 마이그레이션 시 필수 확인 사항 |
|
|
16
|
+
|
|
17
|
+
## Island
|
|
18
|
+
Island 컴포넌트 특화 스타일링 패턴
|
|
19
|
+
|
|
20
|
+
| Impact | Description |
|
|
21
|
+
|--------|-------------|
|
|
22
|
+
| HIGH | 스타일 충돌 방지, 독립적 hydration 지원 |
|
|
23
|
+
|
|
24
|
+
## Component
|
|
25
|
+
컴포넌트 레벨 스타일링 패턴
|
|
26
|
+
|
|
27
|
+
| Impact | Description |
|
|
28
|
+
|--------|-------------|
|
|
29
|
+
| HIGH | 재사용성, 일관성, 유지보수성 향상 |
|
|
30
|
+
|
|
31
|
+
## Performance
|
|
32
|
+
CSS 빌드 및 로딩 최적화
|
|
33
|
+
|
|
34
|
+
| Impact | Description |
|
|
35
|
+
|--------|-------------|
|
|
36
|
+
| MEDIUM | 번들 크기, 초기 로딩 성능 개선 |
|
|
37
|
+
|
|
38
|
+
## Theme
|
|
39
|
+
다크모드 및 테마 시스템
|
|
40
|
+
|
|
41
|
+
| Impact | Description |
|
|
42
|
+
|--------|-------------|
|
|
43
|
+
| MEDIUM | 사용자 경험, 접근성 향상 |
|
|
@@ -1,32 +1,32 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: Rule Title Here
|
|
3
|
-
impact: CRITICAL | HIGH | MEDIUM | LOW
|
|
4
|
-
impactDescription: One-line description of why this matters
|
|
5
|
-
tags: styling, tag2, tag3
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
## Rule Title Here
|
|
9
|
-
|
|
10
|
-
**Impact: LEVEL (Impact description)**
|
|
11
|
-
|
|
12
|
-
규칙에 대한 간단한 설명.
|
|
13
|
-
|
|
14
|
-
**설정:**
|
|
15
|
-
|
|
16
|
-
```typescript
|
|
17
|
-
// 설정 예시
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
**사용 예시:**
|
|
21
|
-
|
|
22
|
-
```tsx
|
|
23
|
-
// 컴포넌트 예시
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## 추가 패턴
|
|
27
|
-
|
|
28
|
-
```tsx
|
|
29
|
-
// 추가 패턴
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
Reference: [문서 링크](https://example.com)
|
|
1
|
+
---
|
|
2
|
+
title: Rule Title Here
|
|
3
|
+
impact: CRITICAL | HIGH | MEDIUM | LOW
|
|
4
|
+
impactDescription: One-line description of why this matters
|
|
5
|
+
tags: styling, tag2, tag3
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Rule Title Here
|
|
9
|
+
|
|
10
|
+
**Impact: LEVEL (Impact description)**
|
|
11
|
+
|
|
12
|
+
규칙에 대한 간단한 설명.
|
|
13
|
+
|
|
14
|
+
**설정:**
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
// 설정 예시
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
**사용 예시:**
|
|
21
|
+
|
|
22
|
+
```tsx
|
|
23
|
+
// 컴포넌트 예시
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## 추가 패턴
|
|
27
|
+
|
|
28
|
+
```tsx
|
|
29
|
+
// 추가 패턴
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Reference: [문서 링크](https://example.com)
|
|
@@ -1,15 +1,15 @@
|
|
|
1
|
-
{
|
|
2
|
-
"id": "mandu-styling",
|
|
3
|
-
"name": "Mandu Styling",
|
|
4
|
-
"version": "2.0.0",
|
|
5
|
-
"description": "Tailwind CSS v4 integration and Island styling patterns for Mandu Framework",
|
|
6
|
-
"author": "mandu",
|
|
7
|
-
"tailwind": "v4.1+",
|
|
8
|
-
"references": [
|
|
9
|
-
"https://tailwindcss.com/docs",
|
|
10
|
-
"https://tailwindcss.com/docs/upgrade-guide",
|
|
11
|
-
"https://panda-css.com/docs",
|
|
12
|
-
"https://lightningcss.dev/"
|
|
13
|
-
],
|
|
14
|
-
"abstract": "Mandu Island 아키텍처에 최적화된 Tailwind CSS v4 스타일링 가이드. CSS-first 설정, @theme 블록, Mandu 자동 통합(CSS Auto-Build, HMR)을 지원합니다."
|
|
15
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"id": "mandu-styling",
|
|
3
|
+
"name": "Mandu Styling",
|
|
4
|
+
"version": "2.0.0",
|
|
5
|
+
"description": "Tailwind CSS v4 integration and Island styling patterns for Mandu Framework",
|
|
6
|
+
"author": "mandu",
|
|
7
|
+
"tailwind": "v4.1+",
|
|
8
|
+
"references": [
|
|
9
|
+
"https://tailwindcss.com/docs",
|
|
10
|
+
"https://tailwindcss.com/docs/upgrade-guide",
|
|
11
|
+
"https://panda-css.com/docs",
|
|
12
|
+
"https://lightningcss.dev/"
|
|
13
|
+
],
|
|
14
|
+
"abstract": "Mandu Island 아키텍처에 최적화된 Tailwind CSS v4 스타일링 가이드. CSS-first 설정, @theme 블록, Mandu 자동 통합(CSS Auto-Build, HMR)을 지원합니다."
|
|
15
|
+
}
|