@maz-ui/mcp 5.0.0-beta.42 → 5.0.0-beta.46

package/dist/mcp.mjs

@@ -7,7 +7,7 @@ import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
 import { resolve, join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-const version = "5.0.0-beta.42";
+const version = "5.0.0-beta.44";
 
 class MetadataExtractor {
   extract(name, type, content, manualTags = []) {

package/docs/src/components/maz-checklist.md

@@ -163,25 +163,25 @@ You can replace the default search function by providing a custom search functio
       :search-function="customEmployeeSearch"
       color="success"
       elevation
-      class="max-h-96"
+      class="maz:max-h-96"
     >
       <template #item="{ item }">
-        <div class="flex w-full items-center gap-4">
-          <div class="flex h-12 w-12 flex-none items-center justify-center rounded-full bg-gradient-to-br from-primary-500 to-secondary-500 text-white font-semibold text-lg">
+        <div class="maz:flex maz:w-full maz:items-center maz:gap-4">
+          <div class="maz:flex maz:h-12 maz:w-12 maz:flex-none maz:items-center maz:justify-center maz:rounded-full maz:bg-linear-to-br maz:from-primary-500 maz:to-secondary-500 maz:text-white maz:font-semibold maz:text-lg">
             {{ item.initials }}
           </div>
-          <div class="flex flex-1 flex-col gap-1">
-            <div class="flex items-center gap-2">
-              <span class="font-semibold text-normal">{{ item.label }}</span>
+          <div class="maz:flex maz:flex-1 maz:flex-col maz:gap-1">
+            <div class="maz:flex maz:items-center maz:gap-2">
+              <span class="maz:font-semibold maz:text-normal">{{ item.label }}</span>
               <MazBadge :color="item.departmentColor" size="xs">
                 {{ item.department }}
               </MazBadge>
             </div>
-            <span class="text-muted text-sm">{{ item.email }}</span>
+            <span class="maz:text-muted maz:text-sm">{{ item.email }}</span>
           </div>
-          <div class="flex flex-none items-center gap-1">
-            <MazIcon icon="/star.svg" class="text-warning-500" size="1rem" />
-            <span class="text-sm font-medium">{{ item.rating }}</span>
+          <div class="maz:flex maz:flex-none maz:items-center maz:gap-1">
+            <MazIcon icon="/star.svg" class="maz:text-warning-500" size="1rem" />
+            <span class="maz:text-sm maz:font-medium">{{ item.rating }}</span>
           </div>
         </div>
       </template>

package/docs/src/components/maz-sidebar.md

@@ -22,19 +22,19 @@ The following features are planned for a future release and are **not yet availa
 
 ## Sub-components
 
-| Component | Role |
-|---|---|
-| `MazSidebar` | Root container — provides state context |
-| `MazSidebarHeader` | Fixed top area |
-| `MazSidebarContent` | Scrollable central area |
-| `MazSidebarFooter` | Fixed bottom area |
-| `MazSidebarGroup` | Item grouping with optional label |
-| `MazSidebarSeparator` | Visual divider (`<hr>`) |
-| `MazSidebarMenu` | `<ul>` wrapper with `role="menu"` |
-| `MazSidebarMenuItem` | `<li>` item wrapper |
+| Component              | Role                                                                  |
+| ---------------------- | --------------------------------------------------------------------- |
+| `MazSidebar`           | Root container — provides state context                               |
+| `MazSidebarHeader`     | Fixed top area                                                        |
+| `MazSidebarContent`    | Scrollable central area                                               |
+| `MazSidebarFooter`     | Fixed bottom area                                                     |
+| `MazSidebarGroup`      | Item grouping with optional label                                     |
+| `MazSidebarSeparator`  | Visual divider (`<hr>`)                                               |
+| `MazSidebarMenu`       | `<ul>` wrapper with `role="menu"`                                     |
+| `MazSidebarMenuItem`   | `<li>` item wrapper                                                   |
 | `MazSidebarMenuButton` | Clickable item (link or button), supports icon, label, badge, tooltip |
-| `MazSidebarMenuSub` | Collapsible sub-menu |
-| `MazSidebarTrigger` | Toggle button (must be a descendant of `MazSidebar`) |
+| `MazSidebarMenuSub`    | Collapsible sub-menu                                                  |
+| `MazSidebarTrigger`    | Toggle button (must be a descendant of `MazSidebar`)                  |
 
 ## Basic usage
 

package/docs/src/guide/migration-v5.md

@@ -54,11 +54,11 @@ For Cursor, Windsurf, VS Code Copilot, Cline and Claude Desktop, see the [MCP gu
 
 3. **Apply the easy ones in batch.** The mechanical renames are safe to automate:
 
-   > Apply the codemod for sections 2, 3, 6 and 14 (CSS subpath, `rounded-size="base"`, `left-icon`/`right-icon`, Nuxt `injectMainCss`). Show me a diff before saving.
+   > Apply the codemod for "Required changes" sections 2, 3, 6 and 14 (CSS subpath, `rounded-size="base"`, `left-icon`/`right-icon`, Nuxt `injectMainCss`). Show me a diff before saving.
 
 4. **Discuss the judgment calls.** For sections that have more than a rename — `MazIcon` API, `MazChart` `update-mode`, theme preset reshape — let the assistant ask before rewriting:
 
-   > For sections 4, 8 and 10–12, do not patch automatically. Tell me which of my call sites are affected and propose options.
+   > For "Required changes" sections 4, 8 and 10–12, do not patch automatically. Tell me which of my call sites are affected and propose options.
 
 5. **Verify.** After patches:
 
@@ -84,7 +84,9 @@ The MCP server is read-only — it ships docs, not code edits — so the assista
 7. Rename **`left-icon` / `right-icon`** to **`start-icon` / `end-icon`** (and the matching slots / `--has-*-icon` classes) on `MazBtn`, `MazInput`, `MazLink`, `MazContainer`, `MazSelect`. Same idea for `MazCard`'s `footer-align` and `MazDrawer`'s `variant` — `'left' | 'right'` becomes `'start' | 'end'`.
 8. **`MazChart`** drops `vue-chartjs` (lighter bundle, no eager registration of unused chart types). The `update-mode` prop now defaults to `'none'` — pass `update-mode="default"` if you want animated data updates.
 9. **`MazAvatar` size scale fixed.** A CSS-unit `size` now renders at its real value (`size="2rem"` is a 32px avatar, it was ~96px before). Multiply your unit values by 3 to keep the same render, or switch to a `MazSize` keyword (`'mini' | 'xs' | 'sm' | 'md' | 'lg' | 'xl'`). The upgrade tool does the ×3 rewrite for you on static values.
-10. That's it for most apps. Everything else is opt-in.
+10. Rename **`MazPullToRefresh`**'s `on-click` prop to `on-refresh` (handled by the upgrade tool).
+11. Replace bare **`from 'maz-ui'`** utility imports with **`from '@maz-ui/utils'`** (the root re-export of utils was removed; handled by the upgrade tool). Components/composables/directives/plugins stay on their subpaths; types remain importable from `maz-ui`.
+12. That's it for most apps. Everything else is opt-in.
 
 ## Prerequisites
 
@@ -597,6 +599,49 @@ The upgrade tool rewrites static `size="<unit>"` values on `<MazAvatar>` automat
 rg "<MazAvatar[^>]*\bsize=" src/
 ```
 
+### 17. `MazPullToRefresh` — `on-click` → `on-refresh`
+
+The callback prop of `MazPullToRefresh` was renamed from `on-click` to `on-refresh` to reflect what it actually does: it runs when the refresh is triggered on release, not on a click.
+
+```vue
+<!-- v4 -->
+<MazPullToRefresh :on-click="fetchData" />
+
+<!-- v5 -->
+<MazPullToRefresh :on-refresh="fetchData" />
+```
+
+The upgrade tool rewrites this automatically on `<MazPullToRefresh>` tags (both `on-click` and `onClick`, bound or static).
+
+```bash
+# Find usages to update
+rg "<MazPullToRefresh[^>]*\bon-?[Cc]lick" src/
+```
+
+### 18. Root `maz-ui` import removed for utilities
+
+In v4, the bare `maz-ui` entry re-exported `@maz-ui/utils`, so you could write `import { sleep } from 'maz-ui'`. In v5 that root re-export is gone — import helpers from their package directly:
+
+```ts
+// v4
+import { sleep, formatDate } from 'maz-ui'
+
+// v5
+import { sleep, formatDate } from '@maz-ui/utils'
+```
+
+Components, composables, directives and plugins were **already** subpath-only in v4 (`maz-ui/components/MazBtn`, `maz-ui/composables/useToast`, …) and are unchanged. The upgrade tool rewrites the utility imports for you.
+
+The `maz-ui` root now exposes **types only** (zero runtime cost), so shared types stay importable from the short path:
+
+```ts
+import type { MazColor, MazSize } from 'maz-ui'
+```
+
+### 19. ESM-only
+
+`maz-ui` and its `@maz-ui/*` packages ship **ESM only** (no CommonJS build). This was already the case in v4, but if you consume the library from a CommonJS context (old Jest without ESM, `require()`), use a bundler/test runner with ESM support (Vitest, Jest ≥ 29 with ESM, or native `import`).
+
 ## Informational changes (probably no action needed)
 
 ### Theme colors are now emitted as OKLCh

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@maz-ui/mcp",
   "type": "module",
-  "version": "5.0.0-beta.42",
+  "version": "5.0.0-beta.46",
   "description": "Maz-UI ModelContextProtocol Client",
   "author": "Louis Mazel <me@loicmazuel.com>",
   "license": "MIT",
@@ -41,19 +41,19 @@
     "docs"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "@maz-ui/utils": "5.0.0-beta.39",
-    "maz-ui": "5.0.0-beta.42"
+    "@maz-ui/utils": "5.0.0-beta.46",
+    "@modelcontextprotocol/sdk": "^1.30.1",
+    "maz-ui": "5.0.0-beta.46"
   },
   "devDependencies": {
-    "@modelcontextprotocol/inspector": "^0.21.2",
-    "@swc/core": "1.15.40",
-    "prettier": "^3.8.4",
+    "@maz-ui/eslint-config": "5.0.0-beta.44",
+    "@maz-ui/node": "5.0.0-beta.44",
+    "@modelcontextprotocol/inspector": "^2.8.0",
+    "@swc/core": "1.16.2",
+    "prettier": "^3.9.9",
     "ts-node-maintained": "^10.9.5",
-    "tsx": "^4.22.3",
-    "unbuild": "^3.6.1",
-    "@maz-ui/eslint-config": "5.0.0-beta.39",
-    "@maz-ui/node": "5.0.0-beta.26"
+    "tsx": "^4.23.15",
+    "unbuild": "^3.6.1"
   },
   "lint-staged": {
     "*.{js,ts,mjs,mts,cjs,md,yml,json}": "cross-env NODE_ENV=production eslint --fix"