Changelog

Version history and release notes of the core packages.

@codemirror/view 6.36.1 (2024-12-19)

Bug fixes

Fix a crash in MatchDecorator when updating matches at the end of the document.

@codemirror/view 6.36.0 (2024-12-17)

Bug fixes

Make selection rectangles verticaly align precisely, rather than introducing a slight overlap.

Fix an issue in MatchDecorator that caused it to fully rebuild its decorations on normal edits.

New features

View updates now have a viewportMoved flag that is only true when a viewport change originated from something other than mapping the viewport over a document change.

@codemirror/language 6.10.7 (2024-12-17)

Bug fixes

Fix an issue where indentation for a stream language would fail to work when the parse covered only part of the document, far from the start.

Make sure the inner mode gets a chance to indent when indenting right at the end of a nested language section.

@codemirror/autocomplete 6.18.4 (2024-12-17)

New features

Tooltips can now use the clip option to control whether they are hidden when outside the visible editor content.

@codemirror/lint 6.8.3 (2024-11-21)

Bug fixes

Fix an issue that prevented tooltips in the lint gutter from being displayed.

@codemirror/view 6.34.3 (2024-11-15)

Bug fixes

Make sure positions covered by a gutter or a panel aren't treated as visible for the purpose of displaying tooltips.

Properly include the tooltip arrow height when checking whether a tooltip fits in its preferred above/below position.

Fix an issue with compositions on Chrome inserting their content in the wrong position when another document change came in during composition.

@codemirror/autocomplete 6.18.3 (2024-11-13)

Bug fixes

Backspacing to the start of the completed range will no longer close the completion tooltip when it was triggered implicitly by typing the character before that range.

@codemirror/view 6.34.2 (2024-11-05)

Bug fixes

Fix the default cursor color for dark themes, which was way too dark.

@codemirror/search 6.5.7 (2024-11-01)

Bug fixes

Fix an issue where findNext and findPrevious would do nothing when the only match in the document was partially selected.

Fix an infinite loop in SearchCursor when the normalizer function deletes characters.

@codemirror/autocomplete 6.18.2 (2024-10-30)

Bug fixes

Don't immediately show synchronously updated completions when there are some sources that still need to return.

@codemirror/commands 6.7.1 (2024-10-21)

Bug fixes

Change toggleBlockCommentByLine to not affect lines with the selection end right at their start.

@codemirror/commands 6.7.0 (2024-10-07)

Bug fixes

Bind Shift-Enter to the same command as Enter in the default keymap, so that it doesn't do nothing when on an EditContext-supporting browser.

New features

Add commands for by-string-index cursor motion that ignores text direction.

@codemirror/view 6.34.1 (2024-09-27)

Bug fixes

Avoid a stack overflow that could happen when updating a line with a lot of text tokens.

Improve the way enormously long (non-wrapped) lines are displayed by making sure they stay shorter than the maximal pixel size the browser's CSS engine can handle.

@codemirror/view 6.34.0 (2024-09-25)

Bug fixes

Fix an issue where the dots past the wrapping point were displayed incorrectly when using highlightWhitespace with a wrapped sequence of spaces.

Improve performance of documents displaying lots of highlighted spaces by using a CSS background instead of pseudo-element.

New features

@codemirror/view 6.33.1 (2024-08-30)

Avoid an issue where Chrome would incorrectly scroll the window when deleting lines in the editor.

Bug fixes

Fix a crash on old Safari browsers that don't support MediaQueryList.addEventListener.

Fix an issue where EditorView.viewportLineBlocks (and thus other things like the gutter) might be out of date after some kinds of decoration changes.

@codemirror/view 6.29.0 (2024-07-25)

Bug fixes

Fix an issue that caused typing into an editor marked read-only to cause document changes when using EditContext.

Associate a cursor created by clicking above the end of the text on a wrap point with the line before it.

New features

The package now exports the type of hover tooltip sources as HoverTooltipSource.

@codemirror/view 6.28.6 (2024-07-19)

Bug fixes

Fix an issue where the editor got confused about the position of inserted text when using Chrome's EditContext and canceling transactions for typed text.

@codemirror/view 6.28.5 (2024-07-17)

Bug fixes

@codemirror/view 6.28.1 (2024-06-12)

Bug fixes

Disable EditContext by default again, to work around a regression where Chrome's implementation doesn't support inverted selections.

Make sure EditorView.editable is respected when EditContext is used.

@codemirror/view 6.28.0 (2024-06-10)

Bug fixes

Fix an issue where long lines broken up by block widgets were sometimes only partially rendered.

New features

The editor will now, when available (which is only on Chrome for the foreseeable future) use the EditContext API to capture text input.

@codemirror/view 6.27.0 (2024-06-04)

New features

The new setTabFocusMode method can be used to control whether the editor disables key bindings for Tab and Shift-Tab.

@codemirror/view 6.26.4 (2024-06-04)

Bug fixes

Fix an issue where commands with an optional second argument would get the keyboard event in that argument when called from a keymap.

Fix an issue that could cause the cursor to be rendered on the wrong side of a zero-length block widget.

Fix an issue where drawSelection got confused by block widgets in line-wrapped editors in some situations.

Don't hide the native selection in widgets that have focus.

Make sure that clicking an unfocusable editor still remove focus from any other focused elements.

Fix a crash when loading the package in a non-browser environment.

Stop mouse selection when the user types.

@codemirror/commands 6.6.0 (2024-06-04)

New features

The new deleteCharBackwardStrict command just deletes a character, without further smart behavior around indentation.

@codemirror/language-data 6.5.1 (2024-04-15)

Bug fixes

Properly specify the dependency on @codemirror/legacy-modes version 6.4.

@codemirror/view 6.26.3 (2024-04-12)

Bug fixes

Fix an issue where dispatching an update to an editor before it measured itself for the first time could cause the scroll position to incorrectly move.

Fix a crash when multiple tooltips with arrows are shown.

@codemirror/autocomplete 6.16.0 (2024-04-12)

Fix the pasting of copied URIs in iOS.

Fix a bug where a scaled editor could keep performing unnecessary updates due to tiny differences in geometry values returned by the browser.

Fix a bug where, on iOS with a physical keyboard, the modifiers for some keys weren't being passed to the keymaps.

Work around the fact that Mobile Safari makes DOM changes before firing a key event when typing ctrl-d on an external keyboard.

Fix an issue where some commands didn't properly scroll the cursor into view on Mobile Safari.

Re-measure the document when print settings are changed on Chrome.

New features

The EditorView.scrollHandler facet can be used to override or extend the behavior of the editor when things are scrolled into view.

@codemirror/autocomplete 6.15.0 (2024-03-13)

New features

The new filterStrict option can be used to turn off fuzzy matching of completions.

@codemirror/autocomplete 6.14.0 (2024-03-10)

New features

Completion results can now define a map method that can be used to adjust position-dependent information for document changes.

@codemirror/view 6.25.1 (2024-03-06)

Bug fixes

Fix accidental non-optional field in layer config objects.

@codemirror/view 6.25.0 (2024-03-04)

Bug fixes

Properly recognize Android GBoard enter presses that strip a space at the end of the line as enter.

Fix a bug that caused the gutter to have the wrong height when the editor was scaled after construction.

When starting a composition after a non-inclusive mark decoration, temporarily insert a widget that prevents the composed text from inheriting that mark's styles.

Make sure the selection is repositioned when a transaction changes decorations without changing the document.

New features

View plugins can now provide a docViewUpdate method that is called whenever the document view is updated.

Bug fixes

Fix an issue where, when a lot of code is visible in the initial editor, the bottom bit of code is shown without highlighting for one frame.

@codemirror/lint 6.5.0 (2024-01-30)

Bug fixes

Make lint mark decorations inclusive, so that they are applied even if the marked content is replaced by a widget decoration.

New features

linter can now be called with null as source to only provide a configuration.

markerFilter and tooltipFilter function now get passed the current editor state.

@codemirror/view 6.23.1 (2024-01-24)

Bug fixes

Fix a bug that caused Tooltip.above to not take effect for tooltips that were already present when the tooltip plugin is initialized.

Automatically reposition tooltips when their size changes.

@codemirror/language-data 6.4.0 (2024-01-22)

Bug fixes

Include .kts as an extension for Kotlin.

Use @codemirror/lang-yaml instead of the legacy mode for YAML content.

New features

Add an entry for Liquid templates.

@codemirror/autocomplete 6.12.0 (2024-01-12)

Bug fixes

Make sure snippet completions also set userEvent to input.complete.

Fix a crash when the editor lost focus during an update and autocompletion was active.

Fix a crash when using a snippet that has only one field, but multiple instances of that field.

New features

The new activateOnTypingDelay option allows control over the debounce time before the completions are queried when the user types.

@codemirror/state 6.4.0 (2023-12-28)

Bug fixes

When multiple ranges in a single range set overlap, put the smaller ones inside the bigger ones, so that overlapping decorations don't break up each other's elements when coming from the same source.

New features

Selection and selection range eq methods now support an optional argument that makes them also compare by cursor associativity.

The RangeSet.join function can be used to join multiple range sets together.

@codemirror/view 6.23.0 (2023-12-28)

Bug fixes

Work around odd iOS Safari behavior when doing select all.

Fix a composition interruption when an widget is inserted next to the cursor.

Fix a crash in bidirectional cursor motion.

Simplify visual motion through bidirectional text, fix several corner cases where it would work badly.

Fix a bug that broke some bidi isolates not on the first line of the document.

New features

EditorView.bidiIsolatedRanges now supports automatically determining the direction of the range if not provided by the decoration.

EditorView.visualLineSide can be used to find the visual end or start of a line with bidirectional text.

The new EditorView.outerDecorations facet can be used to provide decorations that should always be at the bottom of the precedence stack.

@codemirror/language 6.10.0 (2023-12-28)

New features

The new bidiIsolates extension can be used to wrap syntactic elements where this is appropriate in an element that isolates their text direction, avoiding weird ordering of neutral characters on direction boundaries.

@codemirror/commands 6.3.3 (2023-12-28)

Bug fixes

@codemirror/commands 6.3.2 (2023-11-28)

Bug fixes

Fix a regression that caused deleteCharBackward to sometimes delete a large chunk of text.

@codemirror/state 6.3.2 (2023-11-27)

Bug fixes

Make sure transactions cannot add multiple selections when allowMultipleSelections is false.

Fix a bug that caused Text.iterLines to not return empty lines at the end of the iterated ranges.

@codemirror/view 6.22.1 (2023-11-27)

Bug fixes

Call widget destroy methods when the entire editor is destroyed or reset.

Work around an issue on Safari on macOS Sonoma that made the native cursor visible even when drawSelection is enabled.

Fix an issue where, on some browsers, the screenreader announced text ended up in the printed document.

Fix a bug where a hover tooltip could stick around even though the pointer was no longer on the editor when it was moved out over the tooltip.

Fix an issue where hover tooltips could close when moving the mouse onto them due to mouse position rounding issues.

@codemirror/language 6.9.3 (2023-11-27)

Bug fixes

@codemirror/autocomplete 6.11.0 (2023-11-09)

Bug fixes

Fix an issue that would prevent typing over closed brackets after starting a new line with enter.

New features

Additional elements rendered in completion options with addToOptions are now given access to the editor view.

@codemirror/view 6.22.0 (2023-11-03)

Bug fixes

Exceptions raised by update listeners are now routed to the configured exception sink, if any.

Fix an issue where passing large scroll margins to scrollIntoView would cause the measure loop to fail to terminate.

Widgets that are draggable (and allow drag events through in their ignoreEvent implementation) can now use the editor's built-in drag/drop behavior.

New features

The new scrollTo option to EditorView allows an initial scroll position to be provided.

The new EditorView.scrollSnapshot method returns an effect that can be used to reset to a previous scroll position.

