@dxos/react-ui-editor 0.8.4-main.1da679c → 0.8.4-main.21d9917

package/src/styles/theme.ts

@@ -1,267 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import { type StyleSpec } from 'style-mod';
-
-import { fontBody } from './tokens';
-
-export type ThemeStyles = Record<string, StyleSpec>;
-
-/**
- * Minimal styles.
- * https://codemirror.net/examples/styling
- *
- * Examples:
- * - https://github.com/codemirror/view/blob/main/src/theme.ts
- * - https://github.com/codemirror/theme-one-dark/blob/main/src/one-dark.ts
- *
- * Main layout:
- * https://codemirror.net/examples/styling
- * https://codemirror.net/docs/guide (DOM Structure).
- *
- * <div class="cm-editor [cm-focused] [generated classes]">
- *   <div class="cm-scroller">
- *     <div class="cm-gutters">
- *       <div class="cm-gutter [...]">
- *         <div class="cm-gutterElement">...</div>
- *       </div>
- *     </div>
- *     <div class="cm-content" role="textbox" contenteditable="true">
- *       <div class="cm-line"></div>
- *     </div>
- *     <div class="cm-selectionLayer">
- *       <div class="cm-selectionBackground"></div>
- *     </div>
- *     <div class="cm-cursorLayer">
- *       <div class="cm-cursor"></div>
- *     </div>
- *   </div>
- * </div>
- *
- * NOTE: `light` and `dark` selectors are preprocessed by CodeMirror and can only be in the base theme.
- * NOTE: Use 'unset' to remove default CM style.
- */
-export const defaultTheme: ThemeStyles = {
-  '&': {},
-  '&.cm-focused': {
-    outline: 'none',
-  },
-
-  /**
-   * Scroller
-   */
-  '.cm-scroller': {
-    overflowY: 'auto',
-  },
-
-  /**
-   * Content
-   * NOTE: Apply margins to content so that scrollbar is at the edge of the container.
-   */
-  '.cm-content': {
-    padding: 'unset',
-    fontFamily: fontBody,
-    // NOTE: Base font size (otherwise defined by HTML tag, which might be different for storybook).
-    fontSize: '16px',
-    lineHeight: '24px',
-    color: 'unset',
-  },
-
-  /**
-   * Gutters
-   * NOTE: Gutters should have the same top margin as the content.
-   */
-  '.cm-gutters': {
-    borderRight: 'none',
-    // background: 'transparent',
-  },
-  '.cm-gutter': {},
-  '.cm-gutter.cm-lineNumbers': {
-    paddingRight: '4px',
-    borderRight: '1px solid var(--dx-subduedSeparator)',
-  },
-  '.cm-gutter.cm-lineNumbers .cm-gutterElement': {
-    minWidth: '40px',
-  },
-  /**
-   * Height is set to match the corresponding line (which may have wrapped).
-   */
-  '.cm-gutterElement': {
-    lineHeight: '24px',
-    fontSize: '12px',
-  },
-
-  /**
-   * Line.
-   */
-  '.cm-line': {
-    lineHeight: '24px',
-    paddingInline: 0,
-  },
-  '.cm-activeLine': {
-    background: 'var(--dx-cmActiveLine)',
-  },
-
-  /**
-   * Cursor (layer).
-   */
-  '.cm-cursor, .cm-dropCursor': {
-    borderLeft: '2px solid var(--dx-cmCursor)',
-  },
-  '.cm-placeholder': {
-    color: 'var(--dx-placeholder)',
-  },
-
-  /**
-   * Selection (layer).
-   */
-  '.cm-selectionBackground': {
-    background: 'var(--dx-cmSelection)',
-  },
-  '&.cm-focused > .cm-scroller > .cm-selectionLayer .cm-selectionBackground': {
-    background: 'var(--dx-cmFocusedSelection)',
-  },
-
-  /**
-   * Search.
-   * NOTE: Matches comment.
-   */
-  '.cm-searchMatch': {
-    margin: '0 -3px',
-    padding: '3px',
-    borderRadius: '3px',
-    background: 'var(--dx-cmHighlightSurface)',
-    color: 'var(--dx-cmHighlight)',
-  },
-  '.cm-searchMatch-selected': {
-    textDecoration: 'underline',
-  },
-
-  /**
-   * Link.
-   */
-  '.cm-link': {
-    textDecorationLine: 'underline',
-    textDecorationThickness: '1px',
-    textDecorationColor: 'var(--dx-separator)',
-    textUnderlineOffset: '2px',
-    borderRadius: '.125rem',
-  },
-  '.cm-link > span': {
-    color: 'var(--dx-accentText)',
-  },
-
-  /**
-   * Tooltip.
-   */
-  '.cm-tooltip': {
-    background: 'var(--dx-modalSurface)',
-  },
-  '.cm-tooltip-below': {},
-
-  /**
-   * Autocomplete.
-   * https://github.com/codemirror/autocomplete/blob/main/src/completion.ts
-   */
-  '.cm-tooltip.cm-tooltip-autocomplete': {
-    marginTop: '4px',
-    marginLeft: '-3px',
-    borderColor: 'var(--dx-separator)',
-    borderTop: 'none',
-  },
-  '.cm-tooltip.cm-tooltip-autocomplete > ul': {
-    maxHeight: '20em',
-  },
-  '.cm-tooltip.cm-tooltip-autocomplete > ul > li': {
-    padding: '4px',
-  },
-  '.cm-tooltip.cm-tooltip-autocomplete > ul > li[aria-selected]': {
-    background: 'var(--dx-accentSurface)',
-    color: 'var(--dx-accentSurfaceText)',
-  },
-  '.cm-tooltip.cm-tooltip-autocomplete > ul > completion-section': {
-    paddingLeft: '4px !important',
-    borderBottom: 'none !important',
-    color: 'var(--dx-accentText)',
-  },
-
-  '.cm-completionInfo': {
-    width: '360px !important',
-    margin: '-10px 1px 0 1px',
-    padding: '8px !important',
-    borderColor: 'var(--dx-separator)',
-  },
-  '.cm-completionIcon': {
-    display: 'none',
-  },
-  '.cm-completionLabel': {
-    fontFamily: fontBody,
-  },
-  '.cm-completionMatchedText': {
-    textDecoration: 'none !important',
-    opacity: 0.5,
-  },
-
-  /**
-   * Panels
-   * https://github.com/codemirror/search/blob/main/src/search.ts#L745
-   *
-   * Find/replace panel.
-   * <div class="cm-announced">...</div>
-   * <div class="cm-scroller">...</div>
-   * <div class="cm-panels cm-panels-bottom">
-   *   <div class="cm-search cm-panel">
-   *     <input class="cm-textfield" />
-   *     <button class="cm-button">...</button>
-   *     <label><input type="checkbox" />...</label>
-   *   </div>
-   * </div
-   */
-  // TODO(burdon): Implement custom panel (with icon buttons).
-  '.cm-panels': {},
-  '.cm-panel': {
-    fontFamily: fontBody,
-    backgroundColor: 'var(--surface-bg)',
-  },
-  '.cm-panel input, .cm-panel button, .cm-panel label': {
-    color: 'var(--dx-subdued)',
-    fontFamily: fontBody,
-    fontSize: '14px',
-    all: 'unset',
-    margin: '3px !important',
-    padding: '2px 6px !important',
-    outline: '1px solid transparent',
-  },
-  '.cm-panel input, .cm-panel button': {
-    backgroundColor: 'var(--dx-inputSurface)',
-  },
-  '.cm-panel input:focus, .cm-panel button:focus': {
-    outline: '1px solid var(--dx-neutralFocusIndicator)',
-  },
-  '.cm-panel label': {
-    display: 'inline-flex',
-    alignItems: 'center',
-    cursor: 'pointer',
-  },
-  '.cm-panel input.cm-textfield': {},
-  '.cm-panel input[type=checkbox]': {
-    width: '8px',
-    height: '8px',
-    marginRight: '6px !important',
-    padding: '2px !important',
-    color: 'var(--dx-neutralFocusIndicator)',
-  },
-  '.cm-panel button': {
-    '&:hover': {
-      backgroundColor: 'var(--dx-accentSurfaceHover) !important',
-    },
-    '&:active': {
-      backgroundColor: 'var(--dx-accentSurfaceHover)',
-    },
-  },
-  '.cm-panel.cm-search': {
-    padding: '4px',
-    borderTop: '1px solid var(--dx-separator)',
-  },
-};

