eslint-plugin-package-json 0.56.3 → 0.56.4

package/CHANGELOG.md

@@ -1,11 +1,17 @@
 # Changelog
 
-## [0.56.3](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/compare/v0.56.2...v0.56.3) (2025-09-15)
+## [0.56.4](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/compare/v0.56.3...v0.56.4) (2025-10-14)
+
+
+### Bug Fixes
+
+* re-adopt jsonc-eslint-parser's RuleListener type ([#1319](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues/1319)) ([2c4c7c2](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commit/2c4c7c2591732f1b298e5e6eb279afe5f7d52cab)), closes [#000](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues/000)
 
+## [0.56.3](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/compare/v0.56.2...v0.56.3) (2025-09-15)
 
 ### Bug Fixes
 
-* **plugin:** update types to be compatible with `defineConfig` ([#1245](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues/1245)) ([861e5e1](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commit/861e5e129b3a5e3455b6b2a2a26d453086f20c14)), closes [#1242](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues/1242)
+- **plugin:** update types to be compatible with `defineConfig` ([#1245](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues/1245)) ([861e5e1](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commit/861e5e129b3a5e3455b6b2a2a26d453086f20c14)), closes [#1242](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues/1242)
 
 ## [0.56.2](https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/compare/v0.56.1...v0.56.2) (2025-09-04)
 

package/README.md

@@ -8,7 +8,7 @@
 <p align="center">
 	<!-- prettier-ignore-start -->
 	<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-	<a href="#contributors" target="_blank"><img alt="👪 All Contributors: 29" src="https://img.shields.io/badge/%F0%9F%91%AA_all_contributors-29-21bb42.svg" /></a>
+	<a href="#contributors" target="_blank"><img alt="👪 All Contributors: 30" src="https://img.shields.io/badge/%F0%9F%91%AA_all_contributors-30-21bb42.svg" /></a>
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 	<!-- prettier-ignore-end -->
 	<a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/blob/main/.github/CODE_OF_CONDUCT.md" target="_blank"><img alt="🤝 Code of Conduct: Kept" src="https://img.shields.io/badge/%F0%9F%A4%9D_code_of_conduct-kept-21bb42" /></a>
@@ -130,10 +130,21 @@ export default {
 
 #### `enforceForPrivate`
 
-**Type:** `boolean`
+- **Type:** `boolean`
+- **Default:** [see below]
 
-Determines whether `require-*` rules, if used, should enforce the presence of the corresponding property in package.json files with `"private": true`.
-By default, all `require-*` rules except for [`require-name`](docs/rules/require-name.md) and [`require-version`](docs/rules/require-version.md) will report if the corresponding property is missing in package.json with `"private": true`.
+When a package.json file has a `"private": true` field, it indicates that the package will not be published to npm (or another online registry).
+Some fields that are nice to have in public packages become less relevant when a package is private.
+This option determines whether `require-*` rules, if used, should enforce the presence of the corresponding property in package.json files that have `"private": true`.
+
+By default, this is:
+
+- `false` for [`require-name`](docs/rules/require-name.md) and [`require-version`](docs/rules/require-version.md).
+- `true` for every other `require-*` rule.
+
+By specifying this setting as `true` or `false`, it will override the defaults and apply the setting for ALL rules.  
+In that case, either all `require-*` rules will be applied to private packages or no `require-*` rules will be applied to private packages.  
+Even then, you can override the setting again at the rule level, by using the rule's `ignorePrivate` option, which will take precedence over this global setting.
 
 ### Usage Alongside Prettier
 
@@ -249,7 +260,7 @@ Thanks! 🗂
       <td align="center" valign="top" width="14.28%"><a href="https://davidlj95.com"><img src="https://avatars.githubusercontent.com/u/8050648?v=4?s=100" width="100px;" alt="David LJ"/><br /><sub><b>David LJ</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=davidlj95" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="http://lishaduck.github.io"><img src="https://avatars.githubusercontent.com/u/88557639?v=4?s=100" width="100px;" alt="Eli"/><br /><sub><b>Eli</b></sub></a><br /><a href="#ideas-lishaduck" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues?q=author%3Alishaduck" title="Bug reports">🐛</a></td>
       <td align="center" valign="top" width="14.28%"><a href="http://heggria.site"><img src="https://avatars.githubusercontent.com/u/34475327?v=4?s=100" width="100px;" alt="Heggria"/><br /><sub><b>Heggria</b></sub></a><br /><a href="#ideas-heggria" title="Ideas, Planning, & Feedback">🤔</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Zamiell"><img src="https://avatars.githubusercontent.com/u/5511220?v=4?s=100" width="100px;" alt="James"/><br /><sub><b>James</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=Zamiell" title="Code">💻</a> <a href="#ideas-Zamiell" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues?q=author%3AZamiell" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Zamiell"><img src="https://avatars.githubusercontent.com/u/5511220?v=4?s=100" width="100px;" alt="James"/><br /><sub><b>James</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=Zamiell" title="Code">💻</a> <a href="#ideas-Zamiell" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues?q=author%3AZamiell" title="Bug reports">🐛</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=Zamiell" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/zetlen"><img src="https://avatars.githubusercontent.com/u/1643758?v=4?s=100" width="100px;" alt="James Zetlen"/><br /><sub><b>James Zetlen</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=zetlen" title="Code">💻</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues?q=author%3Azetlen" title="Bug reports">🐛</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=zetlen" title="Documentation">📖</a> <a href="#infra-zetlen" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#maintenance-zetlen" title="Maintenance">🚧</a> <a href="#tool-zetlen" title="Tools">🔧</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://piranna.github.io/"><img src="https://avatars.githubusercontent.com/u/532414?v=4?s=100" width="100px;" alt="Jesús Leganés-Combarro"/><br /><sub><b>Jesús Leganés-Combarro</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=piranna" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="http://www.joshuakgoldberg.com/"><img src="https://avatars.githubusercontent.com/u/3335181?v=4?s=100" width="100px;" alt="Josh Goldberg ✨"/><br /><sub><b>Josh Goldberg ✨</b></sub></a><br /><a href="#tool-JoshuaKGoldberg" title="Tools">🔧</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues?q=author%3AJoshuaKGoldberg" title="Bug reports">🐛</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=JoshuaKGoldberg" title="Code">💻</a> <a href="#infra-JoshuaKGoldberg" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=JoshuaKGoldberg" title="Documentation">📖</a> <a href="#maintenance-JoshuaKGoldberg" title="Maintenance">🚧</a> <a href="#ideas-JoshuaKGoldberg" title="Ideas, Planning, & Feedback">🤔</a> <a href="#content-JoshuaKGoldberg" title="Content">🖋</a> <a href="#projectManagement-JoshuaKGoldberg" title="Project Management">📆</a></td>
@@ -259,20 +270,21 @@ Thanks! 🗂
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/KristjanESPERANTO"><img src="https://avatars.githubusercontent.com/u/35647502?v=4?s=100" width="100px;" alt="Kristjan ESPERANTO"/><br /><sub><b>Kristjan ESPERANTO</b></sub></a><br /><a href="#ideas-kristjanesperanto" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues?q=author%3Akristjanesperanto" title="Bug reports">🐛</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=kristjanesperanto" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/lo1tuma"><img src="https://avatars.githubusercontent.com/u/169170?v=4?s=100" width="100px;" alt="Mathias Schreck"/><br /><sub><b>Mathias Schreck</b></sub></a><br /><a href="#ideas-lo1tuma" title="Ideas, Planning, & Feedback">🤔</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/Cellule"><img src="https://avatars.githubusercontent.com/u/4157103?v=4?s=100" width="100px;" alt="Michael "Mike" Ferris"/><br /><sub><b>Michael "Mike" Ferris</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=cellule" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://morrisoncole.co.uk"><img src="https://avatars.githubusercontent.com/u/963368?v=4?s=100" width="100px;" alt="Morrison Cole"/><br /><sub><b>Morrison Cole</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues?q=author%3AMorrisonCole" title="Bug reports">🐛</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/nschonni"><img src="https://avatars.githubusercontent.com/u/1297909?v=4?s=100" width="100px;" alt="Nick Schonning"/><br /><sub><b>Nick Schonning</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=nschonni" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/rakleed"><img src="https://avatars.githubusercontent.com/u/19418601?v=4?s=100" width="100px;" alt="Pavel"/><br /><sub><b>Pavel</b></sub></a><br /><a href="#ideas-rakleed" title="Ideas, Planning, & Feedback">🤔</a> <a href="#tool-rakleed" title="Tools">🔧</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=rakleed" title="Documentation">📖</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=rakleed" title="Code">💻</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues?q=author%3Arakleed" title="Bug reports">🐛</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://sasial.dev"><img src="https://avatars.githubusercontent.com/u/44125644?v=4?s=100" width="100px;" alt="Sasial"/><br /><sub><b>Sasial</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=sasial-dev" title="Code">💻</a></td>
     </tr>
     <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://sasial.dev"><img src="https://avatars.githubusercontent.com/u/44125644?v=4?s=100" width="100px;" alt="Sasial"/><br /><sub><b>Sasial</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=sasial-dev" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/sirugh"><img src="https://avatars.githubusercontent.com/u/1278869?v=4?s=100" width="100px;" alt="Stephen"/><br /><sub><b>Stephen</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=sirugh" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://hyoban.cc"><img src="https://avatars.githubusercontent.com/u/38493346?v=4?s=100" width="100px;" alt="Stephen Zhou"/><br /><sub><b>Stephen Zhou</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues?q=author%3Ahyoban" title="Bug reports">🐛</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=hyoban" title="Code">💻</a> <a href="#ideas-hyoban" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=hyoban" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://ota-meshi.github.io/"><img src="https://avatars.githubusercontent.com/u/16508807?v=4?s=100" width="100px;" alt="Yosuke Ota"/><br /><sub><b>Yosuke Ota</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues?q=author%3Aota-meshi" title="Bug reports">🐛</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=ota-meshi" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/b3rnhard"><img src="https://avatars.githubusercontent.com/u/10774404?v=4?s=100" width="100px;" alt="b3rnhard"/><br /><sub><b>b3rnhard</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues?q=author%3Ab3rnhard" title="Bug reports">🐛</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/chouchouji"><img src="https://avatars.githubusercontent.com/u/70570907?v=4?s=100" width="100px;" alt="chouchouji"/><br /><sub><b>chouchouji</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=chouchouji" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/michaelfaith"><img src="https://avatars.githubusercontent.com/u/8071845?v=4?s=100" width="100px;" alt="michael faith"/><br /><sub><b>michael faith</b></sub></a><br /><a href="#infra-michaelfaith" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=michaelfaith" title="Code">💻</a> <a href="#maintenance-michaelfaith" title="Maintenance">🚧</a> <a href="#ideas-michaelfaith" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues?q=author%3Amichaelfaith" title="Bug reports">🐛</a> <a href="#tool-michaelfaith" title="Tools">🔧</a> <a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=michaelfaith" title="Documentation">📖</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://roottool.vercel.app"><img src="https://avatars.githubusercontent.com/u/11808736?v=4?s=100" width="100px;" alt="roottool"/><br /><sub><b>roottool</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=roottool" title="Code">💻</a></td>
     </tr>
     <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://roottool.vercel.app"><img src="https://avatars.githubusercontent.com/u/11808736?v=4?s=100" width="100px;" alt="roottool"/><br /><sub><b>roottool</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/commits?author=roottool" title="Code">💻</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/sunnytsang1998"><img src="https://avatars.githubusercontent.com/u/207208443?v=4?s=100" width="100px;" alt="sunnytsang1998"/><br /><sub><b>sunnytsang1998</b></sub></a><br /><a href="https://github.com/JoshuaKGoldberg/eslint-plugin-package-json/issues?q=author%3Asunnytsang1998" title="Bug reports">🐛</a></td>
     </tr>
   </tbody>

package/lib/createRule.d.ts

@@ -1,5 +1,6 @@
-import { AST } from "jsonc-eslint-parser";
+import { AST, RuleListener } from "jsonc-eslint-parser";
 import * as ESTree from "estree";
+import { FromSchema, JSONSchema } from "json-schema-to-ts";
 import { AST as AST$1, Rule, SourceCode } from "eslint";
 
 //#region src/createRule.d.ts
@@ -31,15 +32,23 @@ interface PackageJsonRuleContext<Options extends unknown[] = unknown[]> extends
   };
   sourceCode: PackageJsonSourceCode;
 }
-interface PackageJsonRuleModule<Options extends unknown[] = unknown[]> {
-  create(context: PackageJsonRuleContext<Options>): Rule.NodeListener;
-  meta: Rule.RuleMetaData;
+interface PackageJsonRuleModule<Options extends unknown[] = unknown[], Schema extends JSONSchema[] = JSONSchema[]> {
+  create(context: PackageJsonRuleContext<Options>): RuleListener;
+  meta: Omit<Rule.RuleMetaData, "defaultOptions" | "schema"> & {
+    defaultOptions?: NoInfer<Options>;
+    schema?: Schema;
+  };
 }
 interface PackageJsonSourceCode extends SourceCode {
   ast: PackageJsonAst;
 }
-declare function createRule<Options extends unknown[]>(rule: PackageJsonRuleModule<Options> & {
+type InferJsonSchemasTupleType<T extends JSONSchema[]> = { [K in keyof T]?: FromSchema<T[K]> };
+/**
+ * Rule options type is inferred from the JSON schema by [json-schema-to-ts](https://www.npmjs.com/package/json-schema-to-ts).
+ * If you're not satisfied with the inferred type, you may specify it manually in the first type parameter.
+ */
+declare function createRule<OptionsOverride extends unknown[] = never, const Schema extends JSONSchema[] = JSONSchema[], _OptionsResolved extends unknown[] = ([OptionsOverride] extends [never] ? InferJsonSchemasTupleType<Schema> : OptionsOverride)>(rule: PackageJsonRuleModule<_OptionsResolved, Schema> & {
   name: string;
-}): PackageJsonRuleModule<Options>;
+}): PackageJsonRuleModule<_OptionsResolved, Schema>;
 //#endregion
 export { JsonAstBodyExpression, JsonAstBodyProperty, JsonAstBodyStatement, PackageJsonAst, PackageJsonPluginSettings, PackageJsonRuleContext, PackageJsonRuleModule, PackageJsonSourceCode, createRule };

package/lib/createRule.js

@@ -1,6 +1,10 @@
 import { isPackageJson } from "./utils/isPackageJson.js";
 
 //#region src/createRule.ts
+/**
+* Rule options type is inferred from the JSON schema by [json-schema-to-ts](https://www.npmjs.com/package/json-schema-to-ts).
+* If you're not satisfied with the inferred type, you may specify it manually in the first type parameter.
+*/
 function createRule(rule) {
 	return {
 		create(context) {

package/lib/index.d.ts

@@ -1,10 +1,11 @@
 import { PackageJsonPluginSettings, PackageJsonRuleModule } from "./createRule.js";
 import { plugin } from "./plugin.js";
 import * as jsonc_eslint_parser0 from "jsonc-eslint-parser";
+import * as json_schema_to_ts0 from "json-schema-to-ts";
 import * as eslint0 from "eslint";
 
 //#region src/index.d.ts
-declare const rules: Record<string, PackageJsonRuleModule<unknown[]>>;
+declare const rules: Record<string, PackageJsonRuleModule<unknown[], json_schema_to_ts0.JSONSchema[]>>;
 declare const configs: {
   "legacy-recommended": {
     plugins: string[];

package/lib/plugin.d.ts

@@ -1,5 +1,6 @@
 import { PackageJsonRuleModule } from "./createRule.js";
 import * as parserJsonc from "jsonc-eslint-parser";
+import * as json_schema_to_ts0 from "json-schema-to-ts";
 import { ESLint } from "eslint";
 
 //#region src/plugin.d.ts
@@ -33,7 +34,7 @@ declare const plugin: {
     name: string;
     version: string;
   };
-  rules: Record<string, PackageJsonRuleModule<unknown[]>>;
+  rules: Record<string, PackageJsonRuleModule<unknown[], json_schema_to_ts0.JSONSchema[]>>;
 };
 //#endregion
 export { plugin };

package/lib/rules/no-empty-fields.d.ts

@@ -1,10 +1,20 @@
 import { PackageJsonRuleModule } from "../createRule.js";
 
 //#region src/rules/no-empty-fields.d.ts
-interface Option {
-  ignoreProperties?: string[];
-}
-type Options = [Option?];
-declare const rule: PackageJsonRuleModule<Options>;
+declare const rule: PackageJsonRuleModule<[({
+  ignoreProperties?: string[] | undefined;
+} | undefined)?], [{
+  readonly additionalProperties: false;
+  readonly properties: {
+    readonly ignoreProperties: {
+      readonly description: "Array of top-level properties to ignore.";
+      readonly items: {
+        readonly type: "string";
+      };
+      readonly type: "array";
+    };
+  };
+  readonly type: "object";
+}]>;
 //#endregion
 export { rule };

package/lib/rules/no-redundant-files.d.ts

@@ -1,6 +1,6 @@
 import { PackageJsonRuleModule } from "../createRule.js";
 
 //#region src/rules/no-redundant-files.d.ts
-declare const rule: PackageJsonRuleModule<unknown[]>;
+declare const rule: PackageJsonRuleModule<[], []>;
 //#endregion
 export { rule };

package/lib/rules/order-properties.d.ts

@@ -1,10 +1,25 @@
 import { PackageJsonRuleModule } from "../createRule.js";
 
 //#region src/rules/order-properties.d.ts
-type Options = [{
-  order: Order;
-}?];
-type Order = "legacy" | "sort-package-json" | string[];
-declare const rule: PackageJsonRuleModule<Options>;
+declare const rule: PackageJsonRuleModule<[({
+  order?: "sort-package-json" | "legacy" | string[] | undefined;
+} | undefined)?], [{
+  readonly additionalProperties: false;
+  readonly properties: {
+    readonly order: {
+      readonly anyOf: readonly [{
+        readonly enum: readonly ["legacy", "sort-package-json"];
+        readonly type: readonly ["string"];
+      }, {
+        readonly items: {
+          readonly type: readonly ["string"];
+        };
+        readonly type: readonly ["array"];
+      }];
+      readonly description: "Specifies the sorting order of top-level properties.";
+    };
+  };
+  readonly type: "object";
+}]>;
 //#endregion
 export { rule };

package/lib/rules/order-properties.js

@@ -39,11 +39,10 @@ const rule = createRule({
 	create(context) {
 		return { "Program:exit"() {
 			const { ast, text } = context.sourceCode;
-			const options = {
-				order: "sort-package-json",
-				...context.options[0]
-			};
-			const requiredOrder = options.order === "legacy" ? standardOrderLegacy : options.order === "sort-package-json" ? sortOrder : options.order;
+			const options = { ...context.options[0] };
+			options.order ??= "sort-package-json";
+			const { order } = options;
+			const requiredOrder = order === "legacy" ? standardOrderLegacy : order === "sort-package-json" ? sortOrder : order;
 			const json = JSON.parse(text);
 			const orderedSource = sortObjectKeys(json, [...requiredOrder, ...Object.keys(json)]);
 			const orderedKeys = Object.keys(orderedSource);

package/lib/rules/repository-shorthand.d.ts

@@ -1,10 +1,18 @@
 import { PackageJsonRuleModule } from "../createRule.js";
 
 //#region src/rules/repository-shorthand.d.ts
-type Form = "object" | "shorthand";
-type Options = [{
-  form: Form;
-}?];
-declare const rule: PackageJsonRuleModule<Options>;
+declare const rule: PackageJsonRuleModule<[({
+  form?: "object" | "shorthand" | undefined;
+} | undefined)?], [{
+  readonly additionalProperties: false;
+  readonly properties: {
+    readonly form: {
+      readonly description: "Specifies which repository form to enforce.";
+      readonly enum: readonly ["object", "shorthand"];
+      readonly type: readonly ["string"];
+    };
+  };
+  readonly type: "object";
+}]>;
 //#endregion
 export { rule };

package/lib/rules/require-properties.d.ts

@@ -3,8 +3,17 @@ import { PackageJsonRuleModule } from "../createRule.js";
 //#region src/rules/require-properties.d.ts
 declare const rules: {
   [k: string]: PackageJsonRuleModule<[({
-    ignorePrivate?: boolean;
-  } | undefined)?]>;
+    ignorePrivate: boolean;
+  } | undefined)?], [{
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly ignorePrivate: {
+        readonly default: boolean;
+        readonly type: "boolean";
+      };
+    };
+    readonly type: "object";
+  }]>;
 };
 //#endregion
 export { rules };

package/lib/rules/restrict-dependency-ranges.d.ts

@@ -1,15 +1,92 @@
 import { PackageJsonRuleModule } from "../createRule.js";
 
 //#region src/rules/restrict-dependency-ranges.d.ts
-interface Option {
-  forDependencyTypes?: string[];
-  forPackages?: string[];
-  forVersions?: string;
-  rangeType: RangeType | RangeType[];
-}
-type Options = [Option | Option[] | undefined];
-declare const RANGE_TYPES: readonly ["caret", "pin", "tilde"];
-type RangeType = (typeof RANGE_TYPES)[number];
-declare const rule: PackageJsonRuleModule<Options>;
+declare const rule: PackageJsonRuleModule<[({
+  forDependencyTypes?: string[] | undefined;
+  forPackages?: string[] | undefined;
+  forVersions?: string | undefined;
+  rangeType: "caret" | "pin" | "tilde" | ("caret" | "pin" | "tilde")[];
+} | {
+  forDependencyTypes?: string[] | undefined;
+  forPackages?: string[] | undefined;
+  forVersions?: string | undefined;
+  rangeType: "caret" | "pin" | "tilde" | ("caret" | "pin" | "tilde")[];
+}[] | undefined)?], [{
+  readonly oneOf: readonly [{
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly forDependencyTypes: {
+        readonly description: "Apply a range type restriction for an entire group of dependencies by which type of dependencies they belong to.";
+        readonly items: {
+          readonly enum: string[];
+        };
+        readonly type: "array";
+      };
+      readonly forPackages: {
+        readonly description: "The exact name of a package, or a regex pattern used to match a group of packages by name.";
+        readonly items: {
+          readonly type: "string";
+        };
+        readonly type: "array";
+      };
+      readonly forVersions: {
+        readonly description: "Apply a restriction to a specific semver range.";
+        readonly type: "string";
+      };
+      readonly rangeType: {
+        readonly description: "Identifies which range type or types you want to apply to packages that match any of the other match options (or all dependencies if no other options are provided).";
+        readonly oneOf: readonly [{
+          readonly enum: readonly ["caret", "pin", "tilde"];
+        }, {
+          readonly items: {
+            readonly enum: readonly ["caret", "pin", "tilde"];
+          };
+          readonly type: "array";
+        }];
+      };
+    };
+    readonly required: readonly ["rangeType"];
+    readonly type: "object";
+  }, {
+    readonly description: "Array of configuration options, specifying range requirements.";
+    readonly items: {
+      readonly additionalProperties: false;
+      readonly properties: {
+        readonly forDependencyTypes: {
+          readonly description: "Apply a range type restriction for an entire group of dependencies by which type of dependencies they belong to.";
+          readonly items: {
+            readonly enum: string[];
+          };
+          readonly type: "array";
+        };
+        readonly forPackages: {
+          readonly description: "The exact name of a package, or a regex pattern used to match a group of packages by name.";
+          readonly items: {
+            readonly type: "string";
+          };
+          readonly type: "array";
+        };
+        readonly forVersions: {
+          readonly description: "Apply a restriction to a specific semver range.";
+          readonly type: "string";
+        };
+        readonly rangeType: {
+          readonly description: "Identifies which range type or types you want to apply to packages that match any of the other match options (or all dependencies if no other options are provided).";
+          readonly oneOf: readonly [{
+            readonly enum: readonly ["caret", "pin", "tilde"];
+          }, {
+            readonly items: {
+              readonly enum: readonly ["caret", "pin", "tilde"];
+            };
+            readonly type: "array";
+          }];
+        };
+      };
+      readonly required: readonly ["rangeType"];
+      readonly type: "object";
+    };
+    readonly type: "array";
+  }];
+}]>;
 //#endregion
 export { rule };

package/lib/rules/sort-collections.d.ts

@@ -1,7 +1,12 @@
 import { PackageJsonRuleModule } from "../createRule.js";
 
 //#region src/rules/sort-collections.d.ts
-type Options = string[];
-declare const rule: PackageJsonRuleModule<Options>;
+declare const rule: PackageJsonRuleModule<[(string[] | undefined)?], [{
+  readonly description: "Array of package properties to require sorting.";
+  readonly items: {
+    readonly type: "string";
+  };
+  readonly type: "array";
+}]>;
 //#endregion
 export { rule };

package/lib/rules/sort-collections.js

@@ -27,14 +27,11 @@ const rule = createRule({
 			const currentOrder = collection.properties;
 			let desiredOrder;
 			if (keyPartsReversed.at(-1) !== "scripts") desiredOrder = currentOrder.slice().sort((a, b) => {
-				const aKey = a.key.value;
-				const bKey = b.key.value;
-				return aKey > bKey ? 1 : -1;
+				return a.key.value > b.key.value ? 1 : -1;
 			});
 			else {
 				const scriptsSource = context.sourceCode.getText(node);
-				const minimalJson = JSON.parse(`{${scriptsSource}}`);
-				const { scripts: sortedScripts } = sortPackageJson(minimalJson);
+				const { scripts: sortedScripts } = sortPackageJson(JSON.parse(`{${scriptsSource}}`));
 				const propertyNodeMap = Object.fromEntries(collection.properties.map((prop) => [prop.key.value, prop]));
 				desiredOrder = Object.keys(sortedScripts).map((prop) => propertyNodeMap[prop]);
 			}

package/lib/rules/unique-dependencies.d.ts

@@ -1,6 +1,6 @@
 import { PackageJsonRuleModule } from "../createRule.js";
 
 //#region src/rules/unique-dependencies.d.ts
-declare const rule: PackageJsonRuleModule<unknown[]>;
+declare const rule: PackageJsonRuleModule<[], []>;
 //#endregion
 export { rule };

package/lib/rules/valid-bin.d.ts

@@ -1,9 +1,17 @@
 import { PackageJsonRuleModule } from "../createRule.js";
 
 //#region src/rules/valid-bin.d.ts
-type Options = [{
-  enforceCase: boolean;
-}?];
-declare const rule: PackageJsonRuleModule<Options>;
+declare const rule: PackageJsonRuleModule<[({
+  enforceCase?: boolean | undefined;
+} | undefined)?], [{
+  readonly additionalProperties: false;
+  readonly properties: {
+    readonly enforceCase: {
+      readonly description: "Enforce that the bin's keys should be in kebab case.";
+      readonly type: "boolean";
+    };
+  };
+  readonly type: "object";
+}]>;
 //#endregion
 export { rule };

package/lib/rules/valid-bin.js

@@ -9,8 +9,7 @@ const rule = createRule({
 		const shouldEnforceCase = !!context.options[0]?.enforceCase;
 		return { "Program > JSONExpressionStatement > JSONObjectExpression > JSONProperty[key.value=bin]"(node) {
 			const binValueNode = node.value;
-			const binValue = JSON.parse(context.sourceCode.getText(binValueNode));
-			const errors = validateBin(binValue);
+			const errors = validateBin(JSON.parse(context.sourceCode.getText(binValueNode)));
 			if (errors.length) context.report({
 				data: { errors: formatErrors(errors) },
 				messageId: "validationError",

package/lib/rules/valid-local-dependency.d.ts

@@ -1,6 +1,6 @@
 import { PackageJsonRuleModule } from "../createRule.js";
 
 //#region src/rules/valid-local-dependency.d.ts
-declare const rule: PackageJsonRuleModule<unknown[]>;
+declare const rule: PackageJsonRuleModule<[], []>;
 //#endregion
 export { rule };

package/lib/rules/valid-name.d.ts

@@ -1,6 +1,6 @@
 import { PackageJsonRuleModule } from "../createRule.js";
 
 //#region src/rules/valid-name.d.ts
-declare const rule: PackageJsonRuleModule<unknown[]>;
+declare const rule: PackageJsonRuleModule<[], []>;
 //#endregion
 export { rule };

package/lib/rules/valid-package-definition.d.ts

@@ -1,10 +1,20 @@
 import { PackageJsonRuleModule } from "../createRule.js";
 
 //#region src/rules/valid-package-definition.d.ts
-interface Option {
-  ignoreProperties?: string[];
-}
-type Options = [Option?];
-declare const rule: PackageJsonRuleModule<Options>;
+declare const rule: PackageJsonRuleModule<[({
+  ignoreProperties?: string[] | undefined;
+} | undefined)?], [{
+  readonly additionalProperties: false;
+  readonly properties: {
+    readonly ignoreProperties: {
+      readonly description: "Array of top-level package properties to ignore.";
+      readonly items: {
+        readonly type: "string";
+      };
+      readonly type: "array";
+    };
+  };
+  readonly type: "object";
+}]>;
 //#endregion
 export { rule };

package/lib/rules/valid-properties.d.ts

@@ -3,7 +3,7 @@ import { PackageJsonRuleModule } from "../createRule.js";
 //#region src/rules/valid-properties.d.ts
 /** All basic valid- flavor rules */
 declare const rules: {
-  [k: string]: PackageJsonRuleModule<unknown[]>;
+  [k: string]: PackageJsonRuleModule<[], []>;
 };
 //#endregion
 export { rules };

package/lib/rules/valid-repository-directory.d.ts

@@ -1,6 +1,6 @@
 import { PackageJsonRuleModule } from "../createRule.js";
 
 //#region src/rules/valid-repository-directory.d.ts
-declare const rule: PackageJsonRuleModule<unknown[]>;
+declare const rule: PackageJsonRuleModule<[], []>;
 //#endregion
 export { rule };

package/lib/rules/valid-version.d.ts

@@ -1,6 +1,6 @@
 import { PackageJsonRuleModule } from "../createRule.js";
 
 //#region src/rules/valid-version.d.ts
-declare const rule: PackageJsonRuleModule<unknown[]>;
+declare const rule: PackageJsonRuleModule<[], []>;
 //#endregion
 export { rule };

package/lib/types/estree.d.ts

@@ -5,6 +5,4 @@ declare module "estree" {
   interface NodeMap {
     JSONNode: JSONNode;
   }
-}
-//#endregion
-export {};
+}

package/lib/utils/createSimpleRequirePropertyRule.d.ts

@@ -11,9 +11,6 @@ interface CreateRequirePropertyRuleOptions {
    */
   isRecommended?: boolean;
 }
-type Options = [{
-  ignorePrivate?: boolean;
-}?];
 /**
  * Given a top-level property name, create a rule that requires that property to be present.
  * Optionally, include it in the recommended config.
@@ -24,7 +21,18 @@ declare const createSimpleRequirePropertyRule: (propertyName: string, {
   ignorePrivateDefault,
   isRecommended
 }?: CreateRequirePropertyRuleOptions) => {
-  rule: PackageJsonRuleModule<Options>;
+  rule: PackageJsonRuleModule<[({
+    ignorePrivate: boolean;
+  } | undefined)?], [{
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly ignorePrivate: {
+        readonly default: boolean;
+        readonly type: "boolean";
+      };
+    };
+    readonly type: "object";
+  }]>;
   ruleName: string;
 };
 //#endregion

package/lib/utils/createSimpleValidPropertyRule.d.ts

@@ -9,7 +9,7 @@ type ValidationFunction = (value: unknown) => string[];
  * to create a more complex rule, create it in its own file.
  */
 declare const createSimpleValidPropertyRule: (propertyName: string, validationFunction: ValidationFunction, aliases?: string[]) => {
-  rule: PackageJsonRuleModule<unknown[]>;
+  rule: PackageJsonRuleModule<[], []>;
   ruleName: string;
 };
 //#endregion

package/lib/utils/createSimpleValidPropertyRule.js

@@ -17,8 +17,7 @@ const createSimpleValidPropertyRule = (propertyName, validationFunction, aliases
 				return propertyNames.reduce((acc, name) => {
 					acc[`Program > JSONExpressionStatement > JSONObjectExpression > JSONProperty[key.value=${name}]`] = (node) => {
 						const valueNode = node.value;
-						const value = JSON.parse(context.sourceCode.getText(valueNode));
-						const errors = validationFunction(value);
+						const errors = validationFunction(JSON.parse(context.sourceCode.getText(valueNode)));
 						if (errors.length) context.report({
 							data: { errors: formatErrors(errors) },
 							messageId: "validationError",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "eslint-plugin-package-json",
-	"version": "0.56.3",
+	"version": "0.56.4",
 	"description": "Rules for consistent, readable, and valid package.json files. 🗂️",
 	"homepage": "https://github.com/JoshuaKGoldberg/eslint-plugin-package-json#readme",
 	"bugs": {
@@ -35,7 +35,6 @@
 		"lint:docs": "eslint-doc-generator --check",
 		"lint:knip": "knip",
 		"lint:md": "markdownlint \"**/*.md\" \".github/**/*.md\" --rules sentences-per-line",
-		"lint:packages": "pnpm dedupe --check",
 		"prepare": "husky",
 		"test": "vitest",
 		"typecheck": "tsc"
@@ -57,9 +56,8 @@
 	},
 	"devDependencies": {
 		"@eslint-community/eslint-plugin-eslint-comments": "4.5.0",
-		"@eslint/js": "9.35.0",
+		"@eslint/js": "9.37.0",
 		"@release-it/conventional-changelog": "10.0.0",
-		"@types/eslint-plugin-markdown": "2.0.2",
 		"@types/estree": "1.0.7",
 		"@types/node": "22.18.0",
 		"@types/semver": "7.7.0",
@@ -68,21 +66,21 @@
 		"@vitest/coverage-v8": "3.2.0",
 		"@vitest/eslint-plugin": "1.3.3",
 		"console-fail-test": "0.5.0",
-		"eslint": "9.35.0",
-		"eslint-doc-generator": "2.2.0",
+		"eslint": "9.37.0",
+		"eslint-doc-generator": "2.3.0",
 		"eslint-plugin-eslint-plugin": "7.0.0",
-		"eslint-plugin-jsdoc": "54.5.0",
-		"eslint-plugin-jsonc": "2.20.0",
-		"eslint-plugin-markdown": "5.1.0",
+		"eslint-plugin-jsdoc": "60.8.0",
+		"eslint-plugin-jsonc": "2.21.0",
 		"eslint-plugin-n": "17.21.0",
 		"eslint-plugin-perfectionist": "4.15.0",
 		"eslint-plugin-regexp": "2.10.0",
-		"eslint-plugin-yml": "1.18.0",
+		"eslint-plugin-yml": "1.19.0",
 		"husky": "9.1.7",
-		"jiti": "2.5.0",
-		"jsonc-eslint-parser": "2.4.0",
-		"knip": "5.63.0",
-		"lint-staged": "16.1.0",
+		"jiti": "2.6.0",
+		"json-schema-to-ts": "3.1.1",
+		"jsonc-eslint-parser": "2.4.1",
+		"knip": "5.64.0",
+		"lint-staged": "16.2.0",
 		"markdownlint": "0.38.0",
 		"markdownlint-cli": "0.45.0",
 		"prettier": "3.6.0",
@@ -91,18 +89,18 @@
 		"prettier-plugin-sh": "0.18.0",
 		"release-it": "19.0.1",
 		"sentences-per-line": "0.3.0",
-		"tsdown": "0.14.0",
+		"tsdown": "0.15.0",
 		"typescript": "5.9.2",
-		"typescript-eslint": "8.41.0",
+		"typescript-eslint": "8.46.0",
 		"vitest": "3.2.0"
 	},
 	"peerDependencies": {
 		"eslint": ">=8.0.0",
 		"jsonc-eslint-parser": "^2.0.0"
 	},
-	"packageManager": "pnpm@10.15.0",
+	"packageManager": "pnpm@10.18.0",
 	"engines": {
-		"node": "^=20.19.0 || >=22.12.0"
+		"node": "^20.19.0 || >=22.12.0"
 	},
 	"publishConfig": {
 		"provenance": true