antfu/diff-match-patch-es

ESM and TypeScript rewrite of Google's diff-match-patch for JavaScript

diff-match-patch-es

ESM and TypeScript rewrite of Google's diff-match-patch (for JavaScript).

Features

• Rewritten in ESM and TypeScript, ships with type declarations
• Published as dual ESM/CJS formats
• Refactor all to pure functions, fully tree-shakable

Migration

Migration from diff-match-patch npm package

• Default export and the class constructor has been removed
• Function name has been unified to camelCase
• Previous options like Diff_Timeout and Diff_EditCost are now passed as an options object in the arguments if needed

// before
import DiffMatchPatch from 'diff-match-patch'

const dmp = new DiffMatchPatch()
dmp.Diff_Timeout = 1
const result = dmp.diff_main('hello', 'world')

// after
import { diff } from 'diff-match-patch-es'

const result = diff('hello', 'world', { diffTimeout: 1 })

Why?

Well, the code source repo from Google hasn't been updated for 5 years, and the npm package diff-match-patch hasn't been published for 4 years. And the code is not ESM nor tree-shakable. While this library is a composition of diff patch and match functions, sometimes you don't need all of them but since all functions were bound to a single class, all the code has to be included in the bundle. It's probably not a big deal as this whole library is still relatively small, but it's a bit annoying to me when you know something wasn't optimal. So I took an afternoon porting and rewriting the library to ESM and TypeScript. Helpfully it will lead to better maintainability and help the community to move forward with the modern JavaScript ecosystem.

Sponsors

License

Apache-2.0 License