@codemirror/view 6.21.4 (2023-10-24)

Make the context menu work when clicking below the content in a fixed-height editor.

Tooltips that have been put below/above their target position because there is no room on their default side now stay there on further updates.

@codemirror/autocomplete 6.9.2 (2023-10-06)

Bug fixes

Fix a bug in completeAnyWord that could cause it to generate invalid regular expressions and crash.

@codemirror/view 6.21.2 (2023-10-02)

Bug fixes

Fix a regression that broke dragging text from inside the editor.

@codemirror/view 6.21.1 (2023-10-02)

Bug fixes

Fix a bug that could corrupt the DOM view for specific changes involving newlines and mark decorations.

@codemirror/view 6.21.0 (2023-09-29)

Bug fixes

Fix a bug that could cause zero-length widgets at the start of a line to be left in the view even after they were removed.

New features

RectangleMarker's dimension properties are now public.

@codemirror/commands 6.3.0 (2023-09-29)

Bug fixes

Make it possible for selectParentSyntax to jump out of or into a syntax tree overlay.

Make Cmd-Backspace and Cmd-Delete on macOS delete to the next line wrap point, not the start/end of the line.

New features

Fix an issue that caused the tooltip system to leave empty nodes in the DOM when an editor using the parent option to tooltips is destroyed.

Fix a bug that regression mouse interaction with the area of a fixed-size editor that isn't covered by the content.

Fix some issues with the way moveVertically behaved for positions on line wrap points.

Fix a bug that could cause the document DOM to be incorrectly updated on some types of viewport changes.

New features

The new getDrawSelectionConfig function returns the drawSelection configuration for a given state.

@codemirror/language 6.9.1 (2023-09-20)

Bug fixes

Indentation now works a lot better in mixed-language documents that interleave the languages in a complex way.

Bug fixes

Make sure scrolling diagnostic into view in the panel works when the editor is scaled.

@codemirror/collab 6.1.1 (2023-09-14)

Bug fixes

Fix an issue where the configuration process raised an error when multiple instances of the collab extensions were added.

@codemirror/view 6.18.1 (2023-09-11)

Bug fixes

Fix an issue where the editor duplicated text when the browser moved content into the focused text node on composition.

Make sure widgetMarker is called for gutters on lines covered by a block replace decoration.

Fix an issue where the cursor could be shown in a position that doesn't allow a cursor when the selection is in a block widget.

@codemirror/view 6.18.0 (2023-09-05)

New features

The new EditorView.scaleX and scaleY properties return the CSS-transformed scale of the editor (or 1 when not scaled).

The editor now supports being scaled with CSS.

@codemirror/view 6.17.1 (2023-08-31)

Bug fixes

Don't close the hover tooltip when the pointer moves over empty space caused by line breaks within the hovered range.

Fix a bug where on Chrome Android, if a virtual keyboard was slow to apply a change, the editor could end up dropping it.

Work around an issue where line-wise copy/cut didn't work in Firefox because the browser wasn't firing those events when nothing was selected.

Fix a crash triggered by the way some Android IME systems update the DOM.

Fix a bug that caused replacing a word by an emoji on Chrome Android to be treated as a backspace press.

@codemirror/view 6.17.0 (2023-08-28)

Bug fixes

Fix a bug that broke hover tooltips when hovering over a widget.

New features

The new EditorView.cspNonce facet can be used to provide a Content Security Policy nonce for the library's generated CSS.

The new EditorView.bidiIsolatedRanges can be used to inform the editor about ranges styled as Unicode bidirection isolates, so that it can compute the character order correctly.

EditorView.dispatch now also accepts an array of transactions to be applied together in a single view update.

Fix a crash that could occur when a view was reconfigured in a way that removed the lint extension.

@codemirror/collab 6.1.0 (2023-08-22)

New features

The new rebaseUpdates function can be used by a collaborative editing server to accept updates even if they apply to an old document version.

receiveUpdates is now able to handle updates that were rebased by the server.

@codemirror/language 6.9.0 (2023-08-16)

Bug fixes

Make getIndentation return null, rather than 0, when there is no syntax tree available.

New features

The new preparePlaceholder option to codeFolding makes it possible to display contextual information in a folded range placeholder widget.

@codemirror/search 6.5.1 (2023-08-04)

Bug fixes

Make gotoLine prefer to scroll the target line to the middle of the view.

Fix an issue in SearchCursor where character normalization could produce nonsensical matches.

@codemirror/view 6.16.0 (2023-07-31)

Bug fixes

Fix an issue that could cause the scroll position to jump wildly

Don't try to scroll fixed-positioned elements into view by scrolling their parent elements.

Fix a bug that caused the cursor to be hidden when showing a placeholder that consisted of the empty string.

Resolve some issues where composition could incorrectly affect nearby replaced content.

New features

Key bindings can now set a stopPropagation field to cause the view to stop the key event propagation when it considers the event handled.

@codemirror/view 6.14.1 (2023-07-06)

Bug fixes

Fix an issue where scrolling up through line-wrapped text would sometimes cause the scroll position to pop down.

Fix an issue where clicking wouldn't focus the editor on Firefox when it was in an iframe and already the active element of the frame.

Fix a bug that could cause compositions to be disrupted because their surrounding DOM was repurposed for some other piece of content.

Fix a bug where adding content to the editor could inappropriately move the scroll position.

Extend detection of Enter presses on Android to beforeInput events with an "insertLineBreak" type.

@codemirror/lint 6.4.0 (2023-07-03)

New features

Diagnostics can now use "hint" as a severity level.

Fix a bug where the cursor would in some circumstances be drawn on the wrong side of an inline widget.

Fix an issue where scrollPastEnd could cause the scroll position of editors that weren't in view to be changed unnecessarily.

@codemirror/language 6.8.0 (2023-06-12)

New features

The new baseIndentFor method in TreeIndentContext can be used to find the base indentation for an arbitrary node.

@codemirror/autocomplete 6.8.0 (2023-06-12)

New features

The result of Completion.info may now include a destroy method that will be called when the tooltip is removed.

@codemirror/view 6.13.0 (2023-06-05)

Bug fixes

Forbid widget decoration side values bigger than 10000, to prevent them from breaking range ordering invariants.

Fix an Android issue where backspacing at the front of a line with widget decorations could replace those decorations with their text content.

Functions returned by snippet can now be called without a completion object.

@codemirror/view 6.10.0 (2023-04-25)

Bug fixes

Fix a crash in drawSelection when a measured position falls on a position that doesn't have corresponding screen coordinates.

Work around unhelpful interaction observer behavior that could cause the editor to not notice it was visible.

Give the cursor next to a line-wrapped placeholder a single-line height.

Make sure drop events below the editable element in a fixed-height editor get handled properly.

New features

Widget decorations can now define custom coordsAtPos methods to control the way the editor computes screen positions at or in the widget.

@codemirror/search 6.4.0 (2023-04-25)

Bug fixes

The findNext and findPrevious commands now select the search field text if that field is focused.

New features

The scrollToMatch callback option now receives the editor view as a second parameter.

@codemirror/view 6.9.6 (2023-04-21)

Bug fixes

Fix an issue where, when escape was pressed followed by a key that the editor handled, followed by tab, the tab would still move focus.

Fix an issue where, in some circumstances, the editor would ignore text changes at the end of a composition.

Allow inline widgets to be updated to a different length via updateDOM.

@codemirror/language-data 6.3.0 (2023-04-20)

New features

Use the @codemirror/lang-sass package for .sass and .scss files.

@codemirror/commands 6.2.3 (2023-04-19)

Bug fixes

Block commenting the selection no longer includes indentation on the first line.

@codemirror/view 6.9.5 (2023-04-17)

Bug fixes

Avoid disrupting the composition in specific cases where Safari invasively changes the DOM structure in the middle of a composition.

Fix a bug that prevented destroy being called on hover tooltips.

Fix a bug where the editor could take focus when content changes required it to restore the DOM selection.

Fix height layout corruption caused by a division by zero.

Make sure styles targeting the editor's focus status are specific enough to not cause them to apply to editors nested inside another focused editor. This will require themes to adjust their selection background styles to match the new specificity.

@codemirror/language-data 6.2.1 (2023-04-16)

Bug fixes

Associate Gemfile and Rakefile files with Ruby.

@codemirror/autocomplete 6.5.1 (2023-04-13)

Bug fixes

Keep completions open when interaction with an info tooltip moves focus out of the editor.

@codemirror/autocomplete 6.5.0 (2023-04-13)

Bug fixes

When closeBrackets skips a bracket, it now generates a change that overwrites the bracket.

Replace the entire selected range when picking a completion with a non-cursor selection active.

New features

Completions can now provide a section field that is used to group them into sections.

The new positionInfo option can be used to provide custom logic for positioning the info tooltips.

@codemirror/lint 6.2.1 (2023-04-13)

Bug fixes

The linter function now eagerly includes all lint-related extensions, rather than appending them to the configuration as-needed, so that turning off linting by clearing the compartment that contains it works properly.

@codemirror/view 6.9.4 (2023-04-11)

Bug fixes

Make the editor scroll while dragging a selection near its sides, even if the cursor isn't outside the scrollable element.

Fix a bug that interrupted composition after widgets in some circumstances on Firefox.

Make sure the last change in a composition has its user event set to input.type.compose, even if the compositionend event fires before the changes are applied.

Make it possible to remove additional selection ranges by clicking on them with ctrl/cmd held, even if they aren't cursors.

Keep widget buffers between widgets and compositions, since removing them confuses IME on macOS Firefox.

Fix a bug where, for DOM changes that put the selection in the middle of the changed range, the editor incorrectly set its selection state.

Fix a bug where coordsAtPos could return a coordinates before the line break when querying a line-wrapped position with a positive side.

@codemirror/language-data 6.2.0 (2023-03-28)

Fix an issue in drawSelection where the selection extended into the editor's padding.

Fix pasting of links copied from iOS share sheet.

@codemirror/lint 6.2.0 (2023-02-27)

New features

The new needsRefresh option to linter makes it possible to cause linting to be recalculated for non-document state changes.

New features

The new EditorView.focusChangeEffect facet can be used to dispatch a state effect when the editor is focused or blurred.

@codemirror/commands 6.2.1 (2023-02-15)

Bug fixes

Keep cursor position stable in cursorPageUp/cursorPageDown when there are panels or other scroll margins active.

Make sure toggleComment doesn't get thrown off by local language nesting, by fetching the language data for the start of the selection line.

@codemirror/lint 6.1.1 (2023-02-15)

Bug fixes

Give lint action buttons a pointer cursor style.

Fix a bug that caused diagnostic action callbacks to be called twice when their button was clicked.

@codemirror/autocomplete 6.4.1 (2023-02-14)

Bug fixes

Don't consider node names in trees that aren't the same language as the one at the completion position in ifIn and ifNotIn.

Make sure completions that exactly match the input get a higher score than those that don't (so that even if the latter has a score boost, it ends up lower in the list).

@codemirror/language 6.6.0 (2023-02-13)

New features

Syntax-driven language data queries now support sublanguages, which make it possible to return different data for specific parts of the tree produced by a single language.

@codemirror/view 6.8.1 (2023-02-08)

Bug fixes

Fix an issue where tooltips that have their height reduced have their height flicker when scrolling or otherwise interacting with the editor.

@codemirror/view 6.8.0 (2023-02-07)

Bug fixes

Fix a regression that caused clicking on the scrollbar to move the selection.

Fix an issue where focus or blur event handlers that dispatched editor transactions could corrupt the mouse selection state.

Fix a CSS regression that prevented the drop cursor from being positioned properly.

Bug fixes

Fix a regression where the cursor didn't restart its blink cycle when moving it with the pointer.

