eslint-plugin-package-json 1.8.1 → 1.10.0

package/README.md

@@ -15,7 +15,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: 44" src="https://img.shields.io/badge/%F0%9F%91%AA_all_contributors-44-21bb42.svg" /></a>
+	<a href="#contributors" target="_blank"><img alt="👪 All Contributors: 45" src="https://img.shields.io/badge/%F0%9F%91%AA_all_contributors-45-21bb42.svg" /></a>
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 	<!-- prettier-ignore-end -->
 	<a href="https://codecov.io/gh/michaelfaith/eslint-plugin-package-json" target="_blank"><img alt="🧪 Coverage" src="https://img.shields.io/codecov/c/github/michaelfaith/eslint-plugin-package-json?label=%F0%9F%A7%AA%20coverage" /></a>
@@ -49,7 +49,9 @@ See [Getting Started](https://eslint-plugin-package-json.dev/getting-started) fo
 | [prefer-rolling-workspace-spec](https://eslint-plugin-package-json.dev/rules/prefer-rolling-workspace-spec)                     | Require that dependencies declared with workspace protocol use a rolling workspace spec instead of a specific semver range.                                                                  |     |     | 💡  |
 | [repository-shorthand](https://eslint-plugin-package-json.dev/rules/repository-shorthand)                                       | Enforce either object or shorthand declaration for repository.                                                                                                                               | ✅  | 🔧  |     |
 | [require-attribution](https://eslint-plugin-package-json.dev/rules/require-attribution)                                         | Ensures that proper attribution is included, requiring that either `author` or `contributors` is defined, and that if `contributors` is present, it should include at least one contributor. | ✅  |     | 💡  |
+| [require-package-json-export](https://eslint-plugin-package-json.dev/rules/require-package-json-export)                         | Ensures that if a package specifies `exports` (or `publishConfig.exports`), an explicit `package.json` export is included.                                                                   |     |     | 💡  |
 | [restrict-dependency-ranges](https://eslint-plugin-package-json.dev/rules/restrict-dependency-ranges)                           | Restricts the range of dependencies to allow or disallow specific types of ranges.                                                                                                           |     |     | 💡  |
+| [restrict-dist-tags](https://eslint-plugin-package-json.dev/rules/restrict-dist-tags)                                           | Restricts dependency dist-tags to an allowed list and selected dependency types.                                                                                                             |     |     |     |
 | [restrict-private-properties](https://eslint-plugin-package-json.dev/rules/restrict-private-properties)                         | Disallows unnecessary properties in private packages.                                                                                                                                        |     | 🔧  | 💡  |
 | [restrict-top-level-properties](https://eslint-plugin-package-json.dev/rules/restrict-top-level-properties)                     | Disallows specified top-level properties in package.json.                                                                                                                                    |     |     | 💡  |
 | [scripts-name-casing](https://eslint-plugin-package-json.dev/rules/scripts-name-casing)                                         | Enforce that names for `scripts` are in kebab case (optionally separated by colons).                                                                                                         | 🎨  |     | 💡  |
@@ -209,7 +211,7 @@ Thanks! 🍻
     </tr>
     <tr>
       <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://hirok.io"><img src="https://avatars.githubusercontent.com/u/1075694?v=4?s=100" width="100px;" alt="Hiroki Osame"/><br /><sub><b>Hiroki Osame</b></sub></a><br /><a href="#ideas-privatenumber" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/michaelfaith/eslint-plugin-package-json/commits?author=privatenumber" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://hirok.io"><img src="https://avatars.githubusercontent.com/u/1075694?v=4?s=100" width="100px;" alt="Hiroki Osame"/><br /><sub><b>Hiroki Osame</b></sub></a><br /><a href="#ideas-privatenumber" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/michaelfaith/eslint-plugin-package-json/commits?author=privatenumber" title="Code">💻</a> <a href="https://github.com/michaelfaith/eslint-plugin-package-json/issues?q=author%3Aprivatenumber" title="Bug reports">🐛</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://vanyauhalin.me/"><img src="https://avatars.githubusercontent.com/u/56481109?v=4?s=100" width="100px;" alt="Ivan Uhalin"/><br /><sub><b>Ivan Uhalin</b></sub></a><br /><a href="#ideas-vanyauhalin" 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/michaelfaith/eslint-plugin-package-json/commits?author=Zamiell" title="Code">💻</a> <a href="#ideas-Zamiell" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/michaelfaith/eslint-plugin-package-json/issues?q=author%3AZamiell" title="Bug reports">🐛</a> <a href="https://github.com/michaelfaith/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/michaelfaith/eslint-plugin-package-json/commits?author=zetlen" title="Code">💻</a> <a href="https://github.com/michaelfaith/eslint-plugin-package-json/issues?q=author%3Azetlen" title="Bug reports">🐛</a> <a href="https://github.com/michaelfaith/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>
@@ -237,13 +239,14 @@ Thanks! 🍻
     <tr>
       <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/michaelfaith/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/michaelfaith/eslint-plugin-package-json/issues?q=author%3Ahyoban" title="Bug reports">🐛</a> <a href="https://github.com/michaelfaith/eslint-plugin-package-json/commits?author=hyoban" title="Code">💻</a> <a href="#ideas-hyoban" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/michaelfaith/eslint-plugin-package-json/commits?author=hyoban" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/thernstig"><img src="https://avatars.githubusercontent.com/u/30827238?v=4?s=100" width="100px;" alt="Tobias Hernstig"/><br /><sub><b>Tobias Hernstig</b></sub></a><br /><a href="https://github.com/michaelfaith/eslint-plugin-package-json/issues?q=author%3Athernstig" title="Bug reports">🐛</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://www.wesleytodd.com/"><img src="https://avatars.githubusercontent.com/u/1027776?v=4?s=100" width="100px;" alt="Wes Todd"/><br /><sub><b>Wes Todd</b></sub></a><br /><a href="#ideas-wesleytodd" title="Ideas, Planning, & Feedback">🤔</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/michaelfaith/eslint-plugin-package-json/issues?q=author%3Aota-meshi" title="Bug reports">🐛</a> <a href="https://github.com/michaelfaith/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/michaelfaith/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/michaelfaith/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/michaelfaith/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/michaelfaith/eslint-plugin-package-json/issues?q=author%3Amichaelfaith" title="Bug reports">🐛</a> <a href="#tool-michaelfaith" title="Tools">🔧</a> <a href="https://github.com/michaelfaith/eslint-plugin-package-json/commits?author=michaelfaith" title="Documentation">📖</a> <a href="#projectManagement-michaelfaith" title="Project Management">📆</a></td>
     </tr>
     <tr>
+      <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/michaelfaith/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/michaelfaith/eslint-plugin-package-json/issues?q=author%3Amichaelfaith" title="Bug reports">🐛</a> <a href="#tool-michaelfaith" title="Tools">🔧</a> <a href="https://github.com/michaelfaith/eslint-plugin-package-json/commits?author=michaelfaith" title="Documentation">📖</a> <a href="#projectManagement-michaelfaith" title="Project Management">📆</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/michaelfaith/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/michaelfaith/eslint-plugin-package-json/issues?q=author%3Asunnytsang1998" title="Bug reports">🐛</a></td>
     </tr>

package/dist/experimental/index.mjs

@@ -1,4 +1,4 @@
-import { t as plugin$1 } from "../plugin-DlF-r5D9.mjs";
+import { t as plugin$1 } from "../plugin-BfdzXm-J.mjs";
 import { toCompatRule } from "eslint-json-compat-utils";
 //#region src/experimental/plugin.ts
 const language = "json/json";

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { t as plugin } from "./plugin-DlF-r5D9.mjs";
+import { t as plugin } from "./plugin-BfdzXm-J.mjs";
 //#region src/index.ts
 const rules = plugin.rules;
 const configs = plugin.configs;

package/dist/{plugin-DlF-r5D9.mjs → plugin-BfdzXm-J.mjs}

@@ -41,8 +41,7 @@ function createRule(rule) {
 	const ruleGroup = rule.meta.docs?.ruleGroup;
 	return {
 		create(context) {
-			if (!isPackageJson(context.filename)) return {};
-			return rule.create(context);
+			return isPackageJson(context.filename) ? rule.create(context) : {};
 		},
 		meta: {
 			...rule.meta,
@@ -55,7 +54,7 @@ function createRule(rule) {
 }
 //#endregion
 //#region src/rules/bin-name-casing.ts
-const rule$19 = createRule({
+const rule$21 = createRule({
 	create(context) {
 		return { "Program > JSONExpressionStatement > JSONObjectExpression > JSONProperty[key.value=bin]"(node) {
 			if (node.value.type === "JSONObjectExpression") for (const property of node.value.properties) {
@@ -93,17 +92,16 @@ const rule$19 = createRule({
 });
 //#endregion
 //#region src/rules/exports-subpaths-style.ts
-function isImplicitFormat(node) {
-	if (node.type === "JSONLiteral") return true;
-	return node.properties.every((property) => !isJSONStringLiteral(property.key) || !property.key.value.startsWith("."));
+function isImplicitFormat$1(node) {
+	return node.type === "JSONLiteral" ? true : node.properties.every((property) => !isJSONStringLiteral(property.key) || !property.key.value.startsWith("."));
 }
-const rule$18 = createRule({
+const rule$20 = createRule({
 	create(context) {
 		const [{ prefer = "explicit" } = {}] = context.options;
 		function validateForExplicit(node) {
 			const { value } = node;
 			if (isJSONNullLiteral(value)) return;
-			if (value.type !== "JSONLiteral" && value.type !== "JSONObjectExpression" || !isImplicitFormat(value)) return;
+			if (value.type !== "JSONLiteral" && value.type !== "JSONObjectExpression" || !isImplicitFormat$1(value)) return;
 			context.report({
 				fix(fixer) {
 					const valueText = context.sourceCode.getText(value);
@@ -200,25 +198,21 @@ const getTopLevelProperty = (node) => {
 	return n.type === "JSONProperty" ? n.key : void 0;
 };
 const defaultIgnoreProperties = ["files"];
-const rule$17 = createRule({
+const rule$19 = createRule({
 	create(context) {
 		const ignoreProperties = new Set(context.options[0]?.ignoreProperties ?? defaultIgnoreProperties);
 		return {
 			JSONArrayExpression(node) {
 				const topLevelProperty = getTopLevelProperty(node);
-				if (!topLevelProperty) return;
-				if (!node.elements.length) {
-					const topLevelPropertyName = topLevelProperty.value;
-					if (!ignoreProperties.has(topLevelPropertyName)) report(context, getNode(node));
-				}
+				if (!topLevelProperty || node.elements.length) return;
+				const topLevelPropertyName = topLevelProperty.value;
+				if (!ignoreProperties.has(topLevelPropertyName)) report(context, getNode(node));
 			},
 			JSONObjectExpression(node) {
 				const topLevelProperty = getTopLevelProperty(node);
-				if (!topLevelProperty) return;
-				if (!node.properties.length) {
-					const topLevelPropertyName = topLevelProperty.value;
-					if (!ignoreProperties.has(topLevelPropertyName)) report(context, getNode(node));
-				}
+				if (!topLevelProperty || node.properties.length) return;
+				const topLevelPropertyName = topLevelProperty.value;
+				if (!ignoreProperties.has(topLevelPropertyName)) report(context, getNode(node));
 			}
 		};
 	},
@@ -256,7 +250,7 @@ const getBundledDependencyNames = (value) => {
 	if (value?.type === "JSONArrayExpression") for (const element of value.elements.filter(isNotNullish).filter(isJSONStringLiteral)) names.add(element.value);
 	return names;
 };
-const rule$16 = createRule({
+const rule$18 = createRule({
 	create(context) {
 		const ignorePrivate = context.options[0]?.ignorePrivate ?? true;
 		let isPrivate = false;
@@ -327,7 +321,7 @@ const getCachedLocalFileRegex = (filename) => {
 		return regex;
 	}
 };
-const rule$15 = createRule({
+const rule$17 = createRule({
 	create(context) {
 		const entryCache = {
 			bin: [],
@@ -404,7 +398,7 @@ const rule$15 = createRule({
 });
 //#endregion
 //#region src/rules/no-redundant-publishConfig.ts
-const rule$14 = createRule({
+const rule$16 = createRule({
 	create(context) {
 		let packageName;
 		let publishConfigAccessProperty;
@@ -450,7 +444,7 @@ const rule$14 = createRule({
 });
 //#endregion
 //#region src/rules/order-properties.ts
-const rule$13 = createRule({
+const rule$15 = createRule({
 	create(context) {
 		return { "Program:exit"() {
 			const { ast, text } = context.sourceCode;
@@ -510,7 +504,7 @@ const rule$13 = createRule({
 //#region src/rules/prefer-rolling-workspace-spec.ts
 const rollingWorkspaceSpecRegex = /^workspace:[*^~]?$/;
 const convertibleSpecRegex = /^(workspace:[~^])/;
-const rule$12 = createRule({
+const rule$14 = createRule({
 	create(context) {
 		const { ignoreDependencies = [], ignorePatterns = [] } = context.options[0] ?? {};
 		const ignoreRegexes = ignorePatterns.map((pattern) => new RegExp(pattern));
@@ -608,14 +602,13 @@ const createUrl = (shorthand) => {
 	}
 	return `${providerUrls.github}${shorthand}`;
 };
-const rule$11 = createRule({
+const rule$13 = createRule({
 	create(context) {
 		const [{ form = "object" } = {}] = context.options;
 		function validateRepositoryForObject(node) {
 			if (isJSONStringLiteral(node.value)) context.report({
 				fix(fixer) {
-					if (!isJSONStringLiteral(node.value) || node.value.value.split("/").filter(Boolean).length !== 2) return null;
-					return fixer.replaceText(node.value, JSON.stringify({
+					return !isJSONStringLiteral(node.value) || node.value.value.split("/").filter(Boolean).length !== 2 ? null : fixer.replaceText(node.value, JSON.stringify({
 						type: "git",
 						url: createUrl(node.value.value)
 					}, null, 2));
@@ -687,7 +680,7 @@ const rule$11 = createRule({
 });
 //#endregion
 //#region src/rules/require-attribution.ts
-const rule$10 = createRule({
+const rule$12 = createRule({
 	create(context) {
 		const preferContributorsOnly = context.options[0]?.preferContributorsOnly ?? false;
 		const ignorePrivate = context.options[0]?.ignorePrivate ?? true;
@@ -774,6 +767,86 @@ const rule$10 = createRule({
 	name: "require-attribution"
 });
 //#endregion
+//#region src/utils/increaseIndent.ts
+const increaseIndent = (original, additional) => original.split("\n").join(`\n${additional}`);
+//#endregion
+//#region src/rules/require-package-json-export.ts
+function isImplicitFormat(node) {
+	return node.properties.every((property) => !isJSONStringLiteral(property.key) || !property.key.value.startsWith("."));
+}
+const rule$11 = createRule({
+	create(context) {
+		let publishConfigExportsValueNode;
+		let exportsValueNode;
+		return {
+			"Program > JSONExpressionStatement > JSONObjectExpression > JSONProperty[key.value=exports]"(node) {
+				if (node.value.type === "JSONObjectExpression" || isJSONStringLiteral(node.value)) exportsValueNode = node.value;
+			},
+			"Program > JSONExpressionStatement > JSONObjectExpression > JSONProperty[key.value=publishConfig] > JSONObjectExpression > JSONProperty[key.value=exports]"(node) {
+				if (node.value.type === "JSONObjectExpression" || isJSONStringLiteral(node.value)) publishConfigExportsValueNode = node.value;
+			},
+			"Program:exit"() {
+				const exportsNode = publishConfigExportsValueNode ?? exportsValueNode;
+				if (!exportsNode) return;
+				const isPublishConfig = !!publishConfigExportsValueNode;
+				const { text } = context.sourceCode;
+				const { indent, type } = detectIndent(text);
+				const indentUnit = type === "tab" ? "	" : indent || "  ";
+				const extraIndent = isPublishConfig ? `${indentUnit}${indentUnit}` : indentUnit;
+				if (isJSONStringLiteral(exportsNode) || isImplicitFormat(exportsNode)) {
+					context.report({
+						messageId: "missing",
+						node: exportsNode,
+						suggest: [{
+							messageId: "addExport",
+							fix(fixer) {
+								const valueText = context.sourceCode.getText(exportsNode);
+								const fixedValue = increaseIndent(JSON.stringify({
+									".": JSON.parse(valueText),
+									"./package.json": "./package.json"
+								}, null, indentUnit), extraIndent);
+								return fixer.replaceText(exportsNode, fixedValue);
+							}
+						}]
+					});
+					return;
+				}
+				if (exportsNode.properties.some((property) => isJSONStringLiteral(property.key) && property.key.value === "./package.json")) return;
+				context.report({
+					messageId: "missing",
+					node: exportsNode,
+					suggest: [{
+						messageId: "addExport",
+						fix(fixer) {
+							const valueText = context.sourceCode.getText(exportsNode);
+							const existingExports = JSON.parse(valueText);
+							const fixedValue = increaseIndent(JSON.stringify({
+								...existingExports,
+								"./package.json": "./package.json"
+							}, null, indentUnit), extraIndent);
+							return fixer.replaceText(exportsNode, fixedValue);
+						}
+					}]
+				});
+			}
+		};
+	},
+	meta: {
+		docs: {
+			category: "Best Practices",
+			description: "Ensures that if a package specifies `exports` (or `publishConfig.exports`), an explicit `package.json` export is included."
+		},
+		hasSuggestions: true,
+		messages: {
+			missing: "An export for the package.json is required, and missing.",
+			addExport: "Add package.json export."
+		},
+		schema: [],
+		type: "suggestion"
+	},
+	name: "require-package-json-export"
+});
+//#endregion
 //#region src/utils/createSimpleRequirePropertyRule.ts
 /**
 * Given a top-level property name, create a rule that requires that property to be present.
@@ -790,21 +863,20 @@ const createSimpleRequirePropertyRule = (propertyName, { category, fixValue, ign
 				const ignorePrivate = context.options[0]?.ignorePrivate ?? (typeof enforceForPrivate === "boolean" ? !enforceForPrivate : ignorePrivateDefault);
 				return { "Program > JSONExpressionStatement > JSONObjectExpression"(node) {
 					if (ignorePrivate && node.properties.some((property) => isJSONStringLiteral(property.key) && property.key.value === "private" && property.value.type === "JSONLiteral" && property.value.value === true)) return;
-					if (node.properties.every((property) => !(isJSONStringLiteral(property.key) && property.key.value === propertyName))) {
-						const resolvedValue = typeof fixValue === "function" ? fixValue() : fixValue;
-						context.report({
-							data: { property: propertyName },
-							fix: resolvedValue === void 0 ? void 0 : function* (fixer) {
-								yield fixer.insertTextAfterRange([0, 1], `\n  "${propertyName}": ${JSON.stringify(resolvedValue, null, 2).split("\n").join("\n  ")}`);
-								yield node.properties.length > 0 ? fixer.insertTextAfterRange([0, 1], ",") : fixer.insertTextAfterRange([0, 1], "\n");
-							},
-							loc: {
-								column: 0,
-								line: 1
-							},
-							messageId: "missing"
-						});
-					}
+					if (node.properties.some((property) => isJSONStringLiteral(property.key) && property.key.value === propertyName)) return;
+					const resolvedValue = typeof fixValue === "function" ? fixValue() : fixValue;
+					context.report({
+						data: { property: propertyName },
+						fix: resolvedValue === void 0 ? void 0 : function* (fixer) {
+							yield fixer.insertTextAfterRange([0, 1], `\n  "${propertyName}": ${JSON.stringify(resolvedValue, null, 2).split("\n").join("\n  ")}`);
+							yield node.properties.length > 0 ? fixer.insertTextAfterRange([0, 1], ",") : fixer.insertTextAfterRange([0, 1], "\n");
+						},
+						loc: {
+							column: 0,
+							line: 1
+						},
+						messageId: "missing"
+					});
 				} };
 			},
 			meta: {
@@ -929,7 +1001,7 @@ const rules$2 = Object.fromEntries([
 }));
 //#endregion
 //#region src/rules/restrict-dependency-ranges.ts
-const DEPENDENCY_TYPES = [
+const DEPENDENCY_TYPES$1 = [
 	"dependencies",
 	"devDependencies",
 	"optionalDependencies",
@@ -975,7 +1047,7 @@ const schemaOptions = {
 	properties: {
 		forDependencyTypes: {
 			description: "Apply a range type restriction for an entire group of dependencies by which type of dependencies they belong to.",
-			items: { enum: DEPENDENCY_TYPES },
+			items: { enum: DEPENDENCY_TYPES$1 },
 			type: "array"
 		},
 		forPackages: {
@@ -1001,7 +1073,7 @@ const schemaOptions = {
 const normalizeRangeType = (rangeTypeOrSymbol) => RANGE_TYPES.find((rangeType) => "symbol" in rangeType && rangeType.symbol === rangeTypeOrSymbol || rangeType.alias === rangeTypeOrSymbol);
 /** @returns `undefined` if workspace versions are not supported for the specified {@link rangeType} */
 const getWorkspaceVersionForRange = (rangeType) => {
-	if ("workspaceSymbol" in rangeType) return `workspace:${rangeType.workspaceSymbol}`;
+	return "workspaceSymbol" in rangeType ? `workspace:${rangeType.workspaceSymbol}` : void 0;
 };
 /** For displaying a range type in a user-facing way (ie. an error message). */
 const displayRangeType = (rangeType) => "symbol" in rangeType ? rangeType.symbol : rangeType.alias;
@@ -1029,7 +1101,7 @@ const isVersionSupported = (version) => {
 	return !!semver.validRange(rawVersion);
 };
 const POSSIBLE_WORKSPACE_SPEC_REGEX = /(?:workspace:)?[^~]?/;
-const rule$9 = createRule({
+const rule$10 = createRule({
 	create(context) {
 		if (!context.options[0]) return {};
 		const optionsArray = (Array.isArray(context.options[0]) ? context.options[0].toReversed() : [context.options[0]]).map((option) => ({
@@ -1039,7 +1111,7 @@ const rule$9 = createRule({
 		}));
 		return { "Program > JSONExpressionStatement > JSONObjectExpression > JSONProperty[key.type=JSONLiteral][value.type=JSONObjectExpression]"(node) {
 			const dependencyType = node.key.value;
-			if (!DEPENDENCY_TYPES.includes(dependencyType)) return;
+			if (!DEPENDENCY_TYPES$1.includes(dependencyType)) return;
 			for (const property of node.value.properties) {
 				if (!isJSONStringLiteral(property.key) || !isJSONStringLiteral(property.value)) continue;
 				const name = property.key.value;
@@ -1106,6 +1178,73 @@ const rule$9 = createRule({
 	name: "restrict-dependency-ranges"
 });
 //#endregion
+//#region src/rules/restrict-dist-tags.ts
+const DEPENDENCY_TYPES = [
+	"dependencies",
+	"devDependencies",
+	"optionalDependencies",
+	"peerDependencies"
+];
+const DEFAULT_ALLOWED_TAGS = [
+	"latest",
+	"dev",
+	"next",
+	"alpha",
+	"beta",
+	"canary",
+	"rc"
+];
+const distTagPattern = /^[A-Z0-9][\w.-]*$/i;
+function isDistTag(value) {
+	return !semver.validRange(value) && distTagPattern.test(value);
+}
+const rule$9 = createRule({
+	create(context) {
+		const { allowed = DEFAULT_ALLOWED_TAGS, allowedFor } = context.options[0] ?? {};
+		return { "Program > JSONExpressionStatement > JSONObjectExpression > JSONProperty[key.type=JSONLiteral][value.type=JSONObjectExpression]"(node) {
+			const dependencyType = node.key.value;
+			if (!DEPENDENCY_TYPES.includes(dependencyType)) return;
+			for (const property of node.value.properties) {
+				if (!isJSONStringLiteral(property.key) || !isJSONStringLiteral(property.value)) continue;
+				const spec = property.value.value;
+				if (!isDistTag(spec)) continue;
+				if ((allowedFor === void 0 || allowedFor.includes(dependencyType)) && allowed.includes(spec)) continue;
+				context.report({
+					data: {
+						dependencyType,
+						tag: spec
+					},
+					messageId: "disallowedDistTag",
+					node: property.value
+				});
+			}
+		} };
+	},
+	meta: {
+		defaultOptions: [{ allowed: DEFAULT_ALLOWED_TAGS }],
+		docs: { description: "Restricts dependency dist-tags to an allowed list and selected dependency types." },
+		messages: { disallowedDistTag: "The \"{{ tag }}\" dist-tag is not allowed for {{ dependencyType }}." },
+		schema: [{
+			type: "object",
+			properties: {
+				allowed: {
+					description: "Dist-tags allowed in dependency specifications.",
+					type: "array",
+					items: { type: "string" }
+				},
+				allowedFor: {
+					description: "Dependency sections where the allowed dist-tags may be used.",
+					type: "array",
+					items: { enum: DEPENDENCY_TYPES }
+				}
+			},
+			additionalProperties: false
+		}],
+		type: "problem"
+	},
+	name: "restrict-dist-tags"
+});
+//#endregion
 //#region src/rules/restrict-private-properties.ts
 const defaultBlockedProperties = ["files", "publishConfig"];
 const rule$8 = createRule({
@@ -1325,8 +1464,7 @@ const rule$5 = createRule({
 				const bKey = b.key.value;
 				const ai = rank(aKey);
 				const bi = rank(bKey);
-				if (ai !== bi) return ai - bi;
-				return naturalCompare(aKey, bKey);
+				return ai === bi ? naturalCompare(aKey, bKey) : ai - bi;
 			});
 			if (currentOrder.some((property, i) => desiredOrder[i] !== property)) context.report({
 				data: { key },
@@ -1490,10 +1628,9 @@ const rule$3 = createRule({
 				if (!dependencyPropertyNames.has(node.key.value)) return;
 				const nodeValueType = node.value.type;
 				if (nodeValueType === "JSONArrayExpression") check(node.value.elements, (element) => element);
-				if (nodeValueType === "JSONObjectExpression") {
-					check(node.value.properties.map((property) => property.key), (property) => property.parent);
-					if (trackForCrossGroupUniqueness.includes(node.key.value)) dependenciesCache[node.key.value] = node.value.properties;
-				}
+				if (nodeValueType !== "JSONObjectExpression") return;
+				check(node.value.properties.map((property) => property.key), (property) => property.parent);
+				if (trackForCrossGroupUniqueness.includes(node.key.value)) dependenciesCache[node.key.value] = node.value.properties;
 			},
 			"Program:exit"() {
 				const dependencyNames = new Set(dependenciesCache.dependencies.map((node) => node.key).filter(isJSONStringLiteral).map((dependencyNameNode) => dependencyNameNode.value));
@@ -1743,8 +1880,7 @@ function* lookup(cwd = process.cwd()) {
 	}
 }
 function parsePackageJson(filepath) {
-	if (!filepath || !fs.existsSync(filepath)) return null;
-	return handlePackageManager(filepath);
+	return !filepath || !fs.existsSync(filepath) ? null : handlePackageManager(filepath);
 }
 /**
 * Detects the package manager used in the project.
@@ -1788,10 +1924,10 @@ function getNameAndVersion(pkg) {
 			version: normalizeVersion(version)
 		};
 	}
-	if (typeof pkg.devEngines?.packageManager?.name === "string") return {
+	return typeof pkg.devEngines?.packageManager?.name === "string" ? {
 		name: pkg.devEngines.packageManager.name,
 		version: normalizeVersion(pkg.devEngines.packageManager.version)
-	};
+	} : void 0;
 }
 function handlePackageManager(filepath) {
 	try {
@@ -1940,18 +2076,20 @@ const rule = createRule({
 //#region src/plugin.ts
 const require = createRequire(import.meta.url);
 const rules = {
-	"bin-name-casing": rule$19,
-	"exports-subpaths-style": rule$18,
-	"no-empty-fields": rule$17,
-	"no-local-dependencies": rule$16,
-	"no-redundant-files": rule$15,
-	"no-redundant-publishConfig": rule$14,
-	"order-properties": rule$13,
-	"prefer-rolling-workspace-spec": rule$12,
-	"require-attribution": rule$10,
+	"bin-name-casing": rule$21,
+	"exports-subpaths-style": rule$20,
+	"no-empty-fields": rule$19,
+	"no-local-dependencies": rule$18,
+	"no-redundant-files": rule$17,
+	"no-redundant-publishConfig": rule$16,
+	"order-properties": rule$15,
+	"prefer-rolling-workspace-spec": rule$14,
+	"require-attribution": rule$12,
+	"require-package-json-export": rule$11,
 	...rules$2,
-	"repository-shorthand": rule$11,
-	"restrict-dependency-ranges": rule$9,
+	"repository-shorthand": rule$13,
+	"restrict-dependency-ranges": rule$10,
+	"restrict-dist-tags": rule$9,
 	"restrict-private-properties": rule$8,
 	"restrict-top-level-properties": rule$7,
 	"scripts-name-casing": rule$6,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-package-json",
-  "version": "1.8.1",
+  "version": "1.10.0",
   "description": "Rules for consistent, readable, and valid package.json files. 🗂️",
   "homepage": "https://github.com/michaelfaith/eslint-plugin-package-json#readme",
   "bugs": {
@@ -36,7 +36,8 @@
     "./experimental": {
       "types": "./dist/experimental/index.d.mts",
       "default": "./dist/experimental/index.mjs"
-    }
+    },
+    "./package.json": "./package.json"
   },
   "main": "dist/index.mjs",
   "files": [
@@ -59,38 +60,38 @@
   "devDependencies": {
     "@astrojs/check": "0.9.10",
     "@astrojs/markdown-satteri": "0.4.1",
-    "@astrojs/starlight": "0.42.0",
+    "@astrojs/starlight": "0.42.2",
     "@catppuccin/starlight": "2.1.0",
-    "@eslint-community/eslint-plugin-eslint-comments": "4.8.0",
+    "@eslint-community/eslint-plugin-eslint-comments": "4.8.1",
     "@eslint/js": "10.0.1",
     "@eslint/json": "2.1.0",
     "@eslint/markdown": "8.0.3",
     "@ianvs/prettier-plugin-sort-imports": "4.7.1",
-    "@types/node": "24.13.4",
+    "@types/node": "24.13.6",
     "@types/semver": "7.8.0",
     "@typescript/native": "npm:typescript@7.0.2",
-    "@vitest/coverage-v8": "5.0.0",
+    "@vitest/coverage-v8": "5.0.1",
     "@vitest/eslint-plugin": "1.6.27",
-    "astro": "7.3.2",
-    "astro-og-canvas": "0.13.1",
+    "astro": "7.3.3",
+    "astro-og-canvas": "0.13.2",
     "canvaskit-wasm": "0.42.0",
     "console-fail-test": "0.6.1",
-    "eslint": "10.10.0",
+    "eslint": "10.11.0",
     "eslint-doc-generator": "3.7.1",
     "eslint-plugin-eslint-plugin": "7.6.2",
-    "eslint-plugin-jsdoc": "64.3.8",
+    "eslint-plugin-jsdoc": "64.5.4",
     "eslint-plugin-jsonc": "3.4.2",
     "eslint-plugin-n": "18.3.0",
     "eslint-plugin-node-dependencies": "2.2.0",
-    "eslint-plugin-perfectionist": "5.11.0",
+    "eslint-plugin-perfectionist": "5.11.1",
     "eslint-plugin-regexp": "3.3.0",
-    "eslint-plugin-unicorn": "74.0.0",
+    "eslint-plugin-unicorn": "75.0.0",
     "eslint-plugin-yml": "3.8.1",
     "jiti": "2.7.0",
     "json-schema-to-ts": "3.1.1",
-    "knip": "6.35.1",
+    "knip": "6.37.0",
     "pkg-pr-new": "0.0.88",
-    "prettier": "3.9.6",
+    "prettier": "3.9.8",
     "prettier-plugin-curly": "0.4.1",
     "prettier-plugin-packagejson": "3.0.2",
     "prettier-plugin-sh": "0.19.0",
@@ -101,7 +102,7 @@
     "tsdown": "0.23.0",
     "typescript": "npm:@typescript/typescript6@6.0.2",
     "typescript-eslint": "8.70.0",
-    "vitest": "5.0.0"
+    "vitest": "5.0.1"
   },
   "peerDependencies": {
     "@eslint/json": ">=1.0.0",