eslint-plugin-package-json 0.60.0 → 0.61.0

package/CHANGELOG.md

@@ -1,11 +1,17 @@
 # Changelog
 
-# [0.60.0](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/compare/v0.59.1...v0.60.0) (2025-11-03)
+# [0.61.0](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/compare/v0.60.0...v0.61.0) (2025-11-03)
+
+
+### Features
+
+* add new stylistic config ([#1342](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues/1342)) ([3d01cce](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commit/3d01cce99a1718a7485669c7b8cf6143a255b094)), closes [#1341](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues/1341)
 
+# [0.60.0](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/compare/v0.59.1...v0.60.0) (2025-11-03)
 
 ### Features
 
-* **valid-author:** create more precise reports ([#1337](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues/1337)) ([e79ff9a](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commit/e79ff9ac602d85bf999686b018de6ace3a7bee36)), closes [#000](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues/000)
+- **valid-author:** create more precise reports ([#1337](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues/1337)) ([e79ff9a](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commit/e79ff9ac602d85bf999686b018de6ace3a7bee36)), closes [#000](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues/000)
 
 ## [0.59.1](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/compare/v0.59.0...v0.59.1) (2025-10-30)
 

package/README.md

@@ -28,13 +28,12 @@ npm install eslint eslint-plugin-package-json --save-dev
 
 ## Usage
 
-### Config
+### Recommended Config
 
 This plugin's recommended configuration enables its rules on `**/package.json` files, parsing them with [`jsonc-eslint-parser`](https://github.com/ota-meshi/jsonc-eslint-parser).
 
-In your ESLint configuration file:
-
 ```ts
+// eslint.config.ts
 import packageJson from "eslint-plugin-package-json";
 
 export default [
@@ -46,6 +45,7 @@ export default [
 If you want to override the recommended rules:
 
 ```ts
+// eslint.config.ts
 import packageJson from "eslint-plugin-package-json";
 
 export default [
@@ -61,7 +61,23 @@ export default [
 
 See [ESLint's _Configuration Files_ guide](https://eslint.org/docs/latest/use/configure/configuration-files-new) for details on how to customize your rules and other config settings.
 
-### Legacy Config (deprecated)
+### Stylistic Config
+
+The stylistic configuration enables sets up the parser and files similar to the recommended config, but includes rules that are more opinionated about the style of a package.json.
+This can be used in addition to the recommended config, or on its own.
+
+```ts
+// eslint.config.ts
+import packageJson from "eslint-plugin-package-json";
+
+export default [
+	// your other ESLint configurations
+	packageJson.configs.recommended,
+	packageJson.configs.stylistic,
+];
+```
+
+### Legacy Recommended Config (deprecated)
 
 Usage with ESLint's legacy ("eslintrc") format requires also installing [`jsonc-eslint-parser`](https://github.com/ota-meshi/jsonc-eslint-parser):
 
@@ -160,13 +176,14 @@ The default settings don't conflict, and Prettier plugins can quickly fix up ord
 💼 Configurations enabled in.\
 ✔️ Set in the `legacy-recommended` configuration.\
 ✅ Set in the `recommended` configuration.\
+🎨 Set in the `stylistic` configuration.\
 🔧 Automatically fixable by the [`--fix` CLI option](https://eslint.org/docs/user-guide/command-line-interface#--fix).\
 💡 Manually fixable by [editor suggestions](https://eslint.org/docs/latest/use/core-concepts#rule-suggestions).\
 ❌ Deprecated.
 
 | Name                                                                       | Description                                                                                                 | 💼   | 🔧 | 💡 | ❌  |
 | :------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- | :--- | :- | :- | :- |
-| [exports-subpaths-style](docs/rules/exports-subpaths-style.md)             | Enforce consistent format for the exports field (implicit or explicit subpaths).                            |      | 🔧 |    |    |
+| [exports-subpaths-style](docs/rules/exports-subpaths-style.md)             | Enforce consistent format for the exports field (implicit or explicit subpaths).                            | 🎨   | 🔧 |    |    |
 | [no-empty-fields](docs/rules/no-empty-fields.md)                           | Reports on unnecessary empty arrays and objects.                                                            | ✔️ ✅ |    | 💡 |    |
 | [no-redundant-files](docs/rules/no-redundant-files.md)                     | Prevents adding unnecessary / redundant files.                                                              | ✔️ ✅ |    | 💡 |    |
 | [order-properties](docs/rules/order-properties.md)                         | Package properties must be declared in standard order                                                       | ✔️ ✅ | 🔧 |    |    |

package/lib/index.d.ts

@@ -30,6 +30,19 @@ declare const configs: {
       }];
     };
   };
+  stylistic: {
+    files: string[];
+    languageOptions: {
+      parser: typeof jsonc_eslint_parser0;
+    };
+    name: string;
+    plugins: {
+      readonly "package-json": eslint0.ESLint.Plugin;
+    };
+    rules: {
+      [k: string]: "error";
+    };
+  };
 };
 //#endregion
 export { type PackageJsonPluginSettings, configs, plugin as default, rules };

package/lib/plugin.d.ts

@@ -30,6 +30,19 @@ declare const plugin: {
         }];
       };
     };
+    stylistic: {
+      files: string[];
+      languageOptions: {
+        parser: typeof parserJsonc;
+      };
+      name: string;
+      plugins: {
+        readonly "package-json": ESLint.Plugin;
+      };
+      rules: {
+        [k: string]: "error";
+      };
+    };
   };
   meta: {
     name: string;

package/lib/plugin.js

@@ -44,6 +44,7 @@ const recommendedRules = {
 	...baseRecommendedRules,
 	"package-json/valid-package-definition": ["error", { ignoreProperties: Object.entries(baseRecommendedRules).filter(([name$1]) => name$1.startsWith("package-json/valid-") && name$1 !== "package-json/valid-package-definition").map(([name$1]) => name$1.replace("package-json/valid-", "")) }]
 };
+const stylisticRules = { ...Object.fromEntries(Object.entries(rules$2).filter(([, rule$15]) => rule$15.meta.docs?.category === "Stylistic").map(([name$1]) => ["package-json/" + name$1, "error"])) };
 const plugin = {
 	configs: {
 		"legacy-recommended": {
@@ -58,6 +59,15 @@ const plugin = {
 				return plugin;
 			} },
 			rules: recommendedRules
+		},
+		stylistic: {
+			files: ["**/package.json"],
+			languageOptions: { parser: parserJsonc },
+			name: "package-json/stylistic",
+			plugins: { get "package-json"() {
+				return plugin;
+			} },
+			rules: stylisticRules
 		}
 	},
 	meta: {

package/lib/rules/exports-subpaths-style.js

@@ -46,7 +46,7 @@ const rule = createRule({
 	meta: {
 		defaultOptions: [{ prefer: "explicit" }],
 		docs: {
-			category: "Best Practices",
+			category: "Stylistic",
 			description: "Enforce consistent format for the exports field (implicit or explicit subpaths).",
 			recommended: false
 		},

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "eslint-plugin-package-json",
-	"version": "0.60.0",
+	"version": "0.61.0",
 	"description": "Rules for consistent, readable, and valid package.json files. 🗂️",
 	"homepage": "https://github.com/JoshuaKGoldberg/eslint-plugin-package-json#readme",
 	"bugs": {