package/src/styles/tokens.ts

@@ -1,17 +0,0 @@
-//
-// Copyright 2023 DXOS.org
-//
-
-import { tokens } from '@dxos/react-ui-theme';
-import { get } from '@dxos/util';
-
-/**
- * Returns the tailwind token value.
- */
-const getToken = (path: string, defaultValue?: string | string[]): string => {
-  const value = get(tokens, path, defaultValue);
-  return value?.toString() ?? '';
-};
-
-export const fontBody = getToken('fontFamily.body');
-export const fontMono = getToken('fontFamily.mono');

package/src/testing/PreviewPopover.tsx

@@ -1,78 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { createContext } from '@radix-ui/react-context';
-import React, { type PropsWithChildren, type RefObject, useCallback, useEffect, useRef, useState } from 'react';
-
-import { addEventListener } from '@dxos/async';
-import { type DxAnchorActivate, Popover } from '@dxos/react-ui';
-
-import { type PreviewLinkRef, type PreviewLinkTarget } from '../extensions';
-
-type PreviewLookup = (link: PreviewLinkRef) => Promise<PreviewLinkTarget | null | undefined>;
-
-type PreviewPopoverValue = Partial<{
-  link: PreviewLinkRef;
-  target: PreviewLinkTarget;
-  pending: boolean;
-}>;
-
-const [PreviewPopoverContextProvider, usePreviewPopover] = createContext<PreviewPopoverValue>('PreviewPopover', {});
-
-type PopoverLookupProviderProps = PropsWithChildren<{
-  onLookup?: PreviewLookup;
-}>;
-
-const PreviewPopoverProvider = ({ children, onLookup }: PopoverLookupProviderProps) => {
-  const trigger = useRef<HTMLElement | null>(null);
-  const [value, setValue] = useState<PreviewPopoverValue>({});
-  const [open, setOpen] = useState(false);
-
-  const handleDxAnchorActivate = useCallback(
-    (event: DxAnchorActivate) => {
-      const { refId, label, trigger: dxTrigger } = event;
-      setValue((value) => ({
-        ...value,
-        link: { label, ref: refId },
-        pending: true,
-      }));
-      trigger.current = dxTrigger;
-      queueMicrotask(() => setOpen(true));
-      void onLookup?.({ label, ref: refId }).then((target) =>
-        setValue((value) => ({
-          ...value,
-          target: target ?? undefined,
-          pending: false,
-        })),
-      );
-    },
-    [onLookup],
-  );
-
-  const [rootRef, setRootRef] = useState<HTMLDivElement | null>(null);
-  useEffect(() => {
-    if (!rootRef || !handleDxAnchorActivate) {
-      return;
-    }
-
-    return addEventListener(rootRef, 'dx-anchor-activate' as any, handleDxAnchorActivate, {
-      capture: true,
-      passive: false,
-    });
-  }, [rootRef, handleDxAnchorActivate]);
-
-  return (
-    <PreviewPopoverContextProvider pending={value.pending} link={value.link} target={value.target}>
-      <Popover.Root open={open} onOpenChange={setOpen}>
-        <Popover.VirtualTrigger virtualRef={trigger as unknown as RefObject<HTMLButtonElement>} />
-        <div role='none' className='contents' ref={setRootRef}>
-          {children}
-        </div>
-      </Popover.Root>
-    </PreviewPopoverContextProvider>
-  );
-};
-export { PreviewPopoverProvider, usePreviewPopover };
-
-export type { PopoverLookupProviderProps, PreviewPopoverValue };

package/src/testing/index.ts

@@ -1,6 +0,0 @@
-//
-// Copyright 2022 DXOS.org
-//
-
-export * from './util';
-export * from './PreviewPopover';

package/src/testing/util.ts

@@ -1,7 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-/** deprecated Replace with @dxos/util trim */
-// TODO(burdon): Remove
-export const str = (...lines: string[]) => lines.join('\n');

package/src/types/index.ts

@@ -1,5 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-export * from './types';

package/src/types/types.ts

@@ -1,32 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { type EditorView } from '@codemirror/view';
-import { Schema } from 'effect';
-
-// Runtime data structure.
-export type Range = {
-  from: number;
-  to: number;
-};
-
-// Persistent data structure.
-// TODO(burdon): Rename annotation?
-export type Comment = {
-  id: string;
-  cursor?: string;
-};
-
-/**
- * Callback that renders into a DOM element within the editor.
- */
-export type RenderCallback<Props extends object> = (el: HTMLElement, props: Props, view: EditorView) => void;
-
-export const EditorViewModes = ['preview', 'readonly', 'source'] as const;
-export const EditorViewMode = Schema.Union(...EditorViewModes.map((mode) => Schema.Literal(mode)));
-export type EditorViewMode = Schema.Schema.Type<typeof EditorViewMode>;
-
-export const EditorInputModes = ['default', 'vim', 'vscode'] as const;
-export const EditorInputMode = Schema.Union(...EditorInputModes.map((mode) => Schema.Literal(mode)));
-export type EditorInputMode = Schema.Schema.Type<typeof EditorInputMode>;

