@maz-ui/stylelint-config 5.0.0-beta.0

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

@@ -0,0 +1,59 @@
+# @maz-ui/stylelint-config
+
+Reusable [Stylelint](https://stylelint.io/) configuration for Vue/Nuxt/JS/TS projects, with first-class Tailwind CSS v4 support, RTL-friendly logical properties, and SCSS opt-in.
+
+## Features
+
+- 🚀 **Stylelint Standard base** — opinionated, maintained by the Stylelint team
+- 🎨 **Tailwind v4** — at-rule whitelist, `import-notation: string` enforced
+- 🌍 **RTL-friendly** — logical properties via `stylelint-use-logical-spec`
+- 🔠 **Property ordering** — Recess-based by default, alphabetical or off
+- 💚 **Vue/HTML/SCSS** — auto-detected from your `package.json`
+- 🛠 **Configurable** — toggle features, override rules, append per-file overrides
+
+## Installation
+
+```bash
+pnpm add -D @maz-ui/stylelint-config stylelint
+```
+
+## Basic usage
+
+```js
+// stylelint.config.mjs
+import { defineConfig } from '@maz-ui/stylelint-config'
+
+export default defineConfig()
+```
+
+Vue, Tailwind and SCSS are auto-detected from your `package.json`.
+
+## Options
+
+```js
+defineConfig({
+  vue: true, // auto-detected from `vue`/`nuxt` deps
+  html: false,
+  tailwind: true, // auto-detected from `tailwindcss` dep
+  scss: false, // auto-detected from `sass`/`sass-embedded`/`node-sass`
+  logical: true, // recommend logical CSS properties (RTL-friendly)
+  order: 'recess', // 'recess' | 'alphabetical' | false
+
+  ignores: ['**/legacy/**'],
+  rules: {
+    'no-descending-specificity': null,
+  },
+  overrides: [
+    { files: ['**/*.legacy.css'], rules: { 'color-no-invalid-hex': null } },
+  ],
+})
+```
+
+## Documentation
+
+See the full documentation at [maz-ui.com/ecosystem/stylelint-config](https://maz-ui.com/ecosystem/stylelint-config).
+
+## Compatibility
+
+- **Stylelint** >=16 <18
+- **Node.js** >=20.19.0

package/dist/index.d.mts

@@ -0,0 +1,196 @@
+import { Config } from 'stylelint';
+
+type StylelintConfig = Config;
+type StylelintRules = Config['rules'];
+type StylelintOverride = NonNullable<Config['overrides']>[number];
+/**
+ * Property order strategy.
+ *
+ * - `'recess'`: Recess-based ordering (`stylelint-config-recess-order`).
+ *   Pragmatic, widely adopted, groups related properties together.
+ * - `'alphabetical'`: Strict A→Z ordering. Easy mental model, slightly worse
+ *   diffs than recess.
+ * - `false`: Disable ordering rules entirely.
+ */
+type StylelintOrderStrategy = 'recess' | 'alphabetical' | false;
+interface MazStylelintOptions {
+    /**
+     * Enable Vue support — extends `stylelint-config-recommended-vue` and
+     * registers `postcss-html` for `<style>` blocks in `.vue` files.
+     *
+     * Auto-detected from `vue` or `nuxt` in the consuming `package.json`
+     * unless explicitly set.
+     */
+    vue?: boolean;
+    /**
+     * Enable HTML support — extends `stylelint-config-html` and registers
+     * `postcss-html` for `<style>` blocks in `.html`, `.svg` and similar files.
+     *
+     * @default false
+     */
+    html?: boolean;
+    /**
+     * Enable Tailwind CSS support — whitelists the v4 at-rules
+     * (`@apply`, `@reference`, `@variant`, `@theme`, `@layer`, `@utility`,
+     * `@source`, `@custom-variant`, `@tailwind`, `@screen`, `@starting-style`)
+     * and relaxes patterns that conflict with Tailwind's prefixed classes.
+     *
+     * Auto-detected from `tailwindcss` in the consuming `package.json` unless
+     * explicitly set.
+     */
+    tailwind?: boolean;
+    /**
+     * Enable SCSS support — extends `stylelint-config-recommended-scss` and
+     * registers `postcss-scss` for `.scss` files.
+     *
+     * Auto-detected from `sass` / `sass-embedded` / `node-sass` /
+     * `stylelint-scss` in the consuming `package.json` unless explicitly set.
+     */
+    scss?: boolean;
+    /**
+     * Encourage logical CSS properties (`inset-block`, `margin-inline-start`,
+     * `padding-inline`, …) over their physical equivalents (`top`, `margin-left`,
+     * `padding-left`, …). Highly recommended for RTL/LTR-aware design systems.
+     *
+     * @default true
+     */
+    logical?: boolean;
+    /**
+     * Property order strategy. See {@link StylelintOrderStrategy}.
+     *
+     * @default 'recess'
+     */
+    order?: StylelintOrderStrategy;
+    /**
+     * Glob patterns of files Stylelint should ignore, merged with the package's
+     * sensible defaults (`node_modules/**`, `dist/**`, `coverage/**`, …).
+     */
+    ignores?: string[];
+    /**
+     * Replace the default ignore list with this one (no merge).
+     */
+    ignoresOverride?: string[];
+    /**
+     * Custom rules merged on top of the resolved configuration. Use this to
+     * tweak severity, disable rules or override their options.
+     *
+     * @example
+     * ```ts
+     * defineConfig({
+     *   rules: {
+     *     'no-descending-specificity': null,
+     *     'declaration-block-no-redundant-longhand-properties': [true, {
+     *       ignoreShorthands: ['grid-template'],
+     *     }],
+     *   },
+     * })
+     * ```
+     */
+    rules?: StylelintRules;
+    /**
+     * Additional overrides appended to the resolved configuration. Use this to
+     * apply rules to specific file globs (legacy code, generated CSS, …).
+     *
+     * @example
+     * ```ts
+     * defineConfig({
+     *   overrides: [
+     *     { files: ['**\/*.legacy.css'], rules: { 'no-descending-specificity': null } },
+     *   ],
+     * })
+     * ```
+     */
+    overrides?: StylelintOverride[];
+    /**
+     * Additional plugins merged on top of the resolved configuration.
+     */
+    plugins?: NonNullable<Config['plugins']>;
+}
+
+/**
+ * Baseline rules applied on top of `stylelint-config-standard`.
+ *
+ * The goal is **opinionated but pragmatic**: keep the standard config's
+ * idiomatic-CSS rules, soften the few that fight nested component styling
+ * (Vue, BEM, Tailwind), and add a couple of universally-good rules that are
+ * not in the standard config.
+ */
+declare const baseRules: StylelintRules;
+
+/**
+ * Glob patterns Stylelint should ignore by default. Mirrors the eslint-config
+ * defaults plus a few CSS-specific build outputs.
+ */
+declare const GLOBAL_IGNORES: string[];
+
+/**
+ * Flag every physical property/value that has a logical equivalent.
+ * `liberty/use-logical-spec` is the rule name exposed by the plugin.
+ *
+ * The third argument `except` is intentionally empty — we want a clean
+ * baseline. Teams that need to allow specific physical props (e.g. they
+ * deliberately compute `top: 0` for a fixed header that can't be flipped)
+ * can override the rule in their own config.
+ */
+declare const logicalRules: StylelintRules;
+
+/**
+ * Rules applied when SCSS support is enabled. Mirrors the at-rule whitelist
+ * so projects that use SCSS *and* Tailwind don't get false positives from
+ * `scss/at-rule-no-unknown`.
+ */
+declare function scssRules(includeTailwind: boolean): StylelintRules;
+
+/**
+ * Tailwind v4 at-rules. New ones can be added without bumping a major
+ * version since the rule treats unknown at-rules as warnings, not errors,
+ * but we still prefer to keep this list current.
+ *
+ * Source: https://tailwindcss.com/docs (v4 directives)
+ */
+declare const TAILWIND_AT_RULES: string[];
+/**
+ * Rules to whitelist Tailwind's at-rules and relax patterns that conflict
+ * with Tailwind-prefixed classes (`maz:flex`, `dark:bg-…`).
+ *
+ * When SCSS is also enabled, `at-rule-no-unknown` is disabled by
+ * `stylelint-config-recommended-scss` in favor of `scss/at-rule-no-unknown`
+ * — keep that rule out of this set and merge it in only when SCSS is off.
+ */
+declare const tailwindRules: StylelintRules;
+/**
+ * Tailwind at-rule whitelist for plain CSS contexts (no SCSS).
+ *
+ * Merged on top of `tailwindRules` only when SCSS support is disabled —
+ * with SCSS on, `scss/at-rule-no-unknown` covers both Tailwind and SCSS
+ * directives, and `at-rule-no-unknown` itself is disabled by the SCSS
+ * recommended config.
+ */
+declare const tailwindAtRuleNoUnknown: StylelintRules;
+
+/**
+ * Build a Stylelint config tailored for Vue/Nuxt/JS/TS/Tailwind projects.
+ *
+ * Defaults to the Stylelint Standard rules with a few opinions softened
+ * (BEM/Tailwind class patterns, deep nesting, `v-bind()`). Vue, Tailwind
+ * and SCSS support is auto-detected from the consuming `package.json` —
+ * pass the matching boolean explicitly to opt in or out.
+ *
+ * @example
+ * ```ts
+ * // stylelint.config.mjs
+ * import { defineConfig } from '@maz-ui/stylelint-config'
+ *
+ * export default defineConfig({
+ *   tailwind: true,
+ *   logical: true,
+ *   rules: {
+ *     'no-descending-specificity': null,
+ *   },
+ * })
+ * ```
+ */
+declare function defineConfig(options?: MazStylelintOptions): StylelintConfig;
+
+export { GLOBAL_IGNORES, TAILWIND_AT_RULES, baseRules, defineConfig, logicalRules, scssRules, tailwindAtRuleNoUnknown, tailwindRules };
+export type { MazStylelintOptions, StylelintConfig, StylelintOrderStrategy, StylelintOverride, StylelintRules };

package/dist/index.d.ts

@@ -0,0 +1,196 @@
+import { Config } from 'stylelint';
+
+type StylelintConfig = Config;
+type StylelintRules = Config['rules'];
+type StylelintOverride = NonNullable<Config['overrides']>[number];
+/**
+ * Property order strategy.
+ *
+ * - `'recess'`: Recess-based ordering (`stylelint-config-recess-order`).
+ *   Pragmatic, widely adopted, groups related properties together.
+ * - `'alphabetical'`: Strict A→Z ordering. Easy mental model, slightly worse
+ *   diffs than recess.
+ * - `false`: Disable ordering rules entirely.
+ */
+type StylelintOrderStrategy = 'recess' | 'alphabetical' | false;
+interface MazStylelintOptions {
+    /**
+     * Enable Vue support — extends `stylelint-config-recommended-vue` and
+     * registers `postcss-html` for `<style>` blocks in `.vue` files.
+     *
+     * Auto-detected from `vue` or `nuxt` in the consuming `package.json`
+     * unless explicitly set.
+     */
+    vue?: boolean;
+    /**
+     * Enable HTML support — extends `stylelint-config-html` and registers
+     * `postcss-html` for `<style>` blocks in `.html`, `.svg` and similar files.
+     *
+     * @default false
+     */
+    html?: boolean;
+    /**
+     * Enable Tailwind CSS support — whitelists the v4 at-rules
+     * (`@apply`, `@reference`, `@variant`, `@theme`, `@layer`, `@utility`,
+     * `@source`, `@custom-variant`, `@tailwind`, `@screen`, `@starting-style`)
+     * and relaxes patterns that conflict with Tailwind's prefixed classes.
+     *
+     * Auto-detected from `tailwindcss` in the consuming `package.json` unless
+     * explicitly set.
+     */
+    tailwind?: boolean;
+    /**
+     * Enable SCSS support — extends `stylelint-config-recommended-scss` and
+     * registers `postcss-scss` for `.scss` files.
+     *
+     * Auto-detected from `sass` / `sass-embedded` / `node-sass` /
+     * `stylelint-scss` in the consuming `package.json` unless explicitly set.
+     */
+    scss?: boolean;
+    /**
+     * Encourage logical CSS properties (`inset-block`, `margin-inline-start`,
+     * `padding-inline`, …) over their physical equivalents (`top`, `margin-left`,
+     * `padding-left`, …). Highly recommended for RTL/LTR-aware design systems.
+     *
+     * @default true
+     */
+    logical?: boolean;
+    /**
+     * Property order strategy. See {@link StylelintOrderStrategy}.
+     *
+     * @default 'recess'
+     */
+    order?: StylelintOrderStrategy;
+    /**
+     * Glob patterns of files Stylelint should ignore, merged with the package's
+     * sensible defaults (`node_modules/**`, `dist/**`, `coverage/**`, …).
+     */
+    ignores?: string[];
+    /**
+     * Replace the default ignore list with this one (no merge).
+     */
+    ignoresOverride?: string[];
+    /**
+     * Custom rules merged on top of the resolved configuration. Use this to
+     * tweak severity, disable rules or override their options.
+     *
+     * @example
+     * ```ts
+     * defineConfig({
+     *   rules: {
+     *     'no-descending-specificity': null,
+     *     'declaration-block-no-redundant-longhand-properties': [true, {
+     *       ignoreShorthands: ['grid-template'],
+     *     }],
+     *   },
+     * })
+     * ```
+     */
+    rules?: StylelintRules;
+    /**
+     * Additional overrides appended to the resolved configuration. Use this to
+     * apply rules to specific file globs (legacy code, generated CSS, …).
+     *
+     * @example
+     * ```ts
+     * defineConfig({
+     *   overrides: [
+     *     { files: ['**\/*.legacy.css'], rules: { 'no-descending-specificity': null } },
+     *   ],
+     * })
+     * ```
+     */
+    overrides?: StylelintOverride[];
+    /**
+     * Additional plugins merged on top of the resolved configuration.
+     */
+    plugins?: NonNullable<Config['plugins']>;
+}
+
+/**
+ * Baseline rules applied on top of `stylelint-config-standard`.
+ *
+ * The goal is **opinionated but pragmatic**: keep the standard config's
+ * idiomatic-CSS rules, soften the few that fight nested component styling
+ * (Vue, BEM, Tailwind), and add a couple of universally-good rules that are
+ * not in the standard config.
+ */
+declare const baseRules: StylelintRules;
+
+/**
+ * Glob patterns Stylelint should ignore by default. Mirrors the eslint-config
+ * defaults plus a few CSS-specific build outputs.
+ */
+declare const GLOBAL_IGNORES: string[];
+
+/**
+ * Flag every physical property/value that has a logical equivalent.
+ * `liberty/use-logical-spec` is the rule name exposed by the plugin.
+ *
+ * The third argument `except` is intentionally empty — we want a clean
+ * baseline. Teams that need to allow specific physical props (e.g. they
+ * deliberately compute `top: 0` for a fixed header that can't be flipped)
+ * can override the rule in their own config.
+ */
+declare const logicalRules: StylelintRules;
+
+/**
+ * Rules applied when SCSS support is enabled. Mirrors the at-rule whitelist
+ * so projects that use SCSS *and* Tailwind don't get false positives from
+ * `scss/at-rule-no-unknown`.
+ */
+declare function scssRules(includeTailwind: boolean): StylelintRules;
+
+/**
+ * Tailwind v4 at-rules. New ones can be added without bumping a major
+ * version since the rule treats unknown at-rules as warnings, not errors,
+ * but we still prefer to keep this list current.
+ *
+ * Source: https://tailwindcss.com/docs (v4 directives)
+ */
+declare const TAILWIND_AT_RULES: string[];
+/**
+ * Rules to whitelist Tailwind's at-rules and relax patterns that conflict
+ * with Tailwind-prefixed classes (`maz:flex`, `dark:bg-…`).
+ *
+ * When SCSS is also enabled, `at-rule-no-unknown` is disabled by
+ * `stylelint-config-recommended-scss` in favor of `scss/at-rule-no-unknown`
+ * — keep that rule out of this set and merge it in only when SCSS is off.
+ */
+declare const tailwindRules: StylelintRules;
+/**
+ * Tailwind at-rule whitelist for plain CSS contexts (no SCSS).
+ *
+ * Merged on top of `tailwindRules` only when SCSS support is disabled —
+ * with SCSS on, `scss/at-rule-no-unknown` covers both Tailwind and SCSS
+ * directives, and `at-rule-no-unknown` itself is disabled by the SCSS
+ * recommended config.
+ */
+declare const tailwindAtRuleNoUnknown: StylelintRules;
+
+/**
+ * Build a Stylelint config tailored for Vue/Nuxt/JS/TS/Tailwind projects.
+ *
+ * Defaults to the Stylelint Standard rules with a few opinions softened
+ * (BEM/Tailwind class patterns, deep nesting, `v-bind()`). Vue, Tailwind
+ * and SCSS support is auto-detected from the consuming `package.json` —
+ * pass the matching boolean explicitly to opt in or out.
+ *
+ * @example
+ * ```ts
+ * // stylelint.config.mjs
+ * import { defineConfig } from '@maz-ui/stylelint-config'
+ *
+ * export default defineConfig({
+ *   tailwind: true,
+ *   logical: true,
+ *   rules: {
+ *     'no-descending-specificity': null,
+ *   },
+ * })
+ * ```
+ */
+declare function defineConfig(options?: MazStylelintOptions): StylelintConfig;
+
+export { GLOBAL_IGNORES, TAILWIND_AT_RULES, baseRules, defineConfig, logicalRules, scssRules, tailwindAtRuleNoUnknown, tailwindRules };
+export type { MazStylelintOptions, StylelintConfig, StylelintOrderStrategy, StylelintOverride, StylelintRules };

package/dist/index.mjs

@@ -0,0 +1,243 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+const baseRules = {
+  /**
+   * `selector-class-pattern` enforces kebab-case by default. Component
+   * libraries that ship BEM (`m-btn__icon`) or Tailwind-prefixed classes
+   * (`maz:flex`) trip over it constantly.
+   */
+  "selector-class-pattern": null,
+  /**
+   * `no-descending-specificity` fires false positives in scoped Vue/CSS
+   * modules where the nesting depth simply reflects the markup. Off by
+   * default; teams that want it can re-enable in their own override.
+   */
+  "no-descending-specificity": null,
+  /**
+   * Allow author-time use of Vue's `v-bind()` and the (now widely supported)
+   * native `light-dark()` color function.
+   */
+  "function-no-unknown": [true, {
+    ignoreFunctions: ["v-bind", "light-dark"]
+  }],
+  /**
+   * Native CSS nesting now allows scoping inside another at-rule without an
+   * explicit selector — the `& selector` form is valid in 2026 browsers and
+   * Tailwind v4 emits it. Disable the warning.
+   */
+  "nesting-selector-no-missing-scoping-root": null,
+  /**
+   * Allow `:deep()` (Vue scoped-style descent) and `:global()` (CSS Modules)
+   * out of the box.
+   */
+  "selector-pseudo-class-no-unknown": [true, {
+    ignorePseudoClasses: ["deep", "global", "slotted", "where"]
+  }],
+  /**
+   * Custom property names follow kebab-case in our public CSS APIs
+   * (`--maz-primary`, `--m-btn-bg`). Standard config already allows this but
+   * we make the pattern explicit to surface the convention.
+   */
+  "custom-property-pattern": [
+    "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*(?:--[a-z0-9-]+)?$",
+    {
+      message: "Custom properties should be kebab-case (e.g. --my-token, --my-block--variant)."
+    }
+  ],
+  /**
+   * Be lenient on shorthand collapsing — `grid-template`/`grid-template-areas`
+   * and the `inset` longhands are routinely written long-form for readability.
+   */
+  "declaration-block-no-redundant-longhand-properties": [true, {
+    ignoreShorthands: ["grid-template", "inset"]
+  }]
+};
+
+const GLOBAL_IGNORES = [
+  "**/node_modules/**",
+  "**/dist/**",
+  "**/build/**",
+  "**/output/**",
+  "**/.output/**",
+  "**/coverage/**",
+  "**/temp/**",
+  "**/.temp/**",
+  "**/tmp/**",
+  "**/.tmp/**",
+  "**/.history/**",
+  "**/.vitepress/cache/**",
+  "**/.nuxt/**",
+  "**/.next/**",
+  "**/.svelte-kit/**",
+  "**/.vercel/**",
+  "**/.cache/**",
+  "**/*.min.css",
+  "**/*.min.scss"
+];
+
+const LOGICAL_PLUGIN = ["stylelint-use-logical-spec"];
+const logicalRules = {
+  "liberty/use-logical-spec": ["always"]
+};
+
+const TAILWIND_AT_RULES = [
+  // v4 core
+  "theme",
+  "utility",
+  "source",
+  "variant",
+  "custom-variant",
+  "reference",
+  "apply",
+  "layer",
+  "screen",
+  "starting-style",
+  // v3 carryover (still emitted by some Tailwind plugins)
+  "tailwind",
+  "config",
+  "plugin",
+  "responsive"
+];
+const tailwindRules = {
+  "at-rule-no-deprecated": [true, { ignoreAtRules: ["apply"] }],
+  /**
+   * Tailwind v4 only parses the `prefix(...)` modifier on the bare-string
+   * `@import "..."` form; wrapping the URL in `url(...)` swallows the modifier
+   * and breaks the build. Force the bare-string syntax.
+   */
+  "import-notation": "string"
+};
+const tailwindAtRuleNoUnknown = {
+  "at-rule-no-unknown": [true, { ignoreAtRules: TAILWIND_AT_RULES }]
+};
+
+const SCSS_AT_RULES = [
+  "use",
+  "forward",
+  "mixin",
+  "include",
+  "function",
+  "return",
+  "if",
+  "else",
+  "each",
+  "for",
+  "while",
+  "extend",
+  "at-root",
+  "debug",
+  "warn",
+  "error",
+  "content"
+];
+function scssRules(includeTailwind) {
+  return {
+    "scss/at-rule-no-unknown": [true, {
+      ignoreAtRules: [
+        ...SCSS_AT_RULES,
+        ...includeTailwind ? TAILWIND_AT_RULES : []
+      ]
+    }],
+    /**
+     * SCSS `@use` is forbidden by default in some configs because it must be
+     * at the very top of the file. We trust authors here — the SCSS compiler
+     * itself enforces the placement.
+     */
+    "scss/at-use-no-unnamespaced": null
+  };
+}
+
+function readConsumerPackageJson() {
+  try {
+    return JSON.parse(readFileSync(join(process.cwd(), "package.json"), "utf-8"));
+  } catch {
+    return void 0;
+  }
+}
+function hasDependency(pkg, ...names) {
+  if (!pkg)
+    return false;
+  const buckets = [pkg.dependencies, pkg.devDependencies, pkg.peerDependencies];
+  return names.some((name) => buckets.some((bucket) => bucket && name in bucket));
+}
+function resolveOptions(options) {
+  const pkg = readConsumerPackageJson();
+  return {
+    vue: options.vue ?? hasDependency(pkg, "vue", "nuxt"),
+    html: options.html ?? false,
+    tailwind: options.tailwind ?? hasDependency(pkg, "tailwindcss", "@tailwindcss/vite"),
+    scss: options.scss ?? hasDependency(pkg, "sass", "sass-embedded", "node-sass"),
+    logical: options.logical ?? true,
+    order: options.order ?? "recess"
+  };
+}
+function applyScss(resolved, ctx) {
+  if (!resolved.scss)
+    return;
+  ctx.extends.push("stylelint-config-recommended-scss");
+  Object.assign(ctx.rules, scssRules(resolved.tailwind));
+  ctx.rules["at-rule-no-unknown"] = null;
+  ctx.overrides.push({
+    files: ["**/*.scss"],
+    customSyntax: "postcss-scss"
+  });
+}
+function applyVueAndHtml(resolved, ctx) {
+  if (resolved.vue)
+    ctx.extends.push("stylelint-config-recommended-vue");
+  if (resolved.html)
+    ctx.extends.push("stylelint-config-html");
+  if (!resolved.vue && !resolved.html)
+    return;
+  const vueGlobs = resolved.vue ? ["**/*.vue"] : [];
+  const htmlGlobs = resolved.html ? ["**/*.html"] : [];
+  ctx.overrides.push({
+    files: [...vueGlobs, ...htmlGlobs],
+    customSyntax: "postcss-html"
+  });
+}
+function applyLogical(resolved, ctx) {
+  if (!resolved.logical)
+    return;
+  ctx.plugins.push(...LOGICAL_PLUGIN);
+  Object.assign(ctx.rules, logicalRules);
+}
+function applyUserOverrides(options, ctx) {
+  if (Array.isArray(options.plugins) && options.plugins.length > 0)
+    ctx.plugins.push(...options.plugins);
+  if (options.rules)
+    Object.assign(ctx.rules, options.rules);
+  if (options.overrides?.length)
+    ctx.overrides.push(...options.overrides);
+}
+function defineConfig(options = {}) {
+  const resolved = resolveOptions(options);
+  const ctx = {
+    extends: ["stylelint-config-standard"],
+    plugins: [],
+    rules: { ...baseRules },
+    overrides: []
+  };
+  if (resolved.order === "recess")
+    ctx.extends.push("stylelint-config-recess-order");
+  applyScss(resolved, ctx);
+  applyVueAndHtml(resolved, ctx);
+  if (resolved.tailwind) {
+    Object.assign(ctx.rules, tailwindRules);
+    if (!resolved.scss)
+      Object.assign(ctx.rules, tailwindAtRuleNoUnknown);
+  }
+  applyLogical(resolved, ctx);
+  applyUserOverrides(options, ctx);
+  const ignoreFiles = options.ignoresOverride ?? [...GLOBAL_IGNORES, ...options.ignores ?? []];
+  return {
+    extends: ctx.extends,
+    plugins: ctx.plugins.length > 0 ? ctx.plugins : void 0,
+    rules: ctx.rules,
+    overrides: ctx.overrides.length > 0 ? ctx.overrides : void 0,
+    ignoreFiles
+  };
+}
+
+export { GLOBAL_IGNORES, TAILWIND_AT_RULES, baseRules, defineConfig, logicalRules, scssRules, tailwindAtRuleNoUnknown, tailwindRules };

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@maz-ui/stylelint-config",
+  "type": "module",
+  "version": "5.0.0-beta.0",
+  "description": "Stylelint configuration for CSS, SCSS, Vue and Tailwind CSS projects",
+  "author": "Louis Mazel <me@loicmazuel.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LouisMazel/maz-ui.git"
+  },
+  "bugs": "https://github.com/LouisMazel/maz-ui/issues",
+  "keywords": [
+    "stylelint",
+    "stylelint-config",
+    "css",
+    "scss",
+    "vue",
+    "tailwindcss",
+    "code-quality",
+    "maz-ui"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "LICENSE",
+    "README.md",
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "peerDependencies": {
+    "stylelint": ">=16.0.0 <18.0.0"
+  },
+  "dependencies": {
+    "postcss-html": "^1.8.1",
+    "postcss-scss": "^4.0.9",
+    "stylelint-config-html": "^1.1.0",
+    "stylelint-config-recess-order": "^7.7.0",
+    "stylelint-config-recommended-scss": "^17.0.1",
+    "stylelint-config-recommended-vue": "^1.6.1",
+    "stylelint-config-standard": "^40.0.0",
+    "stylelint-scss": "^7.0.0",
+    "stylelint-use-logical-spec": "^5.0.1"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.5",
+    "stylelint": "^17.11.0",
+    "unbuild": "^3.6.1",
+    "vitest": "^4.1.5",
+    "@maz-ui/eslint-config": "5.0.0-beta.0"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx,mjs,mts,cjs,md,yml,json}": [
+      "eslint --fix"
+    ]
+  },
+  "scripts": {
+    "codegen": "nx build",
+    "build": "unbuild",
+    "dev": "unbuild --stub",
+    "typecheck": "tsc --noEmit --skipLibCheck && tsc --noEmit --skipLibCheck --project tsconfig.test.json",
+    "lint": "cross-env NODE_ENV=production eslint .",
+    "lint:fix": "pnpm lint --fix",
+    "test:unit": "vitest run",
+    "test:unit:coverage": "vitest run --coverage",
+    "test:unit:watch": "vitest watch"
+  }
+}