@tiptap/extensions 3.27.2 → 3.27.3

package/src/placeholder/utils/viewportTracking.ts

@@ -1,137 +0,0 @@
-import type { EditorState, PluginView, StateField, Transaction } from '@tiptap/pm/state'
-import type { EditorView } from '@tiptap/pm/view'
-
-import { PLUGIN_KEY } from '../constants.js'
-import type { ViewportState } from '../types.js'
-import { findScrollParent } from './findScrollParent.js'
-import { getViewportBoundaryPositions } from './getViewportBoundaryPositions.js'
-
-/**
- * The plugin `state` config that tracks the visible viewport boundaries so the
- * decoration callback only scans the nodes currently on screen.
- */
-export const viewportPluginState: StateField<ViewportState> = {
-  /**
-   * Initialises the viewport state with no known positions.
-   * @returns The initial viewport state.
-   */
-  init(): ViewportState {
-    return { topPos: null, bottomPos: null }
-  },
-
-  /**
-   * Updates the viewport state from incoming transactions.
-   * @param tr - The transaction being applied.
-   * @param prev - The previous viewport state.
-   * @returns The next viewport state.
-   */
-  apply(tr: Transaction, prev: ViewportState): ViewportState {
-    const meta = tr.getMeta(PLUGIN_KEY) as
-      | { positions?: { top: number; bottom: number } }
-      | undefined
-
-    if (meta?.positions) {
-      return { topPos: meta.positions.top, bottomPos: meta.positions.bottom }
-    }
-
-    if (!tr.docChanged) {
-      return prev
-    }
-
-    // Preserve last known viewport positions across transactions.
-    // Without this, every keystroke resets back to a full document
-    // scan, defeating the viewport optimisation.
-    // Only map when we have actual positions — null means "no viewport
-    // info yet" and should stay null to fall back to full doc scan.
-    return {
-      topPos: prev.topPos !== null ? tr.mapping.map(prev.topPos) : null,
-      bottomPos: prev.bottomPos !== null ? tr.mapping.map(prev.bottomPos) : null,
-    }
-  },
-}
-
-/**
- * Creates the plugin `view` that recomputes the visible viewport on scroll and
- * document size changes, dispatching the result into the plugin state.
- * @param view - The editor view the plugin is attached to.
- * @returns A plugin view with `update` and `destroy` handlers.
- */
-export function createViewportPluginView(view: EditorView): PluginView {
-  const scrollContainer = findScrollParent(view.dom)
-
-  const computeAndDispatch = () => {
-    const positions = getViewportBoundaryPositions({
-      view,
-      scrollContainer,
-    })
-
-    // Not measurable, keep the last good window frozen
-    if (positions === null) {
-      return
-    }
-
-    const prev = PLUGIN_KEY.getState(view.state)
-    if (prev?.topPos === positions.top && prev?.bottomPos === positions.bottom) {
-      return
-    }
-
-    const tr = view.state.tr.setMeta(PLUGIN_KEY, { positions })
-    view.dispatch(tr)
-  }
-
-  // rAF-based scheduler with interval guard (150ms → ~6–7 Hz) used by
-  // scroll events and update(). The overscan margin hides the extra
-  // latency. When the guard blocks, the callback reschedules itself so
-  // the trailing position is always captured.
-  let frame: number | null = null
-  let lastCompute = 0
-  const MIN_SCROLL_INTERVAL = 150
-
-  const scheduleFrame = () => {
-    if (frame !== null) return
-    frame = requestAnimationFrame(() => {
-      frame = null
-      const now = performance.now()
-      if (now - lastCompute >= MIN_SCROLL_INTERVAL) {
-        lastCompute = now
-        computeAndDispatch()
-      } else {
-        scheduleFrame()
-      }
-    })
-  }
-
-  scrollContainer.addEventListener('scroll', scheduleFrame, { passive: true })
-
-  // Recover a frozen window once the editor becomes usable again (e.g. a modal
-  // closes): re-measure on size/visibility changes and when focus returns.
-  const resizeObserver =
-    typeof ResizeObserver !== 'undefined' ? new ResizeObserver(scheduleFrame) : null
-  resizeObserver?.observe(view.dom)
-
-  const intersectionObserver =
-    typeof IntersectionObserver !== 'undefined' ? new IntersectionObserver(scheduleFrame) : null
-  intersectionObserver?.observe(view.dom)
-
-  view.dom.addEventListener('focus', scheduleFrame)
-
-  // Fire once to populate initial viewport
-  computeAndDispatch()
-
-  return {
-    update(_view: EditorView, prevState: EditorState) {
-      if (view.state.doc.content.size !== prevState.doc.content.size) {
-        scheduleFrame()
-      }
-    },
-    destroy: () => {
-      if (frame !== null) {
-        cancelAnimationFrame(frame)
-      }
-      scrollContainer.removeEventListener('scroll', scheduleFrame)
-      resizeObserver?.disconnect()
-      intersectionObserver?.disconnect()
-      view.dom.removeEventListener('focus', scheduleFrame)
-    },
-  }
-}