@dxos/react-ui-editor 0.8.4-main.3c1ae3b → 0.8.4-main.3eb6e50203

package/src/extensions/autoscroll.ts

@@ -1,163 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { StateEffect } from '@codemirror/state';
-import { EditorView, ViewPlugin } from '@codemirror/view';
-
-import { debounce } from '@dxos/async';
-import { Domino } from '@dxos/react-ui';
-
-import { scrollToLineEffect } from './scrolling';
-
-// TODO(burdon): Reconcile with scrollToLineEffect (scrolling).
-export const scrollToBottomEffect = StateEffect.define<ScrollBehavior | undefined>();
-
-export type AutoScrollOptions = {
-  /** Auto-scroll when reaches the bottom. */
-  autoScroll?: boolean;
-  /** Threshold in px to trigger scroll from bottom. */
-  threshold?: number;
-  /** Throttle time in ms. */
-  throttleDelay?: number;
-  /** Callback when auto-scrolling. */
-  onAutoScroll?: (props: { view: EditorView; distanceFromBottom: number }) => boolean | void;
-};
-
-/**
- * Extension that supports pinning the scroll position and automatically scrolls to the bottom when content is added.
- */
-// TODO(burdon): Reconcile with transcript-extension.
-export const autoScroll = ({
-  autoScroll = true,
-  threshold = 100,
-  throttleDelay = 1_000,
-  onAutoScroll,
-}: Partial<AutoScrollOptions> = {}) => {
-  let buttonContainer: HTMLDivElement | undefined;
-  let hideTimeout: NodeJS.Timeout | undefined;
-  let lastScrollTop = 0;
-  let isPinned = true;
-
-  const setPinned = (pin: boolean) => {
-    isPinned = pin;
-    buttonContainer?.classList.toggle('opacity-0', pin);
-  };
-
-  // Temporarily hide the scrollbar while auto-scrolling.
-  const hideScrollbar = (view: EditorView) => {
-    view.scrollDOM.classList.add('cm-hide-scrollbar');
-    clearTimeout(hideTimeout);
-    hideTimeout = setTimeout(() => {
-      view.scrollDOM.classList.remove('cm-hide-scrollbar');
-    }, 1_000);
-  };
-
-  // Throttled scroll to bottom.
-  const scrollToBottom = (view: EditorView, behavior?: ScrollBehavior) => {
-    setPinned(true);
-    hideScrollbar(view);
-    const line = view.state.doc.lineAt(view.state.doc.length);
-    view.dispatch({
-      selection: { anchor: line.to, head: line.to },
-      effects: scrollToLineEffect.of({ line: line.number, options: { position: 'end', offset: threshold, behavior } }),
-    });
-  };
-
-  // Throttled check for distance from bottom (for downward scrolls only).
-  const checkDistance = debounce((view: EditorView) => {
-    const scrollerRect = view.scrollDOM.getBoundingClientRect();
-    const coords = view.coordsAtPos(view.state.doc.length);
-    const distanceFromBottom = coords ? coords.bottom - scrollerRect.bottom : 0;
-    setPinned(distanceFromBottom < 0);
-  }, 1_000);
-
-  // Debounce scroll updates so rapid edits don't cause clunky scrolling.
-  const triggerUpdate = debounce((view: EditorView) => scrollToBottom(view), throttleDelay);
-
-  return [
-    // Update listener for logging when scrolling is needed.
-    EditorView.updateListener.of(({ view, transactions, heightChanged }) => {
-      // TODO(burdon): Remove and use scrollToLineEffect instead.
-      transactions.forEach((transaction) => {
-        for (const effect of transaction.effects) {
-          if (effect.is(scrollToBottomEffect)) {
-            scrollToBottom(view, effect.value);
-          }
-        }
-      });
-
-      // Maybe scroll if doc changed and pinned.
-      // NOTE: Geometry changed is triggered when widgets change height (e.g., toggle tool block).
-      if (heightChanged && isPinned) {
-        const coords = view.coordsAtPos(view.state.doc.length);
-        const scrollerRect = view.scrollDOM.getBoundingClientRect();
-        const distanceFromBottom = coords ? scrollerRect.bottom - coords.bottom : 0;
-        if (autoScroll && distanceFromBottom < threshold) {
-          const shouldScroll = onAutoScroll?.({ view, distanceFromBottom }) ?? true;
-          if (shouldScroll) {
-            triggerUpdate(view);
-          }
-        } else if (distanceFromBottom < 0) {
-          setPinned(false);
-        }
-      }
-    }),
-
-    // Detect user scroll.
-    EditorView.domEventHandlers({
-      scroll: (event, view) => {
-        const currentScrollTop = view.scrollDOM.scrollTop;
-        const scrollingUp = currentScrollTop < lastScrollTop;
-        lastScrollTop = currentScrollTop;
-
-        // If user scrolls up, immediately unpin auto-scroll.
-        if (scrollingUp) {
-          setPinned(false);
-        } else {
-          checkDistance(view);
-        }
-      },
-    }),
-
-    // Scroll button.
-    ViewPlugin.fromClass(
-      class {
-        constructor(view: EditorView) {
-          buttonContainer = Domino.of('div')
-            .classNames(true && 'cm-scroll-button transition-opacity duration-300 opacity-0')
-            .children(
-              Domino.of('button')
-                .classNames('dx-button bg-accentSurface')
-                .data('density', 'fine')
-                .children(Domino.of<any>('dx-icon').attributes({ icon: 'ph--arrow-down--regular' }))
-                .on('click', () => {
-                  scrollToBottom(view);
-                }),
-            )
-            .build();
-
-          view.scrollDOM.parentElement!.appendChild(buttonContainer);
-        }
-      },
-    ),
-
-    // Styles.
-    EditorView.theme({
-      '.cm-scroller': {
-        scrollbarWidth: 'thin',
-      },
-      '.cm-scroller.cm-hide-scrollbar': {
-        scrollbarWidth: 'none',
-      },
-      '.cm-scroller.cm-hide-scrollbar::-webkit-scrollbar': {
-        display: 'none',
-      },
-      '.cm-scroll-button': {
-        position: 'absolute',
-        bottom: '0.5rem',
-        right: '1rem',
-      },
-    }),
-  ];
-};

