@veltdev/prosemirror-crdt-react 1.0.0

package/README.md

@@ -0,0 +1,59 @@
+# Velt ProseMirror CRDT React Library
+
+With Velt ProseMirror CRDT React Library, you can add powerful multiplayer editing and state synchronization features to any React application using ProseMirror.
+
+The library provides **React-native realtime primitives**:
+
+- `ProseMirrorCrdtEditor` drop-in collaborative ProseMirror React component
+- `useCollaboration` hook for managing shared state, sync status, and versions
+- `createDefaultProseMirrorSchema` ready-made schema with lists and highlight support
+- Shared `undo`/`redo` commands powered by y-prosemirror
+- Fully-managed on a scalable realtime backend
+- Powered by Yjs for industry-standard conflict resolution
+
+**Features include:**
+
+- **Multiplayer Editing** with real-time synchronization
+- **Collaboration** with presence and remote cursors
+- **Conflict Resolution** ensuring document consistency across all clients
+- **Offline Support** with automatic synchronization upon reconnection
+- **Version History** with save and restore APIs
+- **React Hooks** for seamless integration with React components
+- ... and so much more
+
+## Installation
+
+```bash
+npm install @veltdev/prosemirror-crdt-react @veltdev/prosemirror-crdt @veltdev/react prosemirror-model prosemirror-schema-basic prosemirror-schema-list prosemirror-state prosemirror-view y-prosemirror yjs
+```
+
+## Documentation
+
+* Read the [documentation](https://docs.velt.dev/realtime-collaboration/crdt/setup/prosemirror) for setup guides and API references.
+
+## Use cases
+
+The ProseMirror CRDT React library is used to power:
+
+* Collaborative editing tools
+* Real-time document editing
+* Shared workspaces
+* Any shared, mutable environment
+
+## Resources
+
+* Explore [multiplayer editing](https://velt.dev/libraries/prosemirror) to see features like collaborative text, whiteboards, and data grids.
+* [Sample Apps](https://velt.dev/examples): Check out example implementations for various use cases.
+
+## Releases
+
+* See the [latest changes](https://docs.velt.dev/release-notes/).
+
+## Security
+
+* Velt is SOC2 Type 2 and HIPAA compliant. [Learn more](https://velt.dev/security)
+
+## Community
+
+* [X](https://x.com/veltjs): To receive updates, announcements,
+and general Velt tips.

package/cjs/index.js

@@ -0,0 +1,479 @@
+'use strict';
+
+var react$1 = require('react');
+var react = require('@veltdev/react');
+var prosemirrorCrdt = require('@veltdev/prosemirror-crdt');
+var jsxRuntime = require('react/jsx-runtime');
+var prosemirrorModel = require('prosemirror-model');
+var prosemirrorSchemaBasic = require('prosemirror-schema-basic');
+var prosemirrorSchemaList = require('prosemirror-schema-list');
+
+// POLICY: Every function/method in this file MUST be wrapped in try/catch.
+// The package must NEVER throw an exception to the consumer's code.
+function logError(message, error) {
+    try {
+        if (typeof console !== 'undefined' && console.error) {
+            console.error(`[ProseMirrorCRDTReact] ${message}`, error);
+        }
+    }
+    catch {
+        // Logging must never throw into consumer code.
+    }
+}
+function toError(error) {
+    try {
+        return error instanceof Error ? error : new Error(String(error));
+    }
+    catch {
+        return new Error('Unknown error');
+    }
+}
+
+// POLICY: Every function/method in this file MUST be wrapped in try/catch.
+// The package must NEVER throw an exception to the consumer's code.
+function getVeltUser(client) {
+    try {
+        return client.getUser?.();
+    }
+    catch {
+        return null;
+    }
+}
+function useCollaboration(config) {
+    const { client } = react.useVeltClient();
+    const veltInitState = react.useVeltInitState();
+    const [mount, setMount] = react$1.useState(null);
+    const [editorView, setEditorView] = react$1.useState(config.editorView ?? null);
+    const [manager, setManager] = react$1.useState(null);
+    const [isLoading, setIsLoading] = react$1.useState(true);
+    const [synced, setSynced] = react$1.useState(false);
+    const [status, setStatus] = react$1.useState('connecting');
+    const [error, setError] = react$1.useState(null);
+    const [versions, setVersions] = react$1.useState([]);
+    const managerRef = react$1.useRef(null);
+    const createdViewRef = react$1.useRef(null);
+    const configRef = react$1.useRef(config);
+    const activeClientRef = react$1.useRef(null);
+    const activeEditorIdRef = react$1.useRef(null);
+    const activeMountRef = react$1.useRef(null);
+    const activeExternalViewRef = react$1.useRef(null);
+    const unsubscribersRef = react$1.useRef([]);
+    configRef.current = config;
+    const veltClient = config.veltClient ?? client;
+    const enabled = config.enabled ?? true;
+    const effectiveMount = config.mount ?? mount;
+    const externalView = config.editorView ?? null;
+    const cleanupActiveManager = react$1.useCallback(() => {
+        try {
+            for (const unsubscribe of unsubscribersRef.current) {
+                try {
+                    unsubscribe();
+                }
+                catch { /* ignore */ }
+            }
+            unsubscribersRef.current = [];
+            try {
+                managerRef.current?.destroy();
+            }
+            catch { /* ignore */ }
+            managerRef.current = null;
+            const createdView = createdViewRef.current;
+            createdViewRef.current = null;
+            if (createdView && configRef.current.destroyViewOnUnmount !== false) {
+                try {
+                    createdView.destroy();
+                }
+                catch { /* ignore */ }
+            }
+            activeClientRef.current = null;
+            activeEditorIdRef.current = null;
+            activeMountRef.current = null;
+            activeExternalViewRef.current = null;
+            setManager(null);
+            setEditorView(externalView);
+            setIsLoading(true);
+            setSynced(false);
+            setStatus('connecting');
+            setError(null);
+            setVersions([]);
+        }
+        catch (err) {
+            logError('Failed to cleanup ProseMirror collaboration manager', err);
+        }
+    }, [externalView]);
+    const mountRef = react$1.useCallback((element) => {
+        try {
+            setMount(element);
+        }
+        catch (err) {
+            logError('Failed to capture ProseMirror mount element', err);
+        }
+    }, []);
+    react$1.useEffect(() => {
+        try {
+            if (enabled)
+                return;
+            cleanupActiveManager();
+        }
+        catch (err) {
+            logError('Failed to disable ProseMirror collaboration', err);
+        }
+    }, [enabled, cleanupActiveManager]);
+    react$1.useEffect(() => {
+        try {
+            if (!enabled || !veltClient || !veltInitState || !config.schema)
+                return;
+            if (!externalView && !effectiveMount)
+                return;
+            if (!getVeltUser(veltClient))
+                return;
+            if (managerRef.current
+                && activeClientRef.current === veltClient
+                && activeEditorIdRef.current === config.editorId
+                && activeMountRef.current === effectiveMount
+                && activeExternalViewRef.current === externalView) {
+                return;
+            }
+            cleanupActiveManager();
+            let mounted = true;
+            const init = async () => {
+                try {
+                    const latest = configRef.current;
+                    const created = await prosemirrorCrdt.createCollaboration({
+                        editorId: latest.editorId,
+                        veltClient: veltClient,
+                        schema: latest.schema,
+                        initialContent: latest.initialContent,
+                        cursorData: latest.cursorData,
+                        debounceMs: latest.debounceMs,
+                        forceResetInitialContent: latest.forceResetInitialContent,
+                        editorView: externalView ?? undefined,
+                        autoInitialize: false,
+                        onError: (err) => {
+                            try {
+                                if (mounted)
+                                    setError(err);
+                                configRef.current.onError?.(err);
+                            }
+                            catch { /* ignore */ }
+                        },
+                    });
+                    if (!mounted) {
+                        try {
+                            created.destroy();
+                        }
+                        catch { /* ignore */ }
+                        return;
+                    }
+                    let view = externalView;
+                    if (!view && effectiveMount) {
+                        view = created.createEditorView(effectiveMount, {
+                            schema: latest.schema,
+                            state: latest.state,
+                            plugins: latest.plugins,
+                            keymap: latest.keymap,
+                            disableCursors: latest.disableCursors,
+                            viewProps: latest.viewProps,
+                        });
+                        createdViewRef.current = view;
+                    }
+                    else if (view) {
+                        created.attachEditorView(view);
+                    }
+                    if (!view) {
+                        throw new Error('Failed to create ProseMirror EditorView');
+                    }
+                    managerRef.current = created;
+                    activeClientRef.current = veltClient;
+                    activeEditorIdRef.current = latest.editorId;
+                    activeMountRef.current = effectiveMount;
+                    activeExternalViewRef.current = externalView;
+                    setManager(created);
+                    setEditorView(view);
+                    const unsubscribeStatus = created.onStatusChange((nextStatus) => {
+                        try {
+                            if (mounted)
+                                setStatus(nextStatus);
+                        }
+                        catch { /* ignore */ }
+                    });
+                    const unsubscribeSynced = created.onSynced((isSynced) => {
+                        try {
+                            if (mounted)
+                                setSynced(isSynced);
+                        }
+                        catch { /* ignore */ }
+                    });
+                    unsubscribersRef.current = [unsubscribeStatus, unsubscribeSynced];
+                    await created.initialize();
+                    if (mounted && created.synced)
+                        setSynced(true);
+                    if (mounted && created.status !== 'connecting')
+                        setStatus(created.status);
+                    try {
+                        const list = await created.getVersions();
+                        if (mounted)
+                            setVersions(list);
+                    }
+                    catch (err) {
+                        logError('Failed to load initial ProseMirror versions', err);
+                    }
+                    if (mounted) {
+                        setIsLoading(false);
+                        setError(null);
+                    }
+                }
+                catch (err) {
+                    logError('Failed to initialize ProseMirror collaboration', err);
+                    if (mounted) {
+                        setError(toError(err));
+                        setIsLoading(false);
+                    }
+                }
+            };
+            void init();
+            return () => {
+                try {
+                    mounted = false;
+                    cleanupActiveManager();
+                }
+                catch { /* ignore cleanup */ }
+            };
+        }
+        catch (err) {
+            logError('Error in useCollaboration effect', err);
+        }
+    }, [
+        cleanupActiveManager,
+        effectiveMount,
+        enabled,
+        externalView,
+        veltClient,
+        veltInitState,
+        config.editorId,
+        config.schema,
+    ]);
+    const refreshVersions = react$1.useCallback(async () => {
+        try {
+            const list = (await managerRef.current?.getVersions()) ?? [];
+            setVersions(list);
+            return list;
+        }
+        catch (err) {
+            logError('Failed to refresh ProseMirror versions', err);
+            return [];
+        }
+    }, []);
+    const saveVersion = react$1.useCallback(async (name) => {
+        try {
+            const id = (await managerRef.current?.saveVersion(name)) ?? '';
+            try {
+                const list = (await managerRef.current?.getVersions()) ?? [];
+                setVersions(list);
+            }
+            catch { /* best-effort refresh */ }
+            return id;
+        }
+        catch (err) {
+            logError('Failed to save ProseMirror version', err);
+            return '';
+        }
+    }, []);
+    const restoreVersion = react$1.useCallback(async (versionId) => {
+        try {
+            const restored = (await managerRef.current?.restoreVersion(versionId)) ?? false;
+            if (restored) {
+                try {
+                    const list = (await managerRef.current?.getVersions()) ?? [];
+                    setVersions(list);
+                }
+                catch { /* best-effort refresh */ }
+            }
+            return restored;
+        }
+        catch (err) {
+            logError('Failed to restore ProseMirror version', err);
+            return false;
+        }
+    }, []);
+    const destroy = react$1.useCallback(() => {
+        try {
+            cleanupActiveManager();
+            setStatus('disconnected');
+            setIsLoading(false);
+        }
+        catch (err) {
+            logError('Failed to destroy ProseMirror collaboration', err);
+        }
+    }, [cleanupActiveManager]);
+    return {
+        mountRef,
+        editorView,
+        manager,
+        isLoading,
+        synced,
+        isSynced: synced,
+        status,
+        error,
+        versions,
+        refreshVersions,
+        saveVersion,
+        restoreVersion,
+        destroy,
+    };
+}
+
+// POLICY: Every function/method in this file MUST be wrapped in try/catch.
+// The package must NEVER throw an exception to the consumer's code.
+const DEFAULT_HIGHLIGHT_COLOR = '#fff59d';
+function createHighlightMarkSpec(defaultColor = DEFAULT_HIGHLIGHT_COLOR) {
+    try {
+        return {
+            attrs: {
+                color: { default: defaultColor },
+            },
+            parseDOM: [
+                {
+                    tag: 'span[data-highlight]',
+                    getAttrs: (node) => {
+                        try {
+                            const element = node;
+                            return {
+                                color: element.getAttribute('data-highlight-color') || defaultColor,
+                            };
+                        }
+                        catch {
+                            return { color: defaultColor };
+                        }
+                    },
+                },
+                {
+                    style: 'background-color',
+                    getAttrs: (value) => {
+                        try {
+                            return { color: String(value || defaultColor) };
+                        }
+                        catch {
+                            return { color: defaultColor };
+                        }
+                    },
+                },
+            ],
+            toDOM(mark) {
+                try {
+                    const color = mark.attrs.color || defaultColor;
+                    return [
+                        'span',
+                        {
+                            'data-highlight': 'true',
+                            'data-highlight-color': color,
+                            style: `background-color: ${color}`,
+                        },
+                        0,
+                    ];
+                }
+                catch {
+                    return ['span', { 'data-highlight': 'true' }, 0];
+                }
+            },
+        };
+    }
+    catch (error) {
+        logError('Failed to create highlight mark spec', error);
+        return {};
+    }
+}
+function createDefaultProseMirrorSchema() {
+    try {
+        const nodes = prosemirrorSchemaList.addListNodes(prosemirrorSchemaBasic.schema.spec.nodes, 'paragraph block*', 'block');
+        return new prosemirrorModel.Schema({
+            nodes,
+            marks: prosemirrorSchemaBasic.schema.spec.marks.addToEnd('highlight', createHighlightMarkSpec(DEFAULT_HIGHLIGHT_COLOR)),
+        });
+    }
+    catch (error) {
+        logError('Failed to create default ProseMirror schema', error);
+        return prosemirrorSchemaBasic.schema;
+    }
+}
+const defaultProseMirrorSchema = createDefaultProseMirrorSchema();
+
+function ProseMirrorCrdtEditor(props) {
+    const { editorId, documentId, veltClient, schema = defaultProseMirrorSchema, initialContent, forceResetInitialContent, cursorData, debounceMs, enabled, state, plugins, keymap, disableCursors, viewProps, destroyViewOnUnmount, onError, onStatusChange, onManagerReady, onEditorReady, className, editorClassName, } = props;
+    const resolvedEditorId = editorId ?? documentId ?? 'velt-prosemirror-crdt-document';
+    const { mountRef, editorView, manager, status } = useCollaboration({
+        editorId: resolvedEditorId,
+        veltClient,
+        schema,
+        initialContent,
+        forceResetInitialContent,
+        cursorData,
+        debounceMs,
+        enabled,
+        state,
+        plugins,
+        keymap,
+        disableCursors,
+        viewProps,
+        destroyViewOnUnmount,
+        onError,
+    });
+    const lastStatusRef = react$1.useRef(null);
+    react$1.useEffect(() => {
+        try {
+            if (status !== lastStatusRef.current) {
+                lastStatusRef.current = status;
+                onStatusChange?.(status);
+            }
+        }
+        catch (error) {
+            logError('Error in onStatusChange callback', error);
+        }
+    }, [status, onStatusChange]);
+    const notifiedManagerRef = react$1.useRef(null);
+    react$1.useEffect(() => {
+        try {
+            if (manager && manager !== notifiedManagerRef.current) {
+                notifiedManagerRef.current = manager;
+                onManagerReady?.(manager);
+            }
+        }
+        catch (error) {
+            logError('Error in onManagerReady callback', error);
+        }
+    }, [manager, onManagerReady]);
+    const notifiedEditorRef = react$1.useRef(null);
+    react$1.useEffect(() => {
+        try {
+            if (editorView && editorView !== notifiedEditorRef.current) {
+                notifiedEditorRef.current = editorView;
+                onEditorReady?.(editorView);
+            }
+        }
+        catch (error) {
+            logError('Error in onEditorReady callback', error);
+        }
+    }, [editorView, onEditorReady]);
+    try {
+        return (jsxRuntime.jsx("div", { className: className, "data-velt-prosemirror-crdt": "true", children: jsxRuntime.jsx("div", { ref: mountRef, className: editorClassName, "data-prosemirror-crdt-mount": "true" }) }));
+    }
+    catch (error) {
+        logError('Failed to render ProseMirrorCrdtEditor', error);
+        return null;
+    }
+}
+
+Object.defineProperty(exports, "redo", {
+    enumerable: true,
+    get: function () { return prosemirrorCrdt.redo; }
+});
+Object.defineProperty(exports, "undo", {
+    enumerable: true,
+    get: function () { return prosemirrorCrdt.undo; }
+});
+exports.ProseMirrorCrdtEditor = ProseMirrorCrdtEditor;
+exports.createDefaultProseMirrorSchema = createDefaultProseMirrorSchema;
+exports.createHighlightMarkSpec = createHighlightMarkSpec;
+exports.defaultProseMirrorSchema = defaultProseMirrorSchema;
+exports.useCollaboration = useCollaboration;
+//# sourceMappingURL=index.js.map

package/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/utils.ts","../../../src/use-collaboration.ts","../../../src/schema.ts","../../../src/prosemirror-crdt-editor.tsx"],"sourcesContent":[null,null,null,null],"names":["useVeltClient","useVeltInitState","useState","useRef","useCallback","useEffect","createCollaboration","addListNodes","basicSchema","Schema","_jsx"],"mappings":"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"}

package/esm/index.js

@@ -0,0 +1,465 @@
+import { useState, useRef, useCallback, useEffect } from 'react';
+import { useVeltClient, useVeltInitState } from '@veltdev/react';
+import { createCollaboration } from '@veltdev/prosemirror-crdt';
+export { redo, undo } from '@veltdev/prosemirror-crdt';
+import { jsx } from 'react/jsx-runtime';
+import { Schema } from 'prosemirror-model';
+import { schema } from 'prosemirror-schema-basic';
+import { addListNodes } from 'prosemirror-schema-list';
+
+// POLICY: Every function/method in this file MUST be wrapped in try/catch.
+// The package must NEVER throw an exception to the consumer's code.
+function logError(message, error) {
+    try {
+        if (typeof console !== 'undefined' && console.error) {
+            console.error(`[ProseMirrorCRDTReact] ${message}`, error);
+        }
+    }
+    catch {
+        // Logging must never throw into consumer code.
+    }
+}
+function toError(error) {
+    try {
+        return error instanceof Error ? error : new Error(String(error));
+    }
+    catch {
+        return new Error('Unknown error');
+    }
+}
+
+// POLICY: Every function/method in this file MUST be wrapped in try/catch.
+// The package must NEVER throw an exception to the consumer's code.
+function getVeltUser(client) {
+    try {
+        return client.getUser?.();
+    }
+    catch {
+        return null;
+    }
+}
+function useCollaboration(config) {
+    const { client } = useVeltClient();
+    const veltInitState = useVeltInitState();
+    const [mount, setMount] = useState(null);
+    const [editorView, setEditorView] = useState(config.editorView ?? null);
+    const [manager, setManager] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [synced, setSynced] = useState(false);
+    const [status, setStatus] = useState('connecting');
+    const [error, setError] = useState(null);
+    const [versions, setVersions] = useState([]);
+    const managerRef = useRef(null);
+    const createdViewRef = useRef(null);
+    const configRef = useRef(config);
+    const activeClientRef = useRef(null);
+    const activeEditorIdRef = useRef(null);
+    const activeMountRef = useRef(null);
+    const activeExternalViewRef = useRef(null);
+    const unsubscribersRef = useRef([]);
+    configRef.current = config;
+    const veltClient = config.veltClient ?? client;
+    const enabled = config.enabled ?? true;
+    const effectiveMount = config.mount ?? mount;
+    const externalView = config.editorView ?? null;
+    const cleanupActiveManager = useCallback(() => {
+        try {
+            for (const unsubscribe of unsubscribersRef.current) {
+                try {
+                    unsubscribe();
+                }
+                catch { /* ignore */ }
+            }
+            unsubscribersRef.current = [];
+            try {
+                managerRef.current?.destroy();
+            }
+            catch { /* ignore */ }
+            managerRef.current = null;
+            const createdView = createdViewRef.current;
+            createdViewRef.current = null;
+            if (createdView && configRef.current.destroyViewOnUnmount !== false) {
+                try {
+                    createdView.destroy();
+                }
+                catch { /* ignore */ }
+            }
+            activeClientRef.current = null;
+            activeEditorIdRef.current = null;
+            activeMountRef.current = null;
+            activeExternalViewRef.current = null;
+            setManager(null);
+            setEditorView(externalView);
+            setIsLoading(true);
+            setSynced(false);
+            setStatus('connecting');
+            setError(null);
+            setVersions([]);
+        }
+        catch (err) {
+            logError('Failed to cleanup ProseMirror collaboration manager', err);
+        }
+    }, [externalView]);
+    const mountRef = useCallback((element) => {
+        try {
+            setMount(element);
+        }
+        catch (err) {
+            logError('Failed to capture ProseMirror mount element', err);
+        }
+    }, []);
+    useEffect(() => {
+        try {
+            if (enabled)
+                return;
+            cleanupActiveManager();
+        }
+        catch (err) {
+            logError('Failed to disable ProseMirror collaboration', err);
+        }
+    }, [enabled, cleanupActiveManager]);
+    useEffect(() => {
+        try {
+            if (!enabled || !veltClient || !veltInitState || !config.schema)
+                return;
+            if (!externalView && !effectiveMount)
+                return;
+            if (!getVeltUser(veltClient))
+                return;
+            if (managerRef.current
+                && activeClientRef.current === veltClient
+                && activeEditorIdRef.current === config.editorId
+                && activeMountRef.current === effectiveMount
+                && activeExternalViewRef.current === externalView) {
+                return;
+            }
+            cleanupActiveManager();
+            let mounted = true;
+            const init = async () => {
+                try {
+                    const latest = configRef.current;
+                    const created = await createCollaboration({
+                        editorId: latest.editorId,
+                        veltClient: veltClient,
+                        schema: latest.schema,
+                        initialContent: latest.initialContent,
+                        cursorData: latest.cursorData,
+                        debounceMs: latest.debounceMs,
+                        forceResetInitialContent: latest.forceResetInitialContent,
+                        editorView: externalView ?? undefined,
+                        autoInitialize: false,
+                        onError: (err) => {
+                            try {
+                                if (mounted)
+                                    setError(err);
+                                configRef.current.onError?.(err);
+                            }
+                            catch { /* ignore */ }
+                        },
+                    });
+                    if (!mounted) {
+                        try {
+                            created.destroy();
+                        }
+                        catch { /* ignore */ }
+                        return;
+                    }
+                    let view = externalView;
+                    if (!view && effectiveMount) {
+                        view = created.createEditorView(effectiveMount, {
+                            schema: latest.schema,
+                            state: latest.state,
+                            plugins: latest.plugins,
+                            keymap: latest.keymap,
+                            disableCursors: latest.disableCursors,
+                            viewProps: latest.viewProps,
+                        });
+                        createdViewRef.current = view;
+                    }
+                    else if (view) {
+                        created.attachEditorView(view);
+                    }
+                    if (!view) {
+                        throw new Error('Failed to create ProseMirror EditorView');
+                    }
+                    managerRef.current = created;
+                    activeClientRef.current = veltClient;
+                    activeEditorIdRef.current = latest.editorId;
+                    activeMountRef.current = effectiveMount;
+                    activeExternalViewRef.current = externalView;
+                    setManager(created);
+                    setEditorView(view);
+                    const unsubscribeStatus = created.onStatusChange((nextStatus) => {
+                        try {
+                            if (mounted)
+                                setStatus(nextStatus);
+                        }
+                        catch { /* ignore */ }
+                    });
+                    const unsubscribeSynced = created.onSynced((isSynced) => {
+                        try {
+                            if (mounted)
+                                setSynced(isSynced);
+                        }
+                        catch { /* ignore */ }
+                    });
+                    unsubscribersRef.current = [unsubscribeStatus, unsubscribeSynced];
+                    await created.initialize();
+                    if (mounted && created.synced)
+                        setSynced(true);
+                    if (mounted && created.status !== 'connecting')
+                        setStatus(created.status);
+                    try {
+                        const list = await created.getVersions();
+                        if (mounted)
+                            setVersions(list);
+                    }
+                    catch (err) {
+                        logError('Failed to load initial ProseMirror versions', err);
+                    }
+                    if (mounted) {
+                        setIsLoading(false);
+                        setError(null);
+                    }
+                }
+                catch (err) {
+                    logError('Failed to initialize ProseMirror collaboration', err);
+                    if (mounted) {
+                        setError(toError(err));
+                        setIsLoading(false);
+                    }
+                }
+            };
+            void init();
+            return () => {
+                try {
+                    mounted = false;
+                    cleanupActiveManager();
+                }
+                catch { /* ignore cleanup */ }
+            };
+        }
+        catch (err) {
+            logError('Error in useCollaboration effect', err);
+        }
+    }, [
+        cleanupActiveManager,
+        effectiveMount,
+        enabled,
+        externalView,
+        veltClient,
+        veltInitState,
+        config.editorId,
+        config.schema,
+    ]);
+    const refreshVersions = useCallback(async () => {
+        try {
+            const list = (await managerRef.current?.getVersions()) ?? [];
+            setVersions(list);
+            return list;
+        }
+        catch (err) {
+            logError('Failed to refresh ProseMirror versions', err);
+            return [];
+        }
+    }, []);
+    const saveVersion = useCallback(async (name) => {
+        try {
+            const id = (await managerRef.current?.saveVersion(name)) ?? '';
+            try {
+                const list = (await managerRef.current?.getVersions()) ?? [];
+                setVersions(list);
+            }
+            catch { /* best-effort refresh */ }
+            return id;
+        }
+        catch (err) {
+            logError('Failed to save ProseMirror version', err);
+            return '';
+        }
+    }, []);
+    const restoreVersion = useCallback(async (versionId) => {
+        try {
+            const restored = (await managerRef.current?.restoreVersion(versionId)) ?? false;
+            if (restored) {
+                try {
+                    const list = (await managerRef.current?.getVersions()) ?? [];
+                    setVersions(list);
+                }
+                catch { /* best-effort refresh */ }
+            }
+            return restored;
+        }
+        catch (err) {
+            logError('Failed to restore ProseMirror version', err);
+            return false;
+        }
+    }, []);
+    const destroy = useCallback(() => {
+        try {
+            cleanupActiveManager();
+            setStatus('disconnected');
+            setIsLoading(false);
+        }
+        catch (err) {
+            logError('Failed to destroy ProseMirror collaboration', err);
+        }
+    }, [cleanupActiveManager]);
+    return {
+        mountRef,
+        editorView,
+        manager,
+        isLoading,
+        synced,
+        isSynced: synced,
+        status,
+        error,
+        versions,
+        refreshVersions,
+        saveVersion,
+        restoreVersion,
+        destroy,
+    };
+}
+
+// POLICY: Every function/method in this file MUST be wrapped in try/catch.
+// The package must NEVER throw an exception to the consumer's code.
+const DEFAULT_HIGHLIGHT_COLOR = '#fff59d';
+function createHighlightMarkSpec(defaultColor = DEFAULT_HIGHLIGHT_COLOR) {
+    try {
+        return {
+            attrs: {
+                color: { default: defaultColor },
+            },
+            parseDOM: [
+                {
+                    tag: 'span[data-highlight]',
+                    getAttrs: (node) => {
+                        try {
+                            const element = node;
+                            return {
+                                color: element.getAttribute('data-highlight-color') || defaultColor,
+                            };
+                        }
+                        catch {
+                            return { color: defaultColor };
+                        }
+                    },
+                },
+                {
+                    style: 'background-color',
+                    getAttrs: (value) => {
+                        try {
+                            return { color: String(value || defaultColor) };
+                        }
+                        catch {
+                            return { color: defaultColor };
+                        }
+                    },
+                },
+            ],
+            toDOM(mark) {
+                try {
+                    const color = mark.attrs.color || defaultColor;
+                    return [
+                        'span',
+                        {
+                            'data-highlight': 'true',
+                            'data-highlight-color': color,
+                            style: `background-color: ${color}`,
+                        },
+                        0,
+                    ];
+                }
+                catch {
+                    return ['span', { 'data-highlight': 'true' }, 0];
+                }
+            },
+        };
+    }
+    catch (error) {
+        logError('Failed to create highlight mark spec', error);
+        return {};
+    }
+}
+function createDefaultProseMirrorSchema() {
+    try {
+        const nodes = addListNodes(schema.spec.nodes, 'paragraph block*', 'block');
+        return new Schema({
+            nodes,
+            marks: schema.spec.marks.addToEnd('highlight', createHighlightMarkSpec(DEFAULT_HIGHLIGHT_COLOR)),
+        });
+    }
+    catch (error) {
+        logError('Failed to create default ProseMirror schema', error);
+        return schema;
+    }
+}
+const defaultProseMirrorSchema = createDefaultProseMirrorSchema();
+
+function ProseMirrorCrdtEditor(props) {
+    const { editorId, documentId, veltClient, schema = defaultProseMirrorSchema, initialContent, forceResetInitialContent, cursorData, debounceMs, enabled, state, plugins, keymap, disableCursors, viewProps, destroyViewOnUnmount, onError, onStatusChange, onManagerReady, onEditorReady, className, editorClassName, } = props;
+    const resolvedEditorId = editorId ?? documentId ?? 'velt-prosemirror-crdt-document';
+    const { mountRef, editorView, manager, status } = useCollaboration({
+        editorId: resolvedEditorId,
+        veltClient,
+        schema,
+        initialContent,
+        forceResetInitialContent,
+        cursorData,
+        debounceMs,
+        enabled,
+        state,
+        plugins,
+        keymap,
+        disableCursors,
+        viewProps,
+        destroyViewOnUnmount,
+        onError,
+    });
+    const lastStatusRef = useRef(null);
+    useEffect(() => {
+        try {
+            if (status !== lastStatusRef.current) {
+                lastStatusRef.current = status;
+                onStatusChange?.(status);
+            }
+        }
+        catch (error) {
+            logError('Error in onStatusChange callback', error);
+        }
+    }, [status, onStatusChange]);
+    const notifiedManagerRef = useRef(null);
+    useEffect(() => {
+        try {
+            if (manager && manager !== notifiedManagerRef.current) {
+                notifiedManagerRef.current = manager;
+                onManagerReady?.(manager);
+            }
+        }
+        catch (error) {
+            logError('Error in onManagerReady callback', error);
+        }
+    }, [manager, onManagerReady]);
+    const notifiedEditorRef = useRef(null);
+    useEffect(() => {
+        try {
+            if (editorView && editorView !== notifiedEditorRef.current) {
+                notifiedEditorRef.current = editorView;
+                onEditorReady?.(editorView);
+            }
+        }
+        catch (error) {
+            logError('Error in onEditorReady callback', error);
+        }
+    }, [editorView, onEditorReady]);
+    try {
+        return (jsx("div", { className: className, "data-velt-prosemirror-crdt": "true", children: jsx("div", { ref: mountRef, className: editorClassName, "data-prosemirror-crdt-mount": "true" }) }));
+    }
+    catch (error) {
+        logError('Failed to render ProseMirrorCrdtEditor', error);
+        return null;
+    }
+}
+
+export { ProseMirrorCrdtEditor, createDefaultProseMirrorSchema, createHighlightMarkSpec, defaultProseMirrorSchema, useCollaboration };

package/esm/types/index.d.ts

@@ -0,0 +1,6 @@
+export { useCollaboration } from './use-collaboration';
+export { ProseMirrorCrdtEditor } from './prosemirror-crdt-editor';
+export { createDefaultProseMirrorSchema, createHighlightMarkSpec, defaultProseMirrorSchema, } from './schema';
+export type { CollaborationManager, CursorData, ProseMirrorCrdtEditorProps, ProseMirrorCrdtHookResult, ProseMirrorEditorViewOptions, ProseMirrorJSON, ProseMirrorPluginOptions, SyncStatus, Unsubscribe, UseCollaborationConfig, UseCollaborationReturn, UseProseMirrorCrdtConfig, Version, } from './types';
+export { redo, undo } from '@veltdev/prosemirror-crdt';
+//# sourceMappingURL=index.d.ts.map

package/esm/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACL,8BAA8B,EAC9B,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,oBAAoB,EACpB,UAAU,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,4BAA4B,EAC5B,eAAe,EACf,wBAAwB,EACxB,UAAU,EACV,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,OAAO,GACR,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC"}

package/esm/types/prosemirror-crdt-editor.d.ts

@@ -0,0 +1,3 @@
+import type { ProseMirrorCrdtEditorProps } from './types';
+export declare function ProseMirrorCrdtEditor(props: ProseMirrorCrdtEditorProps): import("react").JSX.Element | null;
+//# sourceMappingURL=prosemirror-crdt-editor.d.ts.map

package/esm/types/prosemirror-crdt-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prosemirror-crdt-editor.d.ts","sourceRoot":"","sources":["../../../src/prosemirror-crdt-editor.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAG1D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,sCA8FtE"}

package/esm/types/schema.d.ts

@@ -0,0 +1,6 @@
+import { Schema } from 'prosemirror-model';
+import type { MarkSpec } from 'prosemirror-model';
+export declare function createHighlightMarkSpec(defaultColor?: string): MarkSpec;
+export declare function createDefaultProseMirrorSchema(): Schema;
+export declare const defaultProseMirrorSchema: Schema<any, any>;
+//# sourceMappingURL=schema.d.ts.map

package/esm/types/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAQlD,wBAAgB,uBAAuB,CAAC,YAAY,SAA0B,GAAG,QAAQ,CAoDxF;AAED,wBAAgB,8BAA8B,IAAI,MAAM,CAmBvD;AAED,eAAO,MAAM,wBAAwB,kBAAmC,CAAC"}

package/esm/types/types.d.ts

@@ -0,0 +1,74 @@
+import type { Velt } from '@veltdev/types';
+import type { CollaborationConfig as BaseCollaborationConfig, CollaborationManager, CursorData, ProseMirrorEditorViewOptions, ProseMirrorPluginOptions, ProseMirrorJSON, SyncStatus, Unsubscribe, Version } from '@veltdev/prosemirror-crdt';
+import type { Command, EditorState, Plugin } from 'prosemirror-state';
+import type { DirectEditorProps, EditorView } from 'prosemirror-view';
+export type { CollaborationManager, CursorData, ProseMirrorEditorViewOptions, ProseMirrorJSON, ProseMirrorPluginOptions, SyncStatus, Unsubscribe, Version, };
+export interface UseProseMirrorCrdtConfig extends Omit<BaseCollaborationConfig, 'veltClient' | 'autoInitialize' | 'editorView'> {
+    /** Optional Velt client override. Falls back to useVeltClient(). */
+    veltClient?: Velt;
+    /** Set false to delay manager creation or destroy it while mounted. */
+    enabled?: boolean;
+    /** Existing EditorView owned by the consumer. If omitted, the hook creates one. */
+    editorView?: EditorView | null;
+    /** DOM mount used when the hook creates the EditorView. */
+    mount?: Element | null;
+    /** Optional pre-created state. Collaboration plugins are appended by the base manager. */
+    state?: EditorState;
+    /** Extra ProseMirror plugins placed after y-prosemirror sync/cursor/undo plugins. */
+    plugins?: Plugin[];
+    /** Keymap commands merged through the base package helper. */
+    keymap?: Record<string, Command>;
+    /** Disable remote cursor rendering while keeping document sync enabled. */
+    disableCursors?: boolean;
+    /** Optional EditorView props passed through when the hook creates the view. */
+    viewProps?: Omit<DirectEditorProps, 'state'>;
+    /** Destroy the created EditorView during cleanup. Default: true. */
+    destroyViewOnUnmount?: boolean;
+}
+export interface ProseMirrorCrdtHookResult {
+    /** DOM mount receiver for the managed ProseMirror EditorView. */
+    mountRef: (element: HTMLDivElement | null) => void;
+    /** Active ProseMirror EditorView. */
+    editorView: EditorView | null;
+    /** Escape hatch - the underlying base CollaborationManager. */
+    manager: CollaborationManager | null;
+    /** true until Velt, mount/view, and the base manager are initialized. */
+    isLoading: boolean;
+    /** true after the provider reports initial backend sync complete. */
+    synced: boolean;
+    /** Alias for synced, matching other Velt CRDT React wrappers. */
+    isSynced: boolean;
+    /** Current provider connection status. */
+    status: SyncStatus;
+    /** Non-null if initialization fails or the base package reports an error. */
+    error: Error | null;
+    /** Saved version metadata. */
+    versions: Version[];
+    /** Re-fetch saved versions from the base manager. */
+    refreshVersions: () => Promise<Version[]>;
+    /** Save a named version snapshot. Returns an empty string on failure. */
+    saveVersion: (name: string) => Promise<string>;
+    /** Restore a specific version. Returns false on failure. */
+    restoreVersion: (versionId: string) => Promise<boolean>;
+    /** Destroy the active manager early. Also runs on unmount. */
+    destroy: () => void;
+}
+export type UseCollaborationConfig = UseProseMirrorCrdtConfig;
+export type UseCollaborationReturn = ProseMirrorCrdtHookResult;
+export interface ProseMirrorCrdtEditorProps extends Omit<UseProseMirrorCrdtConfig, 'mount' | 'editorView' | 'editorId'> {
+    /** Unique editor/document identifier for syncing. */
+    editorId?: string;
+    /** Convenience document identifier used as editorId when editorId is omitted. */
+    documentId?: string;
+    /** Class name for the outer wrapper. */
+    className?: string;
+    /** Class name for the ProseMirror mount element. */
+    editorClassName?: string;
+    /** Called once the base CollaborationManager is ready. */
+    onManagerReady?: (manager: CollaborationManager) => void;
+    /** Called when the EditorView is created. */
+    onEditorReady?: (editorView: EditorView) => void;
+    /** Called whenever the sync connection status changes. */
+    onStatusChange?: (status: SyncStatus) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/esm/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}

package/esm/types/use-collaboration.d.ts

@@ -0,0 +1,3 @@
+import type { ProseMirrorCrdtHookResult, UseProseMirrorCrdtConfig } from './types';
+export declare function useCollaboration(config: UseProseMirrorCrdtConfig): ProseMirrorCrdtHookResult;
+//# sourceMappingURL=use-collaboration.d.ts.map

package/esm/types/use-collaboration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collaboration.d.ts","sourceRoot":"","sources":["../../../src/use-collaboration.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAWnF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,wBAAwB,GAAG,yBAAyB,CAgR5F"}

package/esm/types/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function logError(message: string, error?: unknown): void;
+export declare function toError(error: unknown): Error;
+//# sourceMappingURL=utils.d.ts.map

package/esm/types/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAQ/D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAM7C"}

package/index.d.ts

@@ -0,0 +1,87 @@
+import { Velt } from '@veltdev/types';
+import { CollaborationConfig, CollaborationManager, SyncStatus, Version } from '@veltdev/prosemirror-crdt';
+export { CollaborationManager, CursorData, ProseMirrorEditorViewOptions, ProseMirrorJSON, ProseMirrorPluginOptions, SyncStatus, Unsubscribe, Version, redo, undo } from '@veltdev/prosemirror-crdt';
+import { EditorState, Plugin, Command } from 'prosemirror-state';
+import { EditorView, DirectEditorProps } from 'prosemirror-view';
+import * as react from 'react';
+import { Schema, MarkSpec } from 'prosemirror-model';
+
+interface UseProseMirrorCrdtConfig extends Omit<CollaborationConfig, 'veltClient' | 'autoInitialize' | 'editorView'> {
+    /** Optional Velt client override. Falls back to useVeltClient(). */
+    veltClient?: Velt;
+    /** Set false to delay manager creation or destroy it while mounted. */
+    enabled?: boolean;
+    /** Existing EditorView owned by the consumer. If omitted, the hook creates one. */
+    editorView?: EditorView | null;
+    /** DOM mount used when the hook creates the EditorView. */
+    mount?: Element | null;
+    /** Optional pre-created state. Collaboration plugins are appended by the base manager. */
+    state?: EditorState;
+    /** Extra ProseMirror plugins placed after y-prosemirror sync/cursor/undo plugins. */
+    plugins?: Plugin[];
+    /** Keymap commands merged through the base package helper. */
+    keymap?: Record<string, Command>;
+    /** Disable remote cursor rendering while keeping document sync enabled. */
+    disableCursors?: boolean;
+    /** Optional EditorView props passed through when the hook creates the view. */
+    viewProps?: Omit<DirectEditorProps, 'state'>;
+    /** Destroy the created EditorView during cleanup. Default: true. */
+    destroyViewOnUnmount?: boolean;
+}
+interface ProseMirrorCrdtHookResult {
+    /** DOM mount receiver for the managed ProseMirror EditorView. */
+    mountRef: (element: HTMLDivElement | null) => void;
+    /** Active ProseMirror EditorView. */
+    editorView: EditorView | null;
+    /** Escape hatch - the underlying base CollaborationManager. */
+    manager: CollaborationManager | null;
+    /** true until Velt, mount/view, and the base manager are initialized. */
+    isLoading: boolean;
+    /** true after the provider reports initial backend sync complete. */
+    synced: boolean;
+    /** Alias for synced, matching other Velt CRDT React wrappers. */
+    isSynced: boolean;
+    /** Current provider connection status. */
+    status: SyncStatus;
+    /** Non-null if initialization fails or the base package reports an error. */
+    error: Error | null;
+    /** Saved version metadata. */
+    versions: Version[];
+    /** Re-fetch saved versions from the base manager. */
+    refreshVersions: () => Promise<Version[]>;
+    /** Save a named version snapshot. Returns an empty string on failure. */
+    saveVersion: (name: string) => Promise<string>;
+    /** Restore a specific version. Returns false on failure. */
+    restoreVersion: (versionId: string) => Promise<boolean>;
+    /** Destroy the active manager early. Also runs on unmount. */
+    destroy: () => void;
+}
+type UseCollaborationConfig = UseProseMirrorCrdtConfig;
+type UseCollaborationReturn = ProseMirrorCrdtHookResult;
+interface ProseMirrorCrdtEditorProps extends Omit<UseProseMirrorCrdtConfig, 'mount' | 'editorView' | 'editorId'> {
+    /** Unique editor/document identifier for syncing. */
+    editorId?: string;
+    /** Convenience document identifier used as editorId when editorId is omitted. */
+    documentId?: string;
+    /** Class name for the outer wrapper. */
+    className?: string;
+    /** Class name for the ProseMirror mount element. */
+    editorClassName?: string;
+    /** Called once the base CollaborationManager is ready. */
+    onManagerReady?: (manager: CollaborationManager) => void;
+    /** Called when the EditorView is created. */
+    onEditorReady?: (editorView: EditorView) => void;
+    /** Called whenever the sync connection status changes. */
+    onStatusChange?: (status: SyncStatus) => void;
+}
+
+declare function useCollaboration(config: UseProseMirrorCrdtConfig): ProseMirrorCrdtHookResult;
+
+declare function ProseMirrorCrdtEditor(props: ProseMirrorCrdtEditorProps): react.JSX.Element | null;
+
+declare function createHighlightMarkSpec(defaultColor?: string): MarkSpec;
+declare function createDefaultProseMirrorSchema(): Schema;
+declare const defaultProseMirrorSchema: Schema<any, any>;
+
+export { ProseMirrorCrdtEditor, createDefaultProseMirrorSchema, createHighlightMarkSpec, defaultProseMirrorSchema, useCollaboration };
+export type { ProseMirrorCrdtEditorProps, ProseMirrorCrdtHookResult, UseCollaborationConfig, UseCollaborationReturn, UseProseMirrorCrdtConfig };

package/package.json

@@ -0,0 +1,60 @@
+{
+    "name": "@veltdev/prosemirror-crdt-react",
+    "version": "1.0.0",
+    "description": "ProseMirror CRDT React library for Velt",
+    "homepage": "https://velt.dev",
+    "keywords": [
+        "prosemirror",
+        "react",
+        "velt",
+        "real-time",
+        "realtime",
+        "toolkit",
+        "multiplayer",
+        "websockets",
+        "collaboration",
+        "collaborative",
+        "presence",
+        "rooms",
+        "documents",
+        "conflict resolution",
+        "crdts",
+        "comment",
+        "comments",
+        "recording",
+        "screen recording",
+        "cursors",
+        "notifications",
+        "cord",
+        "liveblocks"
+    ],
+    "scripts": {
+        "test": "echo \"Error: no test specified\" && exit 1",
+        "version:update": "node ../update-npm-package.mjs",
+        "publish:crdt": "npm publish --access public"
+    },
+    "author": "Velt Inc.",
+    "license": "Proprietary",
+    "main": "cjs/index.js",
+    "module": "esm/index.js",
+    "types": "index.d.ts",
+    "peerDependencies": {
+        "@veltdev/prosemirror-crdt": ">=1.0.0-beta.1",
+        "@veltdev/react": ">=5.0.2-beta.8",
+        "@veltdev/types": ">=5.0.2-beta.8",
+        "prosemirror-model": "^1.25.10",
+        "prosemirror-schema-basic": "^1.2.4",
+        "prosemirror-schema-list": "^1.5.1",
+        "prosemirror-state": "^1.4.4",
+        "prosemirror-view": "^1.42.0",
+        "react": "^18.2.0 || ^19.0.0",
+        "react-dom": "^18.2.0 || ^19.0.0",
+        "y-prosemirror": "^1.3.7",
+        "yjs": ">=13.6.31"
+    },
+    "peerDependenciesMeta": {
+        "@veltdev/types": {
+            "optional": true
+        }
+    }
+}