Repository navigation
Releases
v3.33.0
@tiptap/extension-collaboration
Minor Changes
-
With
enableContentCheck: true, shared content that does not fit the editor schema now emitscontentErrorinstead of being deleted. The editor pauses editing and sends no changes until compatible content arrives, so read-only users no longer send repairs that the server rejects.If you use
enableContentCheckwith collaboration and want the editor to keep repairing invalid content, turn the content check off.
@tiptap/y-tiptap
Minor Changes
- Add the
onInvalidContentsync option. When it is set, shared content that does not fit the editor schema stays in the shared document instead of being deleted. The editor shows what it can, pauses editing and sends no changes until compatible content arrives.
v3.32.3
@tiptap/core
Patch Changes
- Clearing formatting on a nested list now turns every level into paragraphs, and
clearNodes()works in a chain with other node commands. - Stop removed resizable node views from responding to later editor updates.
@tiptap/extension-bubble-menu
Patch Changes
- Bubble menus now update correctly after IME input, including Korean text
@tiptap/extension-code-block-lowlight
Patch Changes
- Fixed a performance issue where code highlighting updates were unnecessarily triggered by selection-only changes
@tiptap/extension-floating-menu
Patch Changes
- Floating menus now update correctly after IME input, including Korean text
@tiptap/extension-link
Patch Changes
- Pasting a link without a protocol now uses the
defaultProtocoloption instead of always falling back tohttp.
@tiptap/extensions
Patch Changes
- The Placeholder extension no longer leaves placeholders behind on empty nodes after the cursor moves away when
includeChildrenis enabled.
@tiptap/react
Patch Changes
- Fix a React warning when a command like
setContentcreates React node views from inside an effect. - Fixed the cursor no longer following clicks after an editor inside a shadow root was unmounted and remounted.
@tiptap/vue-2
Patch Changes
- Fixed the cursor no longer following clicks after an editor inside a shadow root was unmounted and remounted.
@tiptap/vue-3
Patch Changes
- Fixed the cursor no longer following clicks after an editor inside a shadow root was unmounted and remounted.
@tiptap/y-tiptap
Minor Changes
-
Remove persistent position migrations to stop structural edits and undo or redo from adding migration history to collaborative documents. Saved relative positions no longer follow content that structural edits replace or move.
Existing migration entries are deleted when an editor opens and when later Yjs updates arrive. Yjs can reclaim their stored data when garbage collection is enabled. Document content and other shared data are unchanged. Upgrade all collaborating clients to stop older clients from writing new entries.
Documents that the server refuses to load need cleanup on the server before a client can repair them. With Yjs garbage collection disabled, deleting entries does not reclaim their stored data.
v3.32.0
@tiptap/markdown
Patch Changes
- A literal
!directly before a link is now escaped when serializing to Markdown, so the link is no longer parsed back as an image.
@tiptap/pm
Patch Changes
- Update ProseMirror dependencies to their latest versions.
@tiptap/react
Patch Changes
- Fix
useEditorStateoverflowing the stack when a selector returns a value with circular references, such aseditor.stateafter one stored mark replaces another.
@tiptap/core
Minor Changes
- Add the
schemaSpeceditor option to use an external ProseMirror schema structure with local extension behavior.
Patch Changes
- Fix list toggling between list types that use different item nodes. Nested lists are recursively converted when the target item schema supports nesting, and flattened into sibling items when it does not.
@tiptap/y-tiptap
Patch Changes
-
Keep relative text and node positions attached through structural edits, node moves, and undo or redo across collaborating clients.
-
Improve TypeScript definitions for document synchronization, shared cursors, undo, redo, and document conversions.
-
Improve collaboration performance and keep comments, highlights, caret positions, and remote caret details intact during remote edits.
-
Preserve shared content when a client cannot display its nodes or marks, and pause that client's editing until compatible content is available.
Headless document creation rejects empty content when the schema requires child nodes.
@tiptap/extension-collaboration
Patch Changes
- Keep collaborative editing, cursor presence, and drag handles compatible with the updated
@tiptap/y-tiptapbinding.
@tiptap/extension-collaboration-caret
Patch Changes
- Keep collaborative editing, cursor presence, and drag handles compatible with the updated
@tiptap/y-tiptapbinding.
@tiptap/extension-drag-handle
Patch Changes
- Keep collaborative editing, cursor presence, and drag handles compatible with the updated
@tiptap/y-tiptapbinding.
@tiptap/ai-toolkit
Patch Changes
- Keep collaborative editing, cursor presence, and drag handles compatible with the updated
@tiptap/y-tiptapbinding.
v3.31.4
@tiptap/extension-mathematics
Patch Changes
- The mathematics extension no longer crashes the editor in older WebKit browsers and WKWebView.
@tiptap/core
Patch Changes
- Fix a
TypeErrorthrown when the source editor is destroyed right after dragging content into another editor. splitBlockno longer throwsTransformError: Inserted content deeper than insertion positionwhen the selection spans block boundaries (for example from the start of one paragraph into another block, or across an isolating node). The command now returnsfalsewhen the split is not possible.- Prevent extra CSS declarations from being rendered from editor content.
- Atom block directives (
:::name {…} :::) indented by up to 3 spaces are now tokenized, matching CommonMark indentation rules for block constructs. - Numeric HTML entities (
',') are now decoded when parsing markdown, instead of showing up as literal text in the editor. - The editor element keeps
role="textbox"aftersetOptions()wheneditorProps.attributesis set. Before, a re-render in React replaced the default role with the user attributes. Attributes passed as a function now get the default role as well. - Undoing an input rule restores the Markdown characters that triggered it when using Collaboration.
- Bind
parseMarkdownandrenderMarkdownto the configured extension so hooks can readthis.optionsandthis.namewithout an Editor. - Pressing Enter before the text of a checked task item now leaves the new empty item unchecked and the item with the text checked. Attributes declared with
keepOnSplit: falsenow reset on the new item, not on the one that keeps the text. - Stop joinItemForward and joinItemBackward from joining across isolating nodes.
- Node views without a
contentDOMno longer ignore selection mutations, so ProseMirror moves the caret back to a valid position when the browser places it inside the node view.
@tiptap/markdown
Patch Changes
- Fix Markdown serialization of inline code containing backticks
- Bind
parseMarkdownandrenderMarkdownto the configured extension so hooks can readthis.optionsandthis.namewithout an Editor.
@tiptap/extension-code
Patch Changes
- Fix Markdown serialization of inline code containing backticks
@tiptap/extension-table
Patch Changes
- Table cells exported to Markdown now escape literal pipe characters, so the cell content survives when the output is read back.
- Multi-block table cells no longer leak a U+001F control character into Markdown.
- Right-clicking a cell inside a multi-cell table selection no longer collapses that selection.
- Prevent extra CSS declarations from being rendered from editor content.
- Table cells and headers no longer render the default
colspan="1"androwspan="1"attributes. Cells that actually span still render them, matching how prosemirror-tables serializes spans.
@tiptap/extension-list
Patch Changes
- Parsing large Markdown documents that contain ordered lists is much faster. A 578KB document went from about 19s to about 160ms.
@tiptap/extension-collaboration-caret
Patch Changes
- Prevent extra CSS declarations from being rendered from editor content.
@tiptap/extension-highlight
Patch Changes
- Prevent extra CSS declarations from being rendered from editor content.
@tiptap/extension-text-align
Patch Changes
- Prevent extra CSS declarations from being rendered from editor content.
@tiptap/extension-text-style
Patch Changes
- Prevent extra CSS declarations from being rendered from editor content.
@tiptap/extension-link
Patch Changes
- Typing spaces after a link no longer extends the link, including multiple spaces inserted in one transaction. Formatting changes and undo/redo preserve existing linked whitespace.
@tiptap/react
Patch Changes
- Fix Enter and Shift-Enter inside React node views on iOS and Android.
- React and Vue now use matching menu extension versions when installed from a specific release.
@tiptap/static-renderer
Patch Changes
- Render
<audio>and<video>with a closing tag instead of self-closing them, so browsers no longer nest the following content inside the first audio element. - Rendering a node whose
renderHTMLreturns several nested child elements no longer adds stray commas between them in the HTML string output.
@tiptap/extension-collaboration
Patch Changes
- Undoing an input rule restores the Markdown characters that triggered it when using Collaboration.
@tiptap/vue-2
Patch Changes
- React and Vue now use matching menu extension versions when installed from a specific release.
@tiptap/vue-3
Patch Changes
- React and Vue now use matching menu extension versions when installed from a specific release.
v3.31.3
@tiptap/extension-collaboration-caret
Patch Changes
- Fixed a bug which allowed potentially unsafe color values being sent by other clients. Those unsafe colors received from collaboration users are now ignored.
@tiptap/react
Patch Changes
- Fix a TypeScript error (TS2694) in the shipped type declarations when
skipLibCheckis turned off.
v3.31.2
@tiptap/pm
Patch Changes
- Bump
prosemirror-viewto^1.42.3, which fixes an XSS vulnerability where pasting crafted HTML could run arbitrary JavaScript (GHSA-c8x8-7fp4-3x9w).
v3.31.1
v3.31.0
v3.30.6
@tiptap/core
Patch Changes
- Nested lists exported to Markdown now keep their hierarchy when the file is read back by other Markdown tools.
@tiptap/extension-list
Patch Changes
- Nested lists exported to Markdown now keep their hierarchy when the file is read back by other Markdown tools.
@tiptap/extension-youtube
Patch Changes
- Pasting a YouTube iframe without a
srcattribute no longer crashes the editor. The embed is kept without a source.
@tiptap/markdown
Patch Changes
- Fix Markdown serialization of whitespace-only marked text.
@tiptap/react
Patch Changes
- Reduce overhead in React node views on documents with many nodes.