package/src/util/cursor.ts

@@ -1,56 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { type EditorState } from '@codemirror/state';
-
-import { type Range } from '../types';
-
-import { singleValueFacet } from './facet';
-
-/**
- * Determines if two ranges overlap.
- * A range is considered to overlap if there is any intersection
- * between the two ranges, inclusive of their boundaries.
- */
-export const overlap = (a: Range, b: Range): boolean => a.from <= b.to && a.to >= b.from;
-
-/**
- * Converts indexes into the text document into stable peer-independent cursors.
- *
- * See:
- *  - https://automerge.org/automerge/api-docs/js/functions/next.getCursor.html
- *  - https://github.com/yjs/yjs?tab=readme-ov-file#relative-positions
- *
- * @param {assoc} number Negative values will associate the cursor with the previous character
- *  while positive - with the next one.
- */
-export interface CursorConverter {
-  toCursor(position: number, assoc?: -1 | 1 | undefined): string;
-  fromCursor(cursor: string): number;
-}
-
-const defaultCursorConverter: CursorConverter = {
-  toCursor: (position) => position.toString(),
-  fromCursor: (cursor) => parseInt(cursor),
-};
-
-export class Cursor {
-  static readonly converter = singleValueFacet(defaultCursorConverter);
-
-  static readonly getCursorFromRange = (state: EditorState, range: Range) => {
-    const cursorConverter = state.facet(Cursor.converter);
-    const from = cursorConverter.toCursor(range.from);
-    const to = cursorConverter.toCursor(range.to, -1);
-    return [from, to].join(':');
-  };
-
-  static readonly getRangeFromCursor = (state: EditorState, cursor: string) => {
-    const cursorConverter = state.facet(Cursor.converter);
-
-    const parts = cursor.split(':');
-    const from = cursorConverter.fromCursor(parts[0]);
-    const to = cursorConverter.fromCursor(parts[1]);
-    return from !== undefined && to !== undefined ? { from, to } : undefined;
-  };
-}

package/src/util/debug.ts

@@ -1,64 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { type Transaction } from '@codemirror/state';
-import { type EditorView } from '@codemirror/view';
-
-import { log } from '@dxos/log';
-
-export const wrapWithCatch = (fn: (...args: any[]) => any, label?: string) => {
-  return (...args: any[]) => {
-    try {
-      return fn(...args);
-    } catch (err) {
-      log.catch(err, { label });
-    }
-  };
-};
-
-/**
- * CodeMirror callbacks swallow errors so wrap handlers.
- */
-// TODO(burdon): Reconcile with wrapWithCatch.
-export const callbackWrapper = <T extends Function>(fn: T): T =>
-  ((...args: any[]) => {
-    try {
-      return fn(...args);
-    } catch (err) {
-      log.catch(err);
-    }
-  }) as unknown as T;
-
-/**
- * Log all changes before dispatching them to the view.
- * https://codemirror.net/docs/ref/#view.EditorView.dispatch
- */
-export const debugDispatcher = (trs: readonly Transaction[], view: EditorView) => {
-  logChanges(trs);
-  view.update(trs);
-};
-
-/**
- * Util to log transactions in update listener.
- */
-export const logChanges = (trs: readonly Transaction[]) => {
-  const changes = trs
-    .flatMap((tr) => {
-      if (tr.changes.empty) {
-        return undefined;
-      }
-
-      const changes: any[] = [];
-      tr.changes.iterChanges((fromA, toA, fromB, toB, inserted) =>
-        changes.push(JSON.stringify({ fromA, toA, fromB, toB, inserted: inserted.toString() })),
-      );
-
-      return changes;
-    })
-    .filter(Boolean);
-
-  if (changes.length) {
-    log('changes', { changes });
-  }
-};

