{"_id":"@anandanair/tiptap-visual-diff","_rev":"8-037e65de3325e77e24be500dc689e5ea","name":"@anandanair/tiptap-visual-diff","dist-tags":{"latest":"0.1.7"},"versions":{"0.1.0":{"name":"@anandanair/tiptap-visual-diff","version":"0.1.0","keywords":["tiptap","tiptap-extension","diff","visual-diff","compare","prosemirror","rich-text-editor","track-changes"],"author":{"name":"Anand"},"license":"MIT","_id":"@anandanair/tiptap-visual-diff@0.1.0","maintainers":[{"name":"anandanair","email":"anandanairaan@gmail.com"}],"homepage":"https://github.com/anand/tiptap-visual-diff#readme","bugs":{"url":"https://github.com/anand/tiptap-visual-diff/issues"},"dist":{"shasum":"ab8b5cf74d5bb6fc8b2af576ed3a61419d3fc41e","tarball":"https://registry.npmjs.org/@anandanair/tiptap-visual-diff/-/tiptap-visual-diff-0.1.0.tgz","fileCount":8,"integrity":"sha512-KGEevp0ohwMSRfvoXks2W9Rv80vphAB2y9JNcR5yLm9py1b2uPZs7whIvxpv2NVC13MiJ1eb934znucIY2M4SA==","signatures":[{"sig":"MEYCIQCllWgJ/XY272uWY2A9BNCHAXWFaMdg2da9heOY41JhhQIhAJmYjVwem0o1BCfk3XfGc+9USfpe2E+bdzNKlTdesfof","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63026},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"24e493284c698532f620b15b48899f8ac734a542","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"anandanair","email":"anandanairaan@gmail.com"},"repository":{"url":"git+https://github.com/anand/tiptap-visual-diff.git","type":"git"},"_npmVersion":"11.13.0","description":"ProseMirror decoration-based visual diff extension for Tiptap v3. Compares editor content against a reference document and highlights additions, removals, and modifications inline — without touching the actual document content.","directories":{},"_nodeVersion":"22.20.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.3"},"peerDependencies":{"diff":">=5.0.0","@tiptap/pm":"^3.0.0","@tiptap/core":"^3.0.0"},"peerDependenciesMeta":{"diff":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/tiptap-visual-diff_0.1.0_1779727217768_0.09644524780317232","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@anandanair/tiptap-visual-diff","version":"0.1.1","keywords":["tiptap","tiptap-extension","diff","visual-diff","compare","prosemirror","rich-text-editor","track-changes"],"author":{"name":"Anand"},"license":"MIT","_id":"@anandanair/tiptap-visual-diff@0.1.1","maintainers":[{"name":"anandanair","email":"anandanairaan@gmail.com"}],"homepage":"https://github.com/anandanair/tiptap-visual-diff#readme","bugs":{"url":"https://github.com/anandanair/tiptap-visual-diff/issues"},"dist":{"shasum":"b6b921e2d00822db154dcd0cf4f062a39b2baa5c","tarball":"https://registry.npmjs.org/@anandanair/tiptap-visual-diff/-/tiptap-visual-diff-0.1.1.tgz","fileCount":8,"integrity":"sha512-GNOvbhGBcdX0Ia+CHyicG+lINBE4BbrfxOb9dv6hMY0+s7uiJB3GWXFr1xjIeIGVt3S9jn5qHuxxPCgNEa9Jow==","signatures":[{"sig":"MEYCIQDqosQAeV32/Df0tcck+UE8DJu2tJvEG3uQDLfS4JJQsAIhAOUVKZNvLLPviC4zipB4X4ZsIEPZVrk75kaIeH/JhEA6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63031},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"066d9214d572f9ba3eac27a8962079bde5ff7e43","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"anandanair","email":"anandanairaan@gmail.com"},"repository":{"url":"git+https://github.com/anandanair/tiptap-visual-diff.git","type":"git"},"_npmVersion":"11.13.0","description":"ProseMirror decoration-based visual diff extension for Tiptap v3. Compares editor content against a reference document and highlights additions, removals, and modifications inline — without touching the actual document content.","directories":{},"_nodeVersion":"22.20.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.3"},"peerDependencies":{"diff":">=5.0.0","@tiptap/pm":"^3.0.0","@tiptap/core":"^3.0.0"},"peerDependenciesMeta":{"diff":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/tiptap-visual-diff_0.1.1_1779727359231_0.6755320282441757","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@anandanair/tiptap-visual-diff","version":"0.1.2","keywords":["tiptap","tiptap-extension","diff","visual-diff","compare","prosemirror","rich-text-editor","track-changes"],"author":{"name":"Anand"},"license":"MIT","_id":"@anandanair/tiptap-visual-diff@0.1.2","maintainers":[{"name":"anandanair","email":"anandanairaan@gmail.com"}],"homepage":"https://github.com/anandanair/tiptap-visual-diff#readme","bugs":{"url":"https://github.com/anandanair/tiptap-visual-diff/issues"},"dist":{"shasum":"7e824a6a803037b1f469ae6a206a37809ed465f0","tarball":"https://registry.npmjs.org/@anandanair/tiptap-visual-diff/-/tiptap-visual-diff-0.1.2.tgz","fileCount":8,"integrity":"sha512-DJyCSrGNHed9aRJ2ZRn7fkNeQrQN9l+zLFzbmf0R7/OZjNZXY6xHP+XpQdkNNrwQ32IZt1aChfArjw8t8PsT4Q==","signatures":[{"sig":"MEYCIQDa9Wcw4DDWNGCgkpQv2oRD5BPRu6A8TAnR2K8kcumE0gIhANZfWHRKnpWtNm5jk5vQigLUiZDt/X/4aZ/sG2DWg8zM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63820},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"4e892b26aff12cc9493944a08a32d5702ba8ab3f","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"anandanair","email":"anandanairaan@gmail.com"},"repository":{"url":"git+https://github.com/anandanair/tiptap-visual-diff.git","type":"git"},"_npmVersion":"11.13.0","description":"ProseMirror decoration-based visual diff extension for Tiptap v3. Compares editor content against a reference document and highlights additions, removals, and modifications inline — without touching the actual document content.","directories":{},"_nodeVersion":"22.20.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.3"},"peerDependencies":{"diff":">=5.0.0","@tiptap/pm":"^3.0.0","@tiptap/core":"^3.0.0"},"peerDependenciesMeta":{"diff":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/tiptap-visual-diff_0.1.2_1779727684316_0.9635834488416946","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@anandanair/tiptap-visual-diff","version":"0.1.3","keywords":["tiptap","tiptap-extension","diff","visual-diff","compare","prosemirror","rich-text-editor","track-changes"],"author":{"name":"Anand"},"license":"MIT","_id":"@anandanair/tiptap-visual-diff@0.1.3","maintainers":[{"name":"anandanair","email":"anandanairaan@gmail.com"}],"homepage":"https://github.com/anandanair/tiptap-visual-diff#readme","bugs":{"url":"https://github.com/anandanair/tiptap-visual-diff/issues"},"dist":{"shasum":"9b96f115ce9569aa2305820aaec8135ce5a956ec","tarball":"https://registry.npmjs.org/@anandanair/tiptap-visual-diff/-/tiptap-visual-diff-0.1.3.tgz","fileCount":8,"integrity":"sha512-03mgLmm/t0OtmRSjBiRO96J5sy0Q7GbR1fmgOR+Dg1SNpcVG5flRDBFZ8zR5iOg5t5jfPiWYmMdMno23q1Y3PQ==","signatures":[{"sig":"MEUCIG+pD+nUnvCkSgO5pAc3FYz2cRqsD7gtncH9DJoFczXBAiEA/4hHZqow+RxDMxy3Hu3dqMGs/o/nh7X2TcVWvL3M2tI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64975},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"364c2b6a1b26baebbe8d2254702f8c0f2d84d8bf","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"anandanair","email":"anandanairaan@gmail.com"},"repository":{"url":"git+https://github.com/anandanair/tiptap-visual-diff.git","type":"git"},"_npmVersion":"11.13.0","description":"ProseMirror decoration-based visual diff extension for Tiptap v3. Compares editor content against a reference document and highlights additions, removals, and modifications inline — without touching the actual document content.","directories":{},"_nodeVersion":"22.20.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.3"},"peerDependencies":{"diff":">=5.0.0","@tiptap/pm":"^3.0.0","@tiptap/core":"^3.0.0"},"peerDependenciesMeta":{"diff":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/tiptap-visual-diff_0.1.3_1779763176237_0.9772658747987433","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@anandanair/tiptap-visual-diff","version":"0.1.4","keywords":["tiptap","tiptap-extension","diff","visual-diff","compare","prosemirror","rich-text-editor","track-changes"],"author":{"name":"Anand"},"license":"MIT","_id":"@anandanair/tiptap-visual-diff@0.1.4","maintainers":[{"name":"anandanair","email":"anandanairaan@gmail.com"}],"homepage":"https://github.com/anandanair/tiptap-visual-diff#readme","bugs":{"url":"https://github.com/anandanair/tiptap-visual-diff/issues"},"dist":{"shasum":"3de5a2f5b008b3b68a5352d5743ef57318405cc7","tarball":"https://registry.npmjs.org/@anandanair/tiptap-visual-diff/-/tiptap-visual-diff-0.1.4.tgz","fileCount":8,"integrity":"sha512-+y6d799N7RD/vZgHleO9rMZow34lLMehzeNuPpCta3uJATVmz2WZMPu7HLjm+qkkmipeloAdDNJRirjNPml2gQ==","signatures":[{"sig":"MEYCIQC2nMYiaiAqbj/QM0wuzUnHBHsvnIn8VCMlbBXNV8uc5QIhAN1pwLANcjYU4sMkInH0S4LXZGQQdUruLmTuAEQfYZn/","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64789},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"01fecc0d873fdfcdc095560297b594785858f2f8","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"anandanair","email":"anandanairaan@gmail.com"},"repository":{"url":"git+https://github.com/anandanair/tiptap-visual-diff.git","type":"git"},"_npmVersion":"11.13.0","description":"ProseMirror decoration-based visual diff extension for Tiptap v3. Compares editor content against a reference document and highlights additions, removals, and modifications inline — without touching the actual document content.","directories":{},"_nodeVersion":"22.20.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.3"},"peerDependencies":{"diff":">=5.0.0","@tiptap/pm":"^3.0.0","@tiptap/core":"^3.0.0"},"peerDependenciesMeta":{"diff":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/tiptap-visual-diff_0.1.4_1779765552960_0.6320395435457089","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@anandanair/tiptap-visual-diff","version":"0.1.5","keywords":["tiptap","tiptap-extension","diff","visual-diff","compare","prosemirror","rich-text-editor","track-changes"],"author":{"name":"Anand"},"license":"MIT","_id":"@anandanair/tiptap-visual-diff@0.1.5","maintainers":[{"name":"anandanair","email":"anandanairaan@gmail.com"}],"homepage":"https://github.com/anandanair/tiptap-visual-diff#readme","bugs":{"url":"https://github.com/anandanair/tiptap-visual-diff/issues"},"dist":{"shasum":"f512edaae6465814fe89a16d759243b7f72eda60","tarball":"https://registry.npmjs.org/@anandanair/tiptap-visual-diff/-/tiptap-visual-diff-0.1.5.tgz","fileCount":8,"integrity":"sha512-lToY3KKbKzguOm8CPbantcgt0ypv0MtcRGE0PP1oWWt3gg2w3u1XiZH1rJaLp6apjoRbkw98cFbhJ0r9MQu/VQ==","signatures":[{"sig":"MEYCIQCKQ+dMnIr4GY907Ku15raMIKCk2+TvpgQSpIc7yZB1VAIhAI4hYqOS5UZL/XxKxb3oGFubq9ZyrKmOORZXShiL8Q48","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":65391},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"e7eb229836085949cfdfaa53022b1feb26240391","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"anandanair","email":"anandanairaan@gmail.com"},"repository":{"url":"git+https://github.com/anandanair/tiptap-visual-diff.git","type":"git"},"_npmVersion":"11.13.0","description":"ProseMirror decoration-based visual diff extension for Tiptap v3. Compares editor content against a reference document and highlights additions, removals, and modifications inline — without touching the actual document content.","directories":{},"_nodeVersion":"22.20.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.3"},"peerDependencies":{"diff":">=5.0.0","@tiptap/pm":"^3.0.0","@tiptap/core":"^3.0.0"},"peerDependenciesMeta":{"diff":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/tiptap-visual-diff_0.1.5_1779765858776_0.06053680711021214","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@anandanair/tiptap-visual-diff","version":"0.1.6","keywords":["tiptap","tiptap-extension","diff","visual-diff","compare","prosemirror","rich-text-editor","track-changes"],"author":{"name":"Anand"},"license":"MIT","_id":"@anandanair/tiptap-visual-diff@0.1.6","maintainers":[{"name":"anandanair","email":"anandanairaan@gmail.com"}],"homepage":"https://github.com/anandanair/tiptap-visual-diff#readme","bugs":{"url":"https://github.com/anandanair/tiptap-visual-diff/issues"},"dist":{"shasum":"b7a5c7687471b4be8695806b835e3d6c328b52f0","tarball":"https://registry.npmjs.org/@anandanair/tiptap-visual-diff/-/tiptap-visual-diff-0.1.6.tgz","fileCount":8,"integrity":"sha512-eaH/yfbmsAkXjvXYgziJnWjBMwCyZ/oFZfDIgYUEOp/MFeOxC5DxvTon/yBkKF5g5caNTFaPzrbVk33QJ4P/mw==","signatures":[{"sig":"MEYCIQDMxttALVbsAci/r3FlTecdFWFUrKZ2ZERlZShhvy7Z8gIhAJaZPYQ9MAS7qV5+QNZYrRAsHbpjBJuskOG0WYlBI2pJ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":68444},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"2202e51d2aefae140b9445ba539eb47cfa6ac016","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"anandanair","email":"anandanairaan@gmail.com"},"repository":{"url":"git+https://github.com/anandanair/tiptap-visual-diff.git","type":"git"},"_npmVersion":"11.13.0","description":"ProseMirror decoration-based visual diff extension for Tiptap v3. Compares editor content against a reference document and highlights additions, removals, and modifications inline — without touching the actual document content.","directories":{},"_nodeVersion":"22.20.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^6.0.3"},"peerDependencies":{"diff":">=5.0.0","@tiptap/pm":"^3.0.0","@tiptap/core":"^3.0.0"},"peerDependenciesMeta":{"diff":{"optional":false}},"_npmOperationalInternal":{"tmp":"tmp/tiptap-visual-diff_0.1.6_1779780790207_0.769505346342811","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@anandanair/tiptap-visual-diff","version":"0.1.7","description":"ProseMirror decoration-based visual diff extension for Tiptap v3. Compares editor content against a reference document and highlights additions, removals, and modifications inline — without touching the actual document content.","license":"MIT","author":{"name":"Anand"},"keywords":["tiptap","tiptap-extension","diff","visual-diff","compare","prosemirror","rich-text-editor","track-changes"],"type":"module","main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc","prepublishOnly":"npm run build"},"peerDependencies":{"@tiptap/core":"^3.0.0","@tiptap/pm":"^3.0.0","diff":">=5.0.0"},"peerDependenciesMeta":{"diff":{"optional":false}},"repository":{"type":"git","url":"git+https://github.com/anandanair/tiptap-visual-diff.git"},"publishConfig":{"access":"public"},"devDependencies":{"typescript":"^6.0.3"},"gitHead":"1f060a071c2596bcf38405c931a7c9e96c212e31","_id":"@anandanair/tiptap-visual-diff@0.1.7","bugs":{"url":"https://github.com/anandanair/tiptap-visual-diff/issues"},"homepage":"https://github.com/anandanair/tiptap-visual-diff#readme","_nodeVersion":"22.20.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-c2iXraBYOLiohD+TqLuBTEXpA42DjFQ6doHXSqnaAcAssNI9Y6O+yTOosyCW6h5Ae6W0Mxab8FjK4r8MiQwFlg==","shasum":"b35245d0208d9e42a41f4a556863f67ddb9d14b2","tarball":"https://registry.npmjs.org/@anandanair/tiptap-visual-diff/-/tiptap-visual-diff-0.1.7.tgz","fileCount":9,"unpackedSize":73769,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD7pOYldEx1IquuIZ3Rx2CH2sm7FD1vyetY9hq5Rlm/nQIgbedZ7Ln+LQ6gKZ45TlYfyEhlokxpCek2vufL4DkVix0="}]},"_npmUser":{"name":"anandanair","email":"anandanairaan@gmail.com"},"directories":{},"maintainers":[{"name":"anandanair","email":"anandanairaan@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tiptap-visual-diff_0.1.7_1779894166002_0.13553468765250343"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-25T16:40:17.665Z","modified":"2026-05-27T15:02:46.275Z","0.1.0":"2026-05-25T16:40:17.896Z","0.1.1":"2026-05-25T16:42:39.363Z","0.1.2":"2026-05-25T16:48:04.453Z","0.1.3":"2026-05-26T02:39:36.384Z","0.1.4":"2026-05-26T03:19:13.106Z","0.1.5":"2026-05-26T03:24:18.943Z","0.1.6":"2026-05-26T07:33:10.345Z","0.1.7":"2026-05-27T15:02:46.171Z"},"bugs":{"url":"https://github.com/anandanair/tiptap-visual-diff/issues"},"author":{"name":"Anand"},"license":"MIT","homepage":"https://github.com/anandanair/tiptap-visual-diff#readme","keywords":["tiptap","tiptap-extension","diff","visual-diff","compare","prosemirror","rich-text-editor","track-changes"],"repository":{"type":"git","url":"git+https://github.com/anandanair/tiptap-visual-diff.git"},"description":"ProseMirror decoration-based visual diff extension for Tiptap v3. Compares editor content against a reference document and highlights additions, removals, and modifications inline — without touching the actual document content.","maintainers":[{"name":"anandanair","email":"anandanairaan@gmail.com"}],"readme":"# @anandanair/tiptap-visual-diff\n\nA Tiptap v3 extension that provides real-time **visual diffs** by comparing the editor's current content against a reference document. Highlights additions, removals, and modifications using **ProseMirror decorations** — the actual document content stays clean.\n\n> Built for review workflows where you want to show what changed without polluting the editable content with diff markup.\n\n## Features\n\n- **Inline visual diffs** — green for additions, red strikethrough for removals, amber for modifications\n- **Purely decorative** — diff classes are applied via ProseMirror decorations, never written into the document\n- **Handles all node types** — paragraphs, headings, code blocks, lists (bullet/ordered/task), tables, images, blockquotes, horizontal rules, mentions\n- **Code-aware** — code blocks use line-level diffing; removed code lines render as individual widgets\n- **Mark-aware** — detects formatting-only changes (bold added, link removed, etc.) and highlights them as modifications\n- **Attribute-aware** — catches heading level changes and image src changes\n- **Look-ahead alignment** — handles insertions and deletions of up to 20 consecutive nodes without misalignment\n- **Performance** — decorations are cached and only rebuilt when the document or comparison target changes\n\n## Installation\n\n```bash\nnpm install @anandanair/tiptap-visual-diff\n```\n\nThis package requires the following peer dependencies (install them if you haven't already):\n\n```bash\nnpm install @tiptap/core @tiptap/pm diff\n```\n\n## Quick Start\n\n```ts\nimport { Editor } from \"@tiptap/core\";\nimport StarterKit from \"@tiptap/starter-kit\";\nimport { ComparePlugin } from \"@anandanair/tiptap-visual-diff\";\n\n// Parse your original/reference content to Tiptap JSON\nconst originalJSON = {\n  type: \"doc\",\n  content: [\n    /* ... */\n  ],\n};\n\nconst editor = new Editor({\n  extensions: [\n    StarterKit,\n    ComparePlugin.configure({\n      comparisonContent: originalJSON,\n    }),\n  ],\n  content: \"<p>The new version of the document...</p>\",\n});\n\n// Later: update the comparison target dynamically\neditor.commands.setComparisonContent(newOriginalJSON);\n```\n\n## Usage with React\n\n```tsx\nimport { useEditor, EditorContent } from \"@tiptap/react\";\nimport StarterKit from \"@tiptap/starter-kit\";\nimport { ComparePlugin } from \"@anandanair/tiptap-visual-diff\";\n\nfunction DiffEditor({ originalJSON, proposedMarkdown, onSave }) {\n  const editor = useEditor({\n    extensions: [\n      StarterKit,\n      ComparePlugin.configure({ comparisonContent: originalJSON }),\n    ],\n    content: proposedMarkdown,\n    contentType: \"markdown\",\n  });\n\n  return <EditorContent editor={editor} />;\n}\n```\n\n### Parsing original markdown to JSON\n\nIf your original content is markdown, parse it to Tiptap JSON using a headless editor:\n\n```ts\nimport { Editor } from \"@tiptap/core\";\nimport StarterKit from \"@tiptap/starter-kit\";\nimport { Markdown } from \"@tiptap/markdown\";\n\nfunction parseMarkdownToJSON(markdown: string) {\n  const temp = new Editor({\n    extensions: [StarterKit, Markdown],\n    content: markdown,\n    contentType: \"markdown\",\n  });\n  const json = temp.getJSON();\n  temp.destroy();\n  return json;\n}\n```\n\n## API\n\n### `ComparePlugin.configure(options)`\n\n| Option              | Type                          | Default | Description                                 |\n| ------------------- | ----------------------------- | ------- | ------------------------------------------- |\n| `comparisonContent` | `Record<string, any> \\| null` | `null`  | The Tiptap JSON document to compare against |\n\n### Commands\n\n| Command                | Parameters                             | Description                                                |\n| ---------------------- | -------------------------------------- | ---------------------------------------------------------- |\n| `setComparisonContent` | `content: Record<string, any> \\| null` | Update the comparison target without recreating the editor |\n\n## CSS Classes\n\nThe extension applies these classes via ProseMirror decorations. **Add styles to your CSS to make diffs visible:**\n\n| Class                         | Applied to                     | Meaning                             |\n| ----------------------------- | ------------------------------ | ----------------------------------- |\n| `.diff-added`                 | Inline text, block nodes       | Content added (green background)    |\n| `.diff-removed`               | Widget (span/div)              | Content removed (red strikethrough) |\n| `.diff-modified`              | Inline text, block nodes       | Content modified (amber background) |\n| `.diff-code-added`            | Inline text inside code blocks | Code line added                     |\n| `.diff-removed-block`         | Widget (div)                   | Entire block node removed           |\n| `.diff-removed-cell`          | Widget (td)                    | Table cell removed                  |\n| `.diff-removed-code-block`    | Widget (pre > code)            | Entire code block removed           |\n| `.diff-removed-code-line`     | Widget (div)                   | Individual code line removed        |\n| `.diff-removed-image-wrapper` | Widget (div)                   | Image removed (container)           |\n| `.diff-removed-image-overlay` | Widget (div)                   | Image removed (overlay text)        |\n| `.diff-added code`            | Inline `<code>` elements       | Inline code within added blocks     |\n\n### Example Styles\n\n```css\n.diff-added {\n  background-color: rgba(16, 185, 129, 0.12);\n  color: #065f46;\n  border-radius: 3px;\n  padding: 1px 4px;\n}\n\n.diff-removed {\n  background-color: rgba(239, 68, 68, 0.18);\n  color: #991b1b;\n  text-decoration: line-through;\n  border-radius: 3px;\n  padding: 1px 4px;\n}\n\n.diff-modified {\n  background-color: rgba(234, 179, 8, 0.15);\n  color: #92400e;\n  border-radius: 3px;\n  padding: 1px 4px;\n}\n\n.diff-removed-block {\n  background-color: rgba(239, 68, 68, 0.18);\n  color: #991b1b;\n  text-decoration: line-through;\n  border-left: 3px solid #ef4444;\n  padding: 2px 8px;\n  border-radius: 4px;\n  margin: 2px 0;\n}\n\n.diff-code-added {\n  background-color: rgba(16, 185, 129, 0.18);\n}\n\n.diff-removed-code-line {\n  background-color: rgba(239, 68, 68, 0.18);\n  color: #991b1b;\n  text-decoration: line-through;\n  font-family: monospace;\n  font-size: 0.875rem;\n  padding: 0 4px;\n}\n\n/* Inline <code> within entirely-added blocks.\n   When a block node (p, h1-h6, li) has .diff-added,\n   child <code> elements need explicit styling because\n   browser defaults block color inheritance. */\n.diff-added code {\n  background-color: rgba(16, 185, 129, 0.22);\n  color: #065f46;\n  border-radius: 2px;\n  padding: 1px 3px;\n}\n\n.dark .diff-added code {\n  background-color: rgba(16, 185, 129, 0.18);\n  color: #34d399;\n}\n```\n\n## How It Works\n\n1. The extension stores the `comparisonContent` as a ProseMirror plugin state\n2. When the document changes, it converts the comparison JSON into ProseMirror nodes\n3. It aligns the two node trees using a greedy look-ahead matcher (window of 20)\n4. For matched nodes, it compares text content character-by-character (or line-by-line for code blocks)\n5. Differences are rendered as ProseMirror decorations — inline spans for text changes, widgets for removed content, node decorations for added/modified blocks\n\nThe editor's document content is **never modified** — diffs are purely visual.\n\n## Limitations (v0.1)\n\n- **Insertion/deletion cap**: The look-ahead alignment covers up to 20 consecutive nodes. Inserting or deleting more than 20 consecutive block nodes at once may cause downstream misalignment. In practice, even large content insertions rarely exceed this.\n- **No accept/reject API**: This is a visual diff tool, not a track-changes system. To accept or reject changes, edit the document directly and save.\n- **ESM only**: No CommonJS build in v0.1. Modern bundlers (Next.js, Vite, webpack 5) handle ESM natively.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}