Packages

@tiptap/extension-details

3.35.0 · 20 Nov 2026MIT871.4k / weekRepositoryHomepagenpmAtom feed

Your version

136 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.

  1. 3.35.0

    20 Nov 2026
    • Added the openWithoutDelay option. With it, a Details created open shows its content as soon as it is drawn, instead of one tick later, so code that measures right after drawing reads the full height. It is off by default and only has an effect together with persist.

  2. 3.34.0

    13 Nov 2026
    • A Details node created open now stays open when its content changes right after it is created.

  3. 3.33.1

    10 Nov 2026
    • Deleting a text selection that spans the whole document no longer leaves the deleted text's marks active, so text typed into the emptied editor is no longer bold, linked or otherwise marked.

    • The first goToNextResult() or goToPreviousResult() after a new search now selects the highlighted first result instead of skipping it.

    • yCursorPlugin now publishes a lastSelection awareness field with each collaborative field's latest selection and whether its editor is focused. Unlike cursor, it stays after the editor loses focus, so other clients can still read the selection. lastSelection is now reserved and can't be used as the cursor field.

  4. 3.33.0

    5 Nov 2026
    • With enableContentCheck: true, shared content that does not fit the editor schema now emits contentError instead 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 enableContentCheck with collaboration and want the editor to keep repairing invalid content, turn the content check off.

    • Add the onInvalidContent sync 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.

  5. 3.32.3

    5 Nov 2026
    • 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.

    • Bubble menus now update correctly after IME input, including Korean text

  6. 3.32.1 – 3.32.22 releases without a noteShow each
  7. 3.32.0

    13 Oct 2026
    • A literal ! directly before a link is now escaped when serializing to Markdown, so the link is no longer parsed back as an image.

    • Update ProseMirror dependencies to their latest versions.

    • Fix useEditorState overflowing the stack when a selector returns a value with circular references, such as editor.state after one stored mark replaces another.

  8. 3.31.4

    30 Sep 2026
    • The mathematics extension no longer crashes the editor in older WebKit browsers and WKWebView.

    • Fix a TypeError thrown when the source editor is destroyed right after dragging content into another editor.

    • splitBlock no longer throws TransformError: Inserted content deeper than insertion position when the selection spans block boundaries (for example from the start of one paragraph into another block, or across an isolating node). The command now returns false when the split is not possible.

  9. 3.31.3

    4 Sep 2026
    • Fixed a bug which allowed potentially unsafe color values being sent by other clients. Those unsafe colors received from collaboration users are now ignored.

    • Fix a TypeScript error (TS2694) in the shipped type declarations when skipLibCheck is turned off.

  10. 3.31.2

    3 Sep 2026
  11. 3.31.1

    3 Sep 2026
    • Fix freezes in framework-based node views on iOS and Android

  12. 3.31.0

    1 Sep 2026
    • Align selected with ProseMirror node selections by default, expose text selections through selectionInside, and keep selectedOnTextSelection compatible.

  13. 3.30.6

    31 Aug 2026
    • Nested lists exported to Markdown now keep their hierarchy when the file is read back by other Markdown tools.

    • Nested lists exported to Markdown now keep their hierarchy when the file is read back by other Markdown tools.

    • Pasting a YouTube iframe without a src attribute no longer crashes the editor. The embed is kept without a source.

  14. 3.30.5

    26 Aug 2026
    • Fix a denial-of-service risk where crafted block or inline Markdown attributes could consume excessive CPU and block the browser or server event loop.

  15. 3.30.4

    26 Aug 2026
    • Prevent untrusted HTML attributes from changing an object's prototype when merged with mergeAttributes.

  16. 3.30.3

    24 Aug 2026
    • Unsetting one text style inside a blockquote no longer removes the other text styles in it.

    • YouTube live URLs (/live/<id>) now embed the video.

    • Fix JSX runtime to properly render nested sibling elements by spreading children arrays into DOMOutputSpec

  17. 3.30.2

    18 Aug 2026

    Reading the note…

  18. 3.30.1

    13 Aug 2026

    Reading the note…

  19. 3.30.0

    11 Aug 2026
    • New Decorations API

      Finally the decorations API is here! Even though Decorations itself are nothing new in ProseMirror, the new API makes it much easier to use them in Tiptap without leaving your extensions.

      Decorations change how the document looks without changing the document itself. Highlighting search results, marking spelling mistakes, showing collaborator cursors, putting a drag handle next to every block.

      Until now you had to write a ProseMirror plugin by hand for this, keep the decoration set in plugin state, and map it forward on every transaction. Extensions can now declare decorations directly with a new addDecorations() hook.

      addDecorations() {
        return {
          create: ({ state }) =>
            // findMatches can be any function that returns an array of { from, to } ranges
            findMatches(state.doc).map(match =>
              Decoration.Inline(match.from, match.to, { class: 'highlight' }),
            ),
        }
      }

      There are three kinds. Decoration.Inline() styles a range of text. Decoration.Node() puts attributes on a block's DOM element. Decoration.Widget() renders your own element at a single position.

      Every extension that declares decorations is collected into one plugin, so several extensions can decorate the same document without fighting over it.

      Doing less work on every keystroke

      By default decorations are rebuilt whenever the document changes. That is fine for small documents and wasteful for large ones, so there are two ways to narrow it down.

      shouldUpdate() skips transactions you do not care about. If your decorations only depend on headings, ignore everything else.

      update: 'changedRanges' together with createInRange() only rescans the blocks that actually changed. On a long document this is the difference between scanning the whole thing on every keystroke and scanning one paragraph.

      For decorations driven by data outside the editor, like comments loaded from a server, use update: 'manual' and refresh them yourself with editor.commands.updateDecorations().

      React and Vue components as widgets

      ReactWidgetRenderer and VueWidgetRenderer render a real component into a widget decoration, inside your existing app context. Providers, context and stores work as usual.

      Widgets take a key. Reuse the same key and the component instance stays mounted while the document changes around it, so local state such as an open menu, a counter or a half-typed input survives editing. Use a stable id from your own data, not a position or a list index, otherwise the component remounts and loses that state.

      Widgets also accept the ProseMirror options side, relaxedSide, stopEvent and ignoreSelection.

      Documentation

    • Fix FloatingMenu not registering when the editor prop is provided synchronously, which prevented the menu from appearing

    • ListKeymap now registers a Tab shortcut that sinks a top-level textblock into the previous list's last item. Pressing Tab at the start of a paragraph right after a bullet/ordered/task list moves the paragraph inside the last list item. The handler does nothing when the cursor is already inside a list item (sinkListItem keeps working), when there is no list before the paragraph, when the caret is mid-textblock, or when the selection is not a text selection (for example a gap cursor).

      @tiptap/core also exposes a new getPreviousBlockSibling($pos) helper that returns the block-level sibling before the cursor's textblock, or null at the first child of the block parent.

  20. 3.29.2

    28 Jul 2026

    Reading the note…

  21. 3.29.1

    27 Jul 2026

    Reading the note…

  22. 3.29.0

    24 Jul 2026
    • Add official RubyText extension for HTML ruby text annotations with non-editable annotations and mark-based document storage. The click-to-edit annotation editor can be replaced with a custom element via the renderAnnotationEditor option.

    • Fix a TypeScript build error in isAndroid() where comparing navigator.platform against the literal 'Android' with === could fail to compile under some lib.dom.d.ts typings ("types have no overlap"). Switched to the same .includes() pattern already used by isiOS(), which is not affected by this TypeScript narrowing issue. No runtime behavior change.

    • Fixed a bug where deleting an AllSelection (for example right after Ctrl/Cmd+A) left a lingering "phantom" selection highlight over the emptied document instead of a text cursor. deleteSelection now collapses the selection to a cursor.

  23. 3.28.0

    15 Jul 2026
    • Fix the cursor moving to the details summary after typing in content at the start of a document.

  24. 3.27.4

    13 Jul 2026

    Reading the note…

  25. 3.27.3

    7 Jul 2026

    Reading the note…

  26. 3.27.2

    6 Jul 2026

    Reading the note…

  27. 3.27.1

    18 Jun 2026

    Reading the note…

  28. 3.27.0

    17 Jun 2026
    • Ordered lists now support the type attribute (a, A, i, I).

      The <ol> type attribute is now fully preserved through the HTML round-trip:

      Paste from external editors (Google Docs, Word, LibreOffice) now correctly detects the list style — both from the HTML type attribute and from CSS list-style-type properties.

      Plain text paste of typed ordered list markers (e.g. a. Item, I) Item, i. Item\nii. Item) is detected and converted to the correct list type.

      Markdown round-trip preserves typed markers: parsing a. Item creates type: "a", and serializing a typed list back to markdown uses the correct prefix (e.g. I., ii.).

      Joining of adjacent lists now respects type — two lists with different types (e.g. default numeric and type="a") are not merged.

    • Ordered lists now support the type attribute (a, A, i, I).

      The <ol> type attribute is now fully preserved through the HTML round-trip:

      Paste from external editors (Google Docs, Word, LibreOffice) now correctly detects the list style — both from the HTML type attribute and from CSS list-style-type properties.

      Plain text paste of typed ordered list markers (e.g. a. Item, I) Item, i. Item\nii. Item) is detected and converted to the correct list type.

      Markdown round-trip preserves typed markers: parsing a. Item creates type: "a", and serializing a typed list back to markdown uses the correct prefix (e.g. I., ii.).

      Joining of adjacent lists now respects type — two lists with different types (e.g. default numeric and type="a") are not merged.

    • parseAttributes now supports any word characters at the start of classes or id attributes.

  29. 3.26.1

    11 Jun 2026

    Reading the note…

  30. 3.26.0

    5 Jun 2026
    • Backspace at the start of a non-first child of a blockquote now lifts that child out, splitting the blockquote around it. A second backspace at the start of a top-level textblock whose previous sibling is a blockquote merges the textblock's inline content into the blockquote's last textblock instead of pulling the paragraph back inside.

    • Only add hash attributes to nodes, not to marks.

    • Fix the Selection extension highlighting beyond the selected text on multi-line selections: the native browser selection is now hidden while the editor is blurred, so only the styled .selection decoration is shown.

  31. 3.25.0

    3 Jun 2026
    • Dragging an inline/resizable image within the editor no longer creates a duplicate

      When the Image extension was configured with inline: true or resize enabled, dragging an image within the editor could insert a duplicate at the drop position instead of moving it. This happened because the browser's native image drag behavior could populate dataTransfer.files, causing the FileHandler extension to intercept the drop before ProseMirror's internal move logic could run.

    • Add clearable mark option (default true). unsetAllMarks now skips marks with clearable: false, so semantic marks like comments are not removed by "clear formatting".

    • Add attrsEqual and marksEqual utility functions to @tiptap/core. attrsEqual compares two attribute objects for equality regardless of key ordering. marksEqual compares two arrays of mark objects by type and attributes using attrsEqual.

  32. 3.24.0

    29 May 2026
    • Fix persisted details toggles when the details node is at the start of the document.

  33. 3.23.6

    21 May 2026

    Reading the note…

  34. 3.23.5

    19 May 2026

    Reading the note…

  35. 3.23.4

    13 May 2026

    Reading the note…

  36. 3.23.2

    12 May 2026

    Reading the note…

  37. 3.22.5

    28 Apr 2026

    Reading the note…

  38. 3.22.4

    18 Apr 2026

    Reading the note…

  39. 3.22.3

    8 Apr 2026

    Reading the note…

  40. 3.22.2

    4 Apr 2026

    Reading the note…

  41. 3.22.1

    2 Apr 2026

    Reading the note…

  42. 3.22.0

    31 Mar 2026
    • Fix a rerender loop in the Details node view when the toggle button updates its DOM attributes through renderToggleButton.

  43. 3.21.0

    27 Mar 2026
    • Add a renderToggleButton option to customize the details toggle button, including its accessible label.

  44. 3.20.6

    27 Mar 2026

    Reading the note…

  45. 3.20.5

    24 Mar 2026

    Reading the note…

  46. 3.20.4

    17 Mar 2026

    Reading the note…

  47. 3.20.3

    16 Mar 2026

    Reading the note…

  48. 3.20.2

    15 Mar 2026

    Reading the note…

A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.