Even without a key property, measure request objects that are already scheduled will not be scheduled again by requestMeasure.

Fix an issue where keymaps incorrectly interpreted key events that used Ctrl+Alt modifiers to simulate AltGr on Windows.

Fix a bug where line decorations with a different class property would be treated as equal.

Fix a bug that caused drawSelection to not notice when it was reconfigured.

Fix a crash in the gutter extension caused by sharing of mutable arrays.

Fix a regression that caused touch selection on mobile platforms to not work in an uneditable editor.

Fix a bug where DOM events on the boundary between lines could get assigned to the wrong line.

@codemirror/state 6.2.0 (2022-12-26)

New features

EditorSelection.range now accepts an optional 4th argument to specify the bidi level of the range's head position.

@codemirror/commands 6.1.3 (2022-12-26)

Bug fixes

Preserve selection bidi level when extending the selection, to prevent shift-selection from getting stuck in some kinds of bidirectional text.

@codemirror/language 6.3.2 (2022-12-16)

Bug fixes

Fix a bug that caused ensureSyntaxTree to return incomplete trees when using a viewport-aware parser like StreamLanguage.

@codemirror/autocomplete 6.4.0 (2022-12-14)

Bug fixes

Fix an issue where the extension would sometimes try to draw a disabled dialog at an outdated position, leading to plugin crashes.

New features

A tooltipClass option to autocompletion can now be used to add additional CSS classes to the completion tooltip.

@codemirror/view 6.7.1 (2022-12-12)

Bug fixes

Make the editor properly scroll when moving the pointer out of it during drag selection.

Fix a regression where clicking below the content element in an editor with its own height didn't focus the editor.

@codemirror/view 6.7.0 (2022-12-07)

Bug fixes

Make the editor notice widget height changes to automatically adjust its height information.

Fix an issue where widget buffers could be incorrectly omitted after empty lines.

Fix an issue in content redrawing that could cause coordsAtPos to return incorrect results.

New features

The static RectangleMarker.forRange method exposes the logic used by the editor to draw rectangles covering a selection range.

Layers can now provide a destroy function to be called when the layer is removed.

The new highlightWhitespace extension makes spaces and tabs in the editor visible.

The highlightTrailingWhitespace extension can be used to make trailing whitespace stand out.

@codemirror/view 6.6.0 (2022-11-24)

New features

The layer function can now be used to define extensions that draw DOM elements over or below the document text.

Tooltips that are bigger than the available vertical space for them will now have their height set so that they don't stick out of the window. The new resize property on TooltipView can be used to opt out of this behavior.

@codemirror/autocomplete 6.3.4 (2022-11-24)

Bug fixes

Fix an issue where completion lists could end up being higher than the tooltip they were in.

@codemirror/autocomplete 6.3.3 (2022-11-18)

New features

A tooltip's positioned callback is now passed the available space for tooltips.

Fix an issue where the editor could end up displaying incorrect height measurements (typically after initializing).

@codemirror/view 6.4.1 (2022-11-07)

Bug fixes

Fix an issue where coordinates next to replaced widgets were returned incorrectly, causing the cursor to be drawn in the wrong place.

Update the crosshairCursor state on every mousemove event.

Avoid an issue in the way that the editor enforces cursor associativity that could cause the cursor to get stuck on single-character wrapped lines.

@codemirror/language 6.3.0 (2022-10-24)

New features

HighlightStyle objects now have a specs property holding the tag styles that were used to define them.

Language objects now have a name field holding the language name.

@codemirror/view 6.4.0 (2022-10-18)

Bug fixes

Avoid an issue where scrollPastEnd makes a single-line editor have a vertical scrollbar.

Work around a Chrome bug where it inserts a newline when you press space at the start of a wrapped line.

Align rectangularSelection's behavior with other popular editors by making it create cursors at the end of lines that are too short to touch the rectangle.

Fix an issue where coordinates on mark decoration boundaries were sometimes taken from the wrong side of the position.

Prevent scrolling artifacts caused by attempts to scroll stuff into view when the editor isn't being displayed.

New features

TooltipView objects can now provide a destroy method to be called when the tooltip is removed.

@codemirror/search 6.2.2 (2022-10-18)

Bug fixes

When literal is off, \n, \r, and \t escapes are now also supported in replacement text.

Make sure search dialog inputs don't get treated as form fields when the editor is created inside a form.

Fix a bug in RegExpCursor that would cause it to stop matching in the middle of a line when its current match position was equal to the length of the line.

@codemirror/commands 6.1.2 (2022-10-13)

Bug fixes

Fix a bug that caused deletion commands on non-empty ranges to incorrectly return false and do nothing, causing the editor to fall back to native behavior.

@codemirror/view 6.3.1 (2022-10-10)

Bug fixes

Fix a crash when trying to scroll something into view in an editor that wasn't in the visible DOM.

Fix an issue where coordsAtPos returned the coordinates on the wrong side of a widget decoration wrapped in a mark decoration.

Fix an issue where content on long wrapped lines could fail to properly scroll into view.

Fix an issue where DOM change reading on Chrome Android could get confused when a transaction came in right after a beforeinput event for backspace, enter, or delete.

@codemirror/view 6.3.0 (2022-09-28)

Bug fixes

Reduce the amount of wrap-point jittering when scrolling through a very long wrapped line.

Fix an issue where scrolling to content that wasn't currently drawn due to being on a very long line would often fail to scroll to the right position.

Suppress double-space-adds-period behavior on Chrome Mac when it behaves weirdly next to widget.

New features

Key binding objects with an any property will now add handlers that are called for any key, within the ordering of the keybindings.

@codemirror/commands 6.1.1 (2022-09-28)

Bug fixes

Make sure the selection endpoints are moved out of atomic ranges when applying a deletion command to a non-empty selection.

@codemirror/search 6.2.1 (2022-09-26)

Bug fixes

By-word search queries will now skip any result that had word characters both before and after a match boundary.

@codemirror/view 6.2.5 (2022-09-24)

Bug fixes

Don't override double/triple tap behavior on touch screen devices, so that the mobile selection menu pops up properly.

Fix an issue where updating the selection could crash on Safari when the editor was hidden.

@codemirror/autocomplete 6.3.0 (2022-09-22)

New features

Close bracket configuration now supports a stringPrefixes property that can be used to allow autoclosing of prefixed strings.

@codemirror/state 6.1.2 (2022-09-21)

Bug fixes

Fix an issue where, when multiple transaction extenders took effect, only the highest-precedence one was actually included in the transaction.

@codemirror/view 6.2.4 (2022-09-16)

Bug fixes

Highlight the active line even when there is a selection. Prevent the active line background from obscuring the selection backdrop.

Fix an issue where elements with negative margins would confuse the editor's scrolling-into-view logic.

Fix scrolling to a specific position in an editor that has not been in view yet.

@codemirror/autocomplete 6.2.0 (2022-09-13)

New features

@codemirror/view 6.2.1 (2022-08-25)

Bug fixes

Don't use the global document variable to track focus, since that doesn't work in another window/frame.

Fix an issue where key handlers that didn't return true were sometimes called twice for the same keypress.

Avoid editing glitches when using deletion keys like ctrl-d on iOS.

Properly treat characters from the 'Arabic Presentation Forms-A' Unicode block as right-to-left.

Work around a Firefox bug that inserts text at the wrong point for specific cross-line selections.

@codemirror/search 6.2.0 (2022-08-25)

New features

A new wholeWord search query flag can be used to limit matches to whole words.

SearchCursor and RegExpCursor now support a test parameter that can be used to ignore certain matches.

@codemirror/commands 6.1.0 (2022-08-18)

Bug fixes

Prevent native behavior on Ctrl/Cmd-ArrowLeft/ArrowRight bindings, so that browsers with odd bidi behavior won't do the wrong thing at start/end of line.

Cmd-ArrowLeft/Right on macOS now moves the cursor in the direction of the arrow even in right-to-left content.

New features

The new cursorLineBoundaryLeft/Right and selectLineBoundaryLeft/Right commands allow directional motion to line boundaries.

@codemirror/search 6.1.0 (2022-08-16)

Bug fixes

Fix an infinite loop when the match position of a RegExpCursor ended up in the middle of an UTF16 surrogate pair.

New features

The literal search option can now be set to make literal queries the default.

The new searchPanelOpen function can be used to find out whether the search panel is open for a given state.

@codemirror/view 6.2.0 (2022-08-05)

Bug fixes

Fix a bug where posAtCoords would return the wrong results for positions to the right of wrapped lines.

New features

The new EditorView.setRoot method can be used when an editor view is moved to a new document or shadow root.

@codemirror/view 6.1.4 (2022-08-04)

Bug fixes

Make selection-restoration on focus more reliable.

@codemirror/state 6.1.1 (2022-08-03)

Bug fixes

The editor will now try to suppress browsers' native behavior of resetting the selection in the editable content when the editable element is focused (programmatically, with tab, etc).

Fix a CSS issue that made it possible, when the gutters were wide enough, for them to overlap with the content.

@codemirror/search 6.0.1 (2022-07-22)

Bug fixes

findNext and findPrevious will now return to the current result (and scroll it into view) if no other matches are found.

@codemirror/language 6.2.1 (2022-07-21)

Bug fixes

Fix a bug where bracketMatching would incorrectly match nested brackets in syntax trees that put multiple pairs of brackets in the same parent node.

Fix a bug that could cause indentRange to loop infinitely.

@codemirror/view 6.1.0 (2022-07-19)

New features

MatchDecorator now supports a decorate option that can be used to customize the way decorations are added for each match.

@codemirror/autocomplete 6.1.0 (2022-07-19)

Refine change mapping to preserve insertions made by concurrent changes.

New features

The enables option to Facet.define may now take a function, which will be called with the facet value to create the extensions.

@codemirror/language 6.2.0 (2022-06-30)

Bug fixes

Fix a bug that prevented bracket matching to recognize plain brackets inside a language parsed as an overlay.

Instead of passing a constructed state to the EditorView constructor, it is now also possible to inline the configuration options to the state in the view config object.

@codemirror/language 6.0.0 (2022-06-08)

New features

The foldingChanged option to foldGutter can now be used to trigger a recomputation of the fold markers.

@codemirror/commands 6.0.0 (2022-06-08)

Bug fixes

Fix a bug where by-page selection commands sometimes moved one line too far.

@codemirror/search 6.0.0 (2022-06-08)

The package no longer exports EditorState (since that is no longer necessary to set up a basic editor).

New features

The new minimalSetup export provides a minimal set of editor extensions.

@codemirror/state 0.20.1 (2022-06-02)

New features

EditorView.phrase now accepts additional arguments, which it will interpolate into the phrase in the place of $ markers.

@codemirror/view 0.20.7 (2022-05-30)

Bug fixes

Fix an issue on Chrome Android where the DOM could fail to display the actual document after backspace.

Avoid an issue on Chrome Android where DOM changes were sometimes inappropriately replace by a backspace key effect due to spurious beforeinput events.

Fix a problem where the content element's width didn't cover the width of the actual content.

Work around a bug in Chrome 102 which caused wheel scrolling of the editor to be interrupted every few lines.

@codemirror/autocomplete 0.20.3 (2022-05-30)

Fix an issue where DOM event handlers registered by plugins were retained indefinitely, even after the editor was reconfigured.

@codemirror/language 0.20.1 (2022-05-18)

Bug fixes

Make sure all styles in the CSS generated for a HighlightStyle have a lower precedence than the other rules defined for the style. Use a shorthand property

@codemirror/autocomplete 0.20.1 (2022-05-16)

New features

The new closeOnBlur option determines whether the completion tooltip is closed when the editor loses focus.

CompletionResult objects with filter: false may now have a getMatch property that determines the matched range in the options.

@codemirror/view 0.20.4 (2022-05-03)

Bug fixes

