facebook/lexical
 Watch   
 Star   
 Fork   
简介统计版本
17 days ago
lexical
facebook

v0.32.1

This is an ad-hoc patch release to include #7602 - which fixes an issue that could corrupt a document if a TabNode was at the anchor or focus of a selection when text is inserted under certain circumstances.

Highlights

Core

  • ✅ #7602 Treat all TabNode as if they are in token mode
  • ✅ #7579 Firefox now handles Select All (Ctrl+A) the same way as other browsers

What's Changed

New Contributors

Full Changelog: https://github.com/facebook/lexical/compare/v0.32.0...v0.32.1

19 days ago
lexical
facebook

v0.32.0

Highlights

Core

  • ✅ #7544 2 Tabs on single line selection should indent
  • 🆕 #7573 Feature: Improve Tab/Indent/Outdent to match VSCode
  • ✅ #7568 unbulleting an image doesn't work #5698 ([lexical-selection][lexical-playground])
  • 🆕 #7593 Type: Add flow export type for LexicalUpdateTags

Playground

  • ✅ #7556 Change list, strikethrough and quoteblock shortcuts to match Google Docs for Windows compatibility
  • ✅ #7545 Support Apple Pencil
  • 🆕 #7567 Chore: source command priority from package
  • ✅ #7572 Preserve row striping in frozen table columns
  • ✅ #7568 unbulleting an image doesn't work #5698
  • ✅ #7558 Made checklist icon fully scalable, clickable, and properly spaced at large font sizes
  • 🆕 #7590 Refactor: simplify ExcalidrawModal
  • 🆕 #7509 FloatingUI Context Menu
  • 🆕 #7596 Chore: source command priority from package

Markdown

  • ✅ #7560 Link Transformer URL Protocol Han…
  • ✅ #7564 Prevent transform from removing nodes if the replace function returns false
  • ✅ #7594 Don't select nodes when importing

React

  • ✅ #7589 page freezes when typing a link in an overflow area
  • 🆕 #7584 Feature: allow whitespaces in search keyword in useBasicTypeaheadTriggerMatch

Website

  • ✅ #7569 fix documentation typos
  • ✅ #7574 Fix docusaurus build by adding removeLegacyPostBuildHeadAttribute flag

What's Changed

New Contributors

Full Changelog: https://github.com/facebook/lexical/compare/v0.31.2...v0.32.0

2025-05-21 01:46:28
lexical
facebook

v0.31.2

Patch release for #7549, this is a bug fix release

Highlights

Core:

  • ✅ #7549 Fix infinite loop in indexPath
  • ✅ #7536 Do not export empty textAlign styles

Code:

  • ✅ #7538 Allow code highlighter to be used in headless mode

Markdown:

  • ✅ #7539 Do not export auto-link nodes

Playground:

  • ✅ #7534 Use babel MatchPatterns that work correctly on Windows

What's Changed

New Contributors

Full Changelog: https://github.com/facebook/lexical/compare/v0.31.1...v0.31.2

2025-05-12 01:01:22
lexical
facebook

v0.31.1

