@maz-ui/vite-plugin 0.0.0-stage → 5.7.0-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 LouisMazel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,46 @@
-# Temporary Holding Version
+# @maz-ui/vite-plugin
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Vite plugins for [Maz-UI](https://maz-ui.com). The first one, `MazUiPurgeCss`, removes from the CSS of maz-ui (`maz-ui/style.css`, `maz-ui/utilities.css`) the rules of the components, plugins, directives and utilities your app does not use. It runs at build time only.
+
+With `@maz-ui/nuxt`, the module adds it for you (`css.purge`).
+
+## Installation
+
+```bash
+npm install -D @maz-ui/vite-plugin
+```
+
+Requires `vite >=6 <9` and `maz-ui >= 5.7.0`.
+
+## Usage
+
+```ts
+import { MazUiPurgeCss } from '@maz-ui/vite-plugin'
+// vite.config.ts
+import vue from '@vitejs/plugin-vue'
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    MazUiPurgeCss()
+  ],
+})
+```
+
+## Options
+
+| Option     | Description                                                                                                                   |
+| ---------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `content`  | Globs of the files that use maz-ui, relative to the project root (a package of your monorepo, a dependency in `node_modules`) |
+| `entries`  | Entries of maz-ui to keep: `MazBtn`, `vTooltip`, `plugins/toast`...                                                           |
+| `safelist` | Classes to keep: `maz:` classes or public utilities (`text-title-1`, `/^rich-text/`)                                          |
+| `report`   | Print the CSS saved by the purge (default: `true`)                                                                            |
+
+## Documentation
+
+https://maz-ui.com/ecosystem/vite-plugin
+
+## License
+
+MIT

package/agent-docs/README.md

@@ -0,0 +1,12 @@
+# @maz-ui/vite-plugin documentation for AI agents
+
+> Vite plugin that removes from the CSS of maz-ui the rules of the components, plugins, directives and utilities the app does not use (build only).
+
+These files document the **installed** version of @maz-ui/vite-plugin. Prefer them over what you remember from training data: APIs change between versions.
+
+- Rules for the whole ecosystem: `node_modules/maz-ui/agent-docs/rules.md` when maz-ui is installed.
+- `manifest.json` describes every page (symbols, imports, aliases).
+
+## Ecosystem packages
+
+- [Vite plugin](ecosystem/vite-plugin.md): @maz-ui/vite-plugin removes from the CSS of maz-ui the rules of the components, plugins, directives and utilities your app does not use, at build time.

package/agent-docs/ecosystem/vite-plugin.md

@@ -0,0 +1,167 @@
+---
+title: "Vite plugin"
+description: "@maz-ui/vite-plugin removes from the CSS of maz-ui the rules of the components, plugins, directives and utilities your app does not use, at build time."
+package: "@maz-ui/vite-plugin"
+url: "https://maz-ui.com/ecosystem/vite-plugin"
+---
+
+# Vite plugin
+
+> @maz-ui/vite-plugin removes from the CSS of maz-ui the rules of the components, plugins, directives and utilities your app does not use, at build time.
+
+- Package: `@maz-ui/vite-plugin`
+- Import: `import { MazUiPurgeCss } from '@maz-ui/vite-plugin'`
+- Web: https://maz-ui.com/ecosystem/vite-plugin
+
+`maz-ui/style.css` holds the styles of every component. Most apps use a few of them: the plugin keeps the rules of what your code uses and removes the rest, in the CSS of your production build. It is the first plugin of the package, others may come.
+
+**Tip: Nuxt**
+
+With `@maz-ui/nuxt`, you do not install anything: the module adds the plugin for you, see [`css.purge`](https://maz-ui.com/ecosystem/nuxt.md#css-configuration).
+
+## Installation
+
+For Vue apps built with Vite (`vite >=6 <9`):
+
+```bash [pnpm]
+pnpm add -D @maz-ui/vite-plugin
+```
+
+```bash [npm]
+npm install -D @maz-ui/vite-plugin
+```
+
+```bash [yarn]
+yarn add -D @maz-ui/vite-plugin
+```
+
+It requires `maz-ui >= 5.7.0`, which ships the manifest the plugin reads. Keep both on the same version.
+
+## Usage
+
+```ts
+// vite.config.ts
+import vue from '@vitejs/plugin-vue'
+import { MazUiPurgeCss } from '@maz-ui/vite-plugin'
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    MazUiPurgeCss(),
+  ],
+})
+```
+
+Keep importing `maz-ui/style.css` as usual. The build prints a report:
+
+```txt
+[maz-ui:purge-css] 86.9 kB -> 32.8 kB of maz-ui CSS (-62%, 412 unused classes removed)
+```
+
+## How it works
+
+1. At the build of maz-ui, `dist/css/purge-manifest.json` lists every class of `style.css`, the public utilities, and for each entry (`components/MazBtn`, `plugins/toast`, `directives/vTooltip`...) the classes it renders, with the entries it imports.
+2. In your build, the plugin scans the source files of the project and finds the entries you use by their names: `MazBtn`, `<maz-btn>`, `LazyMazBtn`, `useToast`, `v-tooltip`, `ToastPlugin`... A namespace import of a barrel (`import * as components from 'maz-ui/components'`) keeps every component. It also finds the public utilities used (`text-title-1`, `padded-container`...).
+3. When Vite transforms a CSS file, the plugin removes the rules of the unused entries and utilities, before the hash of the asset is computed, so the cache stays correct. It also removes the classes of `main.css` that no component renders.
+4. At the end of the build, it checks the final JS and HTML: a purged class found there prints a warning, see Bundle check.
+
+The plugin only touches the CSS of maz-ui. The CSS of your own app is never modified.
+
+## Gains
+
+Measured with `vite build`, the maz-ui preset, on the CSS assets of the app. Every Vue app imports `maz-ui/style.css`.
+
+| App | Without purge | With purge | Saved |
+| --- | --- | --- | --- |
+| Landing (MazBtn, MazCard, MazBadge, MazAvatar, MazAccordion) | 103.2 kB (15.6 kB gzip) | 49.1 kB (8.8 kB gzip) | -52% |
+| Sign in (MazInput, MazCheckbox, MazBtn, MazCard, MazLink, toast plugin) | 108.3 kB (16.0 kB gzip) | 64.7 kB (10.1 kB gzip) | -40% |
+| Dashboard (MazTable, MazSelect, MazDatePicker, MazDialog, MazSidebar, MazTabs, MazDropdown, MazSwitch, toast, dialog, vTooltip...) | 156.1 kB (24.2 kB gzip) | 119.5 kB (19.4 kB gzip) | -23% |
+| No Tailwind, with `maz-ui/utilities.css` (padded-container, text-display, rich-text, MazBtn, MazCard) | 118.8 kB (16.9 kB gzip) | 50.9 kB (8.4 kB gzip) | -57% |
+| Every component | 212.0 kB (29.8 kB gzip) | 195.7 kB (28.0 kB gzip) | -8% |
+
+The `style.css` of maz-ui alone goes from 86.9 kB to 32.8 kB (landing), 43.8 kB (sign in) and 50.3 kB (dashboard).
+
+With Nuxt (2 pages using MazBtn, MazCard, MazBadge, LazyMazAccordion, MazInput, MazCheckbox, the toast plugin and vTooltip, `nuxi generate`), the CSS files go from 122.3 kB (21.0 kB gzip) to 78.6 kB (14.8 kB gzip) with the default `css.purge: true`, which is -36%.
+
+**Warning: The numbers depend on your app**
+
+They come from the demo apps above and this setup (preset, Tailwind or not, components used). The more components you use, the smaller the gain.
+
+## Options
+
+All options are optional.
+
+| Option | Type | Description |
+| --- | --- | --- |
+| `content` | `string[]` | Globs of the files that use maz-ui, relative to the root of the project. Added to the defaults |
+| `entries` | `string[]` | Entries of maz-ui to keep even if the plugin does not find them in the code: a component (`MazBtn`), a directive (`vTooltip`), a plugin (`plugins/toast`) |
+| `safelist` | `(string \| RegExp)[]` | Classes to keep: `maz:` classes of the components or public utilities (`text-title-1`, `/^rich-text/`) |
+| `report` | `boolean` | Print the CSS saved by the purge (default: `true`) |
+
+By default, the plugin scans every source file of the project (`vue`, `js`, `jsx`, `ts`, `tsx`, `html`, `md`, `mdx`, `astro`, `svelte`...), and ignores `node_modules`, `dist`, `.output`, `.nuxt`, `coverage` and `.d.ts` files.
+
+### Monorepo
+
+When your app uses components written in another package of the monorepo, add its sources:
+
+```ts
+MazUiPurgeCss({
+  content: ['../../packages/ui/src/**/*.vue'],
+})
+```
+
+### Dependency built on maz-ui
+
+The default scan ignores `node_modules`, the globs of `content` do not: add the files of a dependency that renders maz-ui components (a design system of your company), or list the entries it uses with `entries`:
+
+```ts
+MazUiPurgeCss({
+  content: ['node_modules/@acme/ui/dist/**/*.js'],
+  // or
+  entries: ['MazBtn', 'MazDialog', 'plugins/toast', 'vTooltip'],
+})
+```
+
+### Names built at runtime
+
+A component resolved from a dynamic name, or a class that only appears in HTML loaded at runtime (a CMS, an API), is not found in the source. Keep it explicitly:
+
+```ts
+MazUiPurgeCss({
+  entries: ['MazBtn', 'MazCard'],
+  safelist: ['text-title-1', /^rich-text/],
+})
+```
+
+## Bundle check
+
+At the end of the build, the plugin looks for the purged classes in the final JS and HTML. If one is found, a component of maz-ui is used by a file the plugin does not scan (a dependency, a package of your monorepo), and the build warns:
+
+```txt
+[maz-ui:purge-css] 3 purged classes are in the bundle: rounded-lg, flex, p-4
+A component of maz-ui is probably used by a file the plugin does not scan (a dependency, a package of your monorepo).
+Add its files to the `content` option, or the component to `entries`.
+```
+
+Fix it with `content` (the files that use the component) or `entries`, then rebuild.
+
+## Projects without Tailwind
+
+`maz-ui/utilities.css` contains the public utilities of maz-ui without prefix: the `text-*` and `type-*` type scale, `rich-text`, `padded-container`, `flex-center`, `glass`, `scrollbar-themed`, `disabled-*`, `cursor-interactive`, `cap-f` and `z-default-backdrop`. It weighs 19.7 kB (2.6 kB gzip) and the plugin purges it like `style.css`.
+
+```ts
+import 'maz-ui/style.css'
+import 'maz-ui/utilities.css'
+```
+
+**Warning: With Tailwind CSS**
+
+Keep `@import 'maz-ui/tailwindcss/utilities.css'` in your Tailwind entry and do not import `maz-ui/utilities.css`: you would get duplicates, and no variants (`hover:`, `tab-m:`...). See [Tailwind CSS](https://maz-ui.com/guide/tailwind.md).
+
+## Limitations
+
+- Vite only for now (no webpack, Rollup alone or other bundlers).
+- Build only: the dev server keeps the whole CSS.
+- Entries are found by name in the files of the project: names built at runtime need `entries` or `safelist`.
+- Only the CSS of maz-ui is purged, not the CSS of your app.

package/agent-docs/manifest.json

@@ -0,0 +1 @@
+{"schemaVersion":2,"package":"@maz-ui/vite-plugin","version":"5.7.0-beta.2","description":"Vite plugin that removes from the CSS of maz-ui the rules of the components, plugins, directives and utilities the app does not use (build only).","homepage":"https://maz-ui.com/ecosystem/vite-plugin","group":"ecosystem","docs":[{"id":"ecosystem/vite-plugin","category":"ecosystem","slug":"vite-plugin","title":"Vite plugin","description":"@maz-ui/vite-plugin removes from the CSS of maz-ui the rules of the components, plugins, directives and utilities your app does not use, at build time.","package":"@maz-ui/vite-plugin","file":"ecosystem/vite-plugin.md","url":"https://maz-ui.com/ecosystem/vite-plugin","symbols":["MazUiPurgeCss"],"imports":["import { MazUiPurgeCss } from '@maz-ui/vite-plugin'"],"aliases":["vite plugin","purge css","purgecss","unused css","css size","reduce css","tree shaking css","bundle size","smaller css","mazuipurgecss"],"headings":["Installation","Usage","How it works","Gains","Options","Monorepo","Dependency built on maz-ui","Names built at runtime","Bundle check","Projects without Tailwind","Limitations"],"related":["ecosystem/nuxt","guide/vue"],"chars":7695}],"components":[]}

package/dist/index.d.mts

@@ -0,0 +1,30 @@
+import { Plugin } from 'vite';
+
+interface MazUiPurgeCssOptions {
+    /**
+     * Globs of the files that use maz-ui, relative to the root of the project. The defaults scan every source file of
+     * the project (`node_modules`, `dist` and the build folders excluded). Add the files of a package of your monorepo,
+     * or of a dependency built on maz-ui: these globs can target `node_modules`.
+     */
+    content?: string[];
+    /**
+     * Entries of maz-ui to keep even if the plugin does not find them in the code: a component (`MazBtn`), a directive
+     * (`vTooltip`), a plugin (`plugins/toast`)...
+     */
+    entries?: string[];
+    /** Classes to keep, `maz:` classes of the components or public utilities (`text-title-1`, `/^rich-text/`) */
+    safelist?: (string | RegExp)[];
+    /**
+     * Print the CSS saved by the purge
+     * @default true
+     */
+    report?: boolean;
+}
+/**
+ * Remove from the CSS of maz-ui (`maz-ui/style.css`, `maz-ui/utilities.css`) the rules of the components, directives,
+ * plugins and utilities the app does not use. It runs at build time only: the dev server keeps the whole CSS.
+ */
+declare function MazUiPurgeCss(options?: MazUiPurgeCssOptions): Plugin;
+
+export { MazUiPurgeCss };
+export type { MazUiPurgeCssOptions };

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import { Plugin } from 'vite';
+
+interface MazUiPurgeCssOptions {
+    /**
+     * Globs of the files that use maz-ui, relative to the root of the project. The defaults scan every source file of
+     * the project (`node_modules`, `dist` and the build folders excluded). Add the files of a package of your monorepo,
+     * or of a dependency built on maz-ui: these globs can target `node_modules`.
+     */
+    content?: string[];
+    /**
+     * Entries of maz-ui to keep even if the plugin does not find them in the code: a component (`MazBtn`), a directive
+     * (`vTooltip`), a plugin (`plugins/toast`)...
+     */
+    entries?: string[];
+    /** Classes to keep, `maz:` classes of the components or public utilities (`text-title-1`, `/^rich-text/`) */
+    safelist?: (string | RegExp)[];
+    /**
+     * Print the CSS saved by the purge
+     * @default true
+     */
+    report?: boolean;
+}
+/**
+ * Remove from the CSS of maz-ui (`maz-ui/style.css`, `maz-ui/utilities.css`) the rules of the components, directives,
+ * plugins and utilities the app does not use. It runs at build time only: the dev server keeps the whole CSS.
+ */
+declare function MazUiPurgeCss(options?: MazUiPurgeCssOptions): Plugin;
+
+export { MazUiPurgeCss };
+export type { MazUiPurgeCssOptions };

package/dist/index.mjs

@@ -0,0 +1,220 @@
+import { isAbsolute, relative } from 'node:path';
+import { s as splitSelectorList, a as getRequiredClasses, c as containsName, b as containsToken, l as loadPurgeManifest } from './shared/vite-plugin.Ce6HCqgJ.mjs';
+import postcss from 'postcss';
+import { readFile } from 'node:fs/promises';
+import { glob } from 'tinyglobby';
+import 'node:fs';
+import 'node:module';
+
+const PUBLIC_UTILITIES_LAYER = "maz";
+function isInPublicLayer(rule) {
+  let node = rule.parent;
+  while (node && node.type !== "root") {
+    if (node.type === "atrule" && node.name === "layer" && node.params.trim() === PUBLIC_UTILITIES_LAYER)
+      return true;
+    node = node.parent;
+  }
+  return false;
+}
+function isInKeyframes(rule) {
+  return rule.parent?.type === "atrule" && /keyframes$/i.test(rule.parent.name);
+}
+function removeEmptyAtRules(container) {
+  for (const node of [...container.nodes]) {
+    if (node.type !== "atrule" || !node.nodes)
+      continue;
+    removeEmptyAtRules(node);
+    if (node.nodes.length === 0)
+      node.remove();
+  }
+}
+function purgeCss(css, decision) {
+  const root = postcss.parse(css);
+  const removed = /* @__PURE__ */ new Set();
+  let changed = false;
+  root.walkRules((rule) => {
+    if (isInKeyframes(rule))
+      return;
+    const inPublicLayer = isInPublicLayer(rule);
+    const selectors = splitSelectorList(rule.selector);
+    const kept = selectors.filter((selector) => {
+      const unused = getRequiredClasses(selector).filter((className) => decision.isManaged(className, inPublicLayer) && !decision.isUsed(className));
+      for (const className of unused)
+        removed.add(className);
+      return unused.length === 0;
+    });
+    if (kept.length === selectors.length)
+      return;
+    changed = true;
+    if (kept.length === 0)
+      rule.remove();
+    else
+      rule.selector = kept.join(",");
+  });
+  if (!changed)
+    return { css, removed };
+  removeEmptyAtRules(root);
+  root.raws.semicolon = true;
+  return {
+    css: root.toString(),
+    removed
+  };
+}
+
+const DEFAULT_CONTENT = ["**/*.{vue,js,jsx,mjs,cjs,ts,tsx,mts,cts,html,md,mdx,astro,svelte}"];
+const DEFAULT_IGNORE = [
+  "**/node_modules/**",
+  "**/dist/**",
+  "**/.output/**",
+  "**/.nuxt/**",
+  "**/.vercel/**",
+  "**/.netlify/**",
+  "**/.git/**",
+  "**/.vite/**",
+  "**/.vitepress/cache/**",
+  "**/.vitepress/dist/**",
+  "**/coverage/**",
+  "**/*.d.ts"
+];
+const NAMESPACE_IMPORT = /import\s*\*\s*as\s+[\w$]+\s+from\s*["']maz-ui\/(components|composables|directives|plugins)["']/g;
+async function readContent(root, content, ignore = DEFAULT_IGNORE) {
+  if (content.length === 0)
+    return "";
+  const files = await glob(content, {
+    cwd: root,
+    absolute: true,
+    ignore,
+    dot: false
+  });
+  const sources = await Promise.all(files.map((file) => readFile(file, "utf8").catch(() => "")));
+  return sources.join("\n");
+}
+function matchesEntry(key, aliases, wanted) {
+  return key === wanted || key.endsWith(`/${wanted}`) || aliases.includes(wanted);
+}
+function resolveUsage(manifest, source, options) {
+  const entries = /* @__PURE__ */ new Set();
+  const namespaces = new Set([
+    ...source.matchAll(NAMESPACE_IMPORT)
+  ].map((match) => match[1]));
+  for (const [key, { aliases }] of Object.entries(manifest.entries)) {
+    const directory = key.split("/")[0];
+    if (namespaces.has(directory) || options.entries.some((wanted) => matchesEntry(key, aliases, wanted)) || aliases.some((alias) => containsName(source, alias))) {
+      entries.add(key);
+    }
+  }
+  const classes = /* @__PURE__ */ new Set();
+  for (const key of entries) {
+    for (const index of manifest.entries[key].classes)
+      classes.add(manifest.classes[index]);
+  }
+  for (const utility of manifest.utilities) {
+    if (containsToken(source, utility))
+      classes.add(utility);
+  }
+  const patterns = options.safelist.filter((item) => item instanceof RegExp);
+  const names = new Set(options.safelist.filter((item) => typeof item === "string"));
+  for (const className of [
+    ...manifest.classes,
+    ...manifest.utilities
+  ]) {
+    if (names.has(className) || patterns.some((pattern) => {
+      pattern.lastIndex = 0;
+      return pattern.test(className);
+    })) {
+      classes.add(className);
+    }
+  }
+  return { entries, classes };
+}
+
+const CSS_REQUEST = /\.(?:css|scss|sass|less|styl|stylus|pcss|postcss|sss)(?:$|\?)|[?&]lang\.css/;
+const MANAGED_CLASS_MARKER = "maz\\:";
+const BYTES_PER_KB = 1024;
+function formatSize(bytes) {
+  return `${(bytes / BYTES_PER_KB).toFixed(1)} kB`;
+}
+function MazUiPurgeCss(options = {}) {
+  const { content = [], entries = [], safelist = [], report = true } = options;
+  let config;
+  let manifest;
+  let usage;
+  const removed = /* @__PURE__ */ new Set();
+  const sizes = /* @__PURE__ */ new Map();
+  let manifestClasses = /* @__PURE__ */ new Set();
+  let manifestUtilities = /* @__PURE__ */ new Set();
+  function isManaged(className, inPublicLayer) {
+    if (className.startsWith("maz:"))
+      return manifestClasses.has(className);
+    return inPublicLayer && manifestUtilities.has(className);
+  }
+  return {
+    name: "maz-ui:purge-css",
+    apply: "build",
+    configResolved(resolvedConfig) {
+      config = resolvedConfig;
+      manifest = loadPurgeManifest(config.root);
+      if (!manifest) {
+        config.logger.warn("[maz-ui:purge-css] maz-ui/purge-manifest.json not found: the CSS of maz-ui is not purged (maz-ui >= 5.7.0 is required)");
+        return;
+      }
+      manifestClasses = new Set(manifest.classes);
+      manifestUtilities = new Set(manifest.utilities);
+    },
+    buildStart() {
+      if (!manifest)
+        return;
+      const loadedManifest = manifest;
+      const extraContent = content.map((glob) => isAbsolute(glob) ? relative(config.root, glob) : glob);
+      usage = Promise.all([
+        readContent(config.root, DEFAULT_CONTENT),
+        readContent(config.root, extraContent, [])
+      ]).then((sources) => resolveUsage(loadedManifest, sources.join("\n"), { entries, safelist }));
+    },
+    async transform(code, id) {
+      if (!usage || !CSS_REQUEST.test(id))
+        return;
+      const hasManagedClasses = code.includes(MANAGED_CLASS_MARKER) || code.includes(`@layer ${PUBLIC_UTILITIES_LAYER}`);
+      if (!hasManagedClasses)
+        return;
+      const { classes } = await usage;
+      const result = purgeCss(code, {
+        isManaged,
+        isUsed: (className) => classes.has(className)
+      });
+      if (result.css === code)
+        return;
+      for (const className of result.removed)
+        removed.add(className);
+      sizes.set(id.split("?")[0], { before: code.length, after: result.css.length });
+      return { code: result.css, map: null };
+    },
+    generateBundle(_, bundle) {
+      if (removed.size === 0)
+        return;
+      const output = Object.values(bundle).map((file) => file.type === "chunk" ? file.code : typeof file.source === "string" ? file.source : "").join("\n");
+      const missing = [...removed].filter((className) => containsToken(output, className));
+      if (missing.length > 0) {
+        config.logger.warn([
+          `[maz-ui:purge-css] ${missing.length} purged classes are in the bundle: ${missing.slice(0, 10).join(", ")}${missing.length > 10 ? "..." : ""}`,
+          "A component of maz-ui is probably used by a file the plugin does not scan (a dependency, a package of your monorepo).",
+          "Add its files to the `content` option, or the component to `entries`."
+        ].join("\n"));
+      }
+    },
+    closeBundle() {
+      if (!report || sizes.size === 0 || config.build.ssr)
+        return;
+      const before = [
+        ...sizes.values()
+      ].reduce((total, size) => total + size.before, 0);
+      const after = [
+        ...sizes.values()
+      ].reduce((total, size) => total + size.after, 0);
+      const ratio = Math.round((before - after) / before * 100);
+      config.logger.info(`[maz-ui:purge-css] ${formatSize(before)} -> ${formatSize(after)} of maz-ui CSS (-${ratio}%, ${removed.size} unused classes removed)`);
+    }
+  };
+}
+
+export { MazUiPurgeCss };

package/dist/manifest.d.mts

@@ -0,0 +1,26 @@
+declare const PURGE_MANIFEST_FILE = "purge-manifest.json";
+interface PurgeManifestEntry {
+    /** Names that reveal the entry in the source code: `MazBtn`, `maz-btn`, `useToast`, `v-tooltip`... */
+    aliases: string[];
+    /** Indexes in `classes` of the classes the entry renders, with the entries it imports */
+    classes: number[];
+}
+interface PurgeManifest {
+    version: string;
+    /** Every `maz:` class of `maz-ui/style.css` */
+    classes: string[];
+    /** The public utilities of `maz-ui/utilities.css` (`text-title-1`, `padded-container`...) */
+    utilities: string[];
+    /** Keyed by the path of the entry in `maz-ui` (`components/MazBtn`, `plugins/toast`) */
+    entries: Record<string, PurgeManifestEntry>;
+}
+/**
+ * Write `dist/css/purge-manifest.json` in the build of `maz-ui`: the `maz:` classes of `style.css`, the public
+ * utilities of `utilities.css`, and for every entry the classes it renders with the modules it imports.
+ */
+declare function generatePurgeManifest(distDir: string, version: string): PurgeManifest;
+/** Read the manifest of the `maz-ui` installed in the project */
+declare function loadPurgeManifest(root: string): PurgeManifest | undefined;
+
+export { PURGE_MANIFEST_FILE, generatePurgeManifest, loadPurgeManifest };
+export type { PurgeManifest, PurgeManifestEntry };

package/dist/manifest.d.ts

@@ -0,0 +1,26 @@
+declare const PURGE_MANIFEST_FILE = "purge-manifest.json";
+interface PurgeManifestEntry {
+    /** Names that reveal the entry in the source code: `MazBtn`, `maz-btn`, `useToast`, `v-tooltip`... */
+    aliases: string[];
+    /** Indexes in `classes` of the classes the entry renders, with the entries it imports */
+    classes: number[];
+}
+interface PurgeManifest {
+    version: string;
+    /** Every `maz:` class of `maz-ui/style.css` */
+    classes: string[];
+    /** The public utilities of `maz-ui/utilities.css` (`text-title-1`, `padded-container`...) */
+    utilities: string[];
+    /** Keyed by the path of the entry in `maz-ui` (`components/MazBtn`, `plugins/toast`) */
+    entries: Record<string, PurgeManifestEntry>;
+}
+/**
+ * Write `dist/css/purge-manifest.json` in the build of `maz-ui`: the `maz:` classes of `style.css`, the public
+ * utilities of `utilities.css`, and for every entry the classes it renders with the modules it imports.
+ */
+declare function generatePurgeManifest(distDir: string, version: string): PurgeManifest;
+/** Read the manifest of the `maz-ui` installed in the project */
+declare function loadPurgeManifest(root: string): PurgeManifest | undefined;
+
+export { PURGE_MANIFEST_FILE, generatePurgeManifest, loadPurgeManifest };
+export type { PurgeManifest, PurgeManifestEntry };

package/dist/manifest.mjs

@@ -0,0 +1,5 @@
+export { P as PURGE_MANIFEST_FILE, g as generatePurgeManifest, l as loadPurgeManifest } from './shared/vite-plugin.Ce6HCqgJ.mjs';
+import 'node:fs';
+import 'node:module';
+import 'node:path';
+import 'postcss';

package/dist/shared/vite-plugin.Ce6HCqgJ.mjs

@@ -0,0 +1,200 @@
+import { readFileSync, existsSync, readdirSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join, basename, resolve, dirname } from 'node:path';
+import postcss from 'postcss';
+
+const IDENT_CHAR = /[\w-]/;
+const HEX_DIGIT = /[\da-f]/i;
+const WHITESPACE = /\s/;
+function readIdentifier(selector, start) {
+  let value = "";
+  let index = start;
+  while (index < selector.length) {
+    const char = selector[index];
+    if (char === "\\") {
+      let hex = "";
+      let cursor = index + 1;
+      while (hex.length < 6 && cursor < selector.length && HEX_DIGIT.test(selector[cursor])) {
+        hex += selector[cursor];
+        cursor++;
+      }
+      if (hex) {
+        value += String.fromCodePoint(Number.parseInt(hex, 16));
+        index = cursor < selector.length && WHITESPACE.test(selector[cursor]) ? cursor + 1 : cursor;
+      } else {
+        value += selector[index + 1] ?? "";
+        index += 2;
+      }
+      continue;
+    }
+    if (!IDENT_CHAR.test(char) && char.charCodeAt(0) < 128)
+      break;
+    value += char;
+    index++;
+  }
+  return { value, end: index };
+}
+function skipString(selector, start) {
+  const quote = selector[start];
+  let index = start + 1;
+  while (index < selector.length && selector[index] !== quote) {
+    index += selector[index] === "\\" ? 2 : 1;
+  }
+  return index;
+}
+function walkTopLevel(selector, visit) {
+  let depth = 0;
+  let index = 0;
+  while (index < selector.length) {
+    const char = selector[index];
+    if (char === "\\") {
+      index += 2;
+    } else if (char === '"' || char === "'") {
+      index = skipString(selector, index) + 1;
+    } else if (char === "(" || char === "[") {
+      depth++;
+      index++;
+    } else if (char === ")" || char === "]") {
+      depth--;
+      index++;
+    } else {
+      index = (depth === 0 ? visit(index) : void 0) ?? index + 1;
+    }
+  }
+}
+function splitSelectorList(selector) {
+  const selectors = [];
+  let start = 0;
+  walkTopLevel(selector, (index) => {
+    if (selector[index] === ",") {
+      selectors.push(selector.slice(start, index).trim());
+      start = index + 1;
+    }
+    return void 0;
+  });
+  selectors.push(selector.slice(start).trim());
+  return selectors.filter(Boolean);
+}
+function getRequiredClasses(selector) {
+  const classes = [];
+  walkTopLevel(selector, (index) => {
+    if (selector[index] !== ".")
+      return void 0;
+    const { value, end } = readIdentifier(selector, index + 1);
+    if (value)
+      classes.push(value);
+    return end;
+  });
+  return classes;
+}
+
+const PURGE_MANIFEST_FILE = "purge-manifest.json";
+const ENTRY_DIRECTORIES = [
+  "components",
+  "composables",
+  "directives",
+  "plugins"
+];
+const IMPORT_PATTERN = /(?:\bfrom\s*|\bimport\s*(?:\(\s*)?)["'](\.{1,2}\/[^"']+)["']/g;
+const EXPORT_PATTERN = /export\s*\{([^}]*)\}/g;
+const NAME_CHAR = /[\w$]/;
+const CLASS_CHAR = /[\w-]/;
+function toKebabCase(value) {
+  return value.replace(/([a-z\d])([A-Z])/g, "$1-$2").toLowerCase();
+}
+function collectClasses(css, filter) {
+  const classes = /* @__PURE__ */ new Set();
+  postcss.parse(css).walkRules((rule) => {
+    for (const selector of splitSelectorList(rule.selector)) {
+      for (const className of getRequiredClasses(selector)) {
+        if (filter(className))
+          classes.add(className);
+      }
+    }
+  });
+  return [...classes].sort();
+}
+function containsToken(content, token, isTokenChar = (char) => CLASS_CHAR.test(char)) {
+  let index = content.indexOf(token);
+  while (index !== -1) {
+    const before = index === 0 ? "" : content[index - 1];
+    const after = content[index + token.length] ?? "";
+    const isDecimal = after === "." && /\d/.test(content[index + token.length + 1] ?? "");
+    if (!isTokenChar(before) && !isTokenChar(after) && after !== "!" && after !== "/" && !isDecimal)
+      return true;
+    index = content.indexOf(token, index + 1);
+  }
+  return false;
+}
+function containsName(content, name) {
+  return containsToken(content, name, (char) => NAME_CHAR.test(char) || char === "-");
+}
+function readModules(distDir, file, seen) {
+  if (seen.has(file) || !existsSync(file))
+    return "";
+  seen.add(file);
+  const code = readFileSync(file, "utf8");
+  let content = code;
+  for (const match of code.matchAll(IMPORT_PATTERN))
+    content += `
+${readModules(distDir, resolve(dirname(file), match[1]), seen)}`;
+  return content;
+}
+function getAliases(directory, name, code) {
+  const aliases = /* @__PURE__ */ new Set();
+  if (directory === "components") {
+    aliases.add(name);
+    aliases.add(toKebabCase(name));
+    aliases.add(`Lazy${name}`);
+  }
+  for (const match of code.matchAll(EXPORT_PATTERN)) {
+    for (const specifier of match[1].split(",")) {
+      const exported = specifier.trim().split(/\s+/).pop();
+      if (exported && exported !== "default")
+        aliases.add(exported);
+    }
+  }
+  if (directory === "directives") {
+    for (const alias of [...aliases]) {
+      if (/^v[A-Z]/.test(alias) && !alias.endsWith("Install"))
+        aliases.add(toKebabCase(alias));
+    }
+  }
+  return [...aliases].sort();
+}
+function generatePurgeManifest(distDir, version) {
+  const classes = collectClasses(readFileSync(join(distDir, "css/main.css"), "utf8"), (className) => className.startsWith("maz:"));
+  const utilitiesFile = join(distDir, "css/utilities.css");
+  const utilities = existsSync(utilitiesFile) ? collectClasses(readFileSync(utilitiesFile, "utf8"), () => true) : [];
+  const entries = {};
+  for (const directory of ENTRY_DIRECTORIES) {
+    const folder = join(distDir, directory);
+    if (!existsSync(folder))
+      continue;
+    for (const file of readdirSync(folder)) {
+      if (!file.endsWith(".js") || file === "index.js")
+        continue;
+      const path = join(folder, file);
+      const name = basename(file, ".js");
+      const content = readModules(distDir, path, /* @__PURE__ */ new Set());
+      entries[`${directory}/${name}`] = {
+        aliases: getAliases(directory, name, readFileSync(path, "utf8")),
+        classes: classes.flatMap((className, index) => containsToken(content, className) ? [index] : [])
+      };
+    }
+  }
+  const manifest = { version, classes, utilities, entries };
+  writeFileSync(join(distDir, "css", PURGE_MANIFEST_FILE), JSON.stringify(manifest));
+  return manifest;
+}
+function loadPurgeManifest(root) {
+  try {
+    const require = createRequire(join(root, "package.json"));
+    const file = require.resolve(`maz-ui/${PURGE_MANIFEST_FILE}`);
+    return JSON.parse(readFileSync(file, "utf8"));
+  } catch {
+    return void 0;
+  }
+}
+
+export { PURGE_MANIFEST_FILE as P, getRequiredClasses as a, containsToken as b, containsName as c, generatePurgeManifest as g, loadPurgeManifest as l, splitSelectorList as s };

package/package.json

@@ -1,6 +1,103 @@
 {
   "name": "@maz-ui/vite-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "type": "module",
+  "version": "5.7.0-beta.2",
+  "description": "Vite plugins for Maz-UI: purge the CSS of the components and utilities your app does not use",
+  "author": "Louis Mazel <me@loicmazuel.com>",
+  "license": "MIT",
+  "homepage": "https://maz-ui.com/ecosystem/vite-plugin",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LouisMazel/maz-ui.git",
+    "directory": "packages/vite-plugin"
+  },
+  "bugs": "https://github.com/LouisMazel/maz-ui/issues",
+  "keywords": [
+    "vite",
+    "vite-plugin",
+    "maz-ui",
+    "purge",
+    "css",
+    "tree-shaking"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "monorepo:dev": "./src/index.ts",
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./manifest": {
+      "monorepo:dev": "./src/manifest.ts",
+      "types": "./dist/manifest.d.mts",
+      "import": "./dist/manifest.mjs",
+      "default": "./dist/manifest.mjs"
+    }
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "LICENSE",
+    "README.md",
+    "agent-docs",
+    "dist"
+  ],
+  "engines": {
+    "node": "^22.23.4 || ^24.22.1 || >=26.12.1"
+  },
+  "peerDependencies": {
+    "vite": ">=6.0.0 <9.0.0"
+  },
+  "dependencies": {
+    "postcss": "^8.5.32",
+    "tinyglobby": "^0.2.17"
+  },
+  "devDependencies": {
+    "@maz-ui/eslint-config": "^5.6.0-beta.0",
+    "@types/node": "^26.6.6",
+    "@vitest/coverage-v8": "^5.1.0",
+    "cross-env": "^10.1.0",
+    "eslint": "^10.14.0",
+    "typescript": "^6.0.3",
+    "unbuild": "^3.6.1",
+    "vite": "^8.3.7",
+    "vitest": "5.1.0"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx,mjs,mts,cjs,md,yml,json}": [
+      "eslint --fix"
+    ]
+  },
+  "nx": {
+    "targets": {
+      "build": {
+        "inputs": [
+          "production",
+          "^production",
+          "{workspaceRoot}/tools/agent-docs/src/**/*",
+          "{workspaceRoot}/tools/agent-docs/content/**/*",
+          "{workspaceRoot}/apps/docs/src/**/*"
+        ],
+        "outputs": [
+          "{projectRoot}/dist",
+          "{projectRoot}/agent-docs"
+        ]
+      }
+    }
+  },
+  "scripts": {
+    "build": "unbuild && pnpm generate:agent-docs",
+    "generate:agent-docs": "pnpm -F agent-docs generate --package @maz-ui/vite-plugin",
+    "dev": "unbuild --stub",
+    "typecheck": "tsc --noEmit --skipLibCheck",
+    "lint": "cross-env NODE_ENV=production eslint .",
+    "lint:fix": "pnpm lint --fix",
+    "test:unit": "vitest run",
+    "test:unit:watch": "vitest watch",
+    "test:unit:coverage": "vitest run --coverage"
+  }
 }