npm - @mandujs/mcp - Versions diffs - 0.12.2 → 0.13.0 - Mend

@mandujs/mcp 0.12.2 → 0.13.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 (141) hide show

package/README.md +367 -367
package/package.json +2 -2
package/src/activity-monitor.ts +847 -847
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/index.ts +106 -106
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/generate.ts +7 -4
package/src/tools/guard.ts +17 -4
package/src/tools/hydration.ts +10 -10
package/src/tools/project.ts +334 -334
package/src/tools/runtime.ts +497 -497
package/src/tools/seo.ts +417 -417
package/src/tools/spec.ts +80 -159
package/src/utils/project.ts +22 -12
package/src/utils/withWarnings.ts +83 -83

package/src/resources/skills/mandu-ui/rules/ui-accessibility-focus.md CHANGED Viewed

@@ -1,238 +1,238 @@
----
-title: Focus Management
-impact: HIGH
-impactDescription: Keyboard navigation and focus handling
-tags: ui, accessibility, focus, keyboard
----
-## Focus Management
-**Impact: HIGH (Keyboard navigation and focus handling)**
-키보드 사용자를 위한 포커스 관리와 네비게이션을 구현하세요.
-## Focus Visible 스타일
-```css
-/* globals.css */
-@layer base {
-  /* 키보드 포커스만 표시 (마우스 클릭은 제외) */
-  *:focus {
-    outline: none;
-  }
-  *:focus-visible {
-    @apply outline-2 outline-offset-2 outline-ring;
-  }
-  /* 커스텀 focus ring */
-  .focus-ring {
-    @apply focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2;
-  }
-}
-```
-## Tailwind Focus 유틸리티
-```tsx
-<button
-  className={cn(
-    "rounded-md px-4 py-2",
-    // focus-visible만 스타일링 (키보드 포커스)
-    "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2"
-  )}
->
-  Click me
-</button>
-```
-## Focus Trap
-```bash
-bun add focus-trap-react
-```
-```tsx
-// app/modal/client.tsx
-"use client";
-import FocusTrap from "focus-trap-react";
-import { useEffect, useRef } from "react";
-export function ModalIsland({ open, onClose, children }) {
-  const closeButtonRef = useRef<HTMLButtonElement>(null);
-  // ESC로 닫기
-  useEffect(() => {
-    const handleKeyDown = (e: KeyboardEvent) => {
-      if (e.key === "Escape") onClose();
-    };
-    if (open) {
-      document.addEventListener("keydown", handleKeyDown);
-      return () => document.removeEventListener("keydown", handleKeyDown);
-    }
-  }, [open, onClose]);
-  if (!open) return null;
-  return (
-    <FocusTrap
-      focusTrapOptions={{
-        initialFocus: () => closeButtonRef.current,
-        allowOutsideClick: true,
-      }}
-    >
-      <div className="fixed inset-0 z-50">
-        <div className="fixed inset-0 bg-black/50" onClick={onClose} />
-        <div
-          role="dialog"
-          aria-modal="true"
-          className="fixed left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 bg-white p-6 rounded-lg"
-        >
-          <button
-            ref={closeButtonRef}
-            onClick={onClose}
-            className="absolute top-4 right-4"
-          >
-            Close
-          </button>
-          {children}
-        </div>
-      </div>
-    </FocusTrap>
-  );
-}
-```
-## Roving Focus
-```tsx
-// app/toolbar/client.tsx
-"use client";
-import { useState, useRef, KeyboardEvent } from "react";
-export function ToolbarIsland() {
-  const [focusedIndex, setFocusedIndex] = useState(0);
-  const buttonsRef = useRef<(HTMLButtonElement | null)[]>([]);
-  const items = ["Bold", "Italic", "Underline"];
-  const handleKeyDown = (e: KeyboardEvent, index: number) => {
-    let newIndex = index;
-    switch (e.key) {
-      case "ArrowRight":
-        newIndex = (index + 1) % items.length;
-        break;
-      case "ArrowLeft":
-        newIndex = (index - 1 + items.length) % items.length;
-        break;
-      case "Home":
-        newIndex = 0;
-        break;
-      case "End":
-        newIndex = items.length - 1;
-        break;
-      default:
-        return;
-    }
-    e.preventDefault();
-    setFocusedIndex(newIndex);
-    buttonsRef.current[newIndex]?.focus();
-  };
-  return (
-    <div role="toolbar" aria-label="Text formatting">
-      {items.map((item, index) => (
-        <button
-          key={item}
-          ref={(el) => (buttonsRef.current[index] = el)}
-          tabIndex={focusedIndex === index ? 0 : -1}
-          onKeyDown={(e) => handleKeyDown(e, index)}
-          onFocus={() => setFocusedIndex(index)}
-          className="px-3 py-1 rounded hover:bg-gray-100 focus-visible:ring-2"
-        >
-          {item}
-        </button>
-      ))}
-    </div>
-  );
-}
-```
-## Skip Link
-```tsx
-// app/layout.tsx
-export default function RootLayout({ children }) {
-  return (
-    <html>
-      <body>
-        {/* 첫 번째 요소로 Skip Link */}
-        <a
-          href="#main-content"
-          className="sr-only focus:not-sr-only focus:absolute focus:top-4 focus:left-4 focus:z-50 focus:px-4 focus:py-2 focus:bg-white focus:rounded-md focus:shadow-lg"
-        >
-          Skip to main content
-        </a>
-        <header>{/* ... */}</header>
-        <main id="main-content" tabIndex={-1}>
-          {children}
-        </main>
-      </body>
-    </html>
-  );
-}
-```
-## 포커스 복원
-```tsx
-// hooks/useFocusReturn.ts
-import { useRef, useEffect } from "react";
-export function useFocusReturn(isOpen: boolean) {
-  const previousFocusRef = useRef<HTMLElement | null>(null);
-  useEffect(() => {
-    if (isOpen) {
-      // 열릴 때 현재 포커스 저장
-      previousFocusRef.current = document.activeElement as HTMLElement;
-    } else if (previousFocusRef.current) {
-      // 닫힐 때 포커스 복원
-      previousFocusRef.current.focus();
-      previousFocusRef.current = null;
-    }
-  }, [isOpen]);
-}
-// 사용
-export function DialogIsland({ open, onClose }) {
-  useFocusReturn(open);
-  // ...
-}
-```
-## Tab Order 관리
-```tsx
-// 올바른 tabIndex 사용
-<div>
-  {/* tabIndex="0": 자연스러운 탭 순서에 포함 */}
-  <div tabIndex={0} role="button">Focusable div</div>
-  {/* tabIndex="-1": 프로그래밍으로만 포커스 가능 */}
-  <div tabIndex={-1} ref={focusTargetRef}>Focus target</div>
-  {/* 양수 tabIndex는 피하기 */}
-  {/* ❌ tabIndex={1} - 탭 순서 혼란 */}
-</div>
-```
-Reference: [WAI-ARIA Focus Management](https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/)
+---
+title: Focus Management
+impact: HIGH
+impactDescription: Keyboard navigation and focus handling
+tags: ui, accessibility, focus, keyboard
+---
+## Focus Management
+**Impact: HIGH (Keyboard navigation and focus handling)**
+키보드 사용자를 위한 포커스 관리와 네비게이션을 구현하세요.
+## Focus Visible 스타일
+```css
+/* globals.css */
+@layer base {
+  /* 키보드 포커스만 표시 (마우스 클릭은 제외) */
+  *:focus {
+    outline: none;
+  }
+  *:focus-visible {
+    @apply outline-2 outline-offset-2 outline-ring;
+  }
+  /* 커스텀 focus ring */
+  .focus-ring {
+    @apply focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2;
+  }
+}
+```
+## Tailwind Focus 유틸리티
+```tsx
+<button
+  className={cn(
+    "rounded-md px-4 py-2",
+    // focus-visible만 스타일링 (키보드 포커스)
+    "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2"
+  )}
+>
+  Click me
+</button>
+```
+## Focus Trap
+```bash
+bun add focus-trap-react
+```
+```tsx
+// app/modal/client.tsx
+"use client";
+import FocusTrap from "focus-trap-react";
+import { useEffect, useRef } from "react";
+export function ModalIsland({ open, onClose, children }) {
+  const closeButtonRef = useRef<HTMLButtonElement>(null);
+  // ESC로 닫기
+  useEffect(() => {
+    const handleKeyDown = (e: KeyboardEvent) => {
+      if (e.key === "Escape") onClose();
+    };
+    if (open) {
+      document.addEventListener("keydown", handleKeyDown);
+      return () => document.removeEventListener("keydown", handleKeyDown);
+    }
+  }, [open, onClose]);
+  if (!open) return null;
+  return (
+    <FocusTrap
+      focusTrapOptions={{
+        initialFocus: () => closeButtonRef.current,
+        allowOutsideClick: true,
+      }}
+    >
+      <div className="fixed inset-0 z-50">
+        <div className="fixed inset-0 bg-black/50" onClick={onClose} />
+        <div
+          role="dialog"
+          aria-modal="true"
+          className="fixed left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 bg-white p-6 rounded-lg"
+        >
+          <button
+            ref={closeButtonRef}
+            onClick={onClose}
+            className="absolute top-4 right-4"
+          >
+            Close
+          </button>
+          {children}
+        </div>
+      </div>
+    </FocusTrap>
+  );
+}
+```
+## Roving Focus
+```tsx
+// app/toolbar/client.tsx
+"use client";
+import { useState, useRef, KeyboardEvent } from "react";
+export function ToolbarIsland() {
+  const [focusedIndex, setFocusedIndex] = useState(0);
+  const buttonsRef = useRef<(HTMLButtonElement | null)[]>([]);
+  const items = ["Bold", "Italic", "Underline"];
+  const handleKeyDown = (e: KeyboardEvent, index: number) => {
+    let newIndex = index;
+    switch (e.key) {
+      case "ArrowRight":
+        newIndex = (index + 1) % items.length;
+        break;
+      case "ArrowLeft":
+        newIndex = (index - 1 + items.length) % items.length;
+        break;
+      case "Home":
+        newIndex = 0;
+        break;
+      case "End":
+        newIndex = items.length - 1;
+        break;
+      default:
+        return;
+    }
+    e.preventDefault();
+    setFocusedIndex(newIndex);
+    buttonsRef.current[newIndex]?.focus();
+  };
+  return (
+    <div role="toolbar" aria-label="Text formatting">
+      {items.map((item, index) => (
+        <button
+          key={item}
+          ref={(el) => (buttonsRef.current[index] = el)}
+          tabIndex={focusedIndex === index ? 0 : -1}
+          onKeyDown={(e) => handleKeyDown(e, index)}
+          onFocus={() => setFocusedIndex(index)}
+          className="px-3 py-1 rounded hover:bg-gray-100 focus-visible:ring-2"
+        >
+          {item}
+        </button>
+      ))}
+    </div>
+  );
+}
+```
+## Skip Link
+```tsx
+// app/layout.tsx
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        {/* 첫 번째 요소로 Skip Link */}
+        <a
+          href="#main-content"
+          className="sr-only focus:not-sr-only focus:absolute focus:top-4 focus:left-4 focus:z-50 focus:px-4 focus:py-2 focus:bg-white focus:rounded-md focus:shadow-lg"
+        >
+          Skip to main content
+        </a>
+        <header>{/* ... */}</header>
+        <main id="main-content" tabIndex={-1}>
+          {children}
+        </main>
+      </body>
+    </html>
+  );
+}
+```
+## 포커스 복원
+```tsx
+// hooks/useFocusReturn.ts
+import { useRef, useEffect } from "react";
+export function useFocusReturn(isOpen: boolean) {
+  const previousFocusRef = useRef<HTMLElement | null>(null);
+  useEffect(() => {
+    if (isOpen) {
+      // 열릴 때 현재 포커스 저장
+      previousFocusRef.current = document.activeElement as HTMLElement;
+    } else if (previousFocusRef.current) {
+      // 닫힐 때 포커스 복원
+      previousFocusRef.current.focus();
+      previousFocusRef.current = null;
+    }
+  }, [isOpen]);
+}
+// 사용
+export function DialogIsland({ open, onClose }) {
+  useFocusReturn(open);
+  // ...
+}
+```
+## Tab Order 관리
+```tsx
+// 올바른 tabIndex 사용
+<div>
+  {/* tabIndex="0": 자연스러운 탭 순서에 포함 */}
+  <div tabIndex={0} role="button">Focusable div</div>
+  {/* tabIndex="-1": 프로그래밍으로만 포커스 가능 */}
+  <div tabIndex={-1} ref={focusTargetRef}>Focus target</div>
+  {/* 양수 tabIndex는 피하기 */}
+  {/* ❌ tabIndex={1} - 탭 순서 혼란 */}
+</div>
+```
+Reference: [WAI-ARIA Focus Management](https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/)