Skip to content

fix: restrict peer dependency ranges to avoid npm resolution conflicts#7593

Open
MaxenceMouchard wants to merge 2 commits intoueberdosis:mainfrom
MaxenceMouchard:fix/peer-deps-version-range
Open

fix: restrict peer dependency ranges to avoid npm resolution conflicts#7593
MaxenceMouchard wants to merge 2 commits intoueberdosis:mainfrom
MaxenceMouchard:fix/peer-deps-version-range

Conversation

@MaxenceMouchard
Copy link
Copy Markdown

Changes Overview

Fixes dependency resolution conflicts that occur when all Tiptap packages are pinned to the same version (e.g. 3.19.0).
Several packages currently declare peer dependencies such as "@tiptap/core": "^3.19.0", which allows npm to resolve newer versions of @tiptap/core (e.g. 3.20.x). Those newer versions may require newer peer dependencies such as "@tiptap/pm": "^3.20.x", causing an ERESOLVE unable to resolve dependency tree error when the project intentionally pins @tiptap/pm to 3.19.0.

This PR aligns peer dependency ranges between Tiptap packages so that installations remain consistent when all packages are pinned to the same version.

Implementation Approach

Updated peer dependency ranges across affected packages to ensure they remain compatible when the ecosystem is installed with synchronized versions. The goal is to prevent npm from resolving newer incompatible versions when a project intentionally locks all Tiptap packages to a specific version.

Testing Done

Tested by creating a project with all Tiptap packages pinned to version 3.19.0 and running npm install.

Before this change, npm fails with:

ERESOLVE unable to resolve dependency tree

After applying the peer dependency adjustments, npm install resolves the dependency tree successfully.

Verification Steps

Create a project and pin all Tiptap packages to 3.19.0.

Run npm install.

Verify that npm resolves dependencies without ERESOLVE errors.

Additional Notes

Multiple issues in the repository report similar dependency resolution problems when pinning Tiptap packages to a fixed version.

While investigating this, I also noticed an older branch (fix/pnpm-workspace-deps) addressing a similar peer dependency range issue that was never merged. This PR attempts to provide a minimal fix addressing the same underlying problem.

Checklist

  • I have created a changeset for this PR if necessary.
  • My changes do not break the library.
  • I have added tests where applicable.
  • I have followed the project guidelines.
  • I have fixed any lint issues.

Related Issues

#7591
#7253

@netlify
Copy link
Copy Markdown

netlify bot commented Mar 13, 2026

Deploy Preview for tiptap-embed ready!

Name Link
🔨 Latest commit eaf90cf
🔍 Latest deploy log https://app.netlify.com/projects/tiptap-embed/deploys/69b7f72a67c6320008627a85
😎 Deploy Preview https://deploy-preview-7593--tiptap-embed.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@bdbch bdbch changed the base branch from develop to main March 14, 2026 15:04
@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Mar 16, 2026

🦋 Changeset detected

Latest commit: eaf90cf

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 72 packages
Name Type
@tiptap/core Patch
@tiptap/extension-audio Patch
@tiptap/extension-blockquote Patch
@tiptap/extension-bold Patch
@tiptap/extension-bubble-menu Patch
@tiptap/extension-bullet-list Patch
@tiptap/extension-code Patch
@tiptap/extension-code-block Patch
@tiptap/extension-code-block-lowlight Patch
@tiptap/extension-collaboration Patch
@tiptap/extension-collaboration-caret Patch
@tiptap/extension-color Patch
@tiptap/extension-details Patch
@tiptap/extension-document Patch
@tiptap/extension-drag-handle Patch
@tiptap/extension-drag-handle-react Patch
@tiptap/extension-drag-handle-vue-2 Patch
@tiptap/extension-drag-handle-vue-3 Patch
@tiptap/extension-emoji Patch
@tiptap/extension-file-handler Patch
@tiptap/extension-floating-menu Patch
@tiptap/extension-font-family Patch
@tiptap/extension-hard-break Patch
@tiptap/extension-heading Patch
@tiptap/extension-highlight Patch
@tiptap/extension-horizontal-rule Patch
@tiptap/extension-image Patch
@tiptap/extension-invisible-characters Patch
@tiptap/extension-italic Patch
@tiptap/extension-link Patch
@tiptap/extension-list Patch
@tiptap/extension-mathematics Patch
@tiptap/extension-mention Patch
@tiptap/extension-node-range Patch
@tiptap/extension-ordered-list Patch
@tiptap/extension-paragraph Patch
@tiptap/extension-strike Patch
@tiptap/extension-subscript Patch
@tiptap/extension-superscript Patch
@tiptap/extension-table Patch
@tiptap/extension-table-of-contents Patch
@tiptap/extension-text Patch
@tiptap/extension-text-align Patch
@tiptap/extension-text-style Patch
@tiptap/extension-twitch Patch
@tiptap/extension-typography Patch
@tiptap/extension-underline Patch
@tiptap/extension-unique-id Patch
@tiptap/extension-youtube Patch
@tiptap/extensions Patch
@tiptap/html Patch
@tiptap/markdown Patch
@tiptap/pm Patch
@tiptap/react Patch
@tiptap/starter-kit Patch
@tiptap/static-renderer Patch
@tiptap/suggestion Patch
@tiptap/vue-2 Patch
@tiptap/vue-3 Patch
@tiptap/extension-character-count Patch
@tiptap/extension-dropcursor Patch
@tiptap/extension-focus Patch
@tiptap/extension-gapcursor Patch
@tiptap/extension-history Patch
@tiptap/extension-list-item Patch
@tiptap/extension-list-keymap Patch
@tiptap/extension-placeholder Patch
@tiptap/extension-table-cell Patch
@tiptap/extension-table-header Patch
@tiptap/extension-table-row Patch
@tiptap/extension-task-item Patch
@tiptap/extension-task-list Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant