@codemirror/state 6.5.4 → 6.7.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 6.7.0 (2026-06-23)
+
+### New features
+
+Selection ranges can now be 'undirectional', making selection-expanding commands pick the side that would grow the selection, instead of the given head.
+
+## 6.6.0 (2026-03-12)
+
+### New features
+
+`EditorSelection.range` now takes an optional `assoc` argument.
+
+`SelectionRange.extend` can now be given a third argument to specify associativity.
+
 ## 6.5.4 (2026-01-14)
 
 ### Bug fixes

package/README.md

@@ -1,6 +1,6 @@
 # @codemirror/state [![NPM version](https://img.shields.io/npm/v/@codemirror/state.svg)](https://www.npmjs.org/package/@codemirror/state)
 
-[ [**WEBSITE**](https://codemirror.net/) | [**DOCS**](https://codemirror.net/docs/ref/#state) | [**ISSUES**](https://github.com/codemirror/dev/issues) | [**FORUM**](https://discuss.codemirror.net/c/next/) | [**CHANGELOG**](https://github.com/codemirror/state/blob/main/CHANGELOG.md) ]
+[ [**WEBSITE**](https://codemirror.net/) | [**DOCS**](https://codemirror.net/docs/ref/#state) | [**ISSUES**](https://code.haverbeke.berlin/codemirror/dev/issues) | [**FORUM**](https://discuss.codemirror.net/) | [**CHANGELOG**](https://code.haverbeke.berlin/codemirror/state/src/branch/main/CHANGELOG.md) ]
 
 This package implements the editor state data structures for the
 [CodeMirror](https://codemirror.net/) code editor.
@@ -10,7 +10,7 @@ number of [examples](https://codemirror.net/examples/) and the
 [documentation](https://codemirror.net/docs/).
 
 This code is released under an
-[MIT license](https://github.com/codemirror/state/tree/main/LICENSE).
+[MIT license](https://code.haverbeke.berlin/codemirror/state/tree/main/LICENSE).
 
 We aim to be an inclusive, welcoming community. To make that explicit,
 we have a [code of

package/dist/index.cjs

@@ -1265,10 +1265,18 @@ class SelectionRange {
     /**
     The upper boundary of the range.
     */
-    to, flags) {
+    to, flags, 
+    /**
+    The goal column (stored vertical offset) associated with a
+    cursor. This is used to preserve the vertical position when
+    [moving](https://codemirror.net/6/docs/ref/#view.EditorView.moveVertically) across
+    lines of different length.
+    */
+    goalColumn) {
         this.from = from;
         this.to = to;
         this.flags = flags;
+        this.goalColumn = goalColumn;
     }
     /**
     The anchor of the range—the side that doesn't move when you
@@ -1292,6 +1300,16 @@ class SelectionRange {
     */
     get assoc() { return this.flags & 8 /* RangeFlag.AssocBefore */ ? -1 : this.flags & 16 /* RangeFlag.AssocAfter */ ? 1 : 0; }
     /**
+    A flag that, when set, makes some selection-extending commands
+    treat the range's head and anchor as exchangeable, so that for
+    example Shift-ArrowUp will make the lower side of the selection
+    the anchor, even if that was the head before. Used to implement
+    MacOS-style undirectional selections.
+    */
+    get undirectional() {
+        return (this.flags & 64 /* RangeFlag.Undirectional */) > 0;
+    }
+    /**
     The bidirectional text level associated with this cursor, if
     any.
     */
@@ -1300,16 +1318,6 @@ class SelectionRange {
         return level == 7 ? null : level;
     }
     /**
-    The goal column (stored vertical offset) associated with a
-    cursor. This is used to preserve the vertical position when
-    [moving](https://codemirror.net/6/docs/ref/#view.EditorView.moveVertically) across
-    lines of different length.
-    */
-    get goalColumn() {
-        let value = this.flags >> 6 /* RangeFlag.GoalColumnOffset */;
-        return value == 16777215 /* RangeFlag.NoGoalColumn */ ? undefined : value;
-    }
-    /**
     Map this range through a change, producing a valid range in the
     updated document.
     */
@@ -1322,16 +1330,16 @@ class SelectionRange {
             from = change.mapPos(this.from, 1);
             to = change.mapPos(this.to, -1);
         }
-        return from == this.from && to == this.to ? this : new SelectionRange(from, to, this.flags);
+        return from == this.from && to == this.to ? this : new SelectionRange(from, to, this.flags, this.goalColumn);
     }
     /**
     Extend this range to cover at least `from` to `to`.
     */
-    extend(from, to = from) {
+    extend(from, to = from, assoc = 0) {
         if (from <= this.anchor && to >= this.anchor)
-            return EditorSelection.range(from, to);
+            return EditorSelection.range(from, to, undefined, undefined, assoc);
         let head = Math.abs(from - this.anchor) > Math.abs(to - this.anchor) ? from : to;
-        return EditorSelection.range(this.anchor, head);
+        return EditorSelection.range(this.anchor, head, undefined, undefined, assoc);
     }
     /**
     Compare this range to another range.
@@ -1356,8 +1364,8 @@ class SelectionRange {
     /**
     @internal
     */
-    static create(from, to, flags) {
-        return new SelectionRange(from, to, flags);
+    static create(from, to, flags, goalColumn) {
+        return new SelectionRange(from, to, flags, goalColumn);
     }
 }
 /**
@@ -1472,17 +1480,26 @@ class EditorSelection {
     */
     static cursor(pos, assoc = 0, bidiLevel, goalColumn) {
         return SelectionRange.create(pos, pos, (assoc == 0 ? 0 : assoc < 0 ? 8 /* RangeFlag.AssocBefore */ : 16 /* RangeFlag.AssocAfter */) |
-            (bidiLevel == null ? 7 : Math.min(6, bidiLevel)) |
-            ((goalColumn !== null && goalColumn !== void 0 ? goalColumn : 16777215 /* RangeFlag.NoGoalColumn */) << 6 /* RangeFlag.GoalColumnOffset */));
+            (bidiLevel == null ? 7 : Math.min(6, bidiLevel)), goalColumn);
     }
     /**
     Create a selection range.
     */
-    static range(anchor, head, goalColumn, bidiLevel) {
-        let flags = ((goalColumn !== null && goalColumn !== void 0 ? goalColumn : 16777215 /* RangeFlag.NoGoalColumn */) << 6 /* RangeFlag.GoalColumnOffset */) |
-            (bidiLevel == null ? 7 : Math.min(6, bidiLevel));
-        return head < anchor ? SelectionRange.create(head, anchor, 32 /* RangeFlag.Inverted */ | 16 /* RangeFlag.AssocAfter */ | flags)
-            : SelectionRange.create(anchor, head, (head > anchor ? 8 /* RangeFlag.AssocBefore */ : 0) | flags);
+    static range(anchor, head, goalColumn, bidiLevel, assoc) {
+        let flags = bidiLevel == null ? 7 : Math.min(6, bidiLevel);
+        if (!assoc && anchor != head)
+            assoc = head < anchor ? 1 : -1;
+        if (assoc)
+            flags |= assoc < 0 ? 8 /* RangeFlag.AssocBefore */ : 16 /* RangeFlag.AssocAfter */;
+        return head < anchor ? SelectionRange.create(head, anchor, flags | 32 /* RangeFlag.Inverted */, goalColumn)
+            : SelectionRange.create(anchor, head, flags, goalColumn);
+    }
+    /**
+    Create an [undirectional](https://codemirror.net/6/docs/ref/#state.SelectionRange.undirectional)
+    selection range.
+    */
+    static undirectionalRange(from, to) {
+        return SelectionRange.create(from, to, 64 /* RangeFlag.Undirectional */, undefined);
     }
     /**
     @internal

package/dist/index.d.cts

@@ -358,6 +358,13 @@ declare class SelectionRange {
     */
     readonly to: number;
     private flags;
+    /**
+    The goal column (stored vertical offset) associated with a
+    cursor. This is used to preserve the vertical position when
+    [moving](https://codemirror.net/6/docs/ref/#view.EditorView.moveVertically) across
+    lines of different length.
+    */
+    readonly goalColumn: number | undefined;
     private constructor();
     /**
     The anchor of the range—the side that doesn't move when you
@@ -381,18 +388,19 @@ declare class SelectionRange {
     */
     get assoc(): -1 | 0 | 1;
     /**
+    A flag that, when set, makes some selection-extending commands
+    treat the range's head and anchor as exchangeable, so that for
+    example Shift-ArrowUp will make the lower side of the selection
+    the anchor, even if that was the head before. Used to implement
+    MacOS-style undirectional selections.
+    */
+    get undirectional(): boolean;
+    /**
     The bidirectional text level associated with this cursor, if
     any.
     */
     get bidiLevel(): number | null;
     /**
-    The goal column (stored vertical offset) associated with a
-    cursor. This is used to preserve the vertical position when
-    [moving](https://codemirror.net/6/docs/ref/#view.EditorView.moveVertically) across
-    lines of different length.
-    */
-    get goalColumn(): number | undefined;
-    /**
     Map this range through a change, producing a valid range in the
     updated document.
     */
@@ -400,7 +408,7 @@ declare class SelectionRange {
     /**
     Extend this range to cover at least `from` to `to`.
     */
-    extend(from: number, to?: number): SelectionRange;
+    extend(from: number, to?: number, assoc?: number): SelectionRange;
     /**
     Compare this range to another range.
     */
@@ -488,7 +496,12 @@ declare class EditorSelection {
     /**
     Create a selection range.
     */
-    static range(anchor: number, head: number, goalColumn?: number, bidiLevel?: number): SelectionRange;
+    static range(anchor: number, head: number, goalColumn?: number, bidiLevel?: number, assoc?: number): SelectionRange;
+    /**
+    Create an [undirectional](https://codemirror.net/6/docs/ref/#state.SelectionRange.undirectional)
+    selection range.
+    */
+    static undirectionalRange(from: number, to: number): SelectionRange;
 }
 
 type FacetConfig<Input, Output> = {
@@ -1258,9 +1271,9 @@ 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, side: 0 | 1 | -1) => readonly {
+    static languageData: Facet<(state: EditorState, pos: number, side: -1 | 0 | 1) => readonly {
         [name: string]: any;
-    }[], readonly ((state: EditorState, pos: number, side: 0 | 1 | -1) => readonly {
+    }[], readonly ((state: EditorState, pos: number, side: -1 | 0 | 1) => readonly {
         [name: string]: any;
     }[])[]>;
     /**

package/dist/index.d.ts

@@ -358,6 +358,13 @@ declare class SelectionRange {
     */
     readonly to: number;
     private flags;
+    /**
+    The goal column (stored vertical offset) associated with a
+    cursor. This is used to preserve the vertical position when
+    [moving](https://codemirror.net/6/docs/ref/#view.EditorView.moveVertically) across
+    lines of different length.
+    */
+    readonly goalColumn: number | undefined;
     private constructor();
     /**
     The anchor of the range—the side that doesn't move when you
@@ -381,18 +388,19 @@ declare class SelectionRange {
     */
     get assoc(): -1 | 0 | 1;
     /**
+    A flag that, when set, makes some selection-extending commands
+    treat the range's head and anchor as exchangeable, so that for
+    example Shift-ArrowUp will make the lower side of the selection
+    the anchor, even if that was the head before. Used to implement
+    MacOS-style undirectional selections.
+    */
+    get undirectional(): boolean;
+    /**
     The bidirectional text level associated with this cursor, if
     any.
     */
     get bidiLevel(): number | null;
     /**
-    The goal column (stored vertical offset) associated with a
-    cursor. This is used to preserve the vertical position when
-    [moving](https://codemirror.net/6/docs/ref/#view.EditorView.moveVertically) across
-    lines of different length.
-    */
-    get goalColumn(): number | undefined;
-    /**
     Map this range through a change, producing a valid range in the
     updated document.
     */
@@ -400,7 +408,7 @@ declare class SelectionRange {
     /**
     Extend this range to cover at least `from` to `to`.
     */
-    extend(from: number, to?: number): SelectionRange;
+    extend(from: number, to?: number, assoc?: number): SelectionRange;
     /**
     Compare this range to another range.
     */
@@ -488,7 +496,12 @@ declare class EditorSelection {
     /**
     Create a selection range.
     */
-    static range(anchor: number, head: number, goalColumn?: number, bidiLevel?: number): SelectionRange;
+    static range(anchor: number, head: number, goalColumn?: number, bidiLevel?: number, assoc?: number): SelectionRange;
+    /**
+    Create an [undirectional](https://codemirror.net/6/docs/ref/#state.SelectionRange.undirectional)
+    selection range.
+    */
+    static undirectionalRange(from: number, to: number): SelectionRange;
 }
 
 type FacetConfig<Input, Output> = {
@@ -1258,9 +1271,9 @@ 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, side: 0 | 1 | -1) => readonly {
+    static languageData: Facet<(state: EditorState, pos: number, side: -1 | 0 | 1) => readonly {
         [name: string]: any;
-    }[], readonly ((state: EditorState, pos: number, side: 0 | 1 | -1) => readonly {
+    }[], readonly ((state: EditorState, pos: number, side: -1 | 0 | 1) => readonly {
         [name: string]: any;
     }[])[]>;
     /**

package/dist/index.js

@@ -1262,10 +1262,18 @@ class SelectionRange {
     /**
     The upper boundary of the range.
     */
-    to, flags) {
+    to, flags, 
+    /**
+    The goal column (stored vertical offset) associated with a
+    cursor. This is used to preserve the vertical position when
+    [moving](https://codemirror.net/6/docs/ref/#view.EditorView.moveVertically) across
+    lines of different length.
+    */
+    goalColumn) {
         this.from = from;
         this.to = to;
         this.flags = flags;
+        this.goalColumn = goalColumn;
     }
     /**
     The anchor of the range—the side that doesn't move when you
@@ -1289,6 +1297,16 @@ class SelectionRange {
     */
     get assoc() { return this.flags & 8 /* RangeFlag.AssocBefore */ ? -1 : this.flags & 16 /* RangeFlag.AssocAfter */ ? 1 : 0; }
     /**
+    A flag that, when set, makes some selection-extending commands
+    treat the range's head and anchor as exchangeable, so that for
+    example Shift-ArrowUp will make the lower side of the selection
+    the anchor, even if that was the head before. Used to implement
+    MacOS-style undirectional selections.
+    */
+    get undirectional() {
+        return (this.flags & 64 /* RangeFlag.Undirectional */) > 0;
+    }
+    /**
     The bidirectional text level associated with this cursor, if
     any.
     */
@@ -1297,16 +1315,6 @@ class SelectionRange {
         return level == 7 ? null : level;
     }
     /**
-    The goal column (stored vertical offset) associated with a
-    cursor. This is used to preserve the vertical position when
-    [moving](https://codemirror.net/6/docs/ref/#view.EditorView.moveVertically) across
-    lines of different length.
-    */
-    get goalColumn() {
-        let value = this.flags >> 6 /* RangeFlag.GoalColumnOffset */;
-        return value == 16777215 /* RangeFlag.NoGoalColumn */ ? undefined : value;
-    }
-    /**
     Map this range through a change, producing a valid range in the
     updated document.
     */
@@ -1319,16 +1327,16 @@ class SelectionRange {
             from = change.mapPos(this.from, 1);
             to = change.mapPos(this.to, -1);
         }
-        return from == this.from && to == this.to ? this : new SelectionRange(from, to, this.flags);
+        return from == this.from && to == this.to ? this : new SelectionRange(from, to, this.flags, this.goalColumn);
     }
     /**
     Extend this range to cover at least `from` to `to`.
     */
-    extend(from, to = from) {
+    extend(from, to = from, assoc = 0) {
         if (from <= this.anchor && to >= this.anchor)
-            return EditorSelection.range(from, to);
+            return EditorSelection.range(from, to, undefined, undefined, assoc);
         let head = Math.abs(from - this.anchor) > Math.abs(to - this.anchor) ? from : to;
-        return EditorSelection.range(this.anchor, head);
+        return EditorSelection.range(this.anchor, head, undefined, undefined, assoc);
     }
     /**
     Compare this range to another range.
@@ -1353,8 +1361,8 @@ class SelectionRange {
     /**
     @internal
     */
-    static create(from, to, flags) {
-        return new SelectionRange(from, to, flags);
+    static create(from, to, flags, goalColumn) {
+        return new SelectionRange(from, to, flags, goalColumn);
     }
 }
 /**
@@ -1469,17 +1477,26 @@ class EditorSelection {
     */
     static cursor(pos, assoc = 0, bidiLevel, goalColumn) {
         return SelectionRange.create(pos, pos, (assoc == 0 ? 0 : assoc < 0 ? 8 /* RangeFlag.AssocBefore */ : 16 /* RangeFlag.AssocAfter */) |
-            (bidiLevel == null ? 7 : Math.min(6, bidiLevel)) |
-            ((goalColumn !== null && goalColumn !== void 0 ? goalColumn : 16777215 /* RangeFlag.NoGoalColumn */) << 6 /* RangeFlag.GoalColumnOffset */));
+            (bidiLevel == null ? 7 : Math.min(6, bidiLevel)), goalColumn);
     }
     /**
     Create a selection range.
     */
-    static range(anchor, head, goalColumn, bidiLevel) {
-        let flags = ((goalColumn !== null && goalColumn !== void 0 ? goalColumn : 16777215 /* RangeFlag.NoGoalColumn */) << 6 /* RangeFlag.GoalColumnOffset */) |
-            (bidiLevel == null ? 7 : Math.min(6, bidiLevel));
-        return head < anchor ? SelectionRange.create(head, anchor, 32 /* RangeFlag.Inverted */ | 16 /* RangeFlag.AssocAfter */ | flags)
-            : SelectionRange.create(anchor, head, (head > anchor ? 8 /* RangeFlag.AssocBefore */ : 0) | flags);
+    static range(anchor, head, goalColumn, bidiLevel, assoc) {
+        let flags = bidiLevel == null ? 7 : Math.min(6, bidiLevel);
+        if (!assoc && anchor != head)
+            assoc = head < anchor ? 1 : -1;
+        if (assoc)
+            flags |= assoc < 0 ? 8 /* RangeFlag.AssocBefore */ : 16 /* RangeFlag.AssocAfter */;
+        return head < anchor ? SelectionRange.create(head, anchor, flags | 32 /* RangeFlag.Inverted */, goalColumn)
+            : SelectionRange.create(anchor, head, flags, goalColumn);
+    }
+    /**
+    Create an [undirectional](https://codemirror.net/6/docs/ref/#state.SelectionRange.undirectional)
+    selection range.
+    */
+    static undirectionalRange(from, to) {
+        return SelectionRange.create(from, to, 64 /* RangeFlag.Undirectional */, undefined);
     }
     /**
     @internal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemirror/state",
-  "version": "6.5.4",
+  "version": "6.7.0",
   "description": "Editor state data structures for the CodeMirror code editor",
   "scripts": {
     "test": "cm-runtests",
@@ -33,6 +33,6 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/codemirror/state.git"
+    "url": "git+https://code.haverbeke.berlin/codemirror/state.git"
   }
 }

package/.github/workflows/dispatch.yml

@@ -1,16 +0,0 @@
-name: Trigger CI
-on: push
-
-jobs:
-  build:
-    name: Dispatch to main repo
-    runs-on: ubuntu-latest
-    steps:
-      - name: Emit repository_dispatch
-        uses: mvasigh/dispatch-action@main
-        with:
-          # You should create a personal access token and store it in your repository
-          token: ${{ secrets.DISPATCH_AUTH }}
-          repo: dev
-          owner: codemirror
-          event_type: push