Prevent Mac-style behavior of inserting a period when the user inserts two spaces.

Fix an issue where the editor would sometimes not restore the DOM selection when refocused with a selection identical to the one it held when it lost focus.

@codemirror/lint 0.20.2 (2022-05-02)

The exports from @codemirror/text now live in this package.

@codemirror/view 0.20.1 (2022-04-20)

Bug fixes

Remove debug statements that accidentally made it into 0.20.0.

Fix a regression in moveVertically.

@codemirror/view 0.20.0 (2022-04-20)

Breaking changes

The deprecated interfaces blockAtHeight, visualLineAtHeight, viewportLines, visualLineAt, scrollPosIntoView, scrollTo, and centerOn were removed from the library.

All decorations are now provided through EditorView.decorations, and are part of a single precedence ordering. Decoration sources that need access to the view are provided as functions.

Atomic ranges are now specified through a facet (EditorView.atomicRanges).

Scroll margins are now specified through a facet (EditorView.scrollMargins).

Plugin fields no longer exist in the library (and are replaced by facets holding function values).

This package no longer re-exports the Range type from @codemirror/state.

Bug fixes

Fix a bug where zero-length block widgets could cause viewportLineBlocks to contain overlapping ranges.

New features

The new perLineTextDirection facet configures whether the editor reads text direction per line, or uses a single direction for the entire editor. EditorView.textDirectionAt returns the direction around a given position.

rectangularSelection and crosshairCursor from @codemirror/rectangular-selection were merged into this package.

This package now exports the tooltip functionality that used to live in @codemirror/tooltip.

The exports from the old @codemirror/panel package are now available from this package.

The exports from the old @codemirror/gutter package are now available from this package.

@codemirror/language 0.20.0 (2022-04-20)

Breaking changes

HighlightStyle.get is now called highlightingFor.

HighlightStyles no longer function as extensions (to improve tree shaking), and must be wrapped with syntaxHighlighting to add to an editor configuration.

Language objects no longer have a topNode property.

New features

HighlightStyle and defaultHighlightStyle from the now-removed @codemirror/highlight package now live in this package.

The new forceParsing function can be used to run the parser forward on an editor view.

The exports that used to live in @codemirror/matchbrackets are now exported from this package.

The @codemirror/fold package has been merged into this one.

The exports from the old @codemirror/stream-parser package now live in this package.

@codemirror/commands 0.20.0 (2022-04-20)

Breaking changes

There is no longer a separate commentKeymap. Those bindings are now part of defaultKeymap.

Bug fixes

Make cursorPageUp and cursorPageDown move by window height when the editor is higher than the window.

Fix an issue where DOM syncing could crash when a DOM node was moved from a parent to a child node (via widgets reusing existing nodes).

To avoid interfering with things like a vim mode too much, the editor will now only activate the tab-to-move-focus escape hatch after an escape press that wasn't handled by an event handler.

Make sure the view measures itself before the page is printed.

Tweak types of view plugin defining functions to avoid TypeScript errors when the plugin value doesn't have any of the interface's properties.

@codemirror/language 0.19.9 (2022-03-30)

Bug fixes

Make sure nodes that end at the end of a partial parse aren't treated as valid fold targets.

Fix an issue where the parser sometimes wouldn't reuse parsing work done in the background on transactions.

codemirror 0.19.3 (2022-03-30)

New features

Add the extension that shows a crosshair cursor when Alt is held down to the basic setup.

@codemirror/autocomplete 0.19.15 (2022-03-23)

New features

The selectedCompletionIndex function tells you the position of the currently selected completion.

The new setSelectionCompletion function creates a state effect that moves the selected completion to a given index.

A completion's info method may now return null to indicate that no further info is available.

@codemirror/autocomplete 0.19.14 (2022-03-10)

Bug fixes

Make the ARIA attributes added to the editor during autocompletion spec-compliant.

@codemirror/view 0.19.47 (2022-03-08)

Bug fixes

Fix an issue where block widgets at the start of the viewport could break height computations.

@codemirror/lint 0.19.6 (2022-03-04)

Bug fixes

Fix a bug where hovering over the icons in the lint gutter would sometimes fail to show a tooltip or show the tooltip for another line.

@codemirror/view 0.19.46 (2022-03-03)

Bug fixes

Fix a bug where block widgets on the edges of viewports could cause the positioning of content to misalign with the gutter and height computations.

Improve cursor height next to widgets.

Fix a bug where mapping positions to screen coordinates could return incorred coordinates during composition.

@codemirror/language 0.19.8 (2022-03-03)

Bug fixes

Fix an issue that could cause indentation logic to use the wrong line content when indenting multiple lines at once.

@codemirror/search 0.19.9 (2022-03-03)

New features

The selection-matching extension now accepts a wholeWords option that makes it only highlight matches that span a whole word. Add SearchQuery.getCursor

The SearchQuery class now has a getCursor method that allows external code to create a cursor for the query.

@codemirror/lint 0.19.5 (2022-02-25)

Stop snippet filling when a change happens across one of the snippet fields' boundaries.

@codemirror/view 0.19.44 (2022-02-17)

Bug fixes

Fix a crash that occasionally occurred when drag-selecting in a way that scrolled the editor.

New features

The new EditorView.compositionStarted property indicates whether a composition is starting.

@codemirror/state 0.19.9 (2022-02-16)

Bug fixes

Mapping a non-empty selection range now always puts any newly inserted text on the sides of the range outside of the mapped version.

@codemirror/view 0.19.43 (2022-02-16)

Bug fixes

Fix several issues where editing or composition went wrong due to our zero-width space kludge characters ending up in unexpected places.

Make sure the editor re-measures its dimensions whenever its theme changes.

Fix an issue where some keys on Android phones could leave the editor DOM unsynced with the actual document.

@codemirror/state 0.19.8 (2022-02-15)

Bug fixes

Fix a bug where facet values with computed inputs could incorrectly retain their old value on reconfiguration.

@codemirror/language-data 0.19.2 (2022-02-15)

@codemirror/search 0.19.8 (2022-02-14)

Bug fixes

Fix a bug that caused the search panel to start open when configuring a state with the search() extension.

@codemirror/search 0.19.7 (2022-02-14)

Breaking changes

searchConfig is deprecated in favor of search (but will exist until next major release).

New features

The new search function is now used to enable and configure the search extension.

Fix an issue where reading DOM changes was broken when lineSeparator contained more than one character.

Make ordering of replace and mark decorations with the same extent and inclusivness more predictable by giving replace decorations precedence.

Fix a bug where, on Chrome, replacement across line boundaries and next to widgets could cause bogus zero-width characters to appear in the content.

@codemirror/search 0.19.6 (2022-01-27)

Bug fixes

Make selectNextOccurrence scroll the newly selected range into view.

@codemirror/commands 0.19.8 (2022-01-26)

Bug fixes

deleteCharBackward now removes extending characters one at a time, rather than deleting the entire glyph at once.

Alt-v is no longer bound in emacsStyleKeymap and macOS's standardKeymap, because macOS doesn't bind it by default and it conflicts with some keyboard layouts.

@codemirror/view 0.19.40 (2022-01-19)

Bug fixes

Make composition input properly appear at secondary cursors (except when those are in the DOM node with the composition, in which case the browser won't allow us to intervene without aborting the composition).

Fix a bug that cause the editor to get confused about which content was visible after scrolling something into view.

Fix a bug where the dummy elements rendered around widgets could end up in a separate set of wrapping marks, and thus become visible.

EditorView.moveVertically now preserves the assoc property of the input range.

Get rid of gaps between selection elements drawn by drawSelection.

Fix an issue where replacing text next to a widget might leak bogus zero-width spaces into the document.

Avoid browser selection mishandling when a focused view has setState called by eagerly refocusing it.

@codemirror/commands 0.19.7 (2022-01-11)

Bug fixes

Don't bind Alt-< and Alt-> on macOS by default, since those interfere with some keyboard layouts. Make cursorPageUp/Down scroll the view to keep the cursor in place

cursorPageUp and cursorPageDown now scroll the view by the amount that the cursor moved.

@codemirror/autocomplete 0.19.12 (2022-01-11)

Bug fixes

Fix completion navigation with PageUp/Down when the completion tooltip isn't part of the view DOM.

@codemirror/autocomplete 0.19.11 (2022-01-11)

@codemirror/view 0.19.36 (2021-12-22)

Bug fixes

Fix a crash in posAtCoords when the position lies in a block widget that is rendered but scrolled out of view.

Adding block decorations from a plugin now raises an error. Replacing decorations that cross lines are ignored, when provided by a plugin.

Fix inverted interpretation of the precise argument to posAtCoords.

@codemirror/view 0.19.35 (2021-12-20)

Bug fixes

The editor will now handle double-taps as if they are double-clicks, rather than letting the browser's native behavior happen (because the latter often does the wrong thing).

Fix an issue where backspacing out a selection on Chrome Android would sometimes only delete the last character due to event order issues.

posAtCoords, without second argument, will no longer return null for positions below or above the document.

@codemirror/view 0.19.34 (2021-12-17)

Bug fixes

Fix a bug where content line elements would in some cases lose their cm-line class.

@codemirror/view 0.19.33 (2021-12-16)

Breaking changes

EditorView.scrollTo and EditorView.centerOn are deprecated in favor of EditorView.scrollIntoView, and will be removed in the next breaking release.

Bug fixes

Fix an issue that could cause the editor to unnecessarily interfere with composition (especially visible on macOS Chrome).

A composition started with multiple lines selected will no longer be interruptd by the editor.

New features

The new EditorView.scrollIntoView function allows you to do more fine-grained scrolling.

@codemirror/search 0.19.5 (2021-12-16)

Breaking changes

The search option matchCase was renamed to caseSensitive (the old name will continue to work until the next breaking release).

Bug fixes

openSearchPanel will now update the search query to the current selection even if the panel was already open.

New features

Client code can now pass a custom search panel creation function in the search configuration.

The getSearchQuery function and setSearchQuery effect can now be used to inspect or change the current search query.

@codemirror/view 0.19.32 (2021-12-15)

Bug fixes

Fix a bug where CodeMirror's own event handers would run even after a user-supplied handler called preventDefault on an event.

Properly draw selections when negative text-indent is used for soft wrapping.

Fix an issue where viewportLineBlocks could hold inaccurate height information when the vertical scaling changed.

Fixes drop cursor positioning when the document is scrolled. Force a content measure when the editor comes into view

Fix a bug that could cause the editor to not measure its layout the first time it came into view.

@codemirror/view 0.19.31 (2021-12-13)

New features

The package now exports a dropCursor extension that draws a cursor at the current drop position when dragging content over the editor.

@codemirror/view 0.19.30 (2021-12-13)

Bug fixes

Refine Android key event handling to work properly in a GBoard corner case where pressing Enter fires a bunch of spurious deleteContentBackward events.

Fix an issue where pressing Enter on Chrome Android during composition did not fire key handlers for Enter.

Avoid a Chrome bug where the virtual keyboard closes when pressing backspace after a widget.

Fix an issue where the editor could show a horizontal scroll bar even after all lines that caused it had been deleted or changed.

@codemirror/view 0.19.27 (2021-12-06)

Bug fixes

Fix a bug that could cause EditorView.plugin to inappropriately return null during plugin initialization.

Fix a bug where a block widget without estimatedHeight at the end of the document could fail to be drawn

@codemirror/view 0.19.26 (2021-12-03)

New features

Widgets can now define a destroy method that is called when they are removed from the view.

@codemirror/view 0.19.25 (2021-12-02)

Bug fixes

Widgets around replaced ranges are now visible when their side does not point towards the replaced range.

A replaced line with a line decoration no longer creates an extra empty line block in the editor.

The scrollPastEnd extension will now over-reserve space at the bottom of the editor on startup, to prevent restored scroll positions from being clipped.

New features

EditorView.editorAttributes and contentAttributes may now hold functions that produce the attributes.

@codemirror/language 0.19.7 (2021-12-02)

Bug fixes

Fix an issue where the parse worker could incorrectly stop working when the parse tree has skipped gaps in it.

@codemirror/search 0.19.4 (2021-12-02)

Improve initial highlight for mixed-language editors and limit the amount of parsing done on state creation for faster startup.

@codemirror/autocomplete 0.19.9 (2021-11-26)

Bug fixes

Fix an issue where info tooltips would be visible in an inappropriate position when there was no room to place them properly.

@codemirror/search 0.19.3 (2021-11-22)

Bug fixes

Add userEvent annotations to search and replace transactions.

Make sure the editor handles keys bound to findNext/findPrevious even when there are no matches, to avoid the browser's search interrupting users.

New features

Add a Symbol.iterator property to the cursor types, so that they can be used with for/of.

@codemirror/state 0.19.6 (2021-11-19)

Bug fixes

Fix a bug that caused facet compare functions to be called with an invalid value in some situations.

Fix a bug that caused dynamic facet values to be incorrectly kept unchanged when reconfiguration changed one of their dependencies.

@codemirror/view 0.19.20 (2021-11-19)

Bug fixes

Run a measure cycle when the editor's size spontaneously changes.

@codemirror/view 0.19.19 (2021-11-17)

Bug fixes

Fix a bug that caused the precedence of editorAttributes and contentAttributes to be inverted, making lower-precedence extensions override higher-precedence ones.

@codemirror/language 0.19.5 (2021-11-17)

New features

The new function syntaxTreeAvailable can be used to check if a fully-parsed syntax tree is available up to a given document position.

The module now exports syntaxParserRunning, which tells you whether the background parser is still planning to do more work for a given editor view.

@codemirror/autocomplete 0.19.8 (2021-11-17)

Bug fixes

@codemirror/view 0.19.16 (2021-11-11)

Breaking changes

Block replacement decorations now default to inclusive, because non-inclusive block decorations are rarely what you need.

Bug fixes

Fix an issue that caused block widgets to always have a large side value, making it impossible to show them between to replacement decorations.

Fix a crash that could happen after some types of viewport changes, due to a bug in the block widget view data structure.

@codemirror/state 0.19.5 (2021-11-10)

Bug fixes

Fix a bug that would cause dynamic facet values influenced by a state reconfiguration to not properly recompute.

@codemirror/view 0.19.15 (2021-11-09)

Bug fixes

Fix a bug where the editor would think it was invisible when the document body was given screen height and scroll behavior.

Fix selection reading inside a shadow root on iOS.

@codemirror/autocomplete 0.19.5 (2021-11-09)

Bug fixes

Make sure info tooltips don't stick out of the bottom of the page.

New features

The package exports a new function selectedCompletion, which can be used to find out which completion is currently selected.

Transactions created by picking a completion now have an annotation (pickedCompletion) holding the original completion.

@codemirror/lint 0.19.3 (2021-11-09)

New features

Export a function lintGutter which returns an extension that installs a gutter marking lines with diagnostics.

The package now exports the effect used to update the diagnostics (setDiagnosticsEffect).

@codemirror/view 0.19.14 (2021-11-07)

Bug fixes

Fix an issue where typing into a read-only editor would move the selection.

Fix slowness when backspace is held down on iOS.

@codemirror/view 0.19.13 (2021-11-06)

Bug fixes

Fix a bug where backspace, enter, and delete would get applied twice on iOS.

@codemirror/state 0.19.4 (2021-11-05)

Bug fixes

When reconfiguring a state, effects from the reconfiguring transaction can now be seen by newly added state fields.

@codemirror/view 0.19.12 (2021-11-04)

Bug fixes

Make sure the workaround for the lost virtual keyboard on Chrome Android also works on slower phones. Slight style change in beforeinput handler

Avoid failure cases in viewport-based rendering of very long lines.

@codemirror/state 0.19.3 (2021-11-03)

New features

The precedence levels (under Prec) now have more generic names, because their 'meaningful' names were entirely inappropriate in many situations.

@codemirror/view 0.19.11 (2021-11-03)

Breaking changes

EditorView.scrollPosIntoView has been deprecated. Use the EditorView.scrollTo effect instead.

New features

The new EditorView.centerOn effect can be used to scroll a given range to the center of the view.

@codemirror/view 0.19.10 (2021-11-02)

Bug fixes

Don't crash when IntersectionObserver fires its callback without any records. Try to handle some backspace issues on Chrome Android

Using backspace near uneditable widgets on Chrome Android should now be more reliable.

Work around a number of browser bugs by always rendering zero-width spaces around in-content widgets, so that browsers will treat the positions near them as valid cursor positions and not try to run composition across widget boundaries.

Work around bogus composition changes created by Chrome Android after handled backspace presses.

Work around an issue where tapping on an uneditable node in the editor would sometimes fail to show the virtual keyboard on Chrome Android.

Fix a bug that could, on DOM changes near block widgets, insert superfluous line breaks.

Make interacting with a destroyed editor view do nothing, rather than crash, to avoid tripping people up with pending timeouts and such.

Make sure ViewUpdate.viewportChanged is true whenever visibleRanges changes, so that plugins acting only on visible ranges can use it to check when to update.

Fix line-wise cut on empty lines.

@codemirror/commands 0.19.5 (2021-09-21)

New features

Adds an insertBlankLine command which creates an empty line below the selection, and binds it to Mod-Enter in the default keymap.

@codemirror/lint 0.19.1 (2021-09-17)

Bug fixes

Prevent decorations that cover just a line break from being invisible by showing a widget instead of range for them.

New features

The diagnosticCount method can now be used to determine whether there are active diagnostics.

@codemirror/search 0.19.2 (2021-09-16)

Fix a bug where deleteCharForward/Backward behaved incorrectly when deleting directly before or after an atomic range.

@codemirror/search 0.19.1 (2021-09-06)

Bug fixes

Make highlightSelectionMatches not produce overlapping decorations, since those tend to just get unreadable.

Make sure any existing search text is selected when opening the search panel. Add search config option to not match case when search panel is opened (#4)

New features

The searchConfig function now takes a matchCase option that controls whether the search panel starts in case-sensitive mode.

@codemirror/view 0.19.4 (2021-09-01)

Bug fixes

Fix an issue where lines containing just a widget decoration wrapped in a mark decoration could be displayed with 0 height.

@codemirror/autocomplete 0.19.3 (2021-08-31)

Bug fixes

Improve the sorting of completions by using localeCompare.

Fix reading of autocompletions in NVDA screen reader.

New features

The new icons option can be used to turn off icons in the completion list.

Breaking changes

User event strings now work differently—the events emitted by the core packages follow a different system, and hierarchical event tags can be created by separating the words with dots.

New features

languageDataAt now takes an optional side argument to specificy which side of the position you're interested in.

It is now possible to add a user event annotation with a direct userEvent property on a transaction spec.

Transactions now have an isUserEvent method that can be used to check if it is (a subtype of) some user event type.

@codemirror/view 0.19.1 (2021-08-11)

Breaking changes

The view now emits new-style user event annotations for the transactions it generates.

Bug fixes

Fix a bug where coordsAtPos would allow the passed side argument to override widget sides, producing incorrect cursor positions.

Fix a bug that could cause content lines to be misaligned in certain situations involving widgets at the end of lines.

Fix an issue where, if the browser decided to modify DOM attributes in the content in response to some editing action, the view failed to reset those again.

@codemirror/language 0.19.2 (2021-08-11)

Bug fixes

Fix a bug that caused indentOnInput to fire for the wrong kinds of transactions.

Fix a bug that could cause indentOnInput to apply its changes incorrectly.

@codemirror/language 0.19.1 (2021-08-11)

Bug fixes

Fix incorrect versions for @lezer dependencies.

@codemirror/language 0.19.0 (2021-08-11)

Breaking changes

CodeMirror now uses lezer 0.15, which means different package names (scoped with @lezer) and some breaking changes in the library.

EditorParseContext is now called ParseContext. It is no longer passed to parsers, but must be retrieved with ParseContext.get.

IndentContext.lineIndent now takes a position, not a Line object, as argument.

LezerLanguage was renamed to LRLanguage (because all languages must emit Lezer-style trees, the name was misleading).

Language.parseString no longer exists. You can just call .parser.parse(...) instead.

New features

New IndentContext.lineAt method to access lines in a way that is aware of simulated line breaks.

IndentContext now provides a simulatedBreak property through which client code can query whether the context has a simulated line break.

@codemirror/commands 0.19.1 (2021-08-11)

Bug fixes

Fix incorrect versions for @lezer dependencies.

@codemirror/commands 0.19.0 (2021-08-11)

Breaking changes

Change default binding for backspace to deleteCharBackward, drop deleteCodePointBackward/Forward from the library.

defaultTabBinding was removed.

Bug fixes

Drop Alt-d, Alt-f, and Alt-b bindings from emacsStyleKeymap (and thus from the default macOS bindings).

Fix an issue that caused openLintPanel to not actually open the panel when ran before the editor had any lint state loaded.

New features

The package now exports a forceLinting function that forces pending lint queries to run immediately.

@codemirror/view 0.18.19 (2021-07-12)

Bug fixes

Fix a regression where EditorView.editable.of(false) didn't disable editing on Webkit-based browsers.

@codemirror/view 0.18.18 (2021-07-06)

Bug fixes

Fix a bug that caused EditorView.moveVertically to only move by one line, even when given a custom distance, in some cases.

Hide Safari's native bold/italic/underline controls for the content.

Fix a CSS problem that prevented Safari from breaking words longer than the line in line-wrapping mode.

Avoid a problem where composition would be inappropriately abored on Safari.

Fix drag-selection that scrolls the content by dragging past the visible viewport.

New features

posAtCoords now has an imprecise mode where it'll return an approximate position even for parts of the document that aren't currently rendered.

@codemirror/autocomplete 0.18.8 (2021-06-30)

New features

Add an ifIn helper function that constrains a completion source to only fire when in a given syntax node. Add support for unfiltered completions

A completion result can now set a filter: false property to disable filtering and sorting of completions, when it already did so itself.

@codemirror/view 0.18.17 (2021-06-14)

Bug fixes

Make drawSelection behave properly when lines are split by block widgets.

Make sure drawn selections that span a single line break don't leave a gap between the lines.

@codemirror/autocomplete 0.18.7 (2021-06-14)

Bug fixes

Don't treat continued completions when typing after an explicit completion as explicit.

New features

MouseSelectionStyle.update may now return true to indicate it should be queried for a new selection after the update.

@codemirror/autocomplete 0.18.6 (2021-06-03)

Bug fixes

Adding or reconfiguring completion sources will now cause them to be activated right away if a completion was active.

New features

You can now specify multiple types in Completion.type by separating them by spaces. Small doc comment tweak for Completion.type

New features

A new plugin field, PluginField.atomicRanges, can be used to cause cursor motion to skip past some ranges of the document.

@codemirror/search 0.18.4 (2021-05-27)

New features

Initialize the search query to the current selection, when there is one, when opening the search dialog.

Add a searchConfig function, supporting an option to put the search panel at the top of the editor.

codemirror 0.18.2 (2021-05-25)

Bug fixes

Fix too-low dependency on @codemirror/gutter that could cause broken upgrades.

@codemirror/view 0.18.13 (2021-05-20)

Bug fixes

Fix a bug that would cause the content DOM update to crash in specific circumstances.

Work around an issue where, after some types of changes, Mobile Safari would ignore Enter presses.

Make iOS enter and backspace handling more robust, so that platform bugs are less likely to break those keys in the editor.

Fix a regression where Esc + Tab no longer allowed the user to exit the editor.

New features

You can now drop text files into the editor.

@codemirror/search 0.18.3 (2021-05-18)

Bug fixes

Fix a bug where the first search command in a new editor wouldn't properly open the panel.

Add an attribute to prevent the Grammarly browser extension from messing with the editor content.

Fix more issues around selection handling a Shadow DOM in Safari.

@codemirror/view 0.18.10 (2021-04-27)

Bug fixes

Fix a bug where some types of updates wouldn't properly cause marks around the changes to be joined in the DOM.

Fix an issue where the content and gutters in a fixed-height editor could be smaller than the editor height.

Fix a crash on Safari when initializing an editor in an unfocused window.

Fix a bug where the editor would incorrectly conclude it was out of view in some types of absolutely positioned parent elements.

@codemirror/view 0.18.9 (2021-04-23)

Bug fixes

Fix a crash that occurred when determining DOM coordinates in some specific situations.

Fix a crash when a DOM change that ended at a zero-width view element (widget) removed that element from the DOM.

Disable autocorrect and autocapitalize by default, since in most code-editor contexts they get in the way. You can use EditorView.contentAttributes to override this.

Fix a bug that interfered with native touch selection handling on Android.

Fix an unnecessary DOM update after composition that would disrupt touch selection on Android.

Add a workaround for Safari's broken selection reporting when the editor is in a shadow DOM tree.

Fix select-all from the context menu on Safari.

@codemirror/autocomplete 0.18.5 (2021-04-23)

Bug fixes

Fix a regression where snippet field selection didn't work with @codemirror/state 0.18.6.

Fix a bug where snippet fields with different position numbers were inappropriately merged.

@codemirror/autocomplete 0.18.4 (2021-04-20)

Bug fixes

Fix a crash in Safari when moving the selection during composition.

@codemirror/view 0.18.8 (2021-04-19)

Bug fixes

Handle selection replacements where the inserted text matches the start/end of the replaced text better.

Fix an issue where the editor would miss scroll events when it was placed in a DOM component slot.

@codemirror/lint 0.18.2 (2021-04-16)

Bug fixes

@codemirror/commands 0.18.1 (2021-04-08)

Bug fixes

Also bind Shift-Backspace and Shift-Delete in the default keymap (to do the same thing as the Shift-less binding).

New features

Adds a deleteToLineStart command.

Adds bindings for Cmd-Delete and Cmd-Backspace on macOS.

@codemirror/view 0.18.5 (2021-04-07)

Bug fixes

Fix an issue where nested parsers could see past the end of the nested region.

@codemirror/state 0.18.3 (2021-03-23)

New features

The package now exports a RegExpCursor which is a search cursor that matches regular expression patterns.

The search/replace interface now allows the user to use regular expressions.

Completion.info may now return a promise.

@codemirror/state 0.18.1 (2021-03-10)

New features

The new Compartment.get method can be used to get the content of a compartment in a given state.

@codemirror/view 0.18.1 (2021-03-05)

Bug fixes

Fix an issue where, on iOS, some types of IME would cause the composed content to be deleted when confirming a composition.

@codemirror/state 0.18.0 (2021-03-03)

Breaking changes

tagExtension and the reconfigure transaction spec property have been replaced with the concept of configuration compartments and reconfiguration effects (see Compartment, StateEffect.reconfigure, and StateEffect.appendConfig).

@codemirror/view 0.18.0 (2021-03-03)

Breaking changes

The themeClass function and ``-style selectors in themes are no longer supported (prefixing with cm- should be done manually now).

Themes must now use & (instead of an extra $) to target the editor wrapper element.

The editor no longer adds cm-light or cm-dark classes. Targeting light or dark configurations in base themes should now be done by using a &light or &dark top-level selector.

@codemirror/view 0.17.13 (2021-03-03)

Bug fixes

Work around a Firefox bug where it won't draw the cursor when it is between uneditable elements.

Fix a bug that broke built-in mouse event handling.

@codemirror/language 0.18.0 (2021-03-03)

Breaking changes

Update dependencies to 0.18.

Breaking changes

The Language constructor takes an additional argument that provides the top node type.

New features

Language instances now have a topNode property giving their top node type.

TreeIndentContext now has a continue method that allows an indenter to defer to the indentation of the parent nodes.

@codemirror/commands 0.18.0 (2021-03-03)

Breaking changes

Update dependencies to 0.18.

@codemirror/search 0.18.0 (2021-03-03)

Breaking changes

Update dependencies to 0.18.

@codemirror/autocomplete 0.18.0 (2021-03-03)

Bug fixes

Only preserve selected option across updates when it isn't the first option.

@codemirror/lint 0.18.0 (2021-03-03)

Bug fixes

Make sure action access keys are discoverable for screen reader users.

Selection in the lint panel should now be properly visible to screen readers.

@codemirror/collab 0.18.0 (2021-03-03)

Breaking changes

Update dependencies to 0.18.

@codemirror/language-data 0.18.0 (2021-03-03)

Breaking changes

Update dependencies to 0.18.

codemirror 0.18.0 (2021-03-03)

Breaking changes

Update dependencies to 0.18.

@codemirror/view 0.17.12 (2021-03-02)

Bug fixes

Avoid interfering with touch events, to allow native selection behavior.

Fix a bug that broke sub-selectors with multiple & placeholders in themes.

@codemirror/view 0.17.11 (2021-02-25)

Bug fixes

Fix vertical cursor motion on Safari with a larger line-height.

Fix incorrect selection drawing (with drawSelection) when the selection spans to just after a soft wrap point.

Fix an issue where compositions on Safari were inappropriately aborted in some circumstances.

The view will now redraw when the EditorView.phrases facet changes, to make sure translated text is properly updated.

@codemirror/commands 0.17.5 (2021-02-25)

Bug fixes

Use Alt-l for the default selectLine binding, because Mod-l already has an important meaning in the browser.

Make deleteGroupBackward/deleteGroupForward delete groups of whitespace when bigger than a single space.

Don't change lines that have the end of a range selection directly at their start in indentLess, indentMore, and indentSelection.

@codemirror/view 0.17.10 (2021-02-22)

Fix a crash when the editor was hidden on Safari, due to getClientRects returning an empty list.

Prevent Firefox from making the scrollable element keyboard-focusable.

@codemirror/commands 0.17.3 (2021-02-16)

Bug fixes

Fix an issue where insertNewlineAndIndent behaved strangely with the cursor between brackets that sat on different lines.

@codemirror/view 0.17.7 (2021-01-25)

New features

Add an EditorView.announce state effect that can be used to conveniently provide screen reader announcements.

@codemirror/view 0.17.6 (2021-01-22)

Bug fixes

Avoid creating very high scroll containers for large documents so that we don't overflow the DOM's fixed-precision numbers.

@codemirror/commands 0.17.2 (2021-01-22)

New features

The new insertTab command inserts a tab when nothing is selected, and defers to indentMore otherwise.

The package now exports a defaultTabBinding object that provides a recommended binding for tab (if you must bind tab).

@codemirror/autocomplete 0.17.4 (2021-01-18)

Bug fixes

Fix a styling issue where the selection had become invisible inside snippet fields (when using drawSelection).

New features

Snippet fields can now be selected with the pointing device (so that they are usable on touch devices).

@codemirror/autocomplete 0.17.3 (2021-01-18)

Bug fixes

codemirror 0.17.1 (2021-01-06)

Bug fixes

The highlightStyle function, which defines a highlight style, is now called HighlightStyle.define.

completeSnippets no longer exists. Use completeFromList in combination with snippetCompletion.

The ...Support functions that some language packages exported are gone, since it is now possible to get the support extensions directly from the package's main function.

The language facet now returns an optional single language, not an array anymore.

Languages no longer have getTree and ensureTree methods.

keymap is now a facet, rather than a function, which means you have to use it with keymap.of(...).

The markers option to gutters now takes a view, rather than a state, as argument.

The completionKeymap array now contains more default bindings.

Removes support for Text.iterLines.

Line objects no longer have slice and findClusterBreak methods (use text and the top-level findClusterBreak function instead).

EditorSelection.primary is now called EditorSelection.main.

rectangularSelection now takes its configuration as an object.

A state field's provide option works differently. It now takes a function from the field to an extension. Facet.from has been changed to make it easy to use with this option.

To set an extension's precedence, use the properties of the Prec object instead of the old precedence function.

ViewUpdate.prevState has been renamed to startState.

The gotoLine command is now part of the search package.

highlightActiveLine is now exported from the view package instead of the highlight-selection package.

The highlightSelectionMatches extension is now part of the search package.

Bug fixes

Fix issue where hoverTooltip would falsely believe the mouse was outside of the editor when initialized with the pointer already on the editor.

Drop duplicate completions.

New features

Highlight styles are now instances of an exported HighlightStyle class, which allows you to get at its style module and match it against tags.

The highlight package exports a new function, highlightTree, which runs the tree highlighter over a Lezer tree and tells you which styling should be applied where.

Language objects now have a parseString method that can be used to synchronously parse a string of code in that language.

When configuring an XML schema, it is now possible to provide text to complete into a given element.

Language objects now have a findRegions method that tells you where in the document the language occurs.

Language objects have a new isActiveAt method that tells you whether the language is active at a given point.

The Markdown package now exports two new commands, insertNewlineContinueMarkup and deleteMarkupBackward, to help with editing Markdown.

The new language-data package lists a large number of modes, with some metadata to help locate the one you're interested in.

The language package now exports a LanguageDescription type that can be used to provide metadata about language packages.

The CSS language package now exports a basic CSS completion source.

Language packages' main interface function now returns an instance of LanguageSupport which provides access both to support extensions and the main language.

The new top-level ensureSyntaxTree function in the language package replaces Language.ensureTree.

Facets can now come with extensions that should be enabled when they are present in a state.

The keys used for snippet field navigation are now configurable through the snippetKeymap facet.

The autocomplete package now exports a completeAnyWord function that will gather completions from any words found in the document.

You can now pass defaultKeymap: false to autocompletion to prevent it from adding its default completion keymap.

StateField.init can now be used to provide a custom initial value for a field.

EditorState.toJSON and fromJSON now allow you to opt in to serializing state fields.

Line objects now have a text property holding their entire content.

The new toggleComment command will automatically create a line or block comment depending on what syntax the language supports.

The gotoLine command now allows relative offsets (with + and -), percentages (with a % at the end) and column positions (using : before the column number)

@codemirror/next 0.15.0 (2020-12-04)

Breaking changes

The highlighting system no longer has the concept of a tag system—rather, all tags now exist in the same space.

Highlighting tags are now represented by objects (with the default tag system under tags in the highlight package) rather than strings.

Highlighting styles are now registered separately from the actual highlighter plugin. Syntax addons take care of registering the highlighter. Styles are defined with the highlightStyle function.

The syntax package no longer exists. Its responsibilities have been taken over by the language package.

Language and syntax-related functionality that used to live in the state package (the syntax provider type, props like indentation and foldable) has been moved to the language package.

The stream-syntax package has been renamed to stream-parser, and its interface has been changed to make use of the abstractions provided by the language package.

Providing language data now works differently (the globalLanguageData facet is gone, replaced by a more general languageData facet).

EditorState.tree has been replaced by the syntaxTree function from the language package (since the state package no longer knows about Lezer types).

The ...Syntax exports from language packages have all been renamed to ...Language for consistency with the library's terminology.

Bug fixes

closeBrackets will no longer type-over brackets that it did not itself insert.

Selection drawing in wrapped lines is no longer entirely broken.

Fix an issue where autocompletion wouldn't trigger when an IME composition moved the selection before ending.

Fix a bug where the facet dependency tracking got confused when a dynamic facet depended on another facet that didn't exist in the state.

Querying the coordinates (and thus drawing the cursor) before a block widget no longer crashes.

Fix double-height cursor on line wrap points in Safari.

Actually call ignoreEvent methods on block widgets.

Prevent drawSelection from also hiding the native selection in block widgets.

A text cursor created with Text.iterLines now actually respects the skip parameter.

New Features

The language package now provides most language and parsing related infrastructure. Unlike the old syntax package, it is parse-technique-agnostic. Some of the interfaces that used to live in state, such as the facets and types involved in indentation and folding, have also moved there.

The function passed to changeByRange may now also return effects for each range.

The new State.transactionExtender facet allows you to register functions that add annotations, effects, or reconfiguration to transactions even when they have disabled regular transaction filters.

The new lang-markdown package provides Markdown highlighting.

The foldable function exported from the language package provides an easy way to check whether a given line is foldable.

The getIndentation utility from the language package should now be used to compute automatic indentation for a line. It returns null, as opposed to -1, to indicate that it has no indentation for a given line.

@codemirror/next 0.14.0 (2020-10-23)

Breaking changes

Lezer and lezer-tree have been upgraded to 0.12, which introduces a few breaking changes.

ChangeDesc.mapPos now returns null instead of -1 when reporting a deletion.

EditorView.posAtCoords now returns null, rather than -1, when it fails to find a position.

Bug fixes

Fix an issue where Chrome's shift-enter shortcut confused the editor.

Clicking on the completion list scrollbar no longer selects the first completion.

New features

The lang-json package now exports a jsonParseLinter function that produces a linter based on JSON.parse.

@codemirror/next 0.13.1 (2020-10-14)

Bug fixes

Fix an occasional crash on vertical cursor motion through a scrollable editor.

Fix a bug that caused Change.fromJSON to return invalid change objects in some cases.

Fix a bug where the selection and cursor were drawn in the wrong place in a scrolled editor.

@codemirror/next 0.13.0 (2020-10-01)

Breaking changes

Themes are now specified differently, using plain CSS selectors extended with $ syntax for targeting theme classes. This should make them more flexible.

The style-mod dependency has been upgraded to 3.0, which is a backward-incompatible upgrade.

The multipleSelections extension is no longer supported. You probably want to use drawSelection combined with EditorState.allowMultipleSelections.of(true).

WidgetType no longer takes a type parameter. Implementations are now themselves responsible for creating instance variables and implementing an appropriate eq method.

Drops support for PluginValue.measure (which was very broken already in the previous release).

Bug fixes

The editor no longer loses focus when picking a completion with the mouse.

Fix a bug that caused completion info tooltips to be positioned off-screen.

New features

There is now an SQL language module.

The autocomplete package now exports an ifNotIn helper that can turn off completion sources when the cursor is in a given token type.

There is now a lang-xml package with basic XML support.

ViewUpdate objects now have a geometryChanged getter that tells you whether the geometry of the content changed.

The view module now exports a drawSelection function that creates an extension that overrides the native selection drawing.

Scroll handlers registered view EditorView.domEventHandlers or view plugins will now be called any time the view or an ancestor of the view is scrolled.

DOM event handlers may now return void, for convenience.

There is now a lang-rust package.

The view package now exports a placeholder function that can be used to create a placeholder shown when the editor is empty.

The editor view now has a composing property indicating whether IME is active.

The autocomplete package now exports acceptCompletion and moveCompletionSelection commands.

@codemirror/next 0.12.0 (2020-09-11)

Breaking changes

The way overlapping mark decorations are handled has changed. The editor will now create a separate element for each decoration, and nested them in order of the predecence of the sources that created them (higher precedence wrapping lower precedence, decorations from the state facet wrapping decorations from view plugins).

Registering decorations, event handlers, or other plugin values for a view plugin is now done differently (with an argument to ViewPlugin.define or ViewPlugin.fromClass, rather than method calls on the returned value).

Bug fixes

Vertical cursor motion when the selection isn't empty will now properly collapse it to the appropriate side, rather than moving from the selection head.

Fix the activateOnTyping option to the autocomplete system.

The default backspace binding now deletes by code point, not character.

Tooltips are no longer cut off by scrollable parent elements.

New features

StreamParser now allows an optional tagSystem property to use a custom tag system.

Elements created for mark decorations can now span multiple child elements (raw text, or elements created for lower-precedence marks or widgets).

There is now a lang-java package with a Java syntax.

There is now a dedicated syntax tag for boolean literals ("bool").

Add a C++ syntax.

New commands deleteCodePointForward/Backward.

The editor view now has an inView getter that tells you if the editor is in view at all.

View plugins can now provide a measure method that gets called when the view measures itself.

@codemirror/next 0.11.0 (2020-09-03)

Breaking changes

Autocompletion contexts no longer have a filter method. Completion sources shouldn't filter anymore, but leave that to the plugin.

The filterDownOn property on completion results is now called span.

AutocompleteContext.tokenBefore now takes a list of token type names, and only returns tokens of those types. (In its previous form, it was too error-prone.)

Snippet specs no longer support a name property (use detail instead).

A number of exports from the autocomplete plugin were renamed: autocomplete to autocompletion, AutocompleteContext to CompletionContext, Autocompleter to CompletionSource.

SnippetSpec objects are now a subclass of Completion (which mostly means that their keyword property was renamed to label).

Bug fixes

Fix issue that could cause crashes or incorrectly mapped selections in the history when making changes with addToHistory set to false.

Fuzzy completion matching got a lot more clever, and presents results ordered by match quality.

New features

Text copied linewise will now be inserted as lines above the selection when pasted into an empty selection.

The completion list now shows the matched parts of the strings.

The autocomplete package now exports two new functions, completionStatus and currentCompletions, that let external code query its state.

A new method matchBefore on the autocompletion context can now be used to easily find the text matching a given regexp before the cursor.

Completion contexts now have aborted and addEventListener(abort, ...) properties to allow asynchronous completion queries to stop doing work when cancelled.

Completions now support a detail property to add some extra text after their label.

Completions can now have a boost property to influence the way they are sorted compared to other completions that match the input equally well.

Completions can now have an info property that provides extra information to be shown next to the completion when it is selected.

ChangeSet now has a toJSON method and a static fromJSON method to serialize to and deserialize from JSON.

@codemirror/next 0.10.0 (2020-08-11)

Breaking changes

LezerSyntax instances are now created with LezerSyntax.define instead of new LezerSyntax.

Transaction and change filters are now passed a full transaction as argument.

The ResolvedTransactionSpec type is no longer part of the interface.

The reconfigured property on transactions has been renamed to reconfigure. Similarly, the scrolledIntoView property is now called scrollIntoView.

Editor state objects no longer have an indentWithTabs property.

Bug fixes

Fix an issue where language data at the end of an unfinished nested grammar at the end of the document would use the outer language instead of the inner.

New features

A LezerSyntax instance can now specify a dialect to parse.

Transactions now have a newDoc property that allows you to access the updated document before the new state has been created.

The indentString property on editor states can be used to compute an indentation string of a given column width.

The view package now exports an indentOnInput extension that enables automatic reindentation when certain patterns are typed at the start of a line. The basic setup enables this.

When the cursor is between matching brackets, insertNewlineAndIndent will insert an additional newline after the cursor.

Transaction specs now support a sequential property, which causes them to be interpreted in the document space as produced by earlier specs.

@codemirror/next 0.9.0 (2020-07-30)

Breaking changes

The backspace behavior in the closebrackets package is no longer implicitly included in the extension returned by closeBrackets().

Bug fixes

Fix a crash when running deleteCharBackward when the cursor is at the start of the document.

Fix a bug in Line.slice that would cause it to loop infinitely on long lines.

Make sure the DOM is reset when dispatch fails to update the view.

Fix an issue where double-clicking on a selection in Chrome would leave you with just a cursor, not a selected word.

New features

Highlighting information for a syntax (as in styleTags) can now prefix tag names with ! to make them override the styling of any child nodes for that syntax node.

It is now possible, when specifying syntax highlighting information, to write rules for a node that apply only when its parent nodes are of a given type. This uses / syntax, as in "Declaration/Identifier": "className".

Completion items can now specify a type property that determines the icon shown next to them.

EditorView.inputHandler can now be used to override the way text input (via the DOM) is handled.

The closebrackets package now exports its backspace behavior as a command (deleteBracketPair) and a set of bindings that bind it to backspace as closeBracketsKeymap.

@codemirror/next 0.8.0 (2020-06-29)

Breaking changes

closeBrackets is now a function, rather than an extension value.

The keymap, special-chars, and multiple-selections packages have been merged into the view package.

The way tooltips are declared changed somewhat to fix an issue with tooltips that stay active across document changes.

Assigning precedences to extension is now done using a plain precedence function, rather than a class.

The new state is no longer passed to state field update functions (it is part of the transaction anyway now).

The start and end properties of Line have been renamed to from and to for consistency.

EditorView.lineAt is now called visualLineAt. Its second argument now defaults to 0.

EditorView.lineAtHeight is now called visualLineAtHeight.

The fillConfig utility is no longer part of the library (the library depends on Object.assign now, which provides a standard way to do the same thing).

Completion sources now get all their arguments as properties of the context object.

Language-specific data is now stored in a facet attached to the syntax object, rather than directly in a node prop.

Reconfiguring transactions are now specified in a slightly different way.

Bug fixes

Fix an issue where the selection was unnecessarily moved to the start of the document when clicking on an unfocused editor.

Work around an issue where sometimes the selection would end in the wrong place on Chrome (because the browser reports a different selection from the one it displays.

Fix an issue where disabling the gutter extension would leave its DOM element in the editor.

New features

The EditorView.updateListener facet can be used to have an external function listening for view updates.

The goto-line package now exports a gotoLineKeymap extension.

The new basic-setup package pulls together all the core extensions into a single configuration value.

You can now move through completions with PageUp and PageDown

The editor view now has a setState method to reset its state (again).

The autocomplete package now exports functionality for completing to 'snippets' (longer pieces of text with fields that can be filled in one at a time).

LezerSyntax instances can now directly specify inherent language data (such as comment syntax).

Language packages now export their supporting extensions (if any) as a separate 'support' value.

Autocompletion can now be configured to ask for case-sensitivity.

Completion results can now specify a filterDownOn property to allow the list to be cheaply updated as the user continues typing.

The autocomplete package now exports a completeFromList helper to easily construct a completer from a list of options.

EditorView.dispatch can now be directly called with transaction specs (rather than always calling view.state.update to create its argument).

It is now possible to append extensions from transactions.

Transaction filters can now request the full transaction for the (current) transaction spec if they need it.

@codemirror/next 0.7.1 (2020-06-12)

Bug fixes

Fix an issue where using Enter during composition would insert a newline.

Fix a problem where the library ignored platform-specific key bindings when building a keymap.

@codemirror/next 0.7.0 (2020-06-11)

Breaking changes

EditorView.startMouseSelection has been replaced with the EditorView.mouseSelectionStyle facet, which works somewhat differently.

The indentUnit facet now takes a string, rather than a number, and allows a string of tabs to be specified.

The text package no longer exports isExtendingChar. Use the new cluster break functions instead.

Text direction is now represented as an enum (Direction from the view package) rather than a string.

Selection ranges should be created with EditorSelection.range and EditorSelection.cursor now, rather than directly calling the constructor.

The by-group selection motion commands like moveWordLeft have been renamed to contain 'group' rather than 'word' (moveGroupLeft).

EditorView.movePos has been removed. Use the new cursor motion methods instead.

The keyboard and pointer values for Transaction.userEvent have been renamed keyboardselection and pointerselection.

Commands that move the selection are now prefixed with cursor (cursorCharLeft), and those that extend the selection are prefixed with select (selectGroupForward).

Key bindings are no longer specified as objects, but as arrays of KeyBinding specs, one per binding.

Matching delimiters in syntax trees are now registered with NodeProp.openedBy/closedBy instead of custom props exported from the syntax module.

The lint package's interface was simplified to automatically enable the required extensions when necessary, rather than requiring them to be enabled when configuring the editor.

Bug fixes

Indentation-related commands will now use tabs to indent when appropriate.

The default key bindings on macOS are now a lot closer to how native editor interfaces behave.

New features

The editor view now has a scrollPosIntoView method to scroll a given document position into view.

Add a new package rectangular-selection, which implements rectangle selection on alt-drag.

New indentWithTabs getter on the editor state, which indicates whether indentation should use tabs.

The commands package now exports indentMore and indentLess commands, which unconditionally add/remove indentation on selected lines.

The editor view now has a bidiSpans method to retrieve the text order for a given line.

The text package now exports nextClusterBreak and prevClusterBreak, which can be used to find grapheme cluster breaks in a string.

The new EditorView methods moveByChar, moveByGroup, and moveToLineBoundary can be used to compute cursor motion (in a bidi-aware way).

The view method moveVertically can now be used to compute vertical cursor motion.

Line objects now have a findClusterBreak method for more convenient by-cluster motion.

New commands movePageUp/Down, extendPageUp/Down, deleteGroupForward/Backward.

The view class now has a lineWrapping property that indicates whether line wrapping is enabled for the editor.

EditorView.lineWrapping now holds an extension that enables line wrapping.

Add forward/backward variants of many commands that only support left/right before.

New commands transposeChars, splitLine, and deleteToLineEnd to support macOS's Emacs-style default bindings. New export emacsStyleBaseKeymap that contains these and other Emacs-style bindings.

New commands moveLineBoundaryForward, moveLineBoundaryBackward, extendLineBoundaryForward, and extendLineBoundaryBackward.

New commands extendDocStart and extendDocEnd.

When copying or cutting without a selection, the editor will copy or cut by line.

When pasting N lines while the selection has N active ranges, the editor will now paste one line into each range.

The new EditorState.lineBreak property gives you the proper line break string for a state.

New commands moveLineUp/Down and copyLineUp/Down, bound to Alt-ArrowUp/Down and Shift-Alt-ArrowUp/Down by default.

New command deleteLine, bound to Shift-Mod-k by default.

New commands cursorMatchingBracket and selectMatchingBracket.

It is now possible to customize the DOM element that editor panels are placed into.

The panel extension now has a getPanel accessor to retrieve the panel created by a given constructor function.

New command nextLintDiagnostic to jump to the next linter message.

The new selectParentSyntax command selects the syntax node around the selection.

New commands cursor/selectSyntaxLeft/Right to jump over tokens or bracketed syntactic constructs.

New commands foldAll and unfoldAll.

The fold package now exports a default keymap foldKeymap

The comment package now exports a commentKeymap binding.

New command selectLine.

The new highlightActiveLine extension can be used to style lines with a cursor on them.

New extension highlightSelectionMatches, which enables highlighting of text that matches the current selection.

When defining a highlighter, it is now possible to assign a style to multiple tags by separating them by commas in the property name.

New theme package: theme-one-dark.

Key bindings may now involve multiple key strokes (specified as a space-separated string of key names).

Key bindings that include a preventDefault property will now cause the key event to be stopped even when the bound command(s) return false.

New command: deleteTrailingWhitespace.

New command selectSelectionMatches that selects all instances of the currently selected string.

You can now pass a parent option to a view to append it to the DOM right away.

@codemirror/next 0.6.0 (2020-05-13)

New features

There is now a comment package with commenting/uncommenting commands.

The new collab package implements a framework for collaborative editing.

When creating or updating a state, the selection may now be specified as an {anchor, head?} object literal.

There are new methods toText and sliceDoc on the editor state for working with strings.

Some methods that used to be part of Transaction now have an equivalent on the state object. replaceSelection moved there. changeByRange replaces Transaction.forEachRange. And changes can be used to build up a changeset.

Breaking changes

The Text class interface changed to make better use of its own abstraction. replace takes a Text instance instead of an array of strings, slice now returns a Text, and there's a new append method.

The representation of changes and change sets has been redone. Instead of storing a sequence of change objects, change sets are now a flat map of the locations in the document that changed.

The way transactions work has changed. They are now immutable objects created with EditorState.update.

Transaction filtering works differently now. See the changeFilter and transactionFilter facets.

What used to be extension groups is now called tagged extensions (using the tagExtension function).

mapPos now returns -1 to indicate deletion (when the map mode asks for this).

@codemirror/next 0.5.2 (2020-04-09)

Bug fixes

Fix an issue where external TypeScript builds would try to recompile the library code.

@codemirror/next 0.5.1 (2020-04-08)

Bug fixes

Include the TypeScript declaration files in the npm package.

@codemirror/next 0.5.0 (2020-04-01)

Breaking changes

EditorView.domEventHandlers is now a function, and the handlers receive their arguments in a different order.

Syntax objects no longer have a languageDataAt method (this was moved to EditorState, and changed somewhat).

Completion functions now return a plain list of results, rather than an object.

The interface to EditorState.indentation changed, taking an IndentContext object.

Facets provided by a state field are now declared in an option to StateField.define, instead of in method calls on the field object.

Isolating transactions so that they become their own undo history item is now done with the isolateHistory annotation.

The packages are no longer available as CommonJS files. To run the code on node.js, you'll need node 13 or pass --experimental-modules to node 12.

New features

View plugins now have an eventHandlers method to attach plugin-specific DOM event handlers.

The editor state now has a languageDataAt that collects values stored under a given property name in the main language data and in object attached for a given document type with the addLanguageData facet.

It is now possible to provide indentation functions with information about already-reindented lines through an IndentContext object, making it possible to reindent a region in one go without re-parsing.

Lint sources can now be asynchronous.

The EditorView.editable facet can now be used to control whether the content is editable.

The selectionFilter facet can now be used to control selection updates.

The new changeFilter facet can be used to stop or modify document changes.

Transaction.change now also accepts an array of changes to apply in one go.

The history module now exports a facet that allows you to create inverted effects from a transaction, which will be stored in the history. (This allows making non-document state un/redoable.)

Transactions can now contains state effects, which can describe state changes for extensions, and be integrated with the undo history.

Transactions now have a mapRef method to easily create a position mapping from a given intermediate document to the current document.

@codemirror/next 0.4.0 (2020-02-21)

Breaking Changes

Behavior was renamed to Facet, and works somewhat differently.

The extension package no longer exists. Extension-related concepts are now part of the state package.

The view no longer has its own extension system. It is entirely configured by state extensions.

View plugins are specified through a state facet now, and have a simpler interface.

View plugins may no longer create decorations that significantly impact the height of content, to avoid the cyclic dependency between plugin decorations and the viewport.

Themes work differently now, using static CSS classes on DOM elements so that plugins don't have to update their DOM when the editor theme changes.

Highlighting token types now support a numeric suffix, which replaces the old typeN modifiers.

The interface to syntax extensions and parse trees changed.

The way transaction annotations work was simplified a bit.

Range sets were rewritten and support a somewhat different interface now.

The way decorations are created now separates the creation of the decoration value from the creation of the range to which it should apply.

New features

State facets can provide decorations now.

Reading DOM layout information and similar things is now done with the requestMeasure method.

Facets now explicitly track which fields and other facets they depend on, so that they are recomputed only when necessary.

Any object that has an extension property that holds an extension value may now be used as an extension.

Overlong lines that are inside the viewport will now be partially hidden to speed up rendering and interaction.

The editor view now has a textDirection property telling you whether the main writing direction is left-to-right or right-to-left.

There's now a visibleRanges property that tells you which part of the viewport is actually going to be drawn, speeding up things like highlighting when there's large amounts of collapsed code in the viewport.

Bug fixes

Fix issue where mouse dragging would create selections with the the anchor and head reversed.

Make code folding behave better when the folded node doesn't start on the same line as the actual fold.

Fix a number of issues that would make parsing big files slow (or even lock up entirely).

@codemirror/next 0.3.0 (2019-11-29)

Breaking changes

Language-wide configuration is no longer stored in per-extension node props, but in a single languageData object held in a prop defined in the state package. The Syntax method languageDataAt is used to read it.

Unique extensions no longer exist. Instead, extensions are deduplicated by identity. Merging configurations for an extension should now be done in a behavior.

Bug fixes

Fix issue where starting with an empty editor would break height estimates.

Fix an issue where widgets at the end of a line could stay around after being deleted in some cases.

Fix rendering of lines that are empty except for a widget.

New features

A plugin's drawMeasured method may now return true to request another measure/draw cycle.

The editor view now has a requireMeasure method to schedule a layout check that'll allow plugins to measure and update the DOM.

The state package now re-exports the Text type.

Add an adaptor for connecting ESLint output to the CodeMirror linter package to the lang-javascript package.

The tooltip package provides a way to show tooltip over the editor.

The new autocomplete package implements an autocompletion interface.

The new lint package integrates linting with the editor by underlining issues and providing a list of problems that you can scroll through.

The lang-javascript package now exports an esLint function that can be used to wire up ESLint to the CodeMirror lint integration.

@codemirror/next 0.2.0 (2019-10-28)

Breaking changes

syntaxIndentation no longer has to be registered separately as an extension. It is now implied when registering a tree syntax.

The configuration passed to gutter no longer takes direct class names, but a style option that determines the theme fields used for the gutter.

ViewPlugin instances are now created with a static create method, instead of the constructor.

Declaring custom gutters is now done with a Gutter constructor.

Configuring whether the gutters are fixed is now done with the gutters extension, rather than per individual gutter.

There is now an additional wrapper element around the editor (EditorView.scrollDOM), which is the element that should be targeted with overflow style properties.

EditorView.cssClass no longer accepts space-separated lists of classes.

Slot from the extension package has been replaced with Annotation in the state package. Transaction metadata is now called annotations, and the method names have been updated accordingly.

Command from state was renamed to StateCommand, ViewCommand from view is now called Command.

Bug fixes

Fix a bug where a behavior's combine method wasn't called when the behavior was entirely static.

Fix issue that caused nested replaced decorations to be drawn incorrectly.

ViewUpdate.themeChanged no longer returns the inverse of what it should be returning.

Avoid crash on Firefox when focusing the editor if another form field has focus.

Fixes a bug where changes near replacing decorations would corrupt the editor's view of its height layout.

New features

The new EditorState.foldable behavior provides a way to register code folding services.

Lezer syntax can now register code folding metadata on tree nodes via foldNodeProp.

There is now a fold package with code folding commands (which need the codeFolding extension to be active to work).

EditorView.posFromDOM can now be used to find the document position of a given DOM position.

Gutters can now be themed.

ViewPlugin instances can be extended with dynamic behavior using their behavior and decorations methods.

Gutters can now be passed a handleDOMEvents option that allows client code to register event handlers on them.

You can now iterate over a RangeSet more cheaply with an (internal) iterator using the between method.

Syntax services now have a docTypeAt method that gives you the grammar node around the given point (which may be part of a nesting grammar).

The text package now has replacements for codePointAt and fromCodePoint.

Added a bracket-closing extension in the closebrackets package.

Adds a panel package that contains functionality for showing UI panels at the top or bottom of the editor.

The new search package provides search/replace-related functionality.

Themes and EditorView.cssClass can now target dot-separated more specific versions of a name.

The phrase method on the editor view can now be used to access translation provided with the EditorView.phrases behavior.

Widget toDOM methods are now passed the editor view.

Add EditorView.scrollMargins behavior, which can be used to make the view scroll past regions at the side of the editor when scrolling something into view.

The keymap package now exports a NormalizedKeymap class that can be used to build key handlers on other elements.

@codemirror/next 0.1.0 (2019-10-10)

Breaking Changes

First numbered release.