[dependabot]

Bumps @tiptap/extension-collaboration from 3.27.3 to 3.30.0.

Release notes

Sourced from @​tiptap/extension-collaboration's releases.

v3.30.0

@​tiptap/vue-2

Minor Changes

• ceb0dac: 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

... (truncated)

Changelog

Sourced from @​tiptap/extension-collaboration's changelog.

3.30.0

Patch Changes

• Updated dependencies [0247d39]
• Updated dependencies [58a8953]
• Updated dependencies [51909d3]
• Updated dependencies [3099eef]
  • @​tiptap/core@​3.30.0
  • @​tiptap/pm@​3.30.0

3.29.2

Patch Changes

• @​tiptap/core@​3.29.2
• @​tiptap/pm@​3.29.2

3.29.1

Patch Changes

• @​tiptap/core@​3.29.1
• @​tiptap/pm@​3.29.1

3.29.0

Patch Changes

• Updated dependencies [d26840f]
• Updated dependencies [e150ee0]
• Updated dependencies [935e63f]
• Updated dependencies [b4c5a2d]
• Updated dependencies [a963d48]
• Updated dependencies [51f45b6]
• Updated dependencies [0f63969]
• Updated dependencies [9acaa65]
  • @​tiptap/core@​3.29.0
  • @​tiptap/pm@​3.29.0

3.28.0

Patch Changes

• 3c8da6a: Bump @​tiptap/y-tiptap version to ensure users use latest version
  • @​tiptap/core@​3.28.0
  • @​tiptap/pm@​3.28.0

3.27.4

... (truncated)

Commits

• 7901bc2 chore(release): release new stable release (#8142)
• 5158212 chore(release): release new stable release (#8132)
• 896564a chore(release): release new stable release (#8128)
• 1afef87 chore(release): release new stable release (#8087)
• 51f45b6 fix(core): seed editor state from fallback doc so onContentError is usable (#...
• c5f4b57 chore(release): release new stable release (#8038)
• 3c8da6a chore(deps): bump @​tiptap/y-tiptap to ^3.0.7 (#8042)
• 24263ec chore(release): publish a new stable version
• See full diff in compare view

[dependabot]

Superseded by #16.