stylelint-config-nick2bad4u 3.0.0 → 4.0.0

package/README.md

@@ -50,6 +50,7 @@ export default {
 ## What this config includes
 
 - Standard modern Stylelint presets
+- Unmatchable CSS selector detection via `selector-no-unmatchable`
 - SCSS support
 - File progress and a process-shutdown summary via
   `stylelint-plugin-file-progress/configs/recommended`
@@ -83,9 +84,20 @@ The shared config includes overrides and parsers for:
 - Package entrypoint: `dist/stylelint.config.js`
 - Build command: `npm run build`
 - Export style: ESM only
-- Peer dependency: `stylelint@^17.14.0`
+- Peer dependency: `stylelint@^17.15.0`
 - Node.js: `>=22.12.0`
 
+## Migrating to version 4
+
+Version 4 enables [`selector-no-unmatchable`](https://stylelint.io/user-guide/rules/selector-no-unmatchable/)
+and requires Stylelint 17.15.0 or newer within major 17. Upgrade Stylelint when
+moving from version 3; the Node.js minimum remains 22.12.0.
+
+The rule reports valid CSS selectors that cannot match anything, such as
+`label:checked` or `::before:first-child`. Existing stylesheets may produce new
+diagnostics. It is disabled for SCSS files because SCSS nesting behaves
+differently from the CSS nesting semantics used by this rule.
+
 ## File progress
 
 Version 3 enables file progress by default and requires Stylelint 17.14.0 or
@@ -98,6 +110,14 @@ The Stylelint CLI also writes diagnostics to `stderr`. For a separate JSON repor
 use `stylelint "**/*.css" --formatter json --output-file stylelint-report.json`;
 read the report file instead of combining progress and diagnostics into one pipe.
 Progress also appears in CI and other non-interactive terminals.
+The display matches `eslint-config-nick2bad4u`: dim activity text, a dots spinner,
+colored relative directories, and an emphasized green filename on the next line.
+The success message is `Linting complete!`; detailed metrics are disabled by
+default. The shared rule explicitly sets all current display options, using
+`pathFormat: "relative"` for the ESLint config's legacy
+`hideDirectoryNames: false` setting. Version 3.0.1 requires progress-plugin 1.0.2
+or newer within major 1 to include the matching terminal colors and formatting.
+
 Counts cover observed file-processing events across the process; cached files
 and files that fail to parse before rules execute may not appear. The summary
 runs when the process exits, including in applications that call Stylelint

package/dist/stylelint.config.js

@@ -322,6 +322,8 @@ const config = {
                 // Selector-no-invalid is CSS-only; SCSS placeholder selectors
                 // (%name) and other SCSS-specific syntax would trigger false positives.
                 "selector-no-invalid": null,
+                // SCSS nesting can represent pseudo-elements unlike CSS nesting.
+                "selector-no-unmatchable": null,
             },
         },
     ],