package/src/util/decorations.ts

@@ -1,21 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { type Range } from '@codemirror/state';
-import { type Decoration, type DecorationSet } from '@codemirror/view';
-
-export const decorationSetToArray = (deco: DecorationSet): readonly Range<Decoration>[] => {
-  const ranges: Range<Decoration>[] = [];
-  const iter = deco.iter();
-  while (iter.value) {
-    ranges.push({
-      from: iter.from,
-      to: iter.to,
-      value: iter.value,
-    });
-    iter.next();
-  }
-
-  return ranges;
-};

package/src/util/dom.ts

@@ -1,34 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-export type Rect = {
-  readonly left: number;
-  readonly right: number;
-  readonly top: number;
-  readonly bottom: number;
-};
-
-export const flattenRect = (rect: Rect, left: boolean): Rect => {
-  const x = left ? rect.left : rect.right;
-  return { left: x, right: x, top: rect.top, bottom: rect.bottom };
-};
-
-let scratchRange: Range | null;
-
-export const textRange = (node: Text, from: number, to = from): Range => {
-  const range = scratchRange || (scratchRange = document.createRange());
-  range.setEnd(node, to);
-  range.setStart(node, from);
-  return range;
-};
-
-export const clientRectsFor = (dom: Node): DOMRectList => {
-  if (dom.nodeType === 3) {
-    return textRange(dom as Text, 0, dom.nodeValue!.length).getClientRects();
-  } else if (dom.nodeType === 1) {
-    return (dom as HTMLElement).getClientRects();
-  } else {
-    return [] as any as DOMRectList;
-  }
-};

package/src/util/domino.ts

@@ -1,51 +0,0 @@
-//
-// Copyright 2025 DXOS.org
-//
-
-import { mx } from '@dxos/react-ui-theme';
-import { type ClassNameValue } from '@dxos/react-ui-types';
-
-/**
- * Super lightweight chainable DOM builder.
- */
-export class Domino<T extends HTMLElement> {
-  static of<K extends keyof HTMLElementTagNameMap>(tag: K): Domino<HTMLElementTagNameMap[K]> {
-    return new Domino<HTMLElementTagNameMap[K]>(tag);
-  }
-
-  private readonly _el: T;
-  constructor(tag: keyof HTMLElementTagNameMap) {
-    this._el = document.createElement(tag) as T;
-  }
-  classNames(...classNames: ClassNameValue[]): this {
-    this._el.className = mx(classNames);
-    return this;
-  }
-  text(value: string): this {
-    this._el.textContent = value;
-    return this;
-  }
-  data(key: string, value: string): this {
-    this._el.dataset[key] = value;
-    return this;
-  }
-  style(styles: Partial<CSSStyleDeclaration>): this {
-    Object.assign(this._el.style, styles);
-    return this;
-  }
-  attr<K extends keyof T>(key: K, value: T[K]): this {
-    (this._el as any)[key] = value;
-    return this;
-  }
-  child<C extends HTMLElement>(...children: Domino<C>[]): this {
-    children.forEach((child) => this._el.appendChild(child.build()));
-    return this;
-  }
-  on(event: string, handler: (e: Event) => void): this {
-    this._el.addEventListener(event, handler);
-    return this;
-  }
-  build(): T {
-    return this._el;
-  }
-}

package/src/util/facet.ts

@@ -1,13 +0,0 @@
-//
-// Copyright 2024 DXOS.org
-//
-
-import { Facet } from '@codemirror/state';
-
-export const singleValueFacet = <I, O = I>(defaultValue?: O) =>
-  Facet.define<I, O>({
-    // Called immediately.
-    combine: (providers) => {
-      return (providers[0] ?? defaultValue) as O;
-    },
-  });