@dxos/ui-editor 0.8.4-main.abd8ff62ef → 0.8.4-main.bc2380dfbc

package/dist/lib/browser/index.mjs

@@ -363,30 +363,37 @@ var insertAtLineStart = (view, from, insert) => {
 };
 
 // src/extensions/autocomplete/placeholder.ts
-var placeholder = ({ content, delay = 3e3 }) => {
+var placeholder = ({ content, delay = 3e3, focusOnly = false }) => {
   const plugin = ViewPlugin3.fromClass(class {
     _timeout;
     _decorations = Decoration3.none;
     update(update2) {
+      if (!update2.docChanged && !update2.selectionSet && !update2.focusChanged) {
+        return;
+      }
       if (this._timeout) {
         window.clearTimeout(this._timeout);
         this._timeout = void 0;
       }
+      this._decorations = Decoration3.none;
+      if (focusOnly && !update2.view.hasFocus) {
+        return;
+      }
       const activeLine = update2.view.state.doc.lineAt(update2.view.state.selection.main.head);
-      const isEmpty = activeLine.text.trim() === "";
-      if (isEmpty) {
-        const lineStart = activeLine.from;
-        this._timeout = setTimeout(() => {
-          this._decorations = Decoration3.set([
-            Decoration3.widget({
-              widget: new PlaceholderWidget(content),
-              side: 1
-            }).range(lineStart)
-          ]);
-          update2.view.update([]);
-        }, delay);
+      if (activeLine.text.trim() !== "") {
+        return;
       }
-      this._decorations = Decoration3.none;
+      const lineStart = activeLine.from;
+      const view = update2.view;
+      this._timeout = setTimeout(() => {
+        this._decorations = Decoration3.set([
+          Decoration3.widget({
+            widget: new PlaceholderWidget(content),
+            side: 1
+          }).range(lineStart)
+        ]);
+        view.update([]);
+      }, delay);
     }
     destroy() {
       if (this._timeout) {
@@ -504,341 +511,10 @@ var typeahead = ({ onComplete } = {}) => {
   ];
 };
 
-// src/extensions/auto-scroll.ts
-import { StateEffect as StateEffect2 } from "@codemirror/state";
-import { EditorView as EditorView5, ViewPlugin as ViewPlugin6 } from "@codemirror/view";
-import { addEventListener, combine, throttle } from "@dxos/async";
-import { Domino } from "@dxos/ui";
-import { getSize } from "@dxos/ui-theme";
-
-// src/extensions/scroller.ts
-import { StateEffect } from "@codemirror/state";
-import { EditorView as EditorView4, ViewPlugin as ViewPlugin5 } from "@codemirror/view";
-import { log as log2 } from "@dxos/log";
-var __dxlog_file2 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/scroller.ts";
-var scrollerLineEffect = StateEffect.define();
-var scrollerCrawlEffect = StateEffect.define();
-var scrollToLine = (view, options) => {
-  view.dispatch({
-    effects: scrollerLineEffect.of(options)
-  });
-};
-var scroller = ({ overScroll = 0 } = {}) => {
-  const scrollPlugin = ViewPlugin5.fromClass(class ScrollerPlugin {
-    view;
-    crawler;
-    constructor(view) {
-      this.view = view;
-      this.crawler = createCrawler(this.view);
-    }
-    // No-op.
-    destroy() {
-      this.crawler.cancel();
-    }
-    cancel() {
-      this.crawler.cancel();
-    }
-    crawl(start = false) {
-      if (start) {
-        this.crawler.scroll();
-      } else {
-        this.crawler.cancel();
-      }
-    }
-    scroll({ line, offset = 0, position, behavior = "instant" }) {
-      const { scrollTop, scrollHeight, clientHeight } = this.view.scrollDOM;
-      const scrollerRect = this.view.scrollDOM.getBoundingClientRect();
-      const doc = this.view.state.doc;
-      let targetScrollTop = scrollHeight - clientHeight + offset;
-      if (line >= 0 && line <= doc.lines - 1) {
-        const lineStart = doc.line(line + 1).from;
-        const coords = this.view.coordsAtPos(lineStart);
-        if (coords) {
-          const currentScrollTop = scrollTop;
-          const maxScrollTop = scrollHeight - clientHeight;
-          if (position === "end") {
-            targetScrollTop = currentScrollTop + coords.bottom - scrollerRect.bottom + offset;
-          } else {
-            targetScrollTop = currentScrollTop + coords.top - scrollerRect.top + offset;
-          }
-          targetScrollTop = Math.max(0, Math.min(targetScrollTop, maxScrollTop));
-        }
-      }
-      requestAnimationFrame(() => {
-        this.view.scrollDOM.scrollTo({
-          top: targetScrollTop
-        });
-      });
-    }
-  });
-  return [
-    scrollPlugin,
-    // Listen for effect.s
-    EditorView4.updateListener.of((update2) => {
-      update2.transactions.forEach((transaction) => {
-        try {
-          const plugin = update2.view.plugin(scrollPlugin);
-          if (plugin) {
-            for (const effect of transaction.effects) {
-              if (effect.is(scrollerCrawlEffect)) {
-                plugin.crawl(effect.value);
-              } else if (effect.is(scrollerLineEffect)) {
-                plugin.scroll(effect.value);
-              }
-            }
-          }
-        } catch (err) {
-          log2.catch(err, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 91, S: void 0 });
-        }
-      });
-    }),
-    // Styles.
-    EditorView4.theme({
-      ".cm-scroller": {
-        overflowY: "scroll",
-        // Browser scroll-anchoring: when widgets above the viewport resize (e.g. tool blocks
-        // expanding their TogglePanel), the browser picks a stable element near the viewport
-        // top and adjusts `scrollTop` so the user's view doesn't jump. Auto-scroll's pinning
-        // logic still has the final word when pinned (forces scrollTop to scrollHeight).
-        overflowAnchor: "auto"
-      },
-      ".cm-scroller.cm-hide-scrollbar::-webkit-scrollbar": {
-        display: "none"
-      },
-      ".cm-scroller::-webkit-scrollbar-thumb": {
-        background: "transparent",
-        transition: "background 0.15s"
-      },
-      "&:hover .cm-scroller::-webkit-scrollbar-thumb": {
-        background: "var(--color-scrollbar-thumb)"
-      },
-      // Spacer below the last text line. Implemented as a real block pseudo-element
-      // (rather than `padding-bottom` on `.cm-content`) so it materializes in the
-      // scroller's `scrollHeight` regardless of how `padding` is reset by the base
-      // theme or downstream classes — this is what gives auto-scroll its head-room
-      // so the last line stays `overScroll` px above the viewport bottom.
-      ".cm-content::after": {
-        content: '""',
-        display: "block",
-        height: `${overScroll}px`
-      },
-      ".cm-scroll-button": {
-        position: "absolute",
-        bottom: "0.5rem",
-        right: "1rem"
-      }
-    })
-  ];
-};
-function createCrawler(view, omega = 5, snapThreshold = 5, snapVelocity = 50) {
-  const el = view.scrollDOM;
-  let currentTop = 0;
-  let velocity = 0;
-  let rafId = null;
-  let lastTime = 0;
-  function frame(now) {
-    const dt = lastTime === 0 ? 1 / 60 : Math.min(0.1, (now - lastTime) / 1e3);
-    lastTime = now;
-    const targetTop = el.scrollHeight - el.clientHeight;
-    const delta = targetTop - currentTop;
-    if (Math.abs(delta) < snapThreshold && Math.abs(velocity) < snapVelocity) {
-      el.scrollTop = targetTop;
-      currentTop = targetTop;
-      velocity = 0;
-      rafId = null;
-      lastTime = 0;
-      return;
-    }
-    const accel = omega * omega * delta - 2 * omega * velocity;
-    velocity += accel * dt;
-    currentTop += velocity * dt;
-    el.scrollTop = currentTop;
-    rafId = requestAnimationFrame(frame);
-  }
-  return {
-    scroll: () => {
-      if (rafId === null) {
-        currentTop = el.scrollTop;
-        lastTime = 0;
-        rafId = requestAnimationFrame(frame);
-      }
-    },
-    cancel: () => {
-      if (rafId !== null) {
-        cancelAnimationFrame(rafId);
-        velocity = 0;
-        lastTime = 0;
-        rafId = null;
-      }
-    }
-  };
-}
-
-// src/extensions/auto-scroll.ts
-var autoScrollEffect = StateEffect2.define();
-var autoScroll = ({ scrollOnResize = true } = {}) => {
-  let buttonContainer;
-  let isPinned = true;
-  let jumpPending = false;
-  let enabled = true;
-  let firstUpdate = true;
-  const setPinned = (pinned) => {
-    buttonContainer?.classList.toggle("opacity-0", pinned);
-    isPinned = pinned;
-  };
-  return [
-    // Update listener for scrolling when content changes.
-    EditorView5.updateListener.of((update2) => {
-      const { view, heightChanged, state, startState } = update2;
-      for (const tr of update2.transactions) {
-        for (const effect of tr.effects) {
-          if (effect.is(autoScrollEffect)) {
-            enabled = effect.value;
-            if (enabled) {
-              setPinned(true);
-              view.dispatch({
-                effects: scrollerCrawlEffect.of(true)
-              });
-            } else {
-              view.dispatch({
-                effects: scrollerCrawlEffect.of(false)
-              });
-            }
-          }
-        }
-      }
-      if (!enabled) {
-        return;
-      }
-      if (isPinned && (firstUpdate || startState.doc.length === 0) && state.doc.length > 0) {
-        firstUpdate = false;
-        jumpPending = true;
-        requestAnimationFrame(() => {
-          view.scrollDOM.scrollTop = view.scrollDOM.scrollHeight;
-          jumpPending = false;
-        });
-        return;
-      }
-      firstUpdate = false;
-      if (jumpPending) {
-        return;
-      }
-      if (heightChanged) {
-        if (isPinned) {
-          const { scrollTop, scrollHeight, clientHeight } = view.scrollDOM;
-          const delta = scrollHeight - scrollTop - clientHeight;
-          if (delta > 0) {
-            setPinned(true);
-            view.dispatch({
-              effects: scrollerCrawlEffect.of(true)
-            });
-          } else if (delta < -1) {
-            setPinned(false);
-          }
-        } else {
-          if (state.doc.length === 0) {
-            setPinned(true);
-          }
-        }
-      }
-    }),
-    // Re-pin and jump to bottom when the scroll container itself resizes (e.g. sidebar toggle,
-    // window resize). Doc-driven height changes are handled by the updateListener above; this
-    // observer covers the case where the viewport changes while the doc length is unchanged.
-    scrollOnResize ? ViewPlugin6.fromClass(class {
-      observer;
-      firstObservation = true;
-      destroyed = false;
-      constructor(view) {
-        const onResize = throttle(() => {
-          if (this.destroyed || !enabled) {
-            return;
-          }
-          setPinned(true);
-          requestAnimationFrame(() => {
-            if (this.destroyed) {
-              return;
-            }
-            view.scrollDOM.scrollTop = view.scrollDOM.scrollHeight;
-            view.dispatch({
-              effects: scrollerCrawlEffect.of(true)
-            });
-          });
-        }, 100);
-        this.observer = new ResizeObserver(() => {
-          if (this.firstObservation) {
-            this.firstObservation = false;
-            return;
-          }
-          onResize();
-        });
-        this.observer.observe(view.scrollDOM);
-      }
-      destroy() {
-        this.destroyed = true;
-        this.observer.disconnect();
-      }
-    }) : [],
-    // Detect user scroll and unpin (or re-pin if scrolled to the bottom).
-    ViewPlugin6.fromClass(class {
-      cleanup;
-      constructor(view) {
-        this.cleanup = createUserScrollDetector(view.scrollDOM, throttle(() => {
-          requestAnimationFrame(() => {
-            const { scrollTop, scrollHeight, clientHeight } = view.scrollDOM;
-            const delta = scrollHeight - scrollTop - clientHeight;
-            const pinned = delta === 0;
-            setPinned(pinned);
-            if (!pinned) {
-              view.dispatch({
-                effects: scrollerCrawlEffect.of(false)
-              });
-            }
-          });
-        }, 500));
-      }
-      destroy() {
-        this.cleanup();
-      }
-    }),
-    // Scroll button.
-    ViewPlugin6.fromClass(class {
-      constructor(view) {
-        const icon = Domino.of("dx-icon").classNames(getSize(4)).attributes({
-          icon: "ph--arrow-down--regular"
-        });
-        const button = Domino.of("button").classNames("dx-button bg-accent-surface").attributes({
-          "data-density": "fine"
-        }).append(icon).on("click", () => {
-          setPinned(true);
-          view.dispatch({
-            effects: scrollerLineEffect.of({
-              line: -1,
-              position: "end",
-              behavior: "smooth"
-            })
-          });
-        });
-        buttonContainer = Domino.of("div").classNames("cm-scroll-button transition-opacity duration-300 opacity-0").append(button).root;
-        view.scrollDOM.parentElement.appendChild(buttonContainer);
-      }
-    })
-  ];
-};
-function createUserScrollDetector(element, onUserScroll) {
-  return combine(addEventListener(element, "wheel", () => onUserScroll(), {
-    passive: true
-  }), addEventListener(element, "pointerdown", (event) => {
-    if (event.clientX > element.getBoundingClientRect().right - (element.offsetWidth - element.clientWidth)) {
-      onUserScroll();
-    }
-  }));
-}
-
 // src/extensions/automerge/automerge.ts
 import { next as A3 } from "@automerge/automerge";
 import { StateField, Transaction as Transaction2 } from "@codemirror/state";
-import { EditorView as EditorView6, ViewPlugin as ViewPlugin7 } from "@codemirror/view";
+import { EditorView as EditorView4, ViewPlugin as ViewPlugin5 } from "@codemirror/view";
 import { DocAccessor } from "@dxos/echo-db";
 
 // src/extensions/state.ts
@@ -847,14 +523,14 @@ var initialSync = Transaction.userEvent.of("initial.sync");
 
 // src/extensions/automerge/cursor.ts
 import { fromCursor, toCursor } from "@dxos/echo-db";
-import { log as log3 } from "@dxos/log";
-var __dxlog_file3 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/automerge/cursor.ts";
+import { log as log2 } from "@dxos/log";
+var __dxlog_file2 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/automerge/cursor.ts";
 var cursorConverter = (accessor) => ({
   toCursor: (pos, assoc) => {
     try {
       return toCursor(accessor, pos, assoc);
     } catch (err) {
-      log3.catch(err, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file3, L: 11, S: void 0 });
+      log2.catch(err, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 11, S: void 0 });
       return "";
     }
   },
@@ -862,17 +538,17 @@ var cursorConverter = (accessor) => ({
     try {
       return fromCursor(accessor, cursor);
     } catch (err) {
-      log3.catch(err, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file3, L: 19, S: void 0 });
+      log2.catch(err, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 19, S: void 0 });
       return 0;
     }
   }
 });
 
 // src/extensions/automerge/defs.ts
-import { Annotation, StateEffect as StateEffect3 } from "@codemirror/state";
+import { Annotation, StateEffect } from "@codemirror/state";
 var getPath = (state, field) => state.field(field).path;
 var getLastHeads = (state, field) => state.field(field).lastHeads;
-var updateHeadsEffect = StateEffect3.define({});
+var updateHeadsEffect = StateEffect.define({});
 var updateHeads = (newHeads) => updateHeadsEffect.of({
   newHeads
 });
@@ -883,7 +559,7 @@ var isReconcile = (tr) => {
 
 // src/extensions/automerge/sync.ts
 import { next as A2 } from "@automerge/automerge";
-import { log as log4 } from "@dxos/log";
+import { log as log3 } from "@dxos/log";
 
 // src/extensions/automerge/update-automerge.ts
 import { next as A } from "@automerge/automerge";
@@ -1024,7 +700,7 @@ var charPath = (textPath, candidatePath) => {
 };
 
 // src/extensions/automerge/sync.ts
-var __dxlog_file4 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/automerge/sync.ts";
+var __dxlog_file3 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/automerge/sync.ts";
 var Syncer = class {
   _handle;
   _state;
@@ -1047,7 +723,7 @@ var Syncer = class {
     this._pending = false;
   }
   onEditorChange(view) {
-    log4("onEditorChange", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file4, L: 35, S: this });
+    log3("onEditorChange", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file3, L: 35, S: this });
     const transactions = view.state.field(this._state).unreconciledTransactions.filter((tx) => !isReconcile(tx));
     const newHeads = updateAutomerge(this._state, this._handle, transactions, view.state);
     if (newHeads) {
@@ -1058,7 +734,7 @@ var Syncer = class {
     }
   }
   onAutomergeChange(view) {
-    log4("onAutomergeChange", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file4, L: 47, S: this });
+    log3("onAutomergeChange", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file3, L: 47, S: this });
     const oldHeads = getLastHeads(view.state, this._state);
     const newHeads = A2.getHeads(this._handle.doc());
     const diff = A2.equals(oldHeads, newHeads) ? [] : A2.diff(this._handle.doc(), oldHeads, newHeads);
@@ -1111,7 +787,7 @@ var automerge = (accessor) => {
     // Track heads.
     syncState,
     // Reconcile external updates.
-    ViewPlugin7.fromClass(class {
+    ViewPlugin5.fromClass(class {
       _view;
       constructor(_view) {
         this._view = _view;
@@ -1142,7 +818,7 @@ var automerge = (accessor) => {
       };
     }),
     // Reconcile local updates.
-    EditorView6.updateListener.of(({ view, changes, transactions }) => {
+    EditorView4.updateListener.of(({ view, changes, transactions }) => {
       if (!changes.empty) {
         const isInitialSync = transactions.some((tr) => tr.annotation(Transaction2.userEvent) === initialSync.value);
         if (!isInitialSync) {
@@ -1155,10 +831,10 @@ var automerge = (accessor) => {
 
 // src/extensions/awareness/awareness.ts
 import { Annotation as Annotation2, RangeSet } from "@codemirror/state";
-import { Decoration as Decoration5, EditorView as EditorView7, ViewPlugin as ViewPlugin8, WidgetType as WidgetType3 } from "@codemirror/view";
+import { Decoration as Decoration5, EditorView as EditorView5, ViewPlugin as ViewPlugin6, WidgetType as WidgetType3 } from "@codemirror/view";
 import { Event } from "@dxos/async";
 import { Context } from "@dxos/context";
-var __dxlog_file5 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/awareness/awareness.ts";
+var __dxlog_file4 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/awareness/awareness.ts";
 var dummyProvider = {
   remoteStateChange: new Event(),
   open: () => {
@@ -1174,14 +850,14 @@ var RemoteSelectionChangedAnnotation = Annotation2.define();
 var awareness = (provider = dummyProvider) => {
   return [
     awarenessProvider.of(provider),
-    ViewPlugin8.fromClass(RemoteSelectionsDecorator, {
+    ViewPlugin6.fromClass(RemoteSelectionsDecorator, {
       decorations: (value) => value.decorations
     }),
     styles
   ];
 };
 var RemoteSelectionsDecorator = class {
-  _ctx = new Context(void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file5, L: 33 });
+  _ctx = new Context(void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file4, L: 33 });
   _cursorConverter;
   _provider;
   _lastAnchor;
@@ -1330,7 +1006,7 @@ var RemoteCaretWidget = class extends WidgetType3 {
     return true;
   }
 };
-var styles = EditorView7.theme({
+var styles = EditorView5.theme({
   ".cm-collab-selection": {},
   ".cm-collab-selectionLine": {
     padding: 0,
@@ -1392,8 +1068,8 @@ var styles = EditorView7.theme({
 import { DeferredTask, Event as Event2, sleep } from "@dxos/async";
 import { Context as Context2 } from "@dxos/context";
 import { invariant } from "@dxos/invariant";
-import { log as log5 } from "@dxos/log";
-var __dxlog_file6 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/awareness/awareness-provider.ts";
+import { log as log4 } from "@dxos/log";
+var __dxlog_file5 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/awareness/awareness-provider.ts";
 var DEBOUNCE_INTERVAL = 100;
 var SpaceAwarenessProvider = class {
   _remoteStates = /* @__PURE__ */ new Map();
@@ -1412,7 +1088,7 @@ var SpaceAwarenessProvider = class {
     this._info = info;
   }
   open() {
-    this._ctx = new Context2(void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file6, L: 28 });
+    this._ctx = new Context2(void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file5, L: 28 });
     this._postTask = new DeferredTask(this._ctx, async () => {
       if (this._localState) {
         await this._messenger.postMessage(this._channel, {
@@ -1437,9 +1113,9 @@ var SpaceAwarenessProvider = class {
     void this._messenger.postMessage(this._channel, {
       kind: "query"
     }).catch((err) => {
-      log5.debug("failed to query awareness", {
+      log4.debug("failed to query awareness", {
         err
-      }, { "~LogMeta": "~LogMeta", F: __dxlog_file6, L: 57, S: this });
+      }, { "~LogMeta": "~LogMeta", F: __dxlog_file5, L: 57, S: this });
     });
   }
   close() {
@@ -1451,7 +1127,7 @@ var SpaceAwarenessProvider = class {
     return Array.from(this._remoteStates.values());
   }
   update(position) {
-    invariant(this._postTask, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file6, L: 71, S: this, A: ["this._postTask", ""] });
+    invariant(this._postTask, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file5, L: 71, S: this, A: ["this._postTask", ""] });
     this._localState = {
       peerId: this._peerId,
       position,
@@ -1460,22 +1136,22 @@ var SpaceAwarenessProvider = class {
     this._postTask.schedule();
   }
   _handleQueryMessage() {
-    invariant(this._postTask, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file6, L: 80, S: this, A: ["this._postTask", ""] });
+    invariant(this._postTask, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file5, L: 80, S: this, A: ["this._postTask", ""] });
     this._postTask.schedule();
   }
   _handlePostMessage(message) {
-    invariant(message.kind === "post", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file6, L: 84, S: this, A: ["message.kind === 'post'", ""] });
+    invariant(message.kind === "post", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file5, L: 84, S: this, A: ["message.kind === 'post'", ""] });
     this._remoteStates.set(message.state.peerId, message.state);
     this.remoteStateChange.emit();
   }
 };
 
 // src/extensions/blast.ts
-import { EditorView as EditorView8, keymap as keymap3 } from "@codemirror/view";
+import { EditorView as EditorView6, keymap as keymap3 } from "@codemirror/view";
 import defaultsDeep from "lodash.defaultsdeep";
-import { throttle as throttle2 } from "@dxos/async";
+import { throttle } from "@dxos/async";
 import { invariant as invariant2 } from "@dxos/invariant";
-var __dxlog_file7 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/blast.ts";
+var __dxlog_file6 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/blast.ts";
 var defaultOptions = {
   effect: 2,
   maxParticles: 200,
@@ -1520,7 +1196,7 @@ var blast = (options = defaultOptions) => {
   };
   return [
     // Cursor moved.
-    EditorView8.updateListener.of((update2) => {
+    EditorView6.updateListener.of((update2) => {
       if (blaster?.node !== update2.view.scrollDOM) {
         if (blaster) {
           blaster.destroy();
@@ -1593,7 +1269,7 @@ var Blaster = class {
     return this._node;
   }
   initialize() {
-    invariant2(!this._canvas && !this._ctx, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file7, L: 134, S: this, A: ["!this._canvas && !this._ctx", ""] });
+    invariant2(!this._canvas && !this._ctx, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file6, L: 134, S: this, A: ["!this._canvas && !this._ctx", ""] });
     this._canvas = document.createElement("canvas");
     this._canvas.id = "code-blast-canvas";
     this._canvas.style.position = "absolute";
@@ -1622,7 +1298,7 @@ var Blaster = class {
     }
   }
   start() {
-    invariant2(this._canvas && this._ctx, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file7, L: 166, S: this, A: ["this._canvas && this._ctx", ""] });
+    invariant2(this._canvas && this._ctx, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file6, L: 166, S: this, A: ["this._canvas && this._ctx", ""] });
     this._running = true;
     this.loop();
   }
@@ -1649,11 +1325,11 @@ var Blaster = class {
     this.drawParticles();
     requestAnimationFrame(this.loop.bind(this));
   }
-  shake = throttle2(({ time }) => {
+  shake = throttle(({ time }) => {
     this._shakeTime = this._shakeTimeMax || time;
     this._shakeTimeMax = time;
   }, 100);
-  spawn = throttle2(({ element, point }) => {
+  spawn = throttle(({ element, point }) => {
     const color = getRGBComponents(element, this._options.color);
     const numParticles = random(this._options.particleNumRange.min, this._options.particleNumRange.max);
     const dir = this._lastPoint.x === point.x ? 0 : this._lastPoint.x < point.x ? 1 : -1;
@@ -1762,9 +1438,9 @@ var random = (min, max) => {
 
 // src/extensions/blocks.ts
 import { RangeSetBuilder as RangeSetBuilder3 } from "@codemirror/state";
-import { Decoration as Decoration6, EditorView as EditorView9, ViewPlugin as ViewPlugin9 } from "@codemirror/view";
+import { Decoration as Decoration6, EditorView as EditorView7, ViewPlugin as ViewPlugin7 } from "@codemirror/view";
 import { mx as mx2 } from "@dxos/ui-theme";
-var paragraphBlockPlugin = ViewPlugin9.fromClass(class {
+var paragraphBlockPlugin = ViewPlugin7.fromClass(class {
   decorations;
   constructor(view) {
     this.decorations = this.build(view);
@@ -1823,7 +1499,7 @@ var paragraphBlockPlugin = ViewPlugin9.fromClass(class {
 });
 var blocks = () => [
   paragraphBlockPlugin,
-  EditorView9.baseTheme({
+  EditorView7.baseTheme({
     ".cm-line.block-line": {
       paddingLeft: "0.75rem",
       paddingRight: "0.75rem",
@@ -1857,13 +1533,13 @@ var blocks = () => [
 ];
 
 // src/extensions/bookmarks.ts
-import { Prec as Prec3, StateEffect as StateEffect4, StateField as StateField2 } from "@codemirror/state";
+import { Prec as Prec3, StateEffect as StateEffect2, StateField as StateField2 } from "@codemirror/state";
 import { keymap as keymap4 } from "@codemirror/view";
-import { log as log6 } from "@dxos/log";
-var __dxlog_file8 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/bookmarks.ts";
-var addBookmark = StateEffect4.define();
-var removeBookmark = StateEffect4.define();
-var clearBookmarks = StateEffect4.define();
+import { log as log5 } from "@dxos/log";
+var __dxlog_file7 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/bookmarks.ts";
+var addBookmark = StateEffect2.define();
+var removeBookmark = StateEffect2.define();
+var clearBookmarks = StateEffect2.define();
 var bookmarks = () => {
   return [
     bookmarksField,
@@ -1872,7 +1548,7 @@ var bookmarks = () => {
         key: "Mod-ArrowUp",
         run: (view) => {
           const bookmarks2 = view.state.field(bookmarksField);
-          log6("up", bookmarks2, { "~LogMeta": "~LogMeta", F: __dxlog_file8, L: 18, S: void 0 });
+          log5("up", bookmarks2, { "~LogMeta": "~LogMeta", F: __dxlog_file7, L: 18, S: void 0 });
           return true;
         }
       },
@@ -1880,7 +1556,7 @@ var bookmarks = () => {
         key: "Mod-ArrowDown",
         run: (view) => {
           const bookmarks2 = view.state.field(bookmarksField);
-          log6("down", bookmarks2, { "~LogMeta": "~LogMeta", F: __dxlog_file8, L: 26, S: void 0 });
+          log5("down", bookmarks2, { "~LogMeta": "~LogMeta", F: __dxlog_file7, L: 26, S: void 0 });
           return true;
         }
       }
@@ -1917,27 +1593,27 @@ var bookmarksField = StateField2.define({
 
 // src/extensions/comments.ts
 import { invertedEffects } from "@codemirror/commands";
-import { StateEffect as StateEffect5, StateField as StateField3 } from "@codemirror/state";
-import { Decoration as Decoration7, EditorView as EditorView11, ViewPlugin as ViewPlugin10, hoverTooltip, keymap as keymap6 } from "@codemirror/view";
+import { StateEffect as StateEffect3, StateField as StateField3 } from "@codemirror/state";
+import { Decoration as Decoration7, EditorView as EditorView9, ViewPlugin as ViewPlugin8, hoverTooltip, keymap as keymap6 } from "@codemirror/view";
 import sortBy from "lodash.sortby";
 import { debounce as debounce2 } from "@dxos/async";
-import { log as log7 } from "@dxos/log";
+import { log as log6 } from "@dxos/log";
 import { isNonNullable } from "@dxos/util";
 
 // src/extensions/selection.ts
 import { Transaction as Transaction3 } from "@codemirror/state";
-import { EditorView as EditorView10, keymap as keymap5 } from "@codemirror/view";
+import { EditorView as EditorView8, keymap as keymap5 } from "@codemirror/view";
 import { debounce } from "@dxos/async";
 import { invariant as invariant3 } from "@dxos/invariant";
 import { isTruthy } from "@dxos/util";
-var __dxlog_file9 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/selection.ts";
+var __dxlog_file8 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/selection.ts";
 var documentId = singleValueFacet();
 var stateRestoreAnnotation = "org.dxos.cm.state-restore";
 var createEditorStateTransaction = ({ scrollTo, selection }) => {
   return {
     selection,
     scrollIntoView: !scrollTo,
-    effects: scrollTo ? EditorView10.scrollIntoView(scrollTo, {
+    effects: scrollTo ? EditorView8.scrollIntoView(scrollTo, {
       yMargin: 96
     }) : void 0,
     annotations: Transaction3.userEvent.of(stateRestoreAnnotation)
@@ -1945,12 +1621,12 @@ var createEditorStateTransaction = ({ scrollTo, selection }) => {
 };
 var createEditorStateStore = (keyPrefix) => ({
   getState: (id) => {
-    invariant3(id, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file9, L: 26, S: void 0, A: ["id", ""] });
+    invariant3(id, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file8, L: 26, S: void 0, A: ["id", ""] });
     const state = localStorage.getItem(`${keyPrefix}/${id}`);
     return state ? JSON.parse(state) : void 0;
   },
   setState: (id, state) => {
-    invariant3(id, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file9, L: 31, S: void 0, A: ["id", ""] });
+    invariant3(id, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file8, L: 31, S: void 0, A: ["id", ""] });
     localStorage.setItem(`${keyPrefix}/${id}`, JSON.stringify(state));
   }
 });
@@ -1963,7 +1639,7 @@ var selectionState = ({ getState, setState } = {}) => {
     //     setStateDebounced(id, {});
     //   },
     // }),
-    EditorView10.updateListener.of(({ view, transactions }) => {
+    EditorView8.updateListener.of(({ view, transactions }) => {
       const id = view.state.facet(documentId);
       if (!id || transactions.some((tr) => tr.isUserEvent(stateRestoreAnnotation))) {
         return;
@@ -2002,10 +1678,10 @@ var selectionState = ({ getState, setState } = {}) => {
 };
 
 // src/extensions/comments.ts
-var __dxlog_file10 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/comments.ts";
-var setComments = StateEffect5.define();
-var setSelection = StateEffect5.define();
-var setCommentState = StateEffect5.define();
+var __dxlog_file9 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/comments.ts";
+var setComments = StateEffect3.define();
+var setSelection = StateEffect3.define();
+var setCommentState = StateEffect3.define();
 var commentsState = StateField3.define({
   create: (state) => ({
     id: state.facet(documentId),
@@ -2044,7 +1720,7 @@ var commentsState = StateField3.define({
     return value;
   }
 });
-var styles2 = EditorView11.theme({
+var styles2 = EditorView9.theme({
   ".cm-comment, .cm-comment-current": {
     padding: "3px 0",
     color: "var(--color-cm-comment-text)",
@@ -2065,14 +1741,14 @@ var createCommentMark = (id, isCurrent) => Decoration7.mark({
     "data-comment-id": id
   }
 });
-var commentsDecorations = EditorView11.decorations.compute([
+var commentsDecorations = EditorView9.decorations.compute([
   commentsState
 ], (state) => {
   const { selection: { current }, comments: comments2 } = state.field(commentsState);
   const decorations2 = sortBy(comments2 ?? [], (range) => range.range.from)?.flatMap((comment) => {
     const range = comment.range;
     if (!range) {
-      log7.warn("Invalid range:", range, { "~LogMeta": "~LogMeta", F: __dxlog_file10, L: 93, S: void 0 });
+      log6.warn("Invalid range:", range, { "~LogMeta": "~LogMeta", F: __dxlog_file9, L: 93, S: void 0 });
       return void 0;
     } else if (range.from === range.to) {
       return void 0;
@@ -2082,8 +1758,8 @@ var commentsDecorations = EditorView11.decorations.compute([
   }).filter(isNonNullable);
   return Decoration7.set(decorations2);
 });
-var commentClickedEffect = StateEffect5.define();
-var handleCommentClick = EditorView11.domEventHandlers({
+var commentClickedEffect = StateEffect3.define();
+var handleCommentClick = EditorView9.domEventHandlers({
   click: (event, view) => {
     let target = event.target;
     const editorRoot = view.dom;
@@ -2122,7 +1798,7 @@ var trackPastedComments = (onUpdate) => {
     }
   };
   return [
-    EditorView11.domEventHandlers({
+    EditorView9.domEventHandlers({
       cut: handleTrack,
       copy: handleTrack
     }),
@@ -2144,7 +1820,7 @@ var trackPastedComments = (onUpdate) => {
       return effects;
     }),
     // Handle paste or the undo of comment deletion.
-    EditorView11.updateListener.of((update2) => {
+    EditorView9.updateListener.of((update2) => {
       const restore = [];
       for (let i = 0; i < update2.transactions.length; i++) {
         const tr = update2.transactions[i];
@@ -2200,7 +1876,7 @@ var mapTrackedComment = (comment, changes) => ({
   from: changes.mapPos(comment.from, 1),
   to: changes.mapPos(comment.to, 1)
 });
-var restoreCommentEffect = StateEffect5.define({
+var restoreCommentEffect = StateEffect3.define({
   map: mapTrackedComment
 });
 var createComment = (view) => {
@@ -2286,7 +1962,7 @@ var comments = (options = {}) => {
     //
     // Track deleted ranges and update ranges for decorations.
     //
-    EditorView11.updateListener.of(({ view, state, changes }) => {
+    EditorView9.updateListener.of(({ view, state, changes }) => {
       let mod = false;
       const { comments: comments2, ...value } = state.field(commentsState);
       changes.iterChanges((from, to, from2, to2) => {
@@ -2318,7 +1994,7 @@ var comments = (options = {}) => {
     //
     // Track selection/proximity.
     //
-    EditorView11.updateListener.of(({ view, state }) => {
+    EditorView9.updateListener.of(({ view, state }) => {
       let min = Infinity;
       const { selection: { current, closest }, comments: comments2 } = state.field(commentsState);
       const { head } = state.selection.main;
@@ -2372,7 +2048,7 @@ var scrollThreadIntoView = (view, id, center = true) => {
           anchor: range.from
         } : void 0,
         effects: [
-          needsScroll ? EditorView11.scrollIntoView(range.from, center ? {
+          needsScroll ? EditorView9.scrollIntoView(range.from, center ? {
             y: "center"
           } : void 0) : [],
           needsSelectionUpdate ? setSelection.of({
@@ -2403,7 +2079,7 @@ var ExternalCommentSync = class {
     this.unsubscribe();
   };
 };
-var createExternalCommentSync = (id, subscribe, getComments) => ViewPlugin10.fromClass(class {
+var createExternalCommentSync = (id, subscribe, getComments) => ViewPlugin8.fromClass(class {
   constructor(view) {
     return new ExternalCommentSync(view, id, subscribe, getComments);
   }
@@ -2423,12 +2099,12 @@ var debugNodeLogger = (log12 = console.log) => {
 };
 
 // src/extensions/dnd.ts
-import { EditorView as EditorView12, dropCursor } from "@codemirror/view";
+import { EditorView as EditorView10, dropCursor } from "@codemirror/view";
 var dropFile = (options = {}) => {
   return [
     styles3,
     dropCursor(),
-    EditorView12.domEventHandlers({
+    EditorView10.domEventHandlers({
       drop: (event, view) => {
         event.preventDefault();
         const files = event.dataTransfer?.files;
@@ -2447,7 +2123,7 @@ var dropFile = (options = {}) => {
     })
   ];
 };
-var styles3 = EditorView12.theme({
+var styles3 = EditorView10.theme({
   ".cm-dropCursor": {
     borderLeft: "2px solid var(--color-accent-text)",
     color: "var(--color-accent-text)",
@@ -2469,10 +2145,10 @@ import { vscodeDarkStyle, vscodeLightStyle } from "@uiw/codemirror-theme-vscode"
 import defaultsDeep2 from "lodash.defaultsdeep";
 import { generateName } from "@dxos/display-name";
 import { log as log8 } from "@dxos/log";
-import { hexToHue, isTruthy as isTruthy2 } from "@dxos/util";
+import { hexToHue, isTruthy as isTruthy3 } from "@dxos/util";
 
 // src/styles/theme.ts
-import { EditorView as EditorView13 } from "@codemirror/view";
+import { EditorView as EditorView11 } from "@codemirror/view";
 import { mx as mx3 } from "@dxos/ui-theme";
 var headings = {
   1: {
@@ -2520,7 +2196,7 @@ var markdownTheme = {
     fontWeight: "100 !important"
   })
 };
-var baseTheme = EditorView13.baseTheme({
+var baseTheme = EditorView11.baseTheme({
   /**
   * Outer frame.
   */
@@ -2532,7 +2208,7 @@ var baseTheme = EditorView13.baseTheme({
   * Scroller
   */
   ".cm-scroller": {
-    // Browser scroll-anchoring: see comment in `scroller.ts`. `auto` lets the browser pin a
+    // Browser scroll-anchoring: see comment in `scrolling/crawler.ts`. `auto` lets the browser pin a
     // stable element near the viewport top so widget resizes (e.g. tool-block TogglePanel
     // open/close) don't jump the user's view.
     overflowAnchor: "auto"
@@ -2643,7 +2319,8 @@ var baseTheme = EditorView13.baseTheme({
     textDecorationThickness: "1px",
     textDecorationColor: "var(--color-separator)",
     textUnderlineOffset: "2px",
-    borderRadius: ".125rem"
+    borderRadius: ".125rem",
+    cursor: "pointer"
   },
   ".cm-link > span": {
     color: "var(--color-accent-text)"
@@ -2681,12 +2358,12 @@ var baseTheme = EditorView13.baseTheme({
     padding: "4px"
   },
   ".cm-tooltip.cm-tooltip-autocomplete > ul > li[aria-selected]": {
-    background: "var(--color-active-surface)",
-    color: "var(--color-base-surface-text)"
+    background: "var(--color-current-surface)",
+    color: "var(--color-base-foreground)"
   },
   ".cm-tooltip.cm-tooltip-autocomplete > ul > completion-section": {
     paddingLeft: "4px !important",
-    color: "var(--color-base-surface-text)"
+    color: "var(--color-base-foreground)"
   },
   /**
   * Completion info.
@@ -2705,7 +2382,7 @@ var baseTheme = EditorView13.baseTheme({
     padding: "0 4px"
   },
   ".cm-completionMatchedText": {
-    color: "var(--color-base-surface-text)",
+    color: "var(--color-base-foreground)",
     textDecoration: "none !important"
   },
   /**
@@ -2740,7 +2417,7 @@ var baseTheme = EditorView13.baseTheme({
     backgroundColor: "var(--color-input-surface)"
   },
   ".cm-panel input:focus, .cm-panel button:focus": {
-    outline: "1px solid var(--color-neutral-focus-indicator)"
+    outline: "1px solid var(--color-focus-ring-subtle)"
   },
   ".cm-panel label": {
     display: "inline-flex",
@@ -2753,7 +2430,7 @@ var baseTheme = EditorView13.baseTheme({
     height: "8px",
     marginRight: "6px !important",
     padding: "2px !important",
-    color: "var(--color-neutral-focus-indicator)"
+    color: "var(--color-focus-ring-subtle)"
   },
   ".cm-panel button": {
     "&:hover": {
@@ -2769,14 +2446,14 @@ var baseTheme = EditorView13.baseTheme({
     borderTop: "1px solid var(--color-separator)"
   }
 });
-var editorGutter = EditorView13.theme({
+var editorGutter = EditorView11.theme({
   ".cm-gutters": {
     // NOTE: Non-transparent background required to cover content if scrolling horizontally.
     background: "var(--color-base-surface) !important",
     paddingRight: "1rem"
   }
 });
-var createFontTheme = ({ monospace } = {}) => EditorView13.theme({
+var createFontTheme = ({ monospace } = {}) => EditorView11.theme({
   // Main content.
   ".cm-scroller": {
     fontFamily: monospace ? fontMono : fontBody
@@ -2789,9 +2466,9 @@ var createFontTheme = ({ monospace } = {}) => EditorView13.theme({
 });
 
 // src/extensions/focus.ts
-import { StateEffect as StateEffect6, StateField as StateField5 } from "@codemirror/state";
-import { EditorView as EditorView14 } from "@codemirror/view";
-var focusEffect = StateEffect6.define();
+import { StateEffect as StateEffect4, StateField as StateField5 } from "@codemirror/state";
+import { EditorView as EditorView12 } from "@codemirror/view";
+var focusEffect = StateEffect4.define();
 var focusField = StateField5.define({
   create: () => false,
   update: (value, tr) => {
@@ -2800,38 +2477,381 @@ var focusField = StateField5.define({
         return effect.value;
       }
     }
-    return value;
+    return value;
+  }
+});
+var focus = [
+  focusField,
+  EditorView12.domEventHandlers({
+    focus: (_event, view) => {
+      requestAnimationFrame(() => view.dispatch({
+        effects: focusEffect.of(true)
+      }));
+    },
+    blur: (_event, view) => {
+      requestAnimationFrame(() => view.dispatch({
+        effects: focusEffect.of(false)
+      }));
+    }
+  })
+];
+
+// src/extensions/scrolling/auto-scroll.ts
+import { StateEffect as StateEffect6 } from "@codemirror/state";
+import { EditorView as EditorView14, ViewPlugin as ViewPlugin10 } from "@codemirror/view";
+import { addEventListener, combine, throttle as throttle2 } from "@dxos/async";
+import { Domino } from "@dxos/ui";
+import { getSize } from "@dxos/ui-theme";
+
+// src/extensions/scrolling/crawler.ts
+import { StateEffect as StateEffect5 } from "@codemirror/state";
+import { EditorView as EditorView13, ViewPlugin as ViewPlugin9 } from "@codemirror/view";
+import { log as log7 } from "@dxos/log";
+var __dxlog_file10 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/scrolling/crawler.ts";
+var crawlerLineEffect = StateEffect5.define();
+var crawlerActiveEffect = StateEffect5.define();
+var scrollToLine = (view, options) => {
+  view.dispatch({
+    effects: crawlerLineEffect.of(options)
+  });
+};
+var crawler = ({ overScroll = 0 } = {}) => {
+  const crawlerPlugin = ViewPlugin9.fromClass(class CrawlerPlugin {
+    view;
+    crawler;
+    constructor(view) {
+      this.view = view;
+      this.crawler = createCrawler(this.view);
+    }
+    // No-op.
+    destroy() {
+      this.crawler.cancel();
+    }
+    cancel() {
+      this.crawler.cancel();
+    }
+    crawl(start = false) {
+      if (start) {
+        this.crawler.scroll();
+      } else {
+        this.crawler.cancel();
+      }
+    }
+    scroll({ line, offset = 0, position, behavior = "instant" }) {
+      const { scrollTop, scrollHeight, clientHeight } = this.view.scrollDOM;
+      const scrollerRect = this.view.scrollDOM.getBoundingClientRect();
+      const doc = this.view.state.doc;
+      let targetScrollTop = scrollHeight - clientHeight + offset;
+      if (line >= 0 && line <= doc.lines - 1) {
+        const lineStart = doc.line(line + 1).from;
+        const coords = this.view.coordsAtPos(lineStart);
+        if (coords) {
+          const currentScrollTop = scrollTop;
+          const maxScrollTop = scrollHeight - clientHeight;
+          if (position === "end") {
+            targetScrollTop = currentScrollTop + coords.bottom - scrollerRect.bottom + offset;
+          } else {
+            targetScrollTop = currentScrollTop + coords.top - scrollerRect.top + offset;
+          }
+          targetScrollTop = Math.max(0, Math.min(targetScrollTop, maxScrollTop));
+        }
+      }
+      requestAnimationFrame(() => {
+        this.view.scrollDOM.scrollTo({
+          top: targetScrollTop
+        });
+      });
+    }
+  });
+  return [
+    crawlerPlugin,
+    // Listen for effect.
+    EditorView13.updateListener.of((update2) => {
+      update2.transactions.forEach((transaction) => {
+        try {
+          const plugin = update2.view.plugin(crawlerPlugin);
+          if (plugin) {
+            for (const effect of transaction.effects) {
+              if (effect.is(crawlerActiveEffect)) {
+                plugin.crawl(effect.value);
+              } else if (effect.is(crawlerLineEffect)) {
+                plugin.scroll(effect.value);
+              }
+            }
+          }
+        } catch (err) {
+          log7.catch(err, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file10, L: 98, S: void 0 });
+        }
+      });
+    }),
+    // Styles.
+    EditorView13.theme({
+      ".cm-scroller": {
+        overflowY: "scroll",
+        // Browser scroll-anchoring: when widgets above the viewport resize (e.g. tool blocks
+        // expanding their TogglePanel), the browser picks a stable element near the viewport
+        // top and adjusts `scrollTop` so the user's view doesn't jump. Auto-scroll's pinning
+        // logic still has the final word when pinned (forces scrollTop to scrollHeight).
+        overflowAnchor: "auto"
+      },
+      ".cm-scroller.cm-hide-scrollbar::-webkit-scrollbar": {
+        display: "none"
+      },
+      ".cm-scroller::-webkit-scrollbar-thumb": {
+        background: "transparent",
+        transition: "background 0.15s"
+      },
+      "&:hover .cm-scroller::-webkit-scrollbar-thumb": {
+        background: "var(--color-scrollbar-thumb)"
+      },
+      // Spacer below the last text line. Implemented as a real block pseudo-element
+      // (rather than `padding-bottom` on `.cm-content`) so it materializes in the
+      // scroller's `scrollHeight` regardless of how `padding` is reset by the base
+      // theme or downstream classes — this is what gives auto-scroll its head-room
+      // so the last line stays `overScroll` px above the viewport bottom.
+      ".cm-content::after": {
+        content: '""',
+        display: "block",
+        height: `${overScroll}px`
+      },
+      ".cm-scroll-button": {
+        position: "absolute",
+        bottom: "0.5rem",
+        right: "1rem"
+      }
+    })
+  ];
+};
+function createCrawler(view, omega = 5, snapThreshold = 5, snapVelocity = 50) {
+  const el = view.scrollDOM;
+  let currentTop = 0;
+  let velocity = 0;
+  let rafId = null;
+  let lastTime = 0;
+  function frame(now) {
+    const dt = lastTime === 0 ? 1 / 60 : Math.min(0.1, (now - lastTime) / 1e3);
+    lastTime = now;
+    const targetTop = el.scrollHeight - el.clientHeight;
+    const delta = targetTop - currentTop;
+    if (Math.abs(delta) < snapThreshold && Math.abs(velocity) < snapVelocity) {
+      el.scrollTop = targetTop;
+      currentTop = targetTop;
+      velocity = 0;
+      rafId = null;
+      lastTime = 0;
+      return;
+    }
+    const accel = omega * omega * delta - 2 * omega * velocity;
+    velocity += accel * dt;
+    currentTop += velocity * dt;
+    el.scrollTop = currentTop;
+    rafId = requestAnimationFrame(frame);
   }
-});
-var focus = [
-  focusField,
-  EditorView14.domEventHandlers({
-    focus: (_event, view) => {
-      requestAnimationFrame(() => view.dispatch({
-        effects: focusEffect.of(true)
-      }));
+  return {
+    scroll: () => {
+      if (rafId === null) {
+        currentTop = el.scrollTop;
+        lastTime = 0;
+        rafId = requestAnimationFrame(frame);
+      }
     },
-    blur: (_event, view) => {
-      requestAnimationFrame(() => view.dispatch({
-        effects: focusEffect.of(false)
-      }));
+    cancel: () => {
+      if (rafId !== null) {
+        cancelAnimationFrame(rafId);
+        velocity = 0;
+        lastTime = 0;
+        rafId = null;
+      }
     }
-  })
-];
+  };
+}
+
+// src/extensions/scrolling/auto-scroll.ts
+var autoScrollEffect = StateEffect6.define();
+var autoScroll = ({ scrollOnResize = true } = {}) => {
+  let buttonContainer;
+  let isPinned = true;
+  let jumpPending = false;
+  let enabled = true;
+  let firstUpdate = true;
+  const setPinned = (pinned) => {
+    buttonContainer?.classList.toggle("opacity-0", pinned);
+    isPinned = pinned;
+  };
+  return [
+    // Update listener for scrolling when content changes.
+    EditorView14.updateListener.of((update2) => {
+      const { view, heightChanged, state, startState } = update2;
+      for (const tr of update2.transactions) {
+        for (const effect of tr.effects) {
+          if (effect.is(autoScrollEffect)) {
+            enabled = effect.value;
+            if (enabled) {
+              setPinned(true);
+              view.dispatch({
+                effects: crawlerActiveEffect.of(true)
+              });
+            } else {
+              view.dispatch({
+                effects: crawlerActiveEffect.of(false)
+              });
+            }
+          }
+        }
+      }
+      if (!enabled) {
+        return;
+      }
+      if (isPinned && (firstUpdate || startState.doc.length === 0) && state.doc.length > 0) {
+        firstUpdate = false;
+        jumpPending = true;
+        requestAnimationFrame(() => {
+          view.scrollDOM.scrollTop = view.scrollDOM.scrollHeight;
+          jumpPending = false;
+        });
+        return;
+      }
+      firstUpdate = false;
+      if (jumpPending) {
+        return;
+      }
+      if (heightChanged) {
+        if (isPinned) {
+          const { scrollTop, scrollHeight, clientHeight } = view.scrollDOM;
+          const delta = scrollHeight - scrollTop - clientHeight;
+          if (delta > 0) {
+            setPinned(true);
+            view.dispatch({
+              effects: crawlerActiveEffect.of(true)
+            });
+          } else if (delta < -1) {
+            setPinned(false);
+          }
+        } else {
+          if (state.doc.length === 0) {
+            setPinned(true);
+          }
+        }
+      }
+    }),
+    // Re-pin and jump to bottom when the scroll container itself resizes (e.g. sidebar toggle,
+    // window resize). Doc-driven height changes are handled by the updateListener above; this
+    // observer covers the case where the viewport changes while the doc length is unchanged.
+    scrollOnResize ? ViewPlugin10.fromClass(class {
+      observer;
+      firstObservation = true;
+      destroyed = false;
+      constructor(view) {
+        const onResize = throttle2(() => {
+          if (this.destroyed || !enabled) {
+            return;
+          }
+          setPinned(true);
+          requestAnimationFrame(() => {
+            if (this.destroyed) {
+              return;
+            }
+            view.scrollDOM.scrollTo({
+              top: view.scrollDOM.scrollHeight,
+              behavior: "instant"
+            });
+            view.dispatch({
+              effects: crawlerActiveEffect.of(false)
+            });
+          });
+        }, 50);
+        this.observer = new ResizeObserver(() => {
+          if (this.firstObservation) {
+            this.firstObservation = false;
+            return;
+          }
+          onResize();
+        });
+        this.observer.observe(view.scrollDOM);
+      }
+      destroy() {
+        this.destroyed = true;
+        this.observer.disconnect();
+      }
+    }) : [],
+    // Detect user scroll and unpin (or re-pin if scrolled to the bottom).
+    ViewPlugin10.fromClass(class {
+      cleanup;
+      constructor(view) {
+        const onUserScroll = throttle2(() => {
+          requestAnimationFrame(() => {
+            const { scrollTop, scrollHeight, clientHeight } = view.scrollDOM;
+            const delta = scrollHeight - scrollTop - clientHeight;
+            const pinned = Math.abs(delta) <= 1;
+            setPinned(pinned);
+            if (!pinned) {
+              view.dispatch({
+                effects: crawlerActiveEffect.of(false)
+              });
+            }
+          });
+        }, 500);
+        this.cleanup = createUserScrollDetector(view.scrollDOM, () => {
+          if (isPinned) {
+            setPinned(false);
+            view.dispatch({
+              effects: crawlerActiveEffect.of(false)
+            });
+          }
+          onUserScroll();
+        });
+      }
+      destroy() {
+        this.cleanup();
+      }
+    }),
+    // Scroll button.
+    ViewPlugin10.fromClass(class {
+      constructor(view) {
+        const icon = Domino.of("dx-icon").classNames(getSize(4)).attributes({
+          icon: "ph--arrow-down--regular"
+        });
+        const button = Domino.of("button").classNames("dx-button bg-accent-surface").attributes({
+          "data-density": "fine"
+        }).append(icon).on("click", () => {
+          setPinned(true);
+          view.dispatch({
+            effects: crawlerLineEffect.of({
+              line: -1,
+              position: "end",
+              behavior: "smooth"
+            })
+          });
+        });
+        buttonContainer = Domino.of("div").classNames("cm-scroll-button transition-opacity duration-300 opacity-0").append(button).root;
+        view.scrollDOM.parentElement.appendChild(buttonContainer);
+      }
+    })
+  ];
+};
+function createUserScrollDetector(element, onUserScroll) {
+  return combine(addEventListener(element, "wheel", () => onUserScroll(), {
+    passive: true
+  }), addEventListener(element, "pointerdown", (event) => {
+    if (event.clientX > element.getBoundingClientRect().right - (element.offsetWidth - element.clientWidth)) {
+      onUserScroll();
+    }
+  }));
+}
 
-// src/extensions/scroll-past-end.ts
+// src/extensions/scrolling/scroll-past-end.ts
 import { EditorView as EditorView15, ViewPlugin as ViewPlugin11 } from "@codemirror/view";
 var scrollPastEndPlugin = ViewPlugin11.fromClass(class {
-  height = 1e3;
-  attrs = {
-    style: "padding-bottom: 1000px"
+  _height = 1e3;
+  _attrs = {
+    style: `padding-bottom: ${this._height}px`
   };
   update({ view }) {
     const lastLineBlock = view.lineBlockAt(view.state.doc.length);
     const height = view.dom.clientHeight - lastLineBlock.height - view.documentPadding.top - 0.5;
-    if (height >= 0 && height !== this.height) {
-      this.height = height;
-      this.attrs = {
+    if (height >= 0 && height !== this._height) {
+      this._height = height;
+      this._attrs = {
         style: `padding-bottom: ${height}px`
       };
     }
@@ -2839,9 +2859,22 @@ var scrollPastEndPlugin = ViewPlugin11.fromClass(class {
 });
 var scrollPastEnd = () => [
   scrollPastEndPlugin,
-  EditorView15.contentAttributes.of((view) => view.plugin(scrollPastEndPlugin)?.attrs ?? null)
+  EditorView15.contentAttributes.of((view) => view.plugin(scrollPastEndPlugin)?._attrs ?? null)
 ];
 
+// src/extensions/scrolling/scroller.ts
+import { isTruthy as isTruthy2 } from "@dxos/util";
+var scroller = ({ overScroll, scrollOnResize, autoScroll: autoScroll2 = true } = {}) => {
+  return [
+    crawler({
+      overScroll
+    }),
+    autoScroll2 && autoScroll({
+      scrollOnResize
+    })
+  ].filter(isTruthy2);
+};
+
 // src/extensions/factories.ts
 var __dxlog_file11 = "/__w/dxos/dxos/packages/ui/ui-editor/src/extensions/factories.ts";
 var tabbable = EditorView16.contentAttributes.of({
@@ -2949,8 +2982,8 @@ var createBasicExtensions = (propsProp) => {
         preventDefault: true,
         run: () => true
       }
-    ].filter(isTruthy2))
-  ].filter(isTruthy2);
+    ].filter(isTruthy3))
+  ].filter(isTruthy3);
 };
 var grow = {
   editor: {
@@ -2992,7 +3025,7 @@ var createThemeExtensions = ({ monospace, scrollbarThin, slots: slotsProp, synta
         }
       }
     })
-  ].filter(isTruthy2);
+  ].filter(isTruthy3);
 };
 var createDataExtensions = ({ id, text, messenger, identity }) => {
   const extensions = [];
@@ -4316,7 +4349,7 @@ import { markdown, markdownLanguage as markdownLanguage2 } from "@codemirror/lan
 import { foldNodeProp, syntaxHighlighting as syntaxHighlighting2 } from "@codemirror/language";
 import { languages } from "@codemirror/language-data";
 import { keymap as keymap9 } from "@codemirror/view";
-import { isTruthy as isTruthy3 } from "@dxos/util";
+import { isTruthy as isTruthy4 } from "@dxos/util";
 
 // src/extensions/markdown/highlight.ts
 import { markdownLanguage } from "@codemirror/lang-markdown";
@@ -4548,7 +4581,7 @@ var createMarkdownExtensions = (options = {}) => {
       ...defaultKeymap2,
       // TODO(burdon): Remove?
       ...completionKeymap
-    ].filter(isTruthy3))
+    ].filter(isTruthy4))
   ];
 };
 var noFencedCodeFolding = {
@@ -6629,7 +6662,7 @@ var decorations = () => [
       marginBottom: "2px"
     },
     ".cm-list-item-focused": {
-      borderColor: "var(--color-neutral-focus-indicator)"
+      borderColor: "var(--color-focus-ring-subtle)"
     },
     "&:focus-within .cm-list-item-selected": {
       borderColor: "var(--color-separator)"
@@ -7868,7 +7901,7 @@ var xmlFormatting = ({ skip } = {}) => {
     }),
     EditorView31.baseTheme({
       ".cm-xml-element": {
-        backgroundColor: "var(--color-active-surface)",
+        backgroundColor: "var(--color-current-surface)",
         borderRadius: "0.25rem",
         padding: "0.25rem"
       },
@@ -8129,7 +8162,7 @@ var createNavigationEffectPlugin = (widgetDecorationsField, bookmarks2) => {
               anchor: line.from,
               head: line.from
             },
-            effects: scrollerLineEffect.of({
+            effects: crawlerLineEffect.of({
               line: line.number - 1,
               offset: -16
             })
@@ -8162,7 +8195,7 @@ var createNavigationEffectPlugin = (widgetDecorationsField, bookmarks2) => {
                 anchor: line.to,
                 head: line.to
               },
-              effects: scrollerLineEffect.of({
+              effects: crawlerLineEffect.of({
                 line: line.number - 1,
                 offset: -16
               })
@@ -8174,7 +8207,7 @@ var createNavigationEffectPlugin = (widgetDecorationsField, bookmarks2) => {
                 anchor: line.to,
                 head: line.to
               },
-              effects: scrollerLineEffect.of({
+              effects: crawlerLineEffect.of({
                 line: line.number - 1,
                 position: "end"
               })
@@ -8493,6 +8526,9 @@ export {
   commentsState,
   compactSlots,
   convertTreeToJson,
+  crawler,
+  crawlerActiveEffect,
+  crawlerLineEffect,
   createBasicExtensions,
   createComment,
   createCrawler,
@@ -8580,8 +8616,6 @@ export {
   scrollThreadIntoView,
   scrollToLine,
   scroller,
-  scrollerCrawlEffect,
-  scrollerLineEffect,
   selectionState,
   setBlockquote,
   setComments,