@maz-ui/nuxt 5.0.0 → 5.1.0-beta.0

package/README.md

@@ -209,6 +209,11 @@ export default defineNuxtConfig({
       vFullscreenImg: true,
       vZoomImg: true,
     },
+
+    // AI coding agents (default: { rules: false, mcp: true }, false to disable)
+    // In development, registers the maz-ui MCP server in the configs of the detected agents
+    // (.mcp.json, .cursor/mcp.json, .vscode/mcp.json), rules: true also writes .claude/rules/maz-ui.md and an AGENTS.md section
+    agents: { rules: false, mcp: true },
   },
 })
 ```

package/dist/module.d.mts

@@ -1,4 +1,5 @@
 import * as _nuxt_schema from '@nuxt/schema';
+import { AgentTarget } from '@maz-ui/node';
 import { MazUiThemeOptions, ThemePreset, ThemePresetName } from '@maz-ui/themes';
 import { MazUiTranslationsOptions } from '@maz-ui/translations';
 import { MazUiDefaultsOptions } from 'maz-ui/composables/useGlobalConfig';
@@ -299,6 +300,21 @@ interface MazUiNuxtOptions {
          */
         vTooltip?: boolean | VTooltipOptions;
     };
+    /**
+     * AI coding agents integration
+     * @description Connects the AI coding agents detected in the project (Claude Code, Cursor, GitHub Copilot...) to maz-ui, in development only (never in CI or tests), version-matched with the installed maz-ui, without overwriting files you own.
+     * - `mcp`: registers the maz-ui MCP server in the agent configs (`.mcp.json`, `.cursor/mcp.json`, `.vscode/mcp.json`). Its instructions already give the maz-ui rules to the agents.
+     * - `rules`: also writes the maz-ui rules in `.claude/rules/maz-ui.md` and in a delimited section of `AGENTS.md` (for agents without MCP).
+     * - `targets`: agents to configure (`'claude'`, `'agents-md'`, `'cursor'`, `'vscode'`), default: the detected ones. Nothing is written when no agent is detected.
+     * - `true`: `{ mcp: true, rules: true }`, `false`: disabled
+     * @example `agents: { rules: true }` or `agents: false`
+     * @default { rules: false, mcp: true }
+     */
+    agents?: boolean | {
+        targets?: AgentTarget[];
+        rules?: boolean;
+        mcp?: boolean;
+    };
 }
 
 declare module 'nuxt/schema' {
@@ -309,7 +325,7 @@ declare module 'nuxt/schema' {
         mazUi: MazUiNuxtOptions;
     }
     interface PublicRuntimeConfig {
-        mazUi: Required<MazUiNuxtOptions>;
+        mazUi: Required<Omit<MazUiNuxtOptions, 'agents'>>;
     }
 }
 declare const _default: _nuxt_schema.NuxtModule<MazUiNuxtOptions, MazUiNuxtOptions, false>;

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": ">=3.4.0 <5.0.0"
   },
-  "version": "5.0.0",
+  "version": "5.1.0-beta.0",
   "builder": {
     "@nuxt/module-builder": "1.0.3",
     "unbuild": "unknown"

package/dist/module.mjs

@@ -1,8 +1,11 @@
 import { dirname } from 'node:path';
+import process from 'node:process';
 import { fileURLToPath } from 'node:url';
+import { detectAgentTargets, setupAgents } from '@maz-ui/node';
 import { capitalize } from '@maz-ui/utils/helpers/capitalize';
+import { getErrorMessage } from '@maz-ui/utils/helpers/getErrorMessage';
 import { addCustomTab } from '@nuxt/devtools-kit';
-import { defineNuxtModule, createResolver, addPlugin, addComponent, addImports } from '@nuxt/kit';
+import { defineNuxtModule, createResolver, addPlugin, addComponent, addImports, useLogger } from '@nuxt/kit';
 import { defu } from 'defu';
 
 const COMPONENT_NAMES = {
@@ -155,8 +158,38 @@ const defaults = {
     vClickOutside: false,
     vFullscreenImg: false,
     vTooltip: false
+  },
+  agents: {
+    rules: false,
+    mcp: true
   }
 };
+function syncAgents(agents, nuxt) {
+  if (!agents || !(nuxt.options.dev || nuxt.options._prepare) || process.env.CI || nuxt.options.test) {
+    return;
+  }
+  const logger = useLogger("maz-ui");
+  const isExplicit = nuxt.options.mazUi?.agents !== void 0;
+  try {
+    const { rootDir } = nuxt.options;
+    const { targets: requestedTargets, rules = true, mcp = true } = typeof agents === "object" ? agents : {};
+    const targets = requestedTargets ?? detectAgentTargets(rootDir);
+    if (targets.length === 0 || !rules && !mcp)
+      return;
+    const { changes } = setupAgents({ rootDir, targets, rules, mcp });
+    const applied = changes.filter((change) => ["create", "update", "remove"].includes(change.action));
+    if (applied.length > 0) {
+      const files = applied.map((change) => [change.file, `(${change.action})`].join(" "));
+      logger.info(`AI agents configured for maz-ui: ${files.join(", ")}`);
+    }
+  } catch (error) {
+    const message = `Could not configure the AI agents for maz-ui: ${getErrorMessage(error)}`;
+    if (isExplicit)
+      logger.warn(message);
+    else
+      logger.debug(message);
+  }
+}
 function addMazUiComposableImport({
   name,
   from,
@@ -181,12 +214,13 @@ const module$1 = defineNuxtModule({
   setup(options, nuxt) {
     const { resolve } = createResolver(import.meta.url);
     nuxt.options.build.transpile.push("maz-ui", "@maz-ui/themes", "@maz-ui/translations");
-    const moduleOptions = defu(
+    const { agents, ...moduleOptions } = defu(
       nuxt.options.runtimeConfig.public.mazUi,
       options,
       defaults
     );
     nuxt.options.runtimeConfig.public.mazUi = moduleOptions;
+    syncAgents(agents, nuxt);
     if (moduleOptions.css.injectCss) {
       nuxt.options.css.unshift("maz-ui/style.css");
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@maz-ui/nuxt",
   "type": "module",
-  "version": "5.0.0",
+  "version": "5.1.0-beta.0",
   "description": "Nuxt module for Maz-UI",
   "author": "Louis Mazel <me@loicmazuel.com>",
   "license": "MIT",
@@ -51,13 +51,14 @@
     "nuxt": ">=3.4.0 <5.0.0"
   },
   "dependencies": {
+    "@maz-ui/node": "5.1.0-beta.0",
     "@maz-ui/themes": "5.0.0",
     "@maz-ui/translations": "5.0.0",
     "@maz-ui/utils": "5.0.0",
     "@nuxt/devtools-kit": "^3.4.4",
     "@nuxt/kit": "^4.6.2",
     "defu": "^6.1.7",
-    "maz-ui": "5.0.0"
+    "maz-ui": "5.1.0-beta.0"
   },
   "devDependencies": {
     "@maz-ui/eslint-config": "5.0.0",