RVRite — Package Upgrade & Technology Report

1Executive summary

Two pieces of work landed on this branch. (A) The editor core was migrated from a fragile mixed TipTap v2 install (betas + v1 dead weight) to a clean, consistent TipTap 3.27.0. (B) The frontend and collab-server package.json files were then pruned of confirmed-unused dependencies.

2Major Changes

High-level summary of the most significant architectural, dependency, and API changes completed during the TipTap v3 migration.

3TipTap core upgrade (v2-mixed → v3.27.0)

The baseline was not clean v2 — it mixed 2.0.0-beta.199, 2.0.3, 2.1.x, 2.4.0 and a dead tiptap@1.32.2. Every @tiptap/* package is now pinned to one consistent minor (^3.27.0).

4New packages introduced by the migration

The migration also briefly added @tiptap/extension-collaboration-caret (the v3 rename of collaboration-cursor), but the cleanup later removed it — the main editor uses a vendored caret extension (§5).

5Packages removed or folded in by v3

6Code & technology migration details

ProseMirror normalization make-or-break for track changes

• All 102 prosemirror-* imports across 73 files rewritten to @tiptap/pm/* (state, view, model, transform, gapcursor, schema-list, history). Imported symbols are identical — only the module specifier changed.
• Guarantees a single ProseMirror instance, so Decoration/Step/Selection instanceof checks keep working — the core requirement for the track-changes engine.

Yjs collaboration glue

• All 6 y-prosemirror imports → @tiptap/y-tiptap (ySyncPluginKey, yUndoPluginKey, yCursorPlugin, defaultSelectionBuilder) so they match the v3 Collaboration extension's internal sync.
• The main editor keeps its vendored collaboration-cursor.ts (owns the .collaboration-cursor__caret class) — ~30 DOM queries across the codebase are unaffected.

StarterKit & API call-site changes

• StarterKit configs: history:false → undoRedo:false, plus link:false, underline:false, trailingNode:false, listKeymap:false (v3 now bundles these — disabled to keep the custom Link/Underline).
• @tiptap/extension-text-style: default import → named { TextStyle } (v3 dropped the default export).
• setContent/clearContent (7 call sites): added { emitUpdate:false } — v3 emits updates by default.
• v3 runtime teardown guards: editor.view is now a throwing getter after destroy; unmount code (incl. React 18 StrictMode remount) was hardened with isDestroyed / optional-chaining in Common.tsx, TrackChangeFilter.tsx, Tiptap.tsx.

Build & toolchain

• Production build only moved to Vite — build / prodbuild run vite build. The dev server is unchanged: npm start still runs react-scripts start (CRA), so react-scripts remains a dependency.
• build/prodbuild scripts gained NODE_OPTIONS=--max-old-space-size=4096 — v3's larger graph OOMs at Node's default ~2 GB during minify.
• Related peer-tree fix: @hocuspocus/transformer was bumped 2.0.6 → ^4.2.0 (its v2 was the only blocker to a clean v3 peer tree) — later removed entirely by the cleanup as it is unused in the UI.

7Dependency cleanup (unused-package prune)

After the migration, every declared dependency was checked against real imports (JS/TS/JSX/SCSS/CSS/HTML, dynamic imports, CSS imports, peer-dep roles). Confirmed-unused packages were removed. Only the production build moved to Vite (build/prodbuild → vite build); the dev server still runs react-scripts start, so react-scripts and its CRA tooling are kept. The dead eslintConfig block was removed.

8Current technology stack