@@ -728,6 +730,29 @@ const config = {
         "defensive-css/require-scrollbar-gutter": null,
         "defensive-css/require-system-font-fallback": null,
         "display-notation": "short",
+        // Match the effective progress settings from eslint-config-nick2bad4u.
+        "file-progress/activate": [
+            true,
+            {
+                detailedSuccess: false,
+                failureMark: "✖",
+                fileNameOnNewLine: true,
+                hide: false,
+                hideFileName: false,
+                hidePrefix: false,
+                minFilesBeforeShow: 0,
+                mode: "file",
+                outputStream: "stderr",
+                pathFormat: "relative",
+                prefixMark: "•",
+                showSummaryWhenHidden: false,
+                spinnerStyle: "dots",
+                successMark: "✔",
+                successMessage: "Linting complete!",
+                throttleMs: 0,
+                ttyOnly: false,
+            },
+        ],
         "font-family-name-quotes": "always-where-recommended",
         "font-family-no-duplicate-names": true,
         "font-family-no-missing-generic-family-keyword": true,
@@ -1096,6 +1121,13 @@ const config = {
          */
         "selector-no-invalid": true,
         "selector-no-qualifying-type": null,
+        /*
+         * Disallow valid CSS selectors that can never match an element.
+         * Disabled for SCSS because this rule uses CSS nesting semantics.
+         *
+         * @see {@link https://stylelint.io/user-guide/rules/selector-no-unmatchable | selector-no-unmatchable}
+         */
+        "selector-no-unmatchable": true,
         "selector-not-notation": "complex",
         "selector-pseudo-class-allowed-list": null,
         "selector-pseudo-class-disallowed-list": null,

package/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://www.schemastore.org/package.json",
     "name": "stylelint-config-nick2bad4u",
-    "version": "3.0.0",
+    "version": "4.0.0",
     "private": false,
     "description": "Shared Stylelint config for Nick2bad4u projects.",
     "keywords": [
@@ -51,6 +51,7 @@
         "changelog:release-notes": "git cliff --config node_modules/gitcliff-config-nick2bad4u/cliff.toml --github-repo Nick2bad4u/stylelint-config-nick2bad4u --current",
         "clean:dist": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
         "coverage": "npx vitest run --coverage",
+        "inspector": "npx stylelint-config-inspector@latest",
         "lint": "npx cross-env NODE_OPTIONS=--max_old_space_size=8192 npx eslint . --cache --cache-strategy content --cache-location .cache/.eslintcache",
         "lint:all": "npm run lint && npm run typecheck && npm run test && npm run lint:remark && npm run test:stylelint-config && npm run lint:prettier && npm run lint:package-manager-version && npm run lint:package && npm run lint:yaml && npm run lint:gitleaks && npm run lint:yamllint && npm run lint:secretlint",
         "lint:all:fix": "npm run lint:fix && npm run lint:remark:fix && npm run lint:prettier:fix && npm run sync:package-manager-version && npm run lint:package:fix && npm run typecheck && npm run test && npm run test:stylelint-config && npm run lint:yaml:fix && npm run lint:secretlint",
@@ -97,7 +98,7 @@
         "verify": "npm run release:verify"
     },
     "dependencies": {
-        "@double-great/stylelint-a11y": "^3.5.2",
+        "@double-great/stylelint-a11y": "^3.5.3",
         "@stylistic/stylelint-plugin": "^5.3.0",
         "postcss-html": "^2.0.0",
         "postcss-scss": "^4.0.9",
@@ -108,7 +109,7 @@
         "stylelint-config-standard-scss": "^17.0.0",
         "stylelint-config-tailwindcss": "^1.0.1",
         "stylelint-declaration-block-no-ignored-properties": "^3.0.0",
-        "stylelint-declaration-strict-value": "^1.11.1",
+        "stylelint-declaration-strict-value": "^1.12.1",
         "stylelint-gamut": "^2.0.1",
         "stylelint-group-selectors": "^1.0.10",
         "stylelint-high-performance-animation": "^2.0.0",
@@ -118,12 +119,12 @@
         "stylelint-order": "^8.1.1",
         "stylelint-plugin-container-query-sanity": "^0.1.4",
         "stylelint-plugin-css-performance-budget": "^2.0.7",
-        "stylelint-plugin-defensive-css": "^2.9.6",
+        "stylelint-plugin-defensive-css": "^2.9.7",
         "stylelint-plugin-docusaurus": "^2.0.5",
-        "stylelint-plugin-file-progress": "^1.0.0",
+        "stylelint-plugin-file-progress": "^1.0.2",
         "stylelint-plugin-font": "^1.1.7",
         "stylelint-plugin-grid": "^1.0.6",
-        "stylelint-plugin-use-baseline": "^1.4.5",
+        "stylelint-plugin-use-baseline": "^1.4.6",
         "stylelint-prettier": "^5.0.3",
         "stylelint-scales": "^5.0.0",
         "stylelint-scss": "^7.2.0",
@@ -133,41 +134,41 @@
     "devDependencies": {
         "@arethetypeswrong/cli": "^0.18.5",
         "@microsoft/tsdoc-config": "^0.18.1",
-        "@types/node": "^26.2.0",
-        "@vitest/coverage-v8": "^4.1.11",
+        "@types/node": "^26.5.0",
+        "@vitest/coverage-v8": "^5.0.0",
         "cross-env": "^10.1.0",
-        "eslint": "^10.8.1",
-        "eslint-config-nick2bad4u": "^14.1.0",
+        "eslint": "^10.10.0",
+        "eslint-config-nick2bad4u": "^14.2.1",
         "git-cliff": "^2.13.1",
         "gitcliff-config-nick2bad4u": "^1.5.0",
         "gitleaks-config-nick2bad4u": "^1.0.5",
-        "jscpd": "^5.0.16",
+        "jscpd": "^5.2.0",
         "jscpd-config-nick2bad4u": "^1.1.1",
-        "lychee-config-nick2bad4u": "^3.0.0",
+        "lychee-config-nick2bad4u": "^3.0.2",
         "ncu-config-nick2bad4u": "^0.2.1",
-        "npm-check-updates": "^23.0.2",
+        "npm-check-updates": "^23.1.0",
         "npm-package-json-lint": "^11.0.0",
         "npm-package-json-lint-config-nick2bad4u": "^1.0.4",
         "picocolors": "^1.1.1",
         "prettier": "^3.9.6",
-        "prettier-config-nick2bad4u": "^2.0.2",
+        "prettier-config-nick2bad4u": "^2.0.4",
         "publint": "^0.3.24",
         "remark": "^15.0.1",
         "remark-cli": "^12.0.1",
-        "remark-config-nick2bad4u": "^1.1.3",
-        "secretlint": "^13.0.4",
+        "remark-config-nick2bad4u": "^1.1.4",
+        "secretlint": "^13.0.5",
         "secretlint-config-nick2bad4u": "^1.1.2",
         "sort-package-json": "^4.0.0",
-        "stylelint": "^17.14.1",
-        "stylelint-config-inspector": "^2.3.5",
+        "stylelint": "^17.15.0",
+        "stylelint-config-inspector": "^2.3.7",
         "tsdoc-config-nick2bad4u": "^1.0.6",
         "typescript": "^6.0.3",
         "vite": "^8.2.2",
-        "vitest": "^4.1.11",
+        "vitest": "^5.0.0",
         "yamllint-config-nick2bad4u": "^1.1.1"
     },
     "peerDependencies": {
-        "stylelint": "^17.14.0"
+        "stylelint": "^17.15.0"
     },
     "peerDependenciesMeta": {
         "stylelint": {
@@ -195,10 +196,10 @@
         "registry": "https://registry.npmjs.org/"
     },
     "allowScripts": {
-        "fsevents@2.3.3": true,
-        "unrs-resolver@1.12.2": true,
         "core-js": false,
-        "esbuild@0.28.2": true
+        "esbuild@0.28.2": true,
+        "fsevents@2.3.3": true,
+        "unrs-resolver@1.12.2": true
     },
     "readme": "README.md"
 }