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

package/docs/{src/ecosystem → ecosystem}/stylelint-config.md

@@ -1,9 +1,17 @@
 ---
-title: '@maz-ui/stylelint-config'
-description: Stylelint preset for Vue/Nuxt/JS/TS projects, with first-class Tailwind CSS v4 support, RTL-friendly logical properties, and SCSS opt-in.
+title: "@maz-ui/stylelint-config"
+description: "Stylelint preset for Vue/Nuxt/JS/TS projects, with first-class Tailwind CSS v4 support, RTL-friendly logical properties, and SCSS opt-in."
+package: "@maz-ui/stylelint-config"
+url: "https://maz-ui.com/ecosystem/stylelint-config"
 ---
 
-# {{ $frontmatter.title }}
+# @maz-ui/stylelint-config
+
+> Stylelint preset for Vue/Nuxt/JS/TS projects, with first-class Tailwind CSS v4 support, RTL-friendly logical properties, and SCSS opt-in.
+
+- Package: `@maz-ui/stylelint-config`
+- Import: `import { defineConfig } from '@maz-ui/stylelint-config'`
+- Web: https://maz-ui.com/ecosystem/stylelint-config
 
 `@maz-ui/stylelint-config` is the Stylelint counterpart to [`@maz-ui/eslint-config`](./eslint-config.md). It builds on Stylelint's official **standard** config and layers in the conventions used by maz-ui itself: BEM-friendly class patterns, Tailwind v4 support (at-rule whitelist + tunable plugin policy), RTL-friendly logical properties, optional SCSS support, Vue/HTML block parsing, and a single `extends` knob to compose extra shareable configs.
 
@@ -30,16 +38,16 @@ Vue, Tailwind and SCSS are auto-detected from your `package.json`:
 | Detected when… | Enables… |
 | --- | --- |
 | `vue` or `nuxt` is in dependencies | Vue support (`stylelint-config-recommended-vue`, `<style>` block parsing) |
