@ctzhian/tiptap 2.6.1 → 2.7.0

package/dist/extension/node/TableOfContents/index.d.ts

@@ -1,11 +1,8 @@
 import { TocList } from "../../../type";
-import { Extension } from '@tiptap/core';
-import { TableOfContentsOptions, TableOfContentsStorage } from './types';
-export * from './types';
-export declare const TableOfContentsExtension: Extension<TableOfContentsOptions, TableOfContentsStorage>;
-interface TableOfContentsProps {
+import { TableOfContentsOptions } from '@tiptap/extension-table-of-contents';
+interface Props {
     onTocUpdate?: (toc: TocList) => void;
     tableOfContentsOptions?: TableOfContentsOptions;
 }
-export declare const TableOfContents: ({ onTocUpdate, tableOfContentsOptions }: TableOfContentsProps) => Extension<TableOfContentsOptions, TableOfContentsStorage>;
-export default TableOfContents;
+export declare const TableOfContentsExtension: ({ onTocUpdate, tableOfContentsOptions }: Props) => import("@tiptap/core").Extension<TableOfContentsOptions, import("@tiptap/extension-table-of-contents").TableOfContentsStorage>;
+export {};

package/dist/extension/node/TableOfContents/index.js

@@ -4,374 +4,31 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-/* eslint-disable @typescript-eslint/no-unused-vars */
-
-import { Extension } from '@tiptap/core';
-import { v4 as uuidv4 } from 'uuid';
-import { TableOfContentsPlugin } from "./plugin";
-import { getHeadlineLevel, getHierarchicalIndexes, getLinearIndexes } from "./util";
-export * from "./types";
-
-// 全局组合状态管理，避免在 IME 组合期间触发 TOC 更新
-var globalCompositionState = false;
-var globalCompositionEndTimer = null;
-var globalInputTimer = null;
-var lastInputTime = 0;
-
-// 全局监听组合状态和输入事件
-if (typeof document !== 'undefined') {
-  document.addEventListener('compositionstart', function () {
-    globalCompositionState = true;
-  }, {
-    passive: true
-  });
-  document.addEventListener('compositionend', function () {
-    globalCompositionState = false;
-    // 组合结束后，延迟刷新所有 TOC 实例
-    if (globalCompositionEndTimer) {
-      clearTimeout(globalCompositionEndTimer);
-    }
-    globalCompositionEndTimer = setTimeout(function () {
-      // 这里会通过 editor 实例来触发刷新
-      // 具体实现在 onTransaction 中处理
-    }, 200);
-  }, {
-    passive: true
-  });
-
-  // 监听所有输入事件，记录最后输入时间
-  document.addEventListener('input', function () {
-    lastInputTime = Date.now();
-  }, {
-    passive: true
-  });
-  document.addEventListener('keydown', function () {
-    lastInputTime = Date.now();
-  }, {
-    passive: true
-  });
-}
-var addTocActiveStatesAndGetItems = function addTocActiveStatesAndGetItems(content, options) {
-  var editor = options.editor;
-  var headlines = [];
-  var scrolledOverIds = [];
-  var activeId = null;
-  if (editor.isDestroyed) {
-    return content;
-  }
-  editor.state.doc.descendants(function (node, pos) {
-    var _options$anchorTypes;
-    var isValidType = (_options$anchorTypes = options.anchorTypes) === null || _options$anchorTypes === void 0 ? void 0 : _options$anchorTypes.includes(node.type.name);
-    if (!isValidType) {
-      return;
-    }
-    headlines.push({
-      node: node,
-      pos: pos
-    });
-  });
-  headlines.forEach(function (headline) {
-    var domElement = editor.view.domAtPos(headline.pos + 1).node;
-    var scrolledOver = options.storage.scrollPosition >= domElement.offsetTop;
-    if (scrolledOver) {
-      activeId = headline.node.attrs.id;
-      scrolledOverIds.push(headline.node.attrs.id);
-    }
-  });
-  return content.map(function (heading) {
-    return _objectSpread(_objectSpread({}, heading), {}, {
-      isActive: heading.id === activeId,
-      isScrolledOver: scrolledOverIds.includes(heading.id)
-    });
-  });
-};
-var setTocData = function setTocData(options) {
-  var editor = options.editor,
-    onUpdate = options.onUpdate;
-  if (editor.isDestroyed) {
-    return;
-  }
-  var headlines = [];
-  var anchors = [];
-  var anchorEls = [];
-  editor.state.doc.descendants(function (node, pos) {
-    var _options$anchorTypes2;
-    var isValidType = (_options$anchorTypes2 = options.anchorTypes) === null || _options$anchorTypes2 === void 0 ? void 0 : _options$anchorTypes2.includes(node.type.name);
-    if (!isValidType) {
-      return;
-    }
-    headlines.push({
-      node: node,
-      pos: pos
-    });
-  });
-  headlines.forEach(function (headline) {
-    if (headline.node.textContent.length === 0) {
-      return;
-    }
-    var domElement = editor.view.domAtPos(headline.pos + 1).node;
-    var scrolledOver = options.storage.scrollPosition >= domElement.offsetTop;
-    anchorEls.push(domElement);
-    var originalLevel = headline.node.attrs.level;
-    var level = options.getLevelFn(headline, anchors);
-    var itemIndex = options.getIndexFn(headline, anchors, level);
-    anchors.push({
-      itemIndex: itemIndex,
-      id: headline.node.attrs.id || options.getId(headline.node.textContent),
-      originalLevel: originalLevel,
-      level: level,
-      textContent: headline.node.textContent,
-      pos: headline.pos,
-      editor: editor,
-      isActive: false,
-      isScrolledOver: scrolledOver,
-      node: headline.node,
-      dom: domElement
-    });
-  });
-
-  // 计算 active 和 scrolledOver 状态
-  anchors = addTocActiveStatesAndGetItems(anchors, {
-    editor: options.editor,
-    anchorTypes: options.anchorTypes,
-    storage: options.storage
-  });
-
-  // 更新存储
-  options.storage.anchors = anchorEls;
-  options.storage.content = anchors;
-
-  // 调用回调
-  if (onUpdate) {
-    var isInitialCreation = options.storage.content.length === 0;
-    onUpdate(anchors, isInitialCreation);
-  }
-};
-export var TableOfContentsExtension = Extension.create({
-  name: 'tableOfContents',
-  addStorage: function addStorage() {
-    return {
-      content: [],
-      anchors: [],
-      scrollHandler: function scrollHandler() {
-        return null;
-      },
-      scrollPosition: 0
-    };
-  },
-  addGlobalAttributes: function addGlobalAttributes() {
-    return [{
-      types: this.options.anchorTypes || ['heading'],
-      attributes: {
-        id: {
-          default: null,
-          renderHTML: function renderHTML(attributes) {
-            return {
-              id: attributes.id
-            };
-          },
-          parseHTML: function parseHTML(element) {
-            return element.id || null;
-          }
-        }
-      }
-    }];
-  },
-  addOptions: function addOptions() {
-    var defaultScrollParent = typeof window !== 'undefined' ? function () {
-      return window;
-    } : undefined;
-    return {
-      // eslint-disable-next-line
-      onUpdate: function onUpdate() {},
-      // eslint-disable-next-line
-      getId: function getId(_textContent) {
-        return uuidv4();
-      },
-      scrollParent: defaultScrollParent,
-      anchorTypes: ['heading']
-    };
-  },
-  addCommands: function addCommands() {
-    var _this = this;
-    return {
-      updateTableOfContents: function updateTableOfContents() {
-        return function (_ref) {
-          var dispatch = _ref.dispatch;
-          if (dispatch) {
-            var _this$options$onUpdat;
-            setTocData({
-              editor: _this.editor,
-              storage: _this.storage,
-              onUpdate: (_this$options$onUpdat = _this.options.onUpdate) === null || _this$options$onUpdat === void 0 ? void 0 : _this$options$onUpdat.bind(_this),
-              getIndexFn: _this.options.getIndex || getLinearIndexes,
-              getLevelFn: _this.options.getLevel || getHeadlineLevel,
-              anchorTypes: _this.options.anchorTypes,
-              getId: _this.options.getId || function (textContent) {
-                return uuidv4();
-              }
-            });
-          }
-          return true;
-        };
-      }
-    };
-  },
-  onTransaction: function onTransaction(_ref2) {
-    var _this2 = this;
-    var transaction = _ref2.transaction;
-    if (!transaction.docChanged) return;
-    var now = Date.now();
-    var timeSinceLastInput = now - lastInputTime;
-
-    // 组合期间完全不处理 TOC 更新，避免打断输入
-    if (globalCompositionState || this.editor.view.composing) {
-      return;
-    }
-
-    // 如果最近有输入（1秒内），延迟处理
-    if (timeSinceLastInput < 1000) {
-      if (globalInputTimer) {
-        clearTimeout(globalInputTimer);
-      }
-      globalInputTimer = setTimeout(function () {
-        // 再次检查组合状态
-        if (!globalCompositionState && !_this2.editor.view.composing) {
-          var _this2$options$onUpda;
-          setTocData({
-            editor: _this2.editor,
-            storage: _this2.storage,
-            onUpdate: (_this2$options$onUpda = _this2.options.onUpdate) === null || _this2$options$onUpda === void 0 ? void 0 : _this2$options$onUpda.bind(_this2),
-            getIndexFn: _this2.options.getIndex || getLinearIndexes,
-            getLevelFn: _this2.options.getLevel || getHeadlineLevel,
-            anchorTypes: _this2.options.anchorTypes,
-            getId: _this2.options.getId || function (textContent) {
-              return uuidv4();
-            }
-          });
-        }
-      }, 1000 - timeSinceLastInput + 200);
-      return;
-    }
-
-    // 非组合期间且无最近输入，使用 setTimeout 确保有足够延迟
-    setTimeout(function () {
-      // 再次检查，确保组合状态没有变化
-      if (!globalCompositionState && !_this2.editor.view.composing) {
-        var _this2$options$onUpda2;
-        setTocData({
-          editor: _this2.editor,
-          storage: _this2.storage,
-          onUpdate: (_this2$options$onUpda2 = _this2.options.onUpdate) === null || _this2$options$onUpda2 === void 0 ? void 0 : _this2$options$onUpda2.bind(_this2),
-          getIndexFn: _this2.options.getIndex || getLinearIndexes,
-          getLevelFn: _this2.options.getLevel || getHeadlineLevel,
-          anchorTypes: _this2.options.anchorTypes,
-          getId: _this2.options.getId || function (textContent) {
-            return uuidv4();
+import { getHierarchicalIndexes, TableOfContents } from '@tiptap/extension-table-of-contents';
+import { Plugin, PluginKey } from '@tiptap/pm/state';
+export var TableOfContentsExtension = function TableOfContentsExtension(_ref) {
+  var onTocUpdate = _ref.onTocUpdate,
+    tableOfContentsOptions = _ref.tableOfContentsOptions;
+  return TableOfContents.extend({
+    addProseMirrorPlugins: function addProseMirrorPlugins() {
+      var imeCompositionPluginKey = new PluginKey('imeComposition');
+      return [new Plugin({
+        key: new PluginKey('tableOfContentImeFix'),
+        appendTransaction: function appendTransaction(transactions, _oldState, newState) {
+          if (transactions.some(function (tr) {
+            return tr.getMeta('composition');
+          })) {
+            return null;
           }
-        });
-      }
-    }, 100);
-  },
-  onCreate: function onCreate() {
-    var _this3 = this;
-    var tr = this.editor.state.tr;
-    var existingIds = [];
-    if (this.options.scrollParent && typeof this.options.scrollParent !== 'function') {
-      console.warn("[Tiptap Table of Contents Deprecation Notice]: The 'scrollParent' option must now be provided as a callback function that returns the 'scrollParent' element. The ability to pass this option directly will be deprecated in future releases.");
-    }
-
-    // 异步处理初始 ID 分配，避免与初始输入竞争
-    requestAnimationFrame(function () {
-      _this3.editor.state.doc.descendants(function (node, pos) {
-        var _this3$options$anchor;
-        var nodeId = node.attrs.id;
-        var isValidType = (_this3$options$anchor = _this3.options.anchorTypes) === null || _this3$options$anchor === void 0 ? void 0 : _this3$options$anchor.includes(node.type.name);
-        if (!isValidType || node.textContent.length === 0) {
-          return;
-        }
-        if (nodeId === null || nodeId === undefined || existingIds.includes(nodeId)) {
-          var id = '';
-          if (_this3.options.getId) {
-            id = _this3.options.getId(node.textContent);
-          } else {
-            id = uuidv4();
+          var imePluginState = imeCompositionPluginKey.getState(newState);
+          if (imePluginState !== null && imePluginState !== void 0 && imePluginState.isComposing) {
+            return null;
           }
-          tr.setNodeMarkup(pos, undefined, _objectSpread(_objectSpread({}, node.attrs), {}, {
-            id: id
-          }));
+          return null;
         }
-        existingIds.push(nodeId);
-      });
-      _this3.editor.view.dispatch(tr);
-
-      // 延迟初始化 TOC 数据
-      setTimeout(function () {
-        var _this3$options$onUpda;
-        setTocData({
-          editor: _this3.editor,
-          storage: _this3.storage,
-          onUpdate: (_this3$options$onUpda = _this3.options.onUpdate) === null || _this3$options$onUpda === void 0 ? void 0 : _this3$options$onUpda.bind(_this3),
-          getIndexFn: _this3.options.getIndex || getLinearIndexes,
-          getLevelFn: _this3.options.getLevel || getHeadlineLevel,
-          anchorTypes: _this3.options.anchorTypes,
-          getId: _this3.options.getId || function (textContent) {
-            return uuidv4();
-          }
-        });
-      }, 100);
-    });
-
-    // 防抖的 scroll handler，避免滚动期间频繁触发回调
-    var scrollTimer = null;
-    this.storage.scrollHandler = function () {
-      if (!_this3.options.scrollParent) {
-        return;
-      }
-      var scrollParent = typeof _this3.options.scrollParent === 'function' ? _this3.options.scrollParent() : _this3.options.scrollParent;
-      var scrollPosition = scrollParent instanceof HTMLElement ? scrollParent.scrollTop : scrollParent.scrollY;
-      _this3.storage.scrollPosition = scrollPosition || 0;
-      if (scrollTimer) clearTimeout(scrollTimer);
-      scrollTimer = setTimeout(function () {
-        var _this3$options$onUpda2, _this3$options;
-        var updatedItems = addTocActiveStatesAndGetItems(_this3.storage.content, {
-          editor: _this3.editor,
-          anchorTypes: _this3.options.anchorTypes,
-          storage: _this3.storage
-        });
-        _this3.storage.content = updatedItems;
-        // 调用 onUpdate 回调
-        (_this3$options$onUpda2 = (_this3$options = _this3.options).onUpdate) === null || _this3$options$onUpda2 === void 0 || _this3$options$onUpda2.call(_this3$options, updatedItems, false);
-      }, 100);
-    };
-
-    // 添加滚动监听
-    if (this.options.scrollParent) {
-      var scrollParent = typeof this.options.scrollParent === 'function' ? this.options.scrollParent() : this.options.scrollParent;
-      if (scrollParent) {
-        scrollParent.addEventListener('scroll', this.storage.scrollHandler);
-      }
-    }
-  },
-  onDestroy: function onDestroy() {
-    if (this.options.scrollParent) {
-      var scrollParent = typeof this.options.scrollParent === 'function' ? this.options.scrollParent() : this.options.scrollParent;
-      if (scrollParent) {
-        scrollParent.removeEventListener('scroll', this.storage.scrollHandler);
-      }
+      })];
     }
-  },
-  addProseMirrorPlugins: function addProseMirrorPlugins() {
-    return [TableOfContentsPlugin({
-      getId: this.options.getId,
-      anchorTypes: this.options.anchorTypes
-    })];
-  }
-});
-export var TableOfContents = function TableOfContents(_ref3) {
-  var onTocUpdate = _ref3.onTocUpdate,
-    tableOfContentsOptions = _ref3.tableOfContentsOptions;
-  return TableOfContentsExtension.configure(_objectSpread(_objectSpread({
+  }).configure(_objectSpread(_objectSpread({
     getIndex: getHierarchicalIndexes
   }, tableOfContentsOptions || {}), {}, {
     onUpdate: function onUpdate(data, isCreate) {
@@ -390,60 +47,7 @@ export var TableOfContents = function TableOfContents(_ref3) {
             textContent: content.textContent
           };
         }));
-      }, 0);
+      }, 60);
     }
   }));
-};
-export default TableOfContents;
-
-// import { TocList } from '@ctzhian/tiptap/type'
-// import { getHierarchicalIndexes, TableOfContents, TableOfContentsOptions } from '@tiptap/extension-table-of-contents'
-// import { Plugin, PluginKey } from '@tiptap/pm/state'
-
-// interface Props {
-//   onTocUpdate?: (toc: TocList) => void
-//   tableOfContentsOptions?: TableOfContentsOptions
-// }
-
-// export const TableOfContentsExtension = ({ onTocUpdate, tableOfContentsOptions }: Props) => TableOfContents.extend({
-//   addProseMirrorPlugins() {
-//     const imeCompositionPluginKey = new PluginKey('imeComposition')
-
-//     return [
-//       new Plugin({
-//         key: new PluginKey('tableOfContentImeFix'),
-//         appendTransaction(transactions, _oldState, newState) {
-//           if (transactions.some(tr => tr.getMeta('composition'))) {
-//             return null
-//           }
-//           const imePluginState = imeCompositionPluginKey.getState(newState) as { isComposing?: boolean } | null
-//           if (imePluginState?.isComposing) {
-//             return null
-//           }
-//           return null
-//         },
-//       }),
-//     ]
-//   }
-// }).configure({
-//   getIndex: getHierarchicalIndexes,
-//   ...(tableOfContentsOptions || {}),
-//   onUpdate(data, isCreate) {
-//     // 先调用用户传入的 onUpdate 回调（如果存在）
-//     tableOfContentsOptions?.onUpdate?.(data, isCreate)
-
-//     // 然后调用我们的 onTocUpdate 回调
-//     setTimeout(() => {
-//       onTocUpdate?.(data.map(content => ({
-//         id: content.id,
-//         isActive: content.isActive,
-//         isScrolledOver: content.isScrolledOver,
-//         itemIndex: content.itemIndex,
-//         level: content.level,
-//         originalLevel: content.originalLevel,
-//         pos: content.pos,
-//         textContent: content.textContent,
-//       })))
-//     }, 60)
-//   }
-// })
+};

package/dist/util/table-utils.d.ts

@@ -32,6 +32,16 @@ export type StateSelectionOptions = {
 export type TableInfo = {
     map: TableMap;
 } & FindNodeResult;
+export type CellWithRect = {
+    pos: number;
+    node: Node;
+    rect: {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+    };
+};
 export declare function isHTMLElement(n: unknown): n is HTMLElement;
 export type DomCellAroundResult = {
     type: 'cell';
@@ -43,22 +53,10 @@ export type DomCellAroundResult = {
     tbodyNode: HTMLTableSectionElement | null;
 };
 export declare function safeClosest<T extends Element>(start: Element | null, selector: string): T | null;
-/**
- * Walk up from an element until we find a TD/TH or the table wrapper.
- * Returns the found element plus its tbody (if present).
- */
 export declare function domCellAround(target: Element): DomCellAroundResult | undefined;
-/**
- * Clamps a value between min and max bounds
- */
 export declare function clamp(value: number, min: number, max: number): number;
-/**
- * Checks if a cell is merged (has colspan or rowspan > 1)
- */
 export declare function isCellMerged(node: Node | null): boolean;
-/**
- * Get information about the table at the current selection or a specific position.
- */
+export declare function getUniqueCellsWithRect(table: TableInfo): CellWithRect[];
 export declare function getTable(editor: Editor | null, tablePos?: number): {
     map: TableMap;
     node: Node;
@@ -66,40 +64,16 @@ export declare function getTable(editor: Editor | null, tablePos?: number): {
     start: number;
     depth: number;
 } | null;
-/**
- * Checks if the current text selection is inside a table cell.
- */
 export declare function isSelectionInCell(state: EditorState): boolean;
-/**
- * Runs a function while preserving the editor's selection.
- */
 export declare function runPreservingCursor(editor: Editor, fn: () => void): boolean;
-/**
- * Determines whether a table cell is effectively empty.
- */
 export declare function isCellEmpty(cellNode: Node): boolean;
-/**
- * Counts how many consecutive empty rows exist at the bottom of a given table.
- */
 export declare function countEmptyRowsFromEnd(editor: Editor, tablePos: number): number;
-/**
- * Counts how many consecutive empty columns exist at the right edge of a given table.
- */
 export declare function countEmptyColumnsFromEnd(editor: Editor, tablePos: number): number;
-/**
- * Rounds a number with a symmetric "dead-zone" around integer boundaries.
- */
 export declare function marginRound(num: number, margin?: number): number;
-/**
- * Selects table cells by their (row, col) coordinates.
- */
 export declare function selectCellsByCoords(editor: Editor | null, tablePos: number, coords: {
     row: number;
     col: number;
 }[], options?: BaseSelectionOptions | DispatchSelectionOptions): EditorState | Transaction | void;
-/**
- * Select the cell at (row, col) using `cellAround` to respect merged cells.
- */
 export declare function selectCellAt({ editor, row, col, tablePos, dispatch, }: {
     editor: Editor | null;
     row: number;
@@ -107,13 +81,7 @@ export declare function selectCellAt({ editor, row, col, tablePos, dispatch, }:
     tablePos?: number;
     dispatch?: (tr: Transaction) => void;
 }): boolean;
-/**
- * Selects a boundary cell of the table based on orientation.
- */
 export declare function selectLastCell(editor: Editor, tableNode: Node, tablePos: number, orientation: Orientation): boolean;
-/**
- * Get all (row, col) coordinates for a given row or column index.
- */
 export declare function getIndexCoordinates({ editor, index, orientation, tablePos, }: {
     editor: Editor | null;
     index: number;
@@ -123,39 +91,38 @@ export declare function getIndexCoordinates({ editor, index, orientation, tableP
     row: number;
     col: number;
 }[] | null;
-/**
- * Given a DOM cell element, find its (row, col) indices within the table.
- */
+export declare function getRowOriginCoords({ editor, rowIndex, tablePos, includeMerged, }: {
+    editor: Editor | null;
+    rowIndex: number;
+    tablePos?: number;
+    includeMerged?: boolean;
+}): {
+    row: number;
+    col: number;
+}[] | null;
+export declare function getRowOriginCells(editor: Editor | null, rowIndex: number, tablePos?: number, options?: {
+    includeMerged?: boolean;
+}): {
+    cells: CellInfo[];
+    mergedCells: CellInfo[];
+};
 export declare function getCellIndicesFromDOM(cell: HTMLTableCellElement, tableNode: Node | null, editor: Editor): {
     rowIndex: number;
     colIndex: number;
 } | null;
-/**
- * Given a DOM element inside a table, find the corresponding table node and its position.
- */
 export declare function getTableFromDOM(tableElement: HTMLElement, editor: Editor): {
     node: Node;
     pos: number;
 } | null;
-/**
- * Checks if a node is a table node
- */
 export declare function isTableNode(node: Node | null | undefined): node is Node;
-/**
- * Get all cells (and unique merged cells) from a specific row.
- */
 export declare function getRowCells(editor: Editor | null, rowIndex?: number, tablePos?: number): {
     cells: CellInfo[];
     mergedCells: CellInfo[];
 };
-/**
- * Collect cells (and unique merged cells) from the current table.
- */
 export declare function getColumnCells(editor: Editor | null, columnIndex?: number, tablePos?: number): {
     cells: CellInfo[];
     mergedCells: CellInfo[];
 };
-/**
- * Compare two DOMRects for equality (within a small tolerance)
- */
+export declare function adjustRowspanForRowInsert(editor: Editor, tablePos: number, insertRowIndex: number): boolean;
+export declare function adjustRowspanForRowDelete(editor: Editor, tablePos: number, deleteRowIndex: number): boolean;
 export declare function rectEq(rect1: DOMRect | null, rect2: DOMRect | null): boolean;