This is a patch release primarily to address a dev tools build regression (#7522)

Highlights

Rich Text

  • ✅ #7516 Backspace now only dedents at the start of first descendant of an indented block

List

  • ✅ #7504 Marker styles are now inherited on indent

Markdown

  • ✅ #7499 Link transformer now explicitly adds a protocol to URLs

React

  • 🆕 #7520 useBasicTypeaheadTriggerMatch punctuation regex fragment is now configurable

Table

  • ✅ #7498 TableNode DOM import now supports frozen rows and columns

Playground

  • ✅ #7506 LexicalTypeaheadMenuPlugin is now positioned correctly when scrolled
  • ✅ #7508 Change text capitalization keyboard shortcuts on macOS to avoid conflicts
  • ✅ #7520 Emoji typeahead search now permits underscore and dashes

Dev Tools

  • ✅ #7522 Vite configuration fix for devtools build

Docs

  • 🆕 #7294 New NodeState documentation and example

What's Changed

New Contributors

Full Changelog: https://github.com/facebook/lexical/compare/v0.31.0...v0.31.1

2025-04-30 13:08:09
lexical
facebook

v0.31.0

Highlights

Core

  • ✅ #7439 Correct caret movement in vertical-rl writing mode
  • ✅ #7450 Migrate string literals to update tag constants
  • ✅ #7471 Chore: Update sveltejs dependency
  • ✅ #7479 Revert Enter command to use inexact matching
  • ✅ #7481 Update KEY_ENTER_COMMAND API docs Website
  • 🆕 #7442 Improve createCommand developer experience
  • 🆕 #7441 Document and export common update tags
  • 🆕 #7448 Documentation Update: Add detailed guides for key and clone concepts

Playground

  • 🆕 #7464 Add keyboard shortcut for comments
  • ✅ #7462 Stabilize text format dropdown width in toolbar
  • ✅ #7478 Disable flaky "Can expand table to fit content when pasting table into table" in collab
  • 🆕 #7482 Refactor autolink tests for reliability

React

  • 🆕 #7477 Make check for entity boundary configurable in LexicalTypeaheadMenuPlugin
  • ✅ #7488 Re-render tables when the hasHorizontalScroll setting is changed
  • ✅ #7486 Support custom cursor sync in CollaborationPlugin

Collab

  • 🆕 #7453 Simplify removeFromParent internal operations

Table

  • ✅ #7447 Handle backspace deletion of tables with merged cells

Markdown

  • ✅ #7476 Add import support for backslash escape sequences

What's Changed

New Contributors

Full Changelog: https://github.com/facebook/lexical/compare/v0.30.0...v0.31.0

2025-04-08 00:01:35
lexical
facebook

v0.30.0

Breaking Changes

Listeners are now always called with the editor they were registered to

#7378 changed the internal updateEditorSync implementation to always use the correct active editor when triggering a listener. This only affects how nested editors delegate their events to listeners attached to a parent editor. If you have listeners attached to the parent editor that expect to be called with the context of the nested editor then you'll have to either also attach the listener to the nested editor, or change the behavior to check the editor argument of the command listener to see which editor the command was originally dispatched to.

Import of markdown blocks preserves separation with shouldPreserveNewLines

#7386 changed the behavior of the markdown import's paragraph merging logic to align with GitHub's markdown editor behavior for list and common markdown formatting expectations when shouldPreserveNewlines is true.

Markdown encoding uses HTML entities to represent leading and trailing whitespace

#7400 changed the markdown encoder to replace leading or trailing whitespace of formatted strings with the corresponding HTML entities

Highlights

Core

  • ✅ #7378 Ensure updateEditorSync is always synchronous and use it when triggering listeners
  • ✅ #7393 Fix right and up arrow key navigation with decorator nodes
  • ✅ #7401 Clone the selection and use $setSelection instead of assigning dirty to true directly
  • ✅ #7397 Change $getTextNodeOffset invariant to warn in prod (error in __DEV__)
  • ✅ #7412 Fix forward line deletion when using control+K
  • 🆕 #7438 Add text-transform styles to exported HTML

Rich Text

  • ✅ #7411 Prevent indentation from becoming negative

Collab

  • ✅ #7330 Don't sync ElementNode __dir property
  • ✅ #7398 Fix scroll position getting changed when someone else makes a change in collab

Markdown

  • ✅ #7386 Preserve paragraph separation after block elements
  • ✅ #7395 Prevent Markdown shortcuts from applying to code-formatted text
  • ✅ #7400 Replace whitespace with code point when the string has leading and trailing whitespaces

List

  • ✅ #7380 Empty list item type change
  • ✅ #7420 Enforce strict list indentation
  • 🆕 #7429 Export registerCheckList

Link

  • ✅ #7366 Add support for image links via NodeSelection

Devtools

  • ✅ #7403 Update debug view to show KEY_ESCAPE_COMMAND immediately

React

  • 🆕 #7404 Add option to disable first item auto-selection in menus

Table

  • 🆕 #7408 Improve logic for pasting table into table
  • 🆕 #7415 Rename and deprecate some table utils

Playground

  • 🆕 #7384 Clear block ElementNode formatting along with TextNode
  • 🆕 #7417 Clear formatting should also clear any indent/outdent if applied
  • ✅ #7368 Remove shared imports from playground for easier re-use
  • ✅ #7388 Use natural dimensions for inherited image size
  • ✅ #7405 Fix floating toolbar position for end-aligned text
  • ✅ #7431 Fix immediate broken image display on load failure

What's Changed

New Contributors

Full Changelog: https://github.com/facebook/lexical/compare/v0.29.0...v0.30.0

2025-03-25 14:15:40
lexical
facebook

v0.29.0

Breaking Changes

https://github.com/facebook/lexical/pull/7351 : Only select RootNode on removal of last child if there was an existing selection https://github.com/facebook/lexical/pull/7353: Support escaping markdown characters https://github.com/facebook/lexical/pull/7357: Refactor: LexicalNestedComposer add skipEditableListener prop and deprecate initialNodes prop and implicit namespace setting https://github.com/facebook/lexical/pull/7372: Set tableFrozenColumn and tableFrozenRow classes only on the scrollable table wrapper

Highlights

React: 🆕 https://github.com/facebook/lexical/pull/7357: LexicalNestedComposer add skipEditableListener prop and deprecate initialNodes prop and implicit namespace setting

Table: ✅https://github.com/facebook/lexical/pull/7372: Set tableFrozenColumn and tableFrozenRow classes only on the scrollable table wrapper ✅https://github.com/facebook/lexical/pull/7316: Add fallback selection to InsertTableCommand

Core editor: ✅https://github.com/facebook/lexical/pull/7351: Only select RootNode on removal of last child if there was an existing selection ✅https://github.com/facebook/lexical/pull/7354: Ignore input event from inside decorators

Markdown: 🆕 https://github.com/facebook/lexical/pull/7353: Feature: Support escaping markdown characters

Playground: 🆕 https://github.com/facebook/lexical/pull/7352 : Chore: Improve accessibility of DraggableBlockPlugin add block button ✅https://github.com/facebook/lexical/pull/7334: Table action menu visibility with cell overflow ✅https://github.com/facebook/lexical/pull/7362: Fix equation rendering in Safari 🆕 https://github.com/facebook/lexical/pull/7371: Chore: Update excalidraw to v0.18.0 Doc: ✅https://github.com/facebook/lexical/pull/7365: Update react.md, fix typo

What's Changed

New Contributors

Full Changelog: https://github.com/facebook/lexical/compare/v0.28.0...v0.29.0

2025-03-19 02:15:42
lexical
facebook

v0.28.0

Ad-hoc minor release with important bug fixes and some enabling features. The most important fix is in #7341 - where under certain conditions nodes may not be updated in the DOM at all (this bug is rarely triggered and has been around for 3+ years).

Breaking Changes

NodeSelection default delete handler #7323

If you have any $onDelete handlers copied from the playground for KEY_DELETE_COMMAND and KEY_BACKSPACE_COMMAND, you can delete them all now. If you leave them in, it will have similar bugs as prior to this PR.

The default KEY_DELETE_COMMAND and KEY_BACKSPACE_COMMAND handlers now event.preventDefault() and call DELETE_CHARACTER_COMMAND for NodeSelection (in addition to the existing RangeSelection behavior).

The DELETE_CHARACTER_COMMAND handler now handles NodeSelection by calling the new NodeSelection.deleteNodes() method which places a new RangeSelection where the first selected node was (if any, and if it was the current selection) and then removes all of the selected nodes.

RootNode and ListItemNode splice #7341

This PR moves the incorrectly overridden append methods for RootNode and ListNode and moves it to the ElementNode's primitive splice method. For RootNode this means that the exception you'd get for appending a leaf node to the root will be thrown in all situations when that node is inserted, rather than just append. For ListNode this means that the automatic ListItemNode wrapping applies in all situations when children are inserted into the node, not just append.

$insertNodeToNearestRoot changes #7342

Previously $insertNodeToNearestRoot could create empty ElementNode when splitting the current node, now it respects canBeEmpty() and will not split in those cases (e.g. ListNode).

ListItemNode CSS #7325

The approach used in #7024 (since v0.26.0) to have a ListItemNode bullet inherit the style of the first text node was too broad, the inline style on the ListItemNode cascades to all of its children. The only way around this is to change the approach.

To retain this feature, you need to add CSS to your theme to specifically style the marker pseudo-element based on these new custom properties. Here's an example from the playground css:

.PlaygroundEditorTheme__listItem::marker {
  color: var(--listitem-marker-color);
  background-color: var(--listitem-marker-background-color);
  font-family: var(--listitem-marker-font-family);
  font-size: var(--listitem-marker-font-size);
}

TableCellNode importDOM #7318

The importDOM implementation for TableCellNode has been corrected to behave as other Lexical roots do with regard to converting <br> tags to LineBreakNode and wrapping runs of top-level inline nodes (including inline decorators) with ParagraphNode. If you have any specific workarounds accounting for the previous behavior, you can remove them. The one difference from other import paths is that a solitary <br> (e.g. <td><br></td>) is converted to an empty ParagraphNode rather than a ParagraphNode containing a LineBreakNode.

getDOMSlot #7336

If you're using the undocumented internal getDOMSlot API, you may need to change your types. There is now a type parameter for ElementDOMSlot so that the element property can be specialized.

Highlights

Core:

  • 🆕 #7321 Add mutatedNodes to UpdateListener payload
  • 🆕 #7323 Add a default delete handler for NodeSelection - this allowed a lot of boilerplate code to be deleted, and all of the existing implementations were subtly broken
  • ✅ #7341 Fix bug in transformer loop that would cause nodes not to get reconciled
  • ✅ #7342 Handle canBeEmpty() in $splitNodes
  • 🆕 #7344 Apply RootNode transforms last

List:

  • ✅ #7325 Move ListItemNode text style inheritance to CSS custom properties

Tables:

  • ✅ #7336 Fix updateDOM for scrollable TableNode
  • ✅ #7318 Fix table cell line breaks

React:

  • ✅ #7315 Remove unused direct dependencies
  • 🆕 #7338 Add onElementChanged callback to DraggableBlockPlugin

Playground:

  • ✅ #7337 Table actions should clear selection instead of moving it to the beginning
  • 🆕 #7338 Add "+" button to DraggableBlockPlugin

Utils:

  • 🆕 #7340 Add a type predicate to objectKlassEquals

New APIs

UpdateListenerPayload mutatedNodes #7321

A mutatedNodes property is now present in the UpdateListener payload. This was done to accommodate the use case when you want to have a MutationListener that listens to all nodes (this is useful in combination with NodeState). Note that this property is only calculated when at least one MutationListener is registered (e.g. editor.registerMutationListener(RootNode, () => {}) is sufficient to compute mutatedNodes for all nodes).

NodeSelection deleteNodes #7323

NodeSelection.deleteNodes() was added to support the default delete handler

RootNode node transform #7344

There is now an ordering guarantee that RootNode node transforms are called last, and documentation about the special case that RootNode is always considered intentionally dirty when any other node is dirty

@lexical/react/LexicalDraggableBlockPlugin onElementChanged #7338

An onElementChanged prop was added to make it possible to implement the "+" button in the playground

What's Changed

New Contributors

Full Changelog: https://github.com/facebook/lexical/compare/v0.27.2...v0.28.0

2025-03-12 06:14:37
lexical
facebook

v0.27.2

v0.27.2 is an ad-hoc patch release to address the prismjs CVE (#7313). The way Lexical uses prismjs should not trigger that issue even in previous versions as it doesn't insert user generated HTML with "id" tags or use the autoloader plug-in, but it's good practice to keep up with security updates either way.

Highlights

Code:

  • ✅ #7313 Update prismjs dependency to 1.30.0

Collab:

  • ✅ #7295 Prevent collab element nodes from removing other nodes from node map

Table:

  • 🆕 #7297 Add table cell selection handler for touch devices
  • ✅ #7309 Fix unintended touch table cell selection when scrolling

Playground:

  • 🆕 #7299 Add touch support for TableCellResizer
  • ✅ #7305 Fix row height resizing for merged cells

What's Changed

Full Changelog: https://github.com/facebook/lexical/compare/v0.27.1...v0.27.2

2025-03-05 04:23:35
lexical
facebook

v0.27.1

v0.27.1 is an ad-hoc patch release to address the regression introduced in v0.26.0 with LexicalNode.getCommonAncestor which occurs when calling node.getCommonAncestor(node) when !$isElementNode(node) (#7287).

Highlights

Core:

  • ✅ #7271 Fix non-ElementNode regression in getCommonAncestor

Core + List:

  • ✅ #7282 Add RTL direction support in output HTML for ElementNode and ListItemNode (previously this was only on ParagraphNode)

Table:

  • ✅ #7283 Fix click and drag table selection in Firefox

What's Changed

Full Changelog: https://github.com/facebook/lexical/compare/v0.27.0...v0.27.1