-| `tailwindcss` or `@tailwindcss/vite` is in dependencies | At-rule whitelist + Tailwind plugin with the `'minimal'` policy (see [Tailwind](#tailwind-css-v4) below) |
+| `tailwindcss` or `@tailwindcss/vite` is in dependencies | At-rule whitelist + Tailwind plugin with the `'minimal'` policy (see Tailwind below) |
 | `sass`, `sass-embedded` or `node-sass` is in dependencies | SCSS support (`stylelint-config-standard-scss`, `postcss-scss`) |
 
-::: warning Monorepo caveat
+**Warning: Monorepo caveat**
+
 Detection only reads the `package.json` in the current working directory. In a monorepo where `tailwindcss`, `vue` or `sass` are hoisted to the root and **not declared** in a sub-package's `package.json`, detection silently fails when Stylelint runs from that sub-package. Set the relevant flags explicitly in those cases:
 
 ```js
 defineConfig({ vue: true, tailwind: true, scss: false })
 ```
-:::
 
 ## Configuration
 
@@ -47,7 +55,7 @@ defineConfig({ vue: true, tailwind: true, scss: false })
 import { defineConfig } from '@maz-ui/stylelint-config'
 
 export default defineConfig({
-  // Each one is also auto-detected — set explicitly to opt in/out.
+  // Each one is also auto-detected - set explicitly to opt in/out.
   vue: true,
   html: false,
 
@@ -88,14 +96,14 @@ export default defineConfig({
   // win Stylelint's cascade.
   extends: ['stylelint-config-clean-order'],
 
-  // Log verbosity — see "Logging" below.
+  // Log verbosity - see "Logging" below.
   logLevel: 'default',
 })
 ```
 
 ## Logging
 
-The preset can explain what it resolved and which plugins / extends it added — useful when you can't figure out why a rule is on or off. Logging is powered by [`@maz-ui/node`](https://www.npmjs.com/package/@maz-ui/node)'s consola-based logger.
+The preset can explain what it resolved and which plugins / extends it added - useful when you can't figure out why a rule is on or off. Logging is powered by [`@maz-ui/node`](https://www.npmjs.com/package/@maz-ui/node)'s consola-based logger.
 
 | `logLevel` | What you see |
 | --- | --- |
@@ -115,7 +123,7 @@ The `logLevel` type comes from `@maz-ui/node` and accepts the full set of consol
 When `logical: true` (default), the preset enables [`stylelint-use-logical-spec`](https://github.com/Jordan-Hall/stylelint-use-logical-spec) which warns whenever you use a physical CSS property that has a logical equivalent:
 
 ```css
-/* ❌ Physical — breaks in RTL languages */
+/* ❌ Physical - breaks in RTL languages */
 .toolbar {
   margin-left: 1rem;
   padding-right: 1rem;
@@ -123,7 +131,7 @@ When `logical: true` (default), the preset enables [`stylelint-use-logical-spec`
   left: 0;
 }
 
-/* ✅ Logical — adapts to writing direction */
+/* ✅ Logical - adapts to writing direction */
 .toolbar {
   margin-inline-start: 1rem;
   padding-inline-end: 1rem;
@@ -146,7 +154,7 @@ When `tailwind` is enabled (truthy or auto-detected), the preset:
 
 - Whitelists every Tailwind v4 at-rule via `at-rule-no-unknown` (and `scss/at-rule-no-unknown` when SCSS is also on): `@apply`, `@theme`, `@layer`, `@variant`, `@custom-variant`, `@reference`, `@utility`, `@source`, `@screen`, `@starting-style`, `@tailwind`.
 - Sets `at-rule-no-deprecated` to allow `@apply` (Tailwind v4 still ships it as the canonical authoring directive).
-- Forces `import-notation: 'string'` — Tailwind v4 only parses the `prefix(...)` modifier on bare-string `@import` forms, never on `url()`-wrapped imports.
+- Forces `import-notation: 'string'` - Tailwind v4 only parses the `prefix(...)` modifier on bare-string `@import` forms, never on `url()`-wrapped imports.
 - Loads [`stylelint-plugin-tailwindcss`](https://github.com/sonofmagic/dev-configs/tree/main/packages/stylelint-plugin-tailwindcss) and applies a curated rule set based on the chosen policy level.
 
 ### Policy levels
@@ -165,10 +173,11 @@ The `tailwind` option accepts a strictness level. Pure `true` (or auto-detection
 defineConfig({ tailwind: 'recommended' })
 ```
 
-::: warning Plugin rules need to find your Tailwind runtime
+**Warning: Plugin rules need to find your Tailwind runtime**
+
 Both `'recommended'` and `'strict'` enable rules from `stylelint-plugin-tailwindcss` that resolve your project's Tailwind installation from each linted file's path. Projects with a Tailwind v4 prefix (`maz:`, `tw:`, …), a non-standard entry CSS, or a monorepo layout where the plugin can't locate Tailwind will produce a flood of false positives (every `@apply maz:flex` flagged as invalid).
 
-`'minimal'` is the safe default — it only enables the at-rule whitelist and a couple of CSS-level rules, no runtime Tailwind validation.
+`'minimal'` is the safe default - it only enables the at-rule whitelist and a couple of CSS-level rules, no runtime Tailwind validation.
 
 If you want validation but hit false positives, drop the offending rule:
 
@@ -181,7 +190,6 @@ defineConfig({
   },
 })
 ```
-:::
 
 The plugin supports both Tailwind v3 and v4.
 
@@ -193,7 +201,7 @@ The plugin supports both Tailwind v3 and v4.
 | `'alphabetical'` | Loads `stylelint-order` and enables `order/properties-alphabetical-order`. Strict A→Z. |
 | `false` | No ordering rules. |
 
-To swap recess for another shareable order config (e.g. `stylelint-config-clean-order`), disable the built-in strategy and extend yours via the [`extends`](#layering-shareable-configs) option:
+To swap recess for another shareable order config (e.g. `stylelint-config-clean-order`), disable the built-in strategy and extend yours via the `extends` option:
 
 ```js
 defineConfig({
@@ -219,14 +227,14 @@ Use this to layer additional shareable configs without rewriting the whole `defi
 
 ## What it includes
 
-- **Stylelint Standard** — Idiomatic CSS rules from the official Stylelint config.
-- **Property ordering** — Recess-based by default (`stylelint-config-recess-order`), alphabetical via `stylelint-order`, or off — see [Property ordering](#property-ordering).
-- **Tailwind v4 support** (opt-in / auto-detected) — at-rule whitelist + `stylelint-plugin-tailwindcss` with three policy levels — see [Tailwind CSS v4](#tailwind-css-v4).
-- **Vue / HTML support** (opt-in / auto-detected) — `<style>` and `<style scoped>` block parsing via `postcss-html`.
-- **SCSS support** (opt-in / auto-detected) — `stylelint-config-standard-scss` + native SCSS at-rule whitelist.
-- **Logical properties** — RTL-friendly authoring via `stylelint-use-logical-spec`.
-- **BEM-friendly class patterns** — disables `selector-class-pattern` and `no-descending-specificity` so `m-btn__icon`, `m-btn--ghost` and `:deep(...)` selectors flow naturally.
-- **Layering** — `extends` option to compose additional shareable configs on top of the resolved output.
+- **Stylelint Standard** - Idiomatic CSS rules from the official Stylelint config.
+- **Property ordering** - Recess-based by default (`stylelint-config-recess-order`), alphabetical via `stylelint-order`, or off - see Property ordering.
+- **Tailwind v4 support** (opt-in / auto-detected) - at-rule whitelist + `stylelint-plugin-tailwindcss` with three policy levels - see Tailwind CSS v4.
+- **Vue / HTML support** (opt-in / auto-detected) - `<style>` and `<style scoped>` block parsing via `postcss-html`.
+- **SCSS support** (opt-in / auto-detected) - `stylelint-config-standard-scss` + native SCSS at-rule whitelist.
+- **Logical properties** - RTL-friendly authoring via `stylelint-use-logical-spec`.
+- **BEM-friendly class patterns** - disables `selector-class-pattern` and `no-descending-specificity` so `m-btn__icon`, `m-btn--ghost` and `:deep(...)` selectors flow naturally.
+- **Layering** - `extends` option to compose additional shareable configs on top of the resolved output.
 
 ## Advanced
 
@@ -256,7 +264,7 @@ export default {
 }
 ```
 
-Each `tailwindPlugin*` constant is the rule object for the corresponding policy level — useful when you compose Stylelint configs by hand instead of going through `defineConfig`.
+Each `tailwindPlugin*` constant is the rule object for the corresponding policy level - useful when you compose Stylelint configs by hand instead of going through `defineConfig`.
 
 ## Migrating from a hand-written `.stylelintrc`