peerDependenciesMetaRelationship

Enforces that any dependencies declared in peerDependenciesMeta are also defined in the package's peerDependencies.

✅ This rule is included in the package-json logical presets.

The rule checks that any dependencies declared in peerDependenciesMeta are also defined in the package’s peerDependencies.

peerDependenciesMeta is meant to provide metadata about peer dependencies. So entries that do not correspond to an existing peerDependencies dependency are considered redundant.

Examples

❌ Incorrect

{
  "peerDependencies": {
    "one-package": "^1.0.0"
  },
  "peerDependenciesMeta": {
    "some-other-package": {
      "optional": true
    }
  }
}

✅ Correct

{
  "peerDependencies": {
    "some-package": "^1.0.0"
  },
  "peerDependenciesMeta": {
    "some-package": {
      "optional": true
    }
  }
}

Suggestions

When this rule reports an invalid peerDependenciesMeta entry, it provides an editor suggestion to remove that property.

Related Rules

• peerDependenciesPresence - Enforces that the peerDependencies property is present.

Further Reading

• npm: package.json > peerDependenciesMeta
• pnpm: package.json > peerDependenciesMeta
• Yarn: package.json > peerDependenciesMeta

Equivalents in Other Linters

• ESLint: package-json/valid-peerDependenciesMeta-relationship