# @atlaskit/editor-plugin-better-type-history

> Better Type History plugin for @atlaskit/editor-core

Latest version **33.0.0** (published 2026-11-17) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @atlaskit/editor-plugin-better-type-history
pnpm add @atlaskit/editor-plugin-better-type-history
yarn add @atlaskit/editor-plugin-better-type-history
bun add @atlaskit/editor-plugin-better-type-history
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 33.0.0 |
| Published | 2026-11-17 |
| First published | 2023-10-18 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 42.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Atlassian Pty Ltd |
| Maintainers | atlassianartifactteam |

## Links

- npm: https://www.npmjs.com/package/@atlaskit/editor-plugin-better-type-history
- Repository: https://bitbucket.org/atlassian/atlassian-frontend-mirror
- Homepage: https://bitbucket.org/atlassian/atlassian-frontend-mirror#readme
- Issues: https://bitbucket.org/atlassian/atlassian-frontend-mirror/issues
- npm.io page: https://npm.io/package/@atlaskit/editor-plugin-better-type-history

## Dependencies (3)

- [@babel/runtime](https://npm.io/package/@babel/runtime.md) ^7.0.0
- [@atlaskit/editor-prosemirror](https://npm.io/package/@atlaskit/editor-prosemirror.md) ^9.0.0
- [@atlaskit/prosemirror-history](https://npm.io/package/@atlaskit/prosemirror-history.md) ^1.3.0

## Recent versions

- 33.0.0 (latest) — 2026-11-17
- 32.0.0 — 2026-11-17
- 31.0.0 — 2026-11-16
- 30.0.0 — 2026-10-27
- 29.0.0 — 2026-10-20
- 28.0.0 — 2026-10-16
- 27.0.0 — 2026-10-13
- 26.0.0 — 2026-10-08
- 25.0.0 — 2026-10-07
- 24.0.0 — 2026-10-02
- 23.0.0 — 2026-10-01
- 22.0.0 — 2026-09-25
- 21.0.0 — 2026-09-24
- 20.0.0 — 2026-09-23
- 19.0.0 — 2026-09-17
- … 104 more at https://npm.io/package/@atlaskit/editor-plugin-better-type-history/versions

## README

# Editor Plugin Better Type History

Better Type History plugin for @atlaskit/editor-core

## Overview

The Better Type History plugin improves undo behavior for custom editor applications by intelligently handling text operations. It optimizes the undo history for paste events, block splitting, and new line insertion, ensuring a better user experience when undoing changes in these specific scenarios.

## Key features

- **Paste event handling** - Automatically flags and closes history for paste operations to improve undo behavior
- **Block splitting detection** - Detects when Enter key splits block nodes and optimizes history accordingly
- **Newline handling** - Intelligently manages history for newline character insertions
- **Transaction metadata** - Uses ProseMirror transaction metadata to track and manage paste events
- **Undo optimization** - Closes history at appropriate points to create better undo snapshots

## Install

- **Install** - `yarn add @atlaskit/editor-plugin-better-type-history`
- **npm** - [@atlaskit/editor-plugin-better-type-history](https://www.npmjs.com/package/@atlaskit/editor-plugin-better-type-history)
- **Source** - [Bitbucket](https://bitbucket.org/atlassian/atlassian-frontend/src/master/packages/editor/editor-plugin-better-type-history)
- **Bundle** - [unpkg.com](https://unpkg.com/@atlaskit/editor-plugin-better-type-history/dist/)

## Usage

The Better Type History plugin is intended for internal use by @atlaskit/editor-core and as a plugin dependency of the Editor within your product.

```typescript
import { betterTypeHistoryPlugin } from '@atlaskit/editor-plugin-better-type-history';
```

Use the `flagPasteEvent` action to mark paste events in transactions:

```typescript
const api = editorAPI.betterTypeHistory;
api.flagPasteEvent(transaction);
```

Detailed docs and example usage can be found [here](https://atlaskit.atlassian.com/packages/editor/editor-plugin-better-type-history).

## Support

For internal Atlassian, visit the slack channel [#help-editor](https://atlassian.slack.com/archives/CFG3PSQ9E) for support or visit [go/editor-help](https://go/editor-help) to submit a bug.

## License

Please see [Atlassian Frontend - License](https://hello.atlassian.net/wiki/spaces/AF/pages/2589099144/Documentation#License) for more licensing information.

---
_Source: https://npm.io/package/@atlaskit/editor-plugin-better-type-history · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
