mcp-probe-kit 3.0.14 → 3.0.16

package/build/resources/ui-ux-data/stacks/nextjs.json

@@ -0,0 +1,218 @@
+[
+  {
+    "No": "1",
+    "Category": "Routing",
+    "Guideline": "Use App Router for new projects",
+    "Description": "App Router is the recommended approach in Next.js 14+",
+    "Do": "app/ directory with page.tsx",
+    "Don't": "pages/ for new projects",
+    "Code Good": "app/dashboard/page.tsx",
+    "Code Bad": "pages/dashboard.tsx",
+    "Severity": "Medium",
+    "Docs URL": "https://nextjs.org/docs/app"
+  },
+  {
+    "No": "2",
+    "Category": "Routing",
+    "Guideline": "Use file-based routing",
+    "Description": "Create routes by adding files in app directory",
+    "Do": "page.tsx for routes layout.tsx for layouts",
+    "Don't": "Manual route configuration",
+    "Code Good": "app/blog/[slug]/page.tsx",
+    "Code Bad": "Custom router setup",
+    "Severity": "Medium",
+    "Docs URL": "https://nextjs.org/docs/app/building-your-application/routing"
+  },
+  {
+    "No": "3",
+    "Category": "Routing",
+    "Guideline": "Colocate related files",
+    "Description": "Keep components styles tests with their routes",
+    "Do": "Component files alongside page.tsx",
+    "Don't": "Separate components folder",
+    "Code Good": "app/dashboard/_components/",
+    "Code Bad": "components/dashboard/",
+    "Severity": "Low",
+    "Docs URL": ""
+  },
+  {
+    "No": "4",
+    "Category": "Routing",
+    "Guideline": "Use route groups for organization",
+    "Description": "Group routes without affecting URL",
+    "Do": "Parentheses for route groups",
+    "Don't": "Nested folders affecting URL",
+    "Code Good": "(marketing)/about/page.tsx",
+    "Code Bad": "marketing/about/page.tsx",
+    "Severity": "Low",
+    "Docs URL": "https://nextjs.org/docs/app/building-your-application/routing/route-groups"
+  },
+  {
+    "No": "5",
+    "Category": "Routing",
+    "Guideline": "Handle loading states",
+    "Description": "Use loading.tsx for route loading UI",
+    "Do": "loading.tsx alongside page.tsx",
+    "Don't": "Manual loading state management",
+    "Code Good": "app/dashboard/loading.tsx",
+    "Code Bad": "useState for loading in page",
+    "Severity": "Medium",
+    "Docs URL": "https://nextjs.org/docs/app/building-your-application/routing/loading-ui-and-streaming"
+  },
+  {
+    "No": "6",
+    "Category": "Routing",
+    "Guideline": "Handle errors with error.tsx",
+    "Description": "Catch errors at route level",
+    "Do": "error.tsx with reset function",
+    "Don't": "try/catch in every component",
+    "Code Good": "app/dashboard/error.tsx",
+    "Code Bad": "try/catch in page component",
+    "Severity": "High",
+    "Docs URL": "https://nextjs.org/docs/app/building-your-application/routing/error-handling"
+  },
+  {
+    "No": "7",
+    "Category": "Rendering",
+    "Guideline": "Use Server Components by default",
+    "Description": "Server Components reduce client JS bundle",
+    "Do": "Keep components server by default",
+    "Don't": "Add 'use client' unnecessarily",
+    "Code Good": "export default function Page()",
+    "Code Bad": "('use client') for static content",
+    "Severity": "High",
+    "Docs URL": "https://nextjs.org/docs/app/building-your-application/rendering/server-components"
+  },
+  {
+    "No": "8",
+    "Category": "Rendering",
+    "Guideline": "Mark Client Components explicitly",
+    "Description": "'use client' for interactive components",
+    "Do": "Add 'use client' only when needed",
+    "Don't": "Server Component with hooks/events",
+    "Code Good": "('use client') for onClick useState",
+    "Code Bad": "No directive with useState",
+    "Severity": "High",
+    "Docs URL": "https://nextjs.org/docs/app/building-your-application/rendering/client-components"
+  },
+  {
+    "No": "9",
+    "Category": "Rendering",
+    "Guideline": "Push Client Components down",
+    "Description": "Keep Client Components as leaf nodes",
+    "Do": "Client wrapper for interactive parts only",
+    "Don't": "Mark page as Client Component",
+    "Code Good": "<InteractiveButton/> in Server Page",
+    "Code Bad": "('use client') on page.tsx",
+    "Severity": "High",
+    "Docs URL": ""
+  },
+  {
+    "No": "10",
+    "Category": "Rendering",
+    "Guideline": "Use streaming for better UX",
+    "Description": "Stream content with Suspense boundaries",
+    "Do": "Suspense for slow data fetches",
+    "Don't": "Wait for all data before render",
+    "Code Good": "<Suspense><SlowComponent/></Suspense>",
+    "Code Bad": "await allData then render",
+    "Severity": "Medium",
+    "Docs URL": "https://nextjs.org/docs/app/building-your-application/routing/loading-ui-and-streaming"
+  },
+  {
+    "No": "11",
+    "Category": "Rendering",
+    "Guideline": "Choose correct rendering strategy",
+    "Description": "SSG for static SSR for dynamic ISR for semi-static",
+    "Do": "generateStaticParams for known paths",
+    "Don't": "SSR for static content",
+    "Code Good": "export const revalidate = 3600",
+    "Code Bad": "fetch without cache config",
+    "Severity": "Medium",
+    "Docs URL": ""
+  },
+  {
+    "No": "12",
+    "Category": "DataFetching",
+    "Guideline": "Fetch data in Server Components",
+    "Description": "Fetch directly in async Server Components",
+    "Do": "async function Page() { const data = await fetch() }",
+    "Don't": "useEffect for initial data",
+    "Code Good": "const data = await fetch(url)",
+    "Code Bad": "useEffect(() => fetch(url))",
+    "Severity": "High",
+    "Docs URL": "https://nextjs.org/docs/app/building-your-application/data-fetching"
+  },
+  {
+    "No": "13",
+    "Category": "DataFetching",
+    "Guideline": "Configure caching explicitly (Next.js 15+)",
+    "Description": "Next.js 15 changed defaults to uncached for fetch",
+    "Do": "Explicitly set cache: 'force-cache' for static data",
+    "Don't": "Assume default is cached (it's not in Next.js 15)",
+    "Code Good": "fetch(url { cache: 'force-cache' })",
+    "Code Bad": "fetch(url) // Uncached in v15",
+    "Severity": "High",
+    "Docs URL": "https://nextjs.org/docs/app/building-your-application/upgrading/version-15"
+  },
+  {
+    "No": "14",
+    "Category": "DataFetching",
+    "Guideline": "Deduplicate fetch requests",
+    "Description": "React and Next.js dedupe same requests",
+    "Do": "Same fetch call in multiple components",
+    "Don't": "Manual request deduplication",
+    "Code Good": "Multiple components fetch same URL",
+    "Code Bad": "Custom cache layer",
+    "Severity": "Low",
+    "Docs URL": ""
+  },
+  {
+    "No": "15",
+    "Category": "DataFetching",
+    "Guideline": "Use Server Actions for mutations",
+    "Description": "Server Actions for form submissions",
+    "Do": "action={serverAction} in forms",
+    "Don't": "API route for every mutation",
+    "Code Good": "<form action={createPost}>",
+    "Code Bad": "<form onSubmit={callApiRoute}>",
+    "Severity": "Medium",
+    "Docs URL": "https://nextjs.org/docs/app/building-your-application/data-fetching/server-actions-and-mutations"
+  },
+  {
+    "No": "16",
+    "Category": "DataFetching",
+    "Guideline": "Revalidate data appropriately",
+    "Description": "Use revalidatePath/revalidateTag after mutations",
+    "Do": "Revalidate after Server Action",
+    "Don't": "'use client' with manual refetch",
+    "Code Good": "revalidatePath('/posts')",
+    "Code Bad": "router.refresh() everywhere",
+    "Severity": "Medium",
+    "Docs URL": "https://nextjs.org/docs/app/building-your-application/caching#revalidating"
+  },
+  {
+    "No": "17",
+    "Category": "Images",
+    "Guideline": "Use next/image for optimization",
+    "Description": "Automatic image optimization and lazy loading",
+    "Do": "<Image> component for all images",
+    "Don't": "<img> tags directly",
+    "Code Good": "<Image src={} alt={} width={} height={}>",
+    "Code Bad": "<img src={}/>",
+    "Severity": "High",
+    "Docs URL": "https://nextjs.org/docs/app/building-your-application/optimizing/images"
+  },
+  {
+    "No": "18",
+    "Category": "Images",
+    "Guideline": "Provide width and height",
+    "Description": "Prevent layout shift with dimensions",
+    "Do": "width and height props or fill",
+    "Don't": "Missing dimensions",
+    "Code Good": "<Image width={400} height={300}/>",
+    "Code Bad": "<Image src={url}/>",
+    "Severity": "High",
+    "Docs URL": ""
+  }
+]

