https://github.com/antfu/diff-match-patch-es
ESM and TypeScript rewrite of Google's diff-match-patch for JavaScript
https://github.com/antfu/diff-match-patch-es
dff-match-patch diff esm javascript typescript
Last synced: about 1 month ago
JSON representation
ESM and TypeScript rewrite of Google's diff-match-patch for JavaScript
- Host: GitHub
- URL: https://github.com/antfu/diff-match-patch-es
- Owner: antfu
- License: apache-2.0
- Created: 2024-02-23T16:21:05.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-09T09:17:13.000Z (4 months ago)
- Last Synced: 2025-04-01T05:35:27.724Z (about 1 month ago)
- Topics: dff-match-patch, diff, esm, javascript, typescript
- Language: TypeScript
- Homepage:
- Size: 303 KB
- Stars: 168
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome - antfu/diff-match-patch-es - ESM and TypeScript rewrite of Google's diff-match-patch for JavaScript (TypeScript)
- awesome - antfu/diff-match-patch-es - ESM and TypeScript rewrite of Google's diff-match-patch for JavaScript (TypeScript)
README
# diff-match-patch-es
[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![bundle][bundle-src]][bundle-href]
[![JSDocs][jsdocs-src]][jsdocs-href]
[![License][license-src]][license-href]
ESM and TypeScript rewrite of Google's [diff-match-patch](https://github.com/google/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](https://github.com/JackuB/diff-match-patch)
- 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
```js
// before
import DiffMatchPatch from 'diff-match-patch'
const dmp = new DiffMatchPatch()
dmp.Diff_Timeout = 1
const result = dmp.diff_main('hello', 'world')
```
```js
// 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](https://github.com/google/diff-match-patch), and the npm package `diff-match-patch` [hasn't been published for 4 years](https://github.com/JackuB/diff-match-patch). 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) License
[npm-version-src]: https://img.shields.io/npm/v/diff-match-patch-es?style=flat&colorA=080f12&colorB=1fa669
[npm-version-href]: https://npmjs.com/package/diff-match-patch-es
[npm-downloads-src]: https://img.shields.io/npm/dm/diff-match-patch-es?style=flat&colorA=080f12&colorB=1fa669
[npm-downloads-href]: https://npmjs.com/package/diff-match-patch-es
[bundle-src]: https://img.shields.io/bundlephobia/minzip/diff-match-patch-es?style=flat&colorA=080f12&colorB=1fa669&label=minzip
[bundle-href]: https://bundlephobia.com/result?p=diff-match-patch-es
[license-src]: https://img.shields.io/github/license/antfu/diff-match-patch-es.svg?style=flat&colorA=080f12&colorB=1fa669
[license-href]: https://github.com/antfu/diff-match-patch-es/blob/main/LICENSE
[jsdocs-src]: https://img.shields.io/badge/jsdocs-reference-080f12?style=flat&colorA=080f12&colorB=1fa669
[jsdocs-href]: https://www.jsdocs.io/package/diff-match-patch-es