package/src/extensions/awareness/awareness-provider.ts

@@ -1,127 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { DeferredTask, Event, sleep } from '@dxos/async';
-import { Context } from '@dxos/context';
-import { invariant } from '@dxos/invariant';
-import { log } from '@dxos/log';
-import { type Messenger } from '@dxos/protocols';
-import { type GossipMessage } from '@dxos/protocols/proto/dxos/mesh/teleport/gossip';
-
-import { type AwarenessInfo, type AwarenessPosition, type AwarenessProvider, type AwarenessState } from './awareness';
-
-type ProtocolMessage =
-  | {
-      kind: 'query';
-    }
-  | {
-      kind: 'post';
-      state: AwarenessState;
-    };
-
-const DEBOUNCE_INTERVAL = 100; // ms
-
-export type AwarenessProviderParams = {
-  messenger: Messenger;
-  channel: string;
-  peerId: string;
-  info: AwarenessInfo;
-};
-
-/**
- * Receives and broadcasts profile and cursor position.
- */
-export class SpaceAwarenessProvider implements AwarenessProvider {
-  private readonly _remoteStates = new Map<string, AwarenessState>();
-
-  private readonly _messenger: Messenger;
-  private readonly _channel: string;
-  private readonly _peerId: string;
-  private readonly _info: AwarenessInfo;
-
-  private _ctx?: Context;
-  private _postTask?: DeferredTask;
-  private _localState?: AwarenessState;
-
-  public readonly remoteStateChange = new Event<void>();
-
-  constructor({ messenger, channel, peerId, info }: AwarenessProviderParams) {
-    this._messenger = messenger;
-    this._channel = channel;
-    this._peerId = peerId;
-    this._info = info;
-  }
-
-  open(): void {
-    this._ctx = new Context();
-    this._postTask = new DeferredTask(this._ctx, async () => {
-      if (this._localState) {
-        await this._messenger.postMessage(this._channel, {
-          kind: 'post',
-          state: this._localState,
-        } satisfies ProtocolMessage);
-
-        // TODO(burdon): Replace with throttle.
-        // TODO(burdon): Send heads?
-        await sleep(DEBOUNCE_INTERVAL);
-      }
-    });
-
-    this._ctx.onDispose(
-      this._messenger.listen(this._channel, (message: GossipMessage) => {
-        switch (message.payload.kind) {
-          case 'query': {
-            this._handleQueryMessage();
-            break;
-          }
-          case 'post': {
-            this._handlePostMessage(message.payload);
-            break;
-          }
-        }
-      }),
-    );
-
-    void this._messenger
-      .postMessage(this._channel, {
-        kind: 'query',
-      } satisfies ProtocolMessage)
-      .catch((err) => {
-        log.debug('failed to query awareness', { err });
-      });
-  }
-
-  close(): void {
-    void this._ctx?.dispose();
-    this._ctx = undefined;
-    this._postTask = undefined;
-  }
-
-  getRemoteStates(): AwarenessState[] {
-    return Array.from(this._remoteStates.values());
-  }
-
-  update(position: AwarenessPosition | undefined): void {
-    invariant(this._postTask);
-    this._localState = {
-      peerId: this._peerId,
-      position,
-      info: this._info,
-    };
-
-    this._postTask.schedule();
-  }
-
-  private _handleQueryMessage(): void {
-    invariant(this._postTask);
-    this._postTask.schedule();
-  }
-
-  private _handlePostMessage(message: ProtocolMessage): void {
-    invariant(message.kind === 'post');
-    // TODO(wittjosiah): Is it helpful or confusing to show cursors for self on other devices?
-    this._remoteStates.set(message.state.peerId, message.state);
-    this.remoteStateChange.emit();
-  }
-}

package/src/extensions/awareness/awareness.ts

@@ -1,315 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { Annotation, type Extension, type Range, RangeSet } from '@codemirror/state';
-import {
-  Decoration,
-  type DecorationSet,
-  EditorView,
-  type PluginValue,
-  ViewPlugin,
-  type ViewUpdate,
-  WidgetType,
-} from '@codemirror/view';
-
-import { Event } from '@dxos/async';
-import { Context } from '@dxos/context';
-
-import { Cursor, type CursorConverter, singleValueFacet } from '../../util';
-
-export interface AwarenessProvider {
-  remoteStateChange: Event<void>;
-
-  open(): void;
-  close(): void;
-
-  getRemoteStates(): AwarenessState[];
-  update(position: AwarenessPosition | undefined): void;
-}
-
-const dummyProvider: AwarenessProvider = {
-  remoteStateChange: new Event(),
-
-  open: () => {},
-  close: () => {},
-
-  getRemoteStates: () => [],
-  update: () => {},
-};
-
-export const awarenessProvider = singleValueFacet<AwarenessProvider>(dummyProvider);
-
-// TODO(dmaretskyi): Specify the users that actually changed. Currently, we recalculate positions for every user.
-const RemoteSelectionChangedAnnotation = Annotation.define();
-
-export type AwarenessPosition = {
-  anchor?: string;
-  head?: string;
-};
-
-export type AwarenessInfo = {
-  displayName: string;
-  darkColor: string;
-  lightColor: string;
-};
-
-export type AwarenessState = {
-  position?: AwarenessPosition;
-  peerId: string;
-  info: AwarenessInfo;
-};
-
-/**
- * Extension provides presence information about other peers.
- */
-export const awareness = (provider = dummyProvider): Extension => {
-  return [
-    awarenessProvider.of(provider),
-    ViewPlugin.fromClass(RemoteSelectionsDecorator, {
-      decorations: (value) => value.decorations,
-    }),
-    styles,
-  ];
-};
-
-/**
- * Generates selection decorations from remote peers.
- */
-export class RemoteSelectionsDecorator implements PluginValue {
-  private readonly _ctx = new Context();
-  private readonly _cursorConverter: CursorConverter;
-  private readonly _provider: AwarenessProvider;
-
-  private _lastAnchor?: number;
-  private _lastHead?: number;
-
-  public decorations: DecorationSet = RangeSet.of([]);
-
-  constructor(view: EditorView) {
-    this._cursorConverter = view.state.facet(Cursor.converter);
-    this._provider = view.state.facet(awarenessProvider);
-    this._provider.open();
-    this._provider.remoteStateChange.on(this._ctx, () => {
-      view.dispatch({ annotations: [RemoteSelectionChangedAnnotation.of([])] });
-    });
-  }
-
-  destroy(): void {
-    void this._ctx.dispose();
-    this._provider.close();
-  }
-
-  update(update: ViewUpdate): void {
-    this._updateLocalSelection(update.view);
-    this._updateRemoteSelections(update.view);
-  }
-
-  private _updateLocalSelection(view: EditorView): void {
-    const hasFocus = view.hasFocus && view.dom.ownerDocument.hasFocus();
-    const { anchor = undefined, head = undefined } = hasFocus ? view.state.selection.main : {};
-    if (this._lastAnchor === anchor && this._lastHead === head) {
-      return;
-    }
-
-    this._lastAnchor = anchor;
-    this._lastHead = head;
-
-    this._provider.update(
-      anchor !== undefined && head !== undefined
-        ? {
-            anchor: this._cursorConverter.toCursor(anchor),
-            head: this._cursorConverter.toCursor(head, -1),
-          }
-        : undefined,
-    );
-  }
-
-  private _updateRemoteSelections(view: EditorView): void {
-    const decorations: Range<Decoration>[] = [
-      // TODO(burdon): Factor out for testing.
-      // {
-      //   from: 0,
-      //   to: 0,
-      //   value: Decoration.widget({ side: 0, block: false, widget: new RemoteCaretWidget('Test', 'red') }),
-      // },
-    ];
-
-    const awarenessStates = this._provider.getRemoteStates();
-    for (const state of awarenessStates) {
-      const anchor = state.position?.anchor ? this._cursorConverter.fromCursor(state.position.anchor) : null;
-      const head = state.position?.head ? this._cursorConverter.fromCursor(state.position.head) : null;
-      if (anchor == null || head == null) {
-        continue;
-      }
-
-      const start = Math.min(Math.min(anchor, head), view.state.doc.length);
-      const end = Math.min(Math.max(anchor, head), view.state.doc.length);
-
-      const startLine = view.state.doc.lineAt(start);
-      const endLine = view.state.doc.lineAt(end);
-
-      const darkColor = state.info.darkColor;
-      const lightColor = state.info.lightColor;
-
-      if (startLine.number === endLine.number) {
-        // Selected content in a single line.
-        decorations.push({
-          from: start,
-          to: end,
-          value: Decoration.mark({
-            attributes: { style: `background-color: ${lightColor}` },
-            class: 'cm-collab-selection',
-          }),
-        });
-      } else {
-        // Selected content in multiple lines; first, render text-selection in the first line.
-        decorations.push({
-          from: start,
-          to: startLine.from + startLine.length,
-          value: Decoration.mark({
-            attributes: { style: `background-color: ${lightColor}` },
-            class: 'cm-collab-selection',
-          }),
-        });
-
-        // Render text-selection in the last line.
-        decorations.push({
-          from: endLine.from,
-          to: end,
-          value: Decoration.mark({
-            attributes: { style: `background-color: ${lightColor}` },
-            class: 'cm-collab-selection',
-          }),
-        });
-
-        for (let i = startLine.number + 1; i < endLine.number; i++) {
-          const linePos = view.state.doc.line(i).from;
-          decorations.push({
-            from: linePos,
-            to: linePos,
-            value: Decoration.line({
-              attributes: { style: `background-color: ${lightColor}`, class: 'cm-collab-selectionLine' },
-            }),
-          });
-        }
-      }
-
-      decorations.push({
-        from: head,
-        to: head,
-        value: Decoration.widget({
-          side: head - anchor > 0 ? -1 : 1, // The local cursor should be rendered outside the remote selection.
-          block: false,
-          widget: new RemoteCaretWidget(state.info.displayName ?? 'Anonymous', darkColor),
-        }),
-      });
-    }
-
-    this.decorations = Decoration.set(decorations, true);
-  }
-}
-
-class RemoteCaretWidget extends WidgetType {
-  constructor(
-    private readonly _name: string,
-    private readonly _color: string,
-  ) {
-    super();
-  }
-
-  override toDOM(): HTMLElement {
-    const span = document.createElement('span');
-    span.className = 'cm-collab-selectionCaret';
-    span.style.backgroundColor = this._color;
-    span.style.borderColor = this._color;
-
-    const dot = document.createElement('div');
-    dot.className = 'cm-collab-selectionCaretDot';
-
-    const info = document.createElement('div');
-    info.className = 'cm-collab-selectionInfo';
-    info.innerText = this._name;
-
-    span.appendChild(document.createTextNode('\u2060'));
-    span.appendChild(dot);
-    span.appendChild(document.createTextNode('\u2060'));
-    span.appendChild(info);
-    span.appendChild(document.createTextNode('\u2060'));
-    return span;
-  }
-
-  override updateDOM(): boolean {
-    return false;
-  }
-
-  override eq(widget: this): boolean {
-    return widget._color === this._color;
-  }
-
-  override get estimatedHeight() {
-    return -1;
-  }
-
-  override ignoreEvent(): boolean {
-    return true;
-  }
-}
-
-const styles = EditorView.theme({
-  '.cm-collab-selection': {},
-  '.cm-collab-selectionLine': {
-    padding: 0,
-    margin: '0px 2px 0px 4px',
-  },
-  '.cm-collab-selectionCaret': {
-    position: 'relative',
-    borderLeft: '1px solid black',
-    borderRight: '1px solid black',
-    marginLeft: '-1px',
-    marginRight: '-1px',
-    boxSizing: 'border-box',
-    display: 'inline',
-    cursor: 'pointer',
-  },
-  '.cm-collab-selectionCaretDot': {
-    borderRadius: '50%',
-    position: 'absolute',
-    width: '.5em',
-    height: '.5em',
-    top: '-.25em',
-    left: '-.25em',
-    backgroundColor: 'inherit',
-    transition: 'transform .3s ease-in-out',
-    boxSizing: 'border-box',
-  },
-  '.cm-collab-selectionCaret:hover > .cm-collab-selectionCaretDot': {
-    transform: 'scale(0)',
-    transformOrigin: 'center',
-  },
-  '.cm-collab-selectionInfo': {
-    position: 'absolute',
-    transform: 'translate(-50%, 0)',
-    top: '-20px',
-    left: 0,
-    fontSize: '.75em',
-    fontFamily: 'sans-serif',
-    fontStyle: 'normal',
-    fontWeight: 'normal',
-    lineHeight: 'normal',
-    userSelect: 'none',
-    color: 'white',
-    padding: '2px 6px',
-    zIndex: 101,
-    transition: 'opacity .3s ease-in-out',
-    backgroundColor: 'inherit',
-    borderRadius: '2px',
-    opacity: 0,
-    transitionDelay: '0s',
-    whiteSpace: 'nowrap',
-  },
-  '.cm-collab-selectionCaret:hover > .cm-collab-selectionInfo': {
-    opacity: 1,
-    transitionDelay: '0s',
-  },
-});

package/src/extensions/awareness/index.ts

@@ -1,6 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-export * from './awareness';
-export * from './awareness-provider';