package/build/resources/ui-ux-data/stacks/nuxt-ui.json

@@ -0,0 +1,14 @@
+[
+  {
+    "No": "1",
+    "Category": "Installation",
+    "Guideline": "Add Nuxt UI module",
+    "Description": "Install and configure Nuxt UI in your Nuxt project",
+    "Do": "pnpm add @nuxt/ui and add to modules",
+    "Don't": "Manual component imports",
+    "Code Good": "modules: ['@nuxt/ui']",
+    "Code Bad": "import { UButton } from '@nuxt/ui'",
+    "Severity": "High",
+    "Docs URL": "https://ui.nuxt.com/docs/getting-started/installation/nuxt"
+  }
+]

package/build/resources/ui-ux-data/stacks/nuxtjs.json

@@ -0,0 +1,182 @@
+[
+  {
+    "No": "1",
+    "Category": "Routing",
+    "Guideline": "Use file-based routing",
+    "Description": "Create routes by adding files in pages directory",
+    "Do": "pages/ directory with index.vue",
+    "Don't": "Manual route configuration",
+    "Code Good": "pages/dashboard/index.vue",
+    "Code Bad": "Custom router setup",
+    "Severity": "Medium",
+    "Docs URL": "https://nuxt.com/docs/getting-started/routing"
+  },
+  {
+    "No": "2",
+    "Category": "Routing",
+    "Guideline": "Use dynamic route parameters",
+    "Description": "Create dynamic routes with bracket syntax",
+    "Do": "[id].vue for dynamic params",
+    "Don't": "Hardcoded routes for dynamic content",
+    "Code Good": "pages/posts/[id].vue",
+    "Code Bad": "pages/posts/post1.vue",
+    "Severity": "Medium",
+    "Docs URL": "https://nuxt.com/docs/getting-started/routing"
+  },
+  {
+    "No": "3",
+    "Category": "Routing",
+    "Guideline": "Use catch-all routes",
+    "Description": "Handle multiple path segments with [...slug]",
+    "Do": "[...slug].vue for catch-all",
+    "Don't": "Multiple nested dynamic routes",
+    "Code Good": "pages/[...slug].vue",
+    "Code Bad": "pages/[a]/[b]/[c].vue",
+    "Severity": "Low",
+    "Docs URL": "https://nuxt.com/docs/getting-started/routing"
+  },
+  {
+    "No": "4",
+    "Category": "Routing",
+    "Guideline": "Define page metadata with definePageMeta",
+    "Description": "Set page-level configuration and middleware",
+    "Do": "definePageMeta for layout middleware title",
+    "Don't": "Manual route meta configuration",
+    "Code Good": "definePageMeta({ layout: 'admin', middleware: 'auth' })",
+    "Code Bad": "router.beforeEach for page config",
+    "Severity": "High",
+    "Docs URL": "https://nuxt.com/docs/api/utils/define-page-meta"
+  },
+  {
+    "No": "5",
+    "Category": "Routing",
+    "Guideline": "Use validate for route params",
+    "Description": "Validate dynamic route parameters before rendering",
+    "Do": "validate function in definePageMeta",
+    "Don't": "Manual validation in setup",
+    "Code Good": "definePageMeta({ validate: (route) => /^d+$/.test(route.params.id) })",
+    "Code Bad": "if (!valid) navigateTo('/404')",
+    "Severity": "Medium",
+    "Docs URL": "https://nuxt.com/docs/api/utils/define-page-meta"
+  },
+  {
+    "No": "6",
+    "Category": "Rendering",
+    "Guideline": "Use SSR by default",
+    "Description": "Server-side rendering is enabled by default",
+    "Do": "Keep ssr: true (default)",
+    "Don't": "Disable SSR unnecessarily",
+    "Code Good": "ssr: true (default)",
+    "Code Bad": "ssr: false for all pages",
+    "Severity": "High",
+    "Docs URL": "https://nuxt.com/docs/guide/concepts/rendering"
+  },
+  {
+    "No": "7",
+    "Category": "Rendering",
+    "Guideline": "Use .client suffix for client-only components",
+    "Description": "Mark components to render only on client",
+    "Do": "ComponentName.client.vue suffix",
+    "Don't": "v-if with process.client check",
+    "Code Good": "Comments.client.vue",
+    "Code Bad": "<div v-if=\"process.client\"><Comments/></div>",
+    "Severity": "Medium",
+    "Docs URL": "https://nuxt.com/docs/guide/directory-structure/components"
+  },
+  {
+    "No": "8",
+    "Category": "Rendering",
+    "Guideline": "Use .server suffix for server-only components",
+    "Description": "Mark components to render only on server",
+    "Do": "ComponentName.server.vue suffix",
+    "Don't": "Manual server check",
+    "Code Good": "HeavyMarkdown.server.vue",
+    "Code Bad": "v-if=\"process.server\"",
+    "Severity": "Low",
+    "Docs URL": "https://nuxt.com/docs/guide/directory-structure/components"
+  },
+  {
+    "No": "9",
+    "Category": "DataFetching",
+    "Guideline": "Use useFetch for simple data fetching",
+    "Description": "Wrapper around useAsyncData for URL fetching",
+    "Do": "useFetch for API calls",
+    "Don't": "$fetch in onMounted",
+    "Code Good": "const { data } = await useFetch('/api/posts')",
+    "Code Bad": "onMounted(async () => { data.value = await $fetch('/api/posts') })",
+    "Severity": "High",
+    "Docs URL": "https://nuxt.com/docs/api/composables/use-fetch"
+  },
+  {
+    "No": "10",
+    "Category": "DataFetching",
+    "Guideline": "Use useAsyncData for complex fetching",
+    "Description": "Fine-grained control over async data",
+    "Do": "useAsyncData for CMS or custom fetching",
+    "Don't": "useFetch for non-URL data sources",
+    "Code Good": "const { data } = await useAsyncData('posts', () => cms.getPosts())",
+    "Code Bad": "const { data } = await useFetch(() => cms.getPosts())",
+    "Severity": "Medium",
+    "Docs URL": "https://nuxt.com/docs/api/composables/use-async-data"
+  },
+  {
+    "No": "11",
+    "Category": "DataFetching",
+    "Guideline": "Use $fetch for non-reactive requests",
+    "Description": "$fetch for event handlers and non-component code",
+    "Do": "$fetch in event handlers or server routes",
+    "Don't": "useFetch in click handlers",
+    "Code Good": "async function submit() { await $fetch('/api/submit', { method: 'POST' }) }",
+    "Code Bad": "async function submit() { await useFetch('/api/submit') }",
+    "Severity": "High",
+    "Docs URL": "https://nuxt.com/docs/api/utils/dollarfetch"
+  },
+  {
+    "No": "12",
+    "Category": "DataFetching",
+    "Guideline": "Use lazy option for non-blocking fetch",
+    "Description": "Defer data fetching for better initial load",
+    "Do": "lazy: true for below-fold content",
+    "Don't": "Blocking fetch for non-critical data",
+    "Code Good": "useFetch('/api/comments', { lazy: true })",
+    "Code Bad": "await useFetch('/api/comments') for footer",
+    "Severity": "Medium",
+    "Docs URL": "https://nuxt.com/docs/api/composables/use-fetch"
+  },
+  {
+    "No": "13",
+    "Category": "DataFetching",
+    "Guideline": "Use server option to control fetch location",
+    "Description": "Choose where data is fetched",
+    "Do": "server: false for client-only data",
+    "Don't": "Server fetch for user-specific client data",
+    "Code Good": "useFetch('/api/user-preferences', { server: false })",
+    "Code Bad": "useFetch for localStorage-dependent data",
+    "Severity": "Medium",
+    "Docs URL": "https://nuxt.com/docs/api/composables/use-fetch"
+  },
+  {
+    "No": "14",
+    "Category": "DataFetching",
+    "Guideline": "Use pick to reduce payload size",
+    "Description": "Select only needed fields from response",
+    "Do": "pick option for large responses",
+    "Don't": "Fetching entire objects when few fields needed",
+    "Code Good": "useFetch('/api/user', { pick: ['id', 'name'] })",
+    "Code Bad": "useFetch('/api/user') then destructure",
+    "Severity": "Low",
+    "Docs URL": "https://nuxt.com/docs/api/composables/use-fetch"
+  },
+  {
+    "No": "15",
+    "Category": "DataFetching",
+    "Guideline": "Use transform for data manipulation",
+    "Description": "Transform data before storing in state",
+    "Do": "transform option for data shaping",
+    "Don't": "Manual transformation after fetch",
+    "Code Good": "useFetch('/api/posts', { transform: (posts) => posts.map(p => p.title) })",
+    "Code Bad": "const titles = data.value.map(p => p.title)",
+    "Severity": "Low",
+    "Docs URL": "https://nuxt.com/docs/api/composables/use-fetch"
+  }
+]