@codemirror/state 0.18.7 → 0.19.3

package/CHANGELOG.md

@@ -1,3 +1,35 @@
+## 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.
+
+## 0.19.2 (2021-09-13)
+
+### New features
+
+The editor state now has a `readOnly` property with a matching facet to control its value.
+
+## 0.19.1 (2021-08-15)
+
+### Bug fixes
+
+Fix a bug where `wordAt` never returned a useful result.
+
+## 0.19.0 (2021-08-11)
+
+### 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.
+
 ## 0.18.7 (2021-05-04)
 
 ### Bug fixes

package/dist/index.cjs

@@ -1106,7 +1106,7 @@ class StateField {
     */
     get extension() { return this; }
 }
-const Prec_ = { fallback: 3, default: 2, extend: 1, override: 0 };
+const Prec_ = { lowest: 4, low: 3, default: 2, high: 1, highest: 0 };
 function prec(value) {
     return (ext) => new PrecExtension(ext, value);
 }
@@ -1122,23 +1122,42 @@ precedence and then by order within each precedence.
 */
 const Prec = {
     /**
-    A precedence below the default precedence, which will cause
-    default-precedence extensions to override it even if they are
-    specified later in the extension ordering.
+    The lowest precedence level. Meant for things that should end up
+    near the end of the extension order.
     */
-    fallback: prec(Prec_.fallback),
+    lowest: prec(Prec_.lowest),
     /**
-    The regular default precedence.
+    A lower-than-default precedence, for extensions.
+    */
+    low: prec(Prec_.low),
+    /**
+    The default precedence, which is also used for extensions
+    without an explicit precedence.
     */
     default: prec(Prec_.default),
     /**
-    A higher-than-default precedence.
+    A higher-than-default precedence, for extensions that should
+    come before those with default precedence.
     */
-    extend: prec(Prec_.extend),
+    high: prec(Prec_.high),
     /**
-    Precedence above the `default` and `extend` precedences.
+    The highest precedence level, for extensions that should end up
+    near the start of the precedence ordering.
     */
-    override: prec(Prec_.override)
+    highest: prec(Prec_.highest),
+    // FIXME Drop these in some future breaking version
+    /**
+    Backwards-compatible synonym for `Prec.lowest`.
+    */
+    fallback: prec(Prec_.lowest),
+    /**
+    Backwards-compatible synonym for `Prec.high`.
+    */
+    extend: prec(Prec_.high),
+    /**
+    Backwards-compatible synonym for `Prec.highest`.
+    */
+    override: prec(Prec_.highest)
 };
 class PrecExtension {
     constructor(inner, prec) {
@@ -1244,7 +1263,7 @@ class Configuration {
     }
 }
 function flatten(extension, compartments, newCompartments) {
-    let result = [[], [], [], []];
+    let result = [[], [], [], [], []];
     let seen = new Map();
     function inner(ext, prec) {
         let known = seen.get(ext);
@@ -1321,6 +1340,9 @@ const lineSeparator = Facet.define({
 const changeFilter = Facet.define();
 const transactionFilter = Facet.define();
 const transactionExtender = Facet.define();
+const readOnly = Facet.define({
+    combine: values => values.length ? values[0] : false
+});
 
 /**
 Annotations are tagged values that are used to add metadata to
@@ -1564,6 +1586,17 @@ class Transaction {
     [effect](https://codemirror.net/6/docs/ref/#state.StateEffect^reconfigure).
     */
     get reconfigured() { return this.startState.config != this.state.config; }
+    /**
+    Returns true if the transaction has a [user
+    event](https://codemirror.net/6/docs/ref/#state.Transaction^userEvent) annotation that is equal to
+    or more specific than `event`. For example, if the transaction
+    has `"select.pointer"` as user event, `"select"` and
+    `"select.pointer"` will match it.
+    */
+    isUserEvent(event) {
+        let e = this.annotation(Transaction.userEvent);
+        return !!(e && (e == event || e.length > event.length && e.slice(0, event.length) == event && e[event.length] == "."));
+    }
 }
 /**
 Annotation used to store transaction timestamps.
@@ -1571,15 +1604,29 @@ Annotation used to store transaction timestamps.
 Transaction.time = Annotation.define();
 /**
 Annotation used to associate a transaction with a user interface
-event. The view will set this to...
+event. Holds a string identifying the event, using a
+dot-separated format to support attaching more specific
+information. The events used by the core libraries are:
 
- - `"input"` when the user types text
- - `"delete"` when the user deletes the selection or text near the selection
- - `"keyboardselection"` when moving the selection via the keyboard
- - `"pointerselection"` when moving the selection through the pointing device
- - `"paste"` when pasting content
- - `"cut"` when cutting
- - `"drop"` when content is inserted via drag-and-drop
+ - `"input"` when content is entered
+   - `"input.type"` for typed input
+     - `"input.type.compose"` for composition
+   - `"input.paste"` for pasted input
+   - `"input.drop"` when adding content with drag-and-drop
+   - `"input.complete"` when autocompleting
+ - `"delete"` when the user deletes content
+   - `"delete.selection"` when deleting the selection
+   - `"delete.forward"` when deleting forward from the selection
+   - `"delete.backward"` when deleting backward from the selection
+   - `"delete.cut"` when cutting to the clipboard
+ - `"move"` when content is moved
+   - `"move.drop"` when content is moved within the editor through drag-and-drop
+ - `"select"` when explicitly changing the selection
+   - `"select.pointer"` when selecting with a mouse or other pointing device
+ - `"undo"` and `"redo"` for history actions
+
+Use [`isUserEvent`](https://codemirror.net/6/docs/ref/#state.Transaction.isUserEvent) to check
+whether the annotation matches a given event.
 */
 Transaction.userEvent = Annotation.define();
 /**
@@ -1636,13 +1683,15 @@ function mergeTransaction(a, b, sequential) {
     };
 }
 function resolveTransactionInner(state, spec, docSize) {
-    let sel = spec.selection;
+    let sel = spec.selection, annotations = asArray(spec.annotations);
+    if (spec.userEvent)
+        annotations = annotations.concat(Transaction.userEvent.of(spec.userEvent));
     return {
         changes: spec.changes instanceof ChangeSet ? spec.changes
             : ChangeSet.of(spec.changes || [], docSize, state.facet(lineSeparator)),
         selection: sel && (sel instanceof EditorSelection ? sel : EditorSelection.single(sel.anchor, sel.head)),
         effects: asArray(spec.effects),
-        annotations: asArray(spec.annotations),
+        annotations,
         scrollIntoView: !!spec.scrollIntoView
     };
 }
@@ -2015,6 +2064,11 @@ class EditorState {
     */
     get lineBreak() { return this.facet(EditorState.lineSeparator) || "\n"; }
     /**
+    Returns true when the editor is
+    [configured](https://codemirror.net/6/docs/ref/#state.EditorState^readOnly) to be read-only.
+    */
+    get readOnly() { return this.facet(readOnly); }
+    /**
     Look up a translation for the given phrase (via the
     [`phrases`](https://codemirror.net/6/docs/ref/#state.EditorState^phrases) facet), or return the
     original string if no translation is found.
@@ -2029,10 +2083,10 @@ class EditorState {
     Find the values for a given language data field, provided by the
     the [`languageData`](https://codemirror.net/6/docs/ref/#state.EditorState^languageData) facet.
     */
-    languageDataAt(name, pos) {
+    languageDataAt(name, pos, side = -1) {
         let values = [];
         for (let provider of this.facet(languageData)) {
-            for (let result of provider(this, pos)) {
+            for (let result of provider(this, pos, side)) {
                 if (Object.prototype.hasOwnProperty.call(result, name))
                     values.push(result[name]);
             }
@@ -2075,7 +2129,7 @@ class EditorState {
                 break;
             end = next;
         }
-        return start == end ? EditorSelection.range(start + from, end + from) : null;
+        return start == end ? null : EditorSelection.range(start + from, end + from);
     }
 }
 /**
@@ -2106,6 +2160,20 @@ editor without normalizing line separators.
 */
 EditorState.lineSeparator = lineSeparator;
 /**
+This facet controls the value of the
+[`readOnly`](https://codemirror.net/6/docs/ref/#state.EditorState.readOnly) getter, which is
+consulted by commands and extensions that implement editing
+functionality to determine whether they should apply. It
+defaults to false, but when its highest-precedence value is
+`true`, such functionality disables itself.
+
+Not to be confused with
+[`EditorView.editable`](https://codemirror.net/6/docs/ref/#view.EditorView^editable), which
+controls whether the editor's DOM is set to be editable (and
+thus focusable).
+*/
+EditorState.readOnly = readOnly;
+/**
 Registers translation phrases. The
 [`phrase`](https://codemirror.net/6/docs/ref/#state.EditorState.phrase) method will look through
 all objects registered with this facet to find translations for
@@ -2137,9 +2205,10 @@ Facet used to register a hook that gets a chance to update or
 replace transaction specs before they are applied. This will
 only be applied for transactions that don't have
 [`filter`](https://codemirror.net/6/docs/ref/#state.TransactionSpec.filter) set to `false`. You
-can either return a single (possibly the input transaction), or
-an array of specs (which will be combined in the same way as the
-arguments to [`EditorState.update`](https://codemirror.net/6/docs/ref/#state.EditorState.update)).
+can either return a single transaction spec (possibly the input
+transaction), or an array of specs (which will be combined in
+the same way as the arguments to
+[`EditorState.update`](https://codemirror.net/6/docs/ref/#state.EditorState.update)).
 
 When possible, it is recommended to avoid accessing
 [`Transaction.state`](https://codemirror.net/6/docs/ref/#state.Transaction.state) in a filter,

package/dist/index.d.ts

@@ -509,21 +509,39 @@ precedence and then by order within each precedence.
 */
 declare const Prec: {
     /**
-    A precedence below the default precedence, which will cause
-    default-precedence extensions to override it even if they are
-    specified later in the extension ordering.
+    The lowest precedence level. Meant for things that should end up
+    near the end of the extension order.
     */
-    fallback: (ext: Extension) => Extension;
+    lowest: (ext: Extension) => Extension;
+    /**
+    A lower-than-default precedence, for extensions.
+    */
+    low: (ext: Extension) => Extension;
     /**
-    The regular default precedence.
+    The default precedence, which is also used for extensions
+    without an explicit precedence.
     */
     default: (ext: Extension) => Extension;
     /**
-    A higher-than-default precedence.
+    A higher-than-default precedence, for extensions that should
+    come before those with default precedence.
+    */
+    high: (ext: Extension) => Extension;
+    /**
+    The highest precedence level, for extensions that should end up
+    near the start of the precedence ordering.
+    */
+    highest: (ext: Extension) => Extension;
+    /**
+    Backwards-compatible synonym for `Prec.lowest`.
+    */
+    fallback: (ext: Extension) => Extension;
+    /**
+    Backwards-compatible synonym for `Prec.high`.
     */
     extend: (ext: Extension) => Extension;
     /**
-    Precedence above the `default` and `extend` precedences.
+    Backwards-compatible synonym for `Prec.highest`.
     */
     override: (ext: Extension) => Extension;
 };
@@ -683,6 +701,10 @@ interface TransactionSpec {
     */
     annotations?: Annotation<any> | readonly Annotation<any>[];
     /**
+    Shorthand for `annotations: `[`Transaction.userEvent`](https://codemirror.net/6/docs/ref/#state.Transaction^userEvent)[`.of(...)`.
+    */
+    userEvent?: string;
+    /**
     When set to `true`, the transaction is marked as needing to
     scroll the current selection into view.
     */
@@ -773,20 +795,42 @@ declare class Transaction {
     */
     get reconfigured(): boolean;
     /**
+    Returns true if the transaction has a [user
+    event](https://codemirror.net/6/docs/ref/#state.Transaction^userEvent) annotation that is equal to
+    or more specific than `event`. For example, if the transaction
+    has `"select.pointer"` as user event, `"select"` and
+    `"select.pointer"` will match it.
+    */
+    isUserEvent(event: string): boolean;
+    /**
     Annotation used to store transaction timestamps.
     */
     static time: AnnotationType<number>;
     /**
     Annotation used to associate a transaction with a user interface
-    event. The view will set this to...
+    event. Holds a string identifying the event, using a
+    dot-separated format to support attaching more specific
+    information. The events used by the core libraries are:
+    
+     - `"input"` when content is entered
+       - `"input.type"` for typed input
+         - `"input.type.compose"` for composition
+       - `"input.paste"` for pasted input
+       - `"input.drop"` when adding content with drag-and-drop
+       - `"input.complete"` when autocompleting
+     - `"delete"` when the user deletes content
+       - `"delete.selection"` when deleting the selection
+       - `"delete.forward"` when deleting forward from the selection
+       - `"delete.backward"` when deleting backward from the selection
+       - `"delete.cut"` when cutting to the clipboard
+     - `"move"` when content is moved
+       - `"move.drop"` when content is moved within the editor through drag-and-drop
+     - `"select"` when explicitly changing the selection
+       - `"select.pointer"` when selecting with a mouse or other pointing device
+     - `"undo"` and `"redo"` for history actions
     
-     - `"input"` when the user types text
-     - `"delete"` when the user deletes the selection or text near the selection
-     - `"keyboardselection"` when moving the selection via the keyboard
-     - `"pointerselection"` when moving the selection through the pointing device
-     - `"paste"` when pasting content
-     - `"cut"` when cutting
-     - `"drop"` when content is inserted via drag-and-drop
+    Use [`isUserEvent`](https://codemirror.net/6/docs/ref/#state.Transaction.isUserEvent) to check
+    whether the annotation matches a given event.
     */
     static userEvent: AnnotationType<string>;
     /**
@@ -1000,6 +1044,25 @@ declare class EditorState {
     */
     get lineBreak(): string;
     /**
+    This facet controls the value of the
+    [`readOnly`](https://codemirror.net/6/docs/ref/#state.EditorState.readOnly) getter, which is
+    consulted by commands and extensions that implement editing
+    functionality to determine whether they should apply. It
+    defaults to false, but when its highest-precedence value is
+    `true`, such functionality disables itself.
+    
+    Not to be confused with
+    [`EditorView.editable`](https://codemirror.net/6/docs/ref/#view.EditorView^editable), which
+    controls whether the editor's DOM is set to be editable (and
+    thus focusable).
+    */
+    static readOnly: Facet<boolean, boolean>;
+    /**
+    Returns true when the editor is
+    [configured](https://codemirror.net/6/docs/ref/#state.EditorState^readOnly) to be read-only.
+    */
+    get readOnly(): boolean;
+    /**
     Registers translation phrases. The
     [`phrase`](https://codemirror.net/6/docs/ref/#state.EditorState.phrase) method will look through
     all objects registered with this facet to find translations for
@@ -1020,16 +1083,16 @@ declare class EditorState {
     A facet used to register [language
     data](https://codemirror.net/6/docs/ref/#state.EditorState.languageDataAt) providers.
     */
-    static languageData: Facet<(state: EditorState, pos: number) => readonly {
+    static languageData: Facet<(state: EditorState, pos: number, side: 0 | 1 | -1) => readonly {
         [name: string]: any;
-    }[], readonly ((state: EditorState, pos: number) => readonly {
+    }[], readonly ((state: EditorState, pos: number, side: 0 | 1 | -1) => readonly {
         [name: string]: any;
     }[])[]>;
     /**
     Find the values for a given language data field, provided by the
     the [`languageData`](https://codemirror.net/6/docs/ref/#state.EditorState^languageData) facet.
     */
-    languageDataAt<T>(name: string, pos: number): readonly T[];
+    languageDataAt<T>(name: string, pos: number, side?: -1 | 0 | 1): readonly T[];
     /**
     Return a function that can categorize strings (expected to
     represent a single [grapheme cluster](https://codemirror.net/6/docs/ref/#text.findClusterBreak))
@@ -1069,9 +1132,10 @@ declare class EditorState {
     replace transaction specs before they are applied. This will
     only be applied for transactions that don't have
     [`filter`](https://codemirror.net/6/docs/ref/#state.TransactionSpec.filter) set to `false`. You
-    can either return a single (possibly the input transaction), or
-    an array of specs (which will be combined in the same way as the
-    arguments to [`EditorState.update`](https://codemirror.net/6/docs/ref/#state.EditorState.update)).
+    can either return a single transaction spec (possibly the input
+    transaction), or an array of specs (which will be combined in
+    the same way as the arguments to
+    [`EditorState.update`](https://codemirror.net/6/docs/ref/#state.EditorState.update)).
     
     When possible, it is recommended to avoid accessing
     [`Transaction.state`](https://codemirror.net/6/docs/ref/#state.Transaction.state) in a filter,

package/dist/index.js

@@ -1102,7 +1102,7 @@ class StateField {
     */
     get extension() { return this; }
 }
-const Prec_ = { fallback: 3, default: 2, extend: 1, override: 0 };
+const Prec_ = { lowest: 4, low: 3, default: 2, high: 1, highest: 0 };
 function prec(value) {
     return (ext) => new PrecExtension(ext, value);
 }
@@ -1118,23 +1118,42 @@ precedence and then by order within each precedence.
 */
 const Prec = {
     /**
-    A precedence below the default precedence, which will cause
-    default-precedence extensions to override it even if they are
-    specified later in the extension ordering.
+    The lowest precedence level. Meant for things that should end up
+    near the end of the extension order.
     */
-    fallback: /*@__PURE__*/prec(Prec_.fallback),
+    lowest: /*@__PURE__*/prec(Prec_.lowest),
     /**
-    The regular default precedence.
+    A lower-than-default precedence, for extensions.
+    */
+    low: /*@__PURE__*/prec(Prec_.low),
+    /**
+    The default precedence, which is also used for extensions
+    without an explicit precedence.
     */
     default: /*@__PURE__*/prec(Prec_.default),
     /**
-    A higher-than-default precedence.
+    A higher-than-default precedence, for extensions that should
+    come before those with default precedence.
     */
-    extend: /*@__PURE__*/prec(Prec_.extend),
+    high: /*@__PURE__*/prec(Prec_.high),
     /**
-    Precedence above the `default` and `extend` precedences.
+    The highest precedence level, for extensions that should end up
+    near the start of the precedence ordering.
     */
-    override: /*@__PURE__*/prec(Prec_.override)
+    highest: /*@__PURE__*/prec(Prec_.highest),
+    // FIXME Drop these in some future breaking version
+    /**
+    Backwards-compatible synonym for `Prec.lowest`.
+    */
+    fallback: /*@__PURE__*/prec(Prec_.lowest),
+    /**
+    Backwards-compatible synonym for `Prec.high`.
+    */
+    extend: /*@__PURE__*/prec(Prec_.high),
+    /**
+    Backwards-compatible synonym for `Prec.highest`.
+    */
+    override: /*@__PURE__*/prec(Prec_.highest)
 };
 class PrecExtension {
     constructor(inner, prec) {
@@ -1240,7 +1259,7 @@ class Configuration {
     }
 }
 function flatten(extension, compartments, newCompartments) {
-    let result = [[], [], [], []];
+    let result = [[], [], [], [], []];
     let seen = new Map();
     function inner(ext, prec) {
         let known = seen.get(ext);
@@ -1317,6 +1336,9 @@ const lineSeparator = /*@__PURE__*/Facet.define({
 const changeFilter = /*@__PURE__*/Facet.define();
 const transactionFilter = /*@__PURE__*/Facet.define();
 const transactionExtender = /*@__PURE__*/Facet.define();
+const readOnly = /*@__PURE__*/Facet.define({
+    combine: values => values.length ? values[0] : false
+});
 
 /**
 Annotations are tagged values that are used to add metadata to
@@ -1560,6 +1582,17 @@ class Transaction {
     [effect](https://codemirror.net/6/docs/ref/#state.StateEffect^reconfigure).
     */
     get reconfigured() { return this.startState.config != this.state.config; }
+    /**
+    Returns true if the transaction has a [user
+    event](https://codemirror.net/6/docs/ref/#state.Transaction^userEvent) annotation that is equal to
+    or more specific than `event`. For example, if the transaction
+    has `"select.pointer"` as user event, `"select"` and
+    `"select.pointer"` will match it.
+    */
+    isUserEvent(event) {
+        let e = this.annotation(Transaction.userEvent);
+        return !!(e && (e == event || e.length > event.length && e.slice(0, event.length) == event && e[event.length] == "."));
+    }
 }
 /**
 Annotation used to store transaction timestamps.
@@ -1567,15 +1600,29 @@ Annotation used to store transaction timestamps.
 Transaction.time = /*@__PURE__*/Annotation.define();
 /**
 Annotation used to associate a transaction with a user interface
-event. The view will set this to...
+event. Holds a string identifying the event, using a
+dot-separated format to support attaching more specific
+information. The events used by the core libraries are:
 
- - `"input"` when the user types text
- - `"delete"` when the user deletes the selection or text near the selection
- - `"keyboardselection"` when moving the selection via the keyboard
- - `"pointerselection"` when moving the selection through the pointing device
- - `"paste"` when pasting content
- - `"cut"` when cutting
- - `"drop"` when content is inserted via drag-and-drop
+ - `"input"` when content is entered
+   - `"input.type"` for typed input
+     - `"input.type.compose"` for composition
+   - `"input.paste"` for pasted input
+   - `"input.drop"` when adding content with drag-and-drop
+   - `"input.complete"` when autocompleting
+ - `"delete"` when the user deletes content
+   - `"delete.selection"` when deleting the selection
+   - `"delete.forward"` when deleting forward from the selection
+   - `"delete.backward"` when deleting backward from the selection
+   - `"delete.cut"` when cutting to the clipboard
+ - `"move"` when content is moved
+   - `"move.drop"` when content is moved within the editor through drag-and-drop
+ - `"select"` when explicitly changing the selection
+   - `"select.pointer"` when selecting with a mouse or other pointing device
+ - `"undo"` and `"redo"` for history actions
+
+Use [`isUserEvent`](https://codemirror.net/6/docs/ref/#state.Transaction.isUserEvent) to check
+whether the annotation matches a given event.
 */
 Transaction.userEvent = /*@__PURE__*/Annotation.define();
 /**
@@ -1632,13 +1679,15 @@ function mergeTransaction(a, b, sequential) {
     };
 }
 function resolveTransactionInner(state, spec, docSize) {
-    let sel = spec.selection;
+    let sel = spec.selection, annotations = asArray(spec.annotations);
+    if (spec.userEvent)
+        annotations = annotations.concat(Transaction.userEvent.of(spec.userEvent));
     return {
         changes: spec.changes instanceof ChangeSet ? spec.changes
             : ChangeSet.of(spec.changes || [], docSize, state.facet(lineSeparator)),
         selection: sel && (sel instanceof EditorSelection ? sel : EditorSelection.single(sel.anchor, sel.head)),
         effects: asArray(spec.effects),
-        annotations: asArray(spec.annotations),
+        annotations,
         scrollIntoView: !!spec.scrollIntoView
     };
 }
@@ -2010,6 +2059,11 @@ class EditorState {
     */
     get lineBreak() { return this.facet(EditorState.lineSeparator) || "\n"; }
     /**
+    Returns true when the editor is
+    [configured](https://codemirror.net/6/docs/ref/#state.EditorState^readOnly) to be read-only.
+    */
+    get readOnly() { return this.facet(readOnly); }
+    /**
     Look up a translation for the given phrase (via the
     [`phrases`](https://codemirror.net/6/docs/ref/#state.EditorState^phrases) facet), or return the
     original string if no translation is found.
@@ -2024,10 +2078,10 @@ class EditorState {
     Find the values for a given language data field, provided by the
     the [`languageData`](https://codemirror.net/6/docs/ref/#state.EditorState^languageData) facet.
     */
-    languageDataAt(name, pos) {
+    languageDataAt(name, pos, side = -1) {
         let values = [];
         for (let provider of this.facet(languageData)) {
-            for (let result of provider(this, pos)) {
+            for (let result of provider(this, pos, side)) {
                 if (Object.prototype.hasOwnProperty.call(result, name))
                     values.push(result[name]);
             }
@@ -2070,7 +2124,7 @@ class EditorState {
                 break;
             end = next;
         }
-        return start == end ? EditorSelection.range(start + from, end + from) : null;
+        return start == end ? null : EditorSelection.range(start + from, end + from);
     }
 }
 /**
@@ -2101,6 +2155,20 @@ editor without normalizing line separators.
 */
 EditorState.lineSeparator = lineSeparator;
 /**
+This facet controls the value of the
+[`readOnly`](https://codemirror.net/6/docs/ref/#state.EditorState.readOnly) getter, which is
+consulted by commands and extensions that implement editing
+functionality to determine whether they should apply. It
+defaults to false, but when its highest-precedence value is
+`true`, such functionality disables itself.
+
+Not to be confused with
+[`EditorView.editable`](https://codemirror.net/6/docs/ref/#view.EditorView^editable), which
+controls whether the editor's DOM is set to be editable (and
+thus focusable).
+*/
+EditorState.readOnly = readOnly;
+/**
 Registers translation phrases. The
 [`phrase`](https://codemirror.net/6/docs/ref/#state.EditorState.phrase) method will look through
 all objects registered with this facet to find translations for
@@ -2132,9 +2200,10 @@ Facet used to register a hook that gets a chance to update or
 replace transaction specs before they are applied. This will
 only be applied for transactions that don't have
 [`filter`](https://codemirror.net/6/docs/ref/#state.TransactionSpec.filter) set to `false`. You
-can either return a single (possibly the input transaction), or
-an array of specs (which will be combined in the same way as the
-arguments to [`EditorState.update`](https://codemirror.net/6/docs/ref/#state.EditorState.update)).
+can either return a single transaction spec (possibly the input
+transaction), or an array of specs (which will be combined in
+the same way as the arguments to
+[`EditorState.update`](https://codemirror.net/6/docs/ref/#state.EditorState.update)).
 
 When possible, it is recommended to avoid accessing
 [`Transaction.state`](https://codemirror.net/6/docs/ref/#state.Transaction.state) in a filter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemirror/state",
-  "version": "0.18.7",
+  "version": "0.19.3",
   "description": "Editor state data structures for the CodeMirror code editor",
   "scripts": {
     "test": "cm-runtests",
@@ -26,7 +26,7 @@
   "sideEffects": false,
   "license": "MIT",
   "dependencies": {
-    "@codemirror/text": "^0.18.0"
+    "@codemirror/text": "^0.19.0"
   },
   "devDependencies": {
     "@codemirror/buildhelper": "^0.1.5"