@maz-ui/mcp 4.0.0-beta.28 → 4.0.0-beta.30

package/dist/mcp.mjs

@@ -4,10 +4,12 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { ListResourcesRequestSchema, ReadResourceRequestSchema, ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { existsSync, readFileSync, readdirSync } from 'node:fs';
-import { resolve, join } from 'node:path';
+import { resolve, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 
-const version = "4.0.0-beta.27";
+const version = "4.0.0-beta.29";
 
+const _dirname = dirname(fileURLToPath(import.meta.url));
 class DocumentationService {
   docsRoot;
   componentsDir;
@@ -18,8 +20,8 @@ class DocumentationService {
   pluginsDir;
   helpersDir;
   constructor() {
-    const localDocsRoot = resolve(__dirname, "../docs/src");
-    const localGeneratedDocsDir = resolve(__dirname, "../docs/generated-docs");
+    const localDocsRoot = resolve(_dirname, "../docs/src");
+    const localGeneratedDocsDir = resolve(_dirname, "../docs/generated-docs");
     this.docsRoot = localDocsRoot;
     this.generatedDocsDir = localGeneratedDocsDir;
     this.componentsDir = join(this.docsRoot, "components");

package/docs/src/guide/getting-started.md

@@ -15,13 +15,13 @@ head:
 
 - 🌱 **Tree-shaking improvements** - Import only what you need
 - 🛠️ **TypeScript-first** - Full type safety out of the box
-- 🎨 **Theming system** - Customizable themes and dark mode support (4 presets available)
-- 🌐 **Internationalization** - Locale management and tree-shakable imports
-- 🎨 **Icon library** - Comprehensive collection of SVG icons designed for performance and flexibility
-- 🧰 **Nuxt module** - Effortless Maz-UI integration with auto-imports
 - 🚀 **Performance optimizations** - Tree-shaking benefits and maximum optimization
-- 🛠️ **Enhanced accessibility** - WCAG 2.1 AA compliant
 - 🆕 **New components** - MazPopover & MazSelectCountry
+- 🎨 **Theming system** - Customizable themes and dark mode support (4 presets available) - [@maz-ui/themes](./themes.md)
+- 🌐 **Internationalization** - Locale management and tree-shakable imports - [@maz-ui/translations](./translations.md)
+- 🎨 **Icon library** - Comprehensive collection of SVG icons designed for performance and flexibility (300+ icons) - [@maz-ui/icons](./icons.md)
+- 🧰 **Nuxt module** - Effortless Maz-UI integration with auto-imports - [@maz-ui/nuxt](./nuxt.md)
+- 🤖 **MCP** - Connect your IA agents to the documentation - [@maz-ui/mcp](./mcp.md)
 
 :::
 

package/docs/src/guide/nuxt.md

@@ -1,11 +1,11 @@
 ---
 title: Install maz-ui with Nuxt
-description: The ultimate Nuxt module for Maz-UI - zero-config setup with auto-imports, theming, and powerful features out of the box
+description: The ultimate Nuxt module for Maz-UI - zero-config setup with auto-imports, theming, internationalization and powerful features out of the box
 ---
 
 # {{ $frontmatter.title }}
 
-Transform your Nuxt application with the most comprehensive Vue.js UI library integration. **Maz-UI Nuxt Module** provides zero-configuration setup, intelligent auto-imports, and powerful theming capabilities.
+Transform your Nuxt application with the most comprehensive Vue.js UI library integration. **Maz-UI Nuxt Module** provides zero-configuration setup, intelligent auto-imports, powerful theming capabilities and internationalization.
 
 ## Why Choose Maz-UI for Nuxt?
 
@@ -136,12 +136,12 @@ export default defineNuxtConfig({
       },
     },
 
-    // 🧩 Components
+    // Components
     components: {
       autoImport: true, // All components globally available
     },
 
-    // 🔌 Plugins (not enabled by default)
+    // Plugins (not enabled by default)
     plugins: {
       aos: true,
       dialog: true,
@@ -149,7 +149,7 @@ export default defineNuxtConfig({
       wait: true,
     },
 
-    // 🎪 Composables (enabled by default)
+    // Composables (enabled by default)
     composables: {
       useFormValidator: true,
       useFreezeValue: true,
@@ -160,7 +160,7 @@ export default defineNuxtConfig({
       useStringMatching: false,
     },
 
-    // 🎯 Directives (not enabled by default)
+    // Directives (not enabled by default)
     directives: {
       vTooltip: true,
       vLazyImg: true,
@@ -240,11 +240,68 @@ const theme = {
 }
 ```
 
-**Theme Strategies Explained:**
+## Theme Strategies Explained
 
-- **`hybrid`** (recommended): Critical CSS inlined, full CSS loaded asynchronously
-- **`runtime`**: CSS generated and injected on client-side
-- **`buildtime`**: CSS generated at build time and included in bundle
+### Hybrid (Recommended)
+
+The hybrid strategy combines optimal performance with zero FOUC (Flash of Unstyled Content):
+
+- **Critical CSS injected immediately** - Essential theme variables are inlined on server side to prevent visual flash (on client side if SSR is not enabled)
+- **Full CSS loaded asynchronously** - Complete theme CSS is injected on client side using `requestIdleCallback` with 100ms timeout, avoiding main thread blocking
+- **SSR-optimized** - When SSR is enabled, critical CSS is inlined during server rendering for instant theming
+
+```ts
+export default defineNuxtConfig({
+  mazUi: {
+    theme: {
+      strategy: 'hybrid' // Recommended for most use cases
+    }
+  }
+})
+```
+
+### Runtime
+
+Immediate CSS injection strategy:
+
+- **Critical CSS on server side** - Essential theme variables are injected during SSR
+- **Full CSS on client side** - Complete theme CSS is injected immediately on client-side hydration
+- **⚠️ Performance impact** - Immediate injection can block the main thread during hydration
+
+```ts
+export default defineNuxtConfig({
+  mazUi: {
+    theme: {
+      strategy: 'runtime' // Use when you need immediate full styling
+    }
+  }
+})
+```
+
+### Buildtime
+
+Build-time CSS generation strategy:
+
+- **No runtime injection** - CSS is generated at build time and must be included manually
+- **Consumer responsibility** - You must handle CSS inclusion in your build process and HTML
+- **Optimal performance** - No client-side CSS generation overhead
+- **Static themes only** - Best for applications without dynamic theme switching
+
+```ts
+export default defineNuxtConfig({
+  mazUi: {
+    theme: {
+      strategy: 'buildtime' // For static sites with predefined themes
+    }
+  }
+})
+```
+
+::: info SSR Behavior
+The behavior of `hybrid` and `runtime` strategies depends on your Nuxt SSR configuration:
+- **With SSR**: Critical CSS is injected during server rendering, full CSS handled on client
+- **SPA mode**: All CSS injection happens on client-side as described in the [themes documentation](/guide/themes#rendering-strategies)
+:::
 
 ### Components
 

package/docs/src/guide/themes.md

@@ -9,15 +9,15 @@ description: Modern and performant theme system for Maz-UI with TypeScript, HSL
 
 <NpmBadge package="@maz-ui/themes"></NpmBadge>
 
-## ✨ Features
+## Features
 
-- 🎨 **Modern HSL CSS Variables** - Maximum flexibility with colors
-- 🌓 **Smart Dark Mode** - Automatic support with `prefers-color-scheme`
-- 🚀 **Automatic Generation** - Color scales (50-950) created automatically
-- ⚡ **Performance Strategies** - Runtime, build-time or hybrid according to your needs
-- 🛡️ **Strict TypeScript** - Complete types for perfect DX
-- 🎯 **Zero FOUC** - Critical CSS injected inline to avoid flashes
-- 🔧 **Flexible Presets** - Ready-to-use and customizable configurations
+- **Modern HSL CSS Variables** - Maximum flexibility with colors
+- **Smart Dark Mode** - Automatic support with `prefers-color-scheme`
+- **Automatic Generation** - Color scales (50-950) created automatically
+- **Performance Strategies** - Runtime, build-time or hybrid according to your needs
+- **Strict TypeScript** - Complete types for perfect DX
+- **Zero FOUC** - Critical CSS injected inline to avoid flashes
+- **Flexible Presets** - Ready-to-use and customizable configurations
 
 ## Quick Usage
 
@@ -290,9 +290,11 @@ The hybrid strategy combines the best of both worlds:
 The full CSS is injected via `requestIdleCallback` with a 100ms timeout, allowing the browser to prioritize critical tasks while ensuring fast loading of complete styling.
 
 ```typescript
+import { mazUi } from '@maz-ui/themes/presets'
+
 app.use(MazUi, {
   theme: {
-    preset: 'maz-ui',
+    preset: mazUi,
     strategy: 'hybrid'
   }
 })
@@ -306,9 +308,11 @@ CSS generated (critical and full) injected immediately.
 - **Main thread blocking** - Immediate injection can impact performance
 
 ```typescript
+import { mazUi } from '@maz-ui/themes/presets'
+
 app.use(MazUi, {
   theme: {
-    preset: 'maz-ui',
+    preset: mazUi,
     strategy: 'runtime'
   }
 })
@@ -320,9 +324,11 @@ CSS generated at build-time and included in the bundle.
 Optimal for static sites without theme changes.
 
 ```typescript
+import { mazUi } from '@maz-ui/themes/presets'
+
 app.use(MazUi, {
   theme: {
-    preset: 'maz-ui',
+    preset: mazUi,
     strategy: 'buildtime'
   }
 })

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@maz-ui/mcp",
   "type": "module",
-  "version": "4.0.0-beta.28",
+  "version": "4.0.0-beta.30",
   "description": "Maz-UI ModelContextProtocol Client",
   "author": "Louis Mazel <me@loicmazuel.com>",
   "license": "MIT",
@@ -68,6 +68,7 @@
     "@swc/core": "1.13.3",
     "@types/node": "^24.2.0",
     "@vitest/coverage-v8": "^3.2.4",
+    "docs": "4.0.0-beta.30",
     "eslint": "^9.26.0",
     "lint-staged": "^16.1.4",
     "prettier": "^3.5.3",
@@ -80,5 +81,5 @@
   "lint-staged": {
     "*.{js,ts,mjs,mts,cjs,md,yml,json}": "cross-env NODE_ENV=production eslint --fix"
   },
-  "gitHead": "8e8079bb7ab88530127e9ab875bc77405b87c4fe"
+  "gitHead": "564a15499b7be5e6fe292e836361cff0a0fc68db"
 }