YJS Provider compatibility is foggy

[Annakan]

Part of the documentation?
https://tiptap.dev/docs/hocuspocus/provider/overview…

Hard to understand, missing or misleading
I read this page and was really wondering if this was AI slop :)

The page seems to contradict itself constantly probably because similar names are used for different things.

Providers are the Y.js way to set up communication between different users, or cache the updates in the browser.

Hocuspocus comes with its own provider and is not compatible anymore (since v2) with other y-providers, as we are supporting multiplexing to synchronize multiple documents over the same websocket connection.

So Hocuspocus and the titptap extension connecting to it are not compatible with the rest of the YJs ecosystem ... right ? Damm ! shame !!! ...

but :

All Y.js providers can be used together. That includes the Hocuspocus provider, and the original y-websocket provider, y-webrtc, y-indexeddb (for in-browser caching) or y-dat (work in progress). You can use the Hocuspocus provider with y-webrtc and other y-providers,

So what it is ?

Does that mean that the Hocuspocus provider ( that I understand to be the TipTap extension part : @hocuspocus/provider) support two 'wire' protocols one for the Hocuspocus SERVER/hub and one for other YJs clients ?

Or does it mean that we can plug several providers into TipTap one optimized for the hocupocus "server" and others to talk to standard Yjs clients/providers ?

but when using Hocuspocus you'll have to use our HocuspocusProvider, and server implementations apart from hocuspocus probably won't work too. You can however instantiate multiple providers if you want to synchronize with Hocuspocus and other servers.

Now I am truly lost :)

I my case I want to synchronize a python server through pycrdt (wrapper around yrs) and I would like to know if I can plug that into the TipTap ecosystem (thus through @hocuspocus/provider and the undo/redo extension etc...) or if I am out of luck and looking into manual sync (and the horrors that come with that)

My current experimentation tend confirm to the latter I would love to be wrong.

Is there any example of this I have missed ?

[janthurau]

That will work out of the box. You can use the collaboration extension of Tiptap together with any yjs provider. If you want to use the tiptapcollabprovider (or hocuspocusprovider), you'll need to use Hocuspocus on the backend. Thank you for pointing this out, I'll fix the docs when I'm back (around Wednesday).

[Annakan]

Much thanks for the prompt answer, I can now confirm that I got it to work with pycrdt-websockets perfectly.
I sill need to figure out the caret handling and many other things but the base are working.

It also seems that passing a reactive value (in my case a vuejs ydoc = ref<Y.Doc()>) as a document (ydoc.value) induces a weird crash in the YJS reconciliation but I need to test more to be sure before reporting a potential bug.

Do you think it would be of value to try to provide a minimal example with pycrdt ?