@codemirror/state 0.19.2 → 0.19.3

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 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

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.
+    */
+    high: prec(Prec_.high),
+    /**
+    The highest precedence level, for extensions that should end up
+    near the start of the precedence ordering.
+    */
+    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_.extend),
+    extend: prec(Prec_.high),
     /**
-    Precedence above the `default` and `extend` precedences.
+    Backwards-compatible synonym for `Prec.highest`.
     */
-    override: prec(Prec_.override)
+    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);
@@ -1576,7 +1595,7 @@ class Transaction {
     */
     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] == ".");
+        return !!(e && (e == event || e.length > event.length && e.slice(0, event.length) == event && e[event.length] == "."));
     }
 }
 /**

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;
 };
@@ -783,7 +801,7 @@ declare class Transaction {
     has `"select.pointer"` as user event, `"select"` and
     `"select.pointer"` will match it.
     */
-    isUserEvent(event: string): boolean | "" | undefined;
+    isUserEvent(event: string): boolean;
     /**
     Annotation used to store transaction timestamps.
     */

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.
+    */
+    high: /*@__PURE__*/prec(Prec_.high),
+    /**
+    The highest precedence level, for extensions that should end up
+    near the start of the precedence ordering.
+    */
+    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_.extend),
+    extend: /*@__PURE__*/prec(Prec_.high),
     /**
-    Precedence above the `default` and `extend` precedences.
+    Backwards-compatible synonym for `Prec.highest`.
     */
-    override: /*@__PURE__*/prec(Prec_.override)
+    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);
@@ -1572,7 +1591,7 @@ class Transaction {
     */
     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] == ".");
+        return !!(e && (e == event || e.length > event.length && e.slice(0, event.length) == event && e[event.length] == "."));
     }
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemirror/state",
-  "version": "0.19.2",
+  "version": "0.19.3",
   "description": "Editor state data structures for the CodeMirror code editor",
   "scripts": {
     "test": "cm-runtests",