@ctzhian/tiptap 1.13.9 → 2.1.0

package/dist/extension/component/TableHandle/index.d.ts

@@ -0,0 +1,28 @@
+import type { Node } from '@tiptap/pm/model';
+import type { Editor } from '@tiptap/react';
+import React from 'react';
+import type { Orientation } from '../../../util/table-utils';
+export interface TableHandleButtonProps {
+    editor: Editor;
+    orientation: Orientation;
+    index?: number;
+    tablePos?: number;
+    tableNode?: Node;
+    onToggleOtherHandle?: (visible: boolean) => void;
+    onOpenChange?: (open: boolean) => void;
+    dragStart?: (e: React.DragEvent) => void;
+}
+export interface TableHandleProps {
+    /**
+     * The Tiptap editor instance.
+     */
+    editor?: Editor | null;
+}
+/**
+ * Main table handle component that manages the positioning and rendering
+ * of table row/column handles, extend buttons, and context menus.
+ */
+export declare function TableHandle({ editor: providedEditor, }: TableHandleProps): React.JSX.Element | null;
+export declare namespace TableHandle {
+    var displayName: string;
+}

package/dist/extension/component/TableHandle/index.js

@@ -0,0 +1,93 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { FloatingPortal } from '@floating-ui/react';
+import React, { useCallback, useMemo, useState } from 'react';
+import { colDragStart, rowDragStart } from "../../node/TableHandler/plugin";
+import { TableHandleMenu } from "./TableHandleMenu";
+import { useTableHandlePositioning } from "./use-table-handle-positioning";
+import { useTableHandleState } from "./use-table-handle-state";
+/**
+ * Main table handle component that manages the positioning and rendering
+ * of table row/column handles, extend buttons, and context menus.
+ */
+export function TableHandle(_ref) {
+  var providedEditor = _ref.editor;
+  var editor = providedEditor;
+  var state = useTableHandleState({
+    editor: editor
+  });
+  var _useState = useState(true),
+    _useState2 = _slicedToArray(_useState, 2),
+    isRowVisible = _useState2[0],
+    setIsRowVisible = _useState2[1];
+  var _useState3 = useState(true),
+    _useState4 = _slicedToArray(_useState3, 2),
+    isColumnVisible = _useState4[0],
+    setIsColumnVisible = _useState4[1];
+  var _useState5 = useState(null),
+    _useState6 = _slicedToArray(_useState5, 2),
+    menuOpen = _useState6[0],
+    setMenuOpen = _useState6[1];
+  var draggingState = useMemo(function () {
+    if (!(state !== null && state !== void 0 && state.draggingState)) return undefined;
+    return {
+      draggedCellOrientation: state.draggingState.draggedCellOrientation,
+      mousePos: state.draggingState.mousePos,
+      initialOffset: state.draggingState.initialOffset
+    };
+  }, [state === null || state === void 0 ? void 0 : state.draggingState]);
+  var _useTableHandlePositi = useTableHandlePositioning((state === null || state === void 0 ? void 0 : state.show) || false, (state === null || state === void 0 ? void 0 : state.referencePosCell) || null, (state === null || state === void 0 ? void 0 : state.referencePosTable) || null, draggingState),
+    rowHandle = _useTableHandlePositi.rowHandle,
+    colHandle = _useTableHandlePositi.colHandle;
+  var toggleRowVisibility = useCallback(function (visible) {
+    setIsRowVisible(visible);
+  }, []);
+  var toggleColumnVisibility = useCallback(function (visible) {
+    setIsColumnVisible(visible);
+  }, []);
+  var handleMenuOpenChange = useCallback(function (type, open) {
+    setMenuOpen(open ? type : null);
+  }, []);
+  if (!editor || !state) return null;
+  var hasValidRowIndex = typeof state.rowIndex === 'number';
+  var hasValidColIndex = typeof state.colIndex === 'number';
+  var shouldShowRow = isRowVisible && rowHandle.isMounted && hasValidRowIndex || menuOpen === 'row';
+  var shouldShowColumn = isColumnVisible && colHandle.isMounted && hasValidColIndex || menuOpen === 'column';
+  var rootElement = state.widgetContainer || document.body;
+  return /*#__PURE__*/React.createElement(FloatingPortal, {
+    root: rootElement
+  }, shouldShowRow && /*#__PURE__*/React.createElement("div", {
+    ref: rowHandle.ref,
+    style: rowHandle.style
+  }, /*#__PURE__*/React.createElement(TableHandleMenu, {
+    editor: editor,
+    orientation: "row",
+    index: state.rowIndex,
+    tablePos: state.blockPos,
+    tableNode: state.block,
+    onToggleOtherHandle: toggleColumnVisibility,
+    dragStart: rowDragStart,
+    onOpenChange: function onOpenChange(open) {
+      return handleMenuOpenChange('row', open);
+    }
+  })), shouldShowColumn && /*#__PURE__*/React.createElement("div", {
+    ref: colHandle.ref,
+    style: colHandle.style
+  }, /*#__PURE__*/React.createElement(TableHandleMenu, {
+    editor: editor,
+    orientation: "column",
+    index: state.colIndex,
+    tablePos: state.blockPos,
+    tableNode: state.block,
+    onToggleOtherHandle: toggleRowVisibility,
+    dragStart: colDragStart,
+    onOpenChange: function onOpenChange(open) {
+      return handleMenuOpenChange('column', open);
+    }
+  })));
+}
+TableHandle.displayName = 'TableHandle';

package/dist/extension/component/TableHandle/use-table-handle-positioning.d.ts

@@ -0,0 +1,40 @@
+/// <reference types="react" />
+type Orientation = 'row' | 'col' | 'cell';
+type DraggingState = {
+    draggedCellOrientation: Exclude<Orientation, 'cell'>;
+    mousePos: number;
+    initialOffset?: number;
+    originalCellSize?: {
+        width: number;
+        height: number;
+    };
+};
+/**
+ * Hook for positioning individual table handles using Floating UI React
+ */
+export declare function useTableHandlePosition(orientation: Orientation, show: boolean, referencePosCell: DOMRect | null, referencePosTable: DOMRect | null, draggingState?: DraggingState): {
+    isMounted: boolean;
+    ref: (node: HTMLElement | null) => void;
+    style: React.CSSProperties;
+};
+/**
+ * Hook for managing positioning of all table handles (row, column, and cell)
+ */
+export declare function useTableHandlePositioning(show: boolean, referencePosCell: DOMRect | null, referencePosTable: DOMRect | null, draggingState?: DraggingState): {
+    rowHandle: {
+        isMounted: boolean;
+        ref: (node: HTMLElement | null) => void;
+        style: import("react").CSSProperties;
+    };
+    colHandle: {
+        isMounted: boolean;
+        ref: (node: HTMLElement | null) => void;
+        style: import("react").CSSProperties;
+    };
+    cellHandle: {
+        isMounted: boolean;
+        ref: (node: HTMLElement | null) => void;
+        style: import("react").CSSProperties;
+    };
+};
+export {};

package/dist/extension/component/TableHandle/use-table-handle-positioning.js

@@ -0,0 +1,193 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+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); }
+import { offset, size, useFloating, useTransitionStyles } from '@floating-ui/react';
+import { useEffect, useMemo } from 'react';
+import { clamp } from "../../../util/table-utils";
+/**
+ * Creates a DOMRect for row handle positioning
+ * Reference is positioned at table edge, aligned with cell
+ */
+function makeRowRect(cell, table, dragging) {
+  if ((dragging === null || dragging === void 0 ? void 0 : dragging.draggedCellOrientation) === 'row') {
+    var _dragging$initialOffs;
+    // Apply the initial offset to maintain handle position
+    var adjustedY = dragging.mousePos + ((_dragging$initialOffs = dragging.initialOffset) !== null && _dragging$initialOffs !== void 0 ? _dragging$initialOffs : 0);
+    var clampedY = clamp(adjustedY, table.y, table.bottom - cell.height);
+    return new DOMRect(table.x, clampedY, table.width, cell.height);
+  }
+  return new DOMRect(table.x, cell.y, table.width, cell.height);
+}
+
+/**
+ * Creates a DOMRect for column handle positioning
+ * Reference is positioned at table edge, aligned with cell
+ */
+function makeColRect(cell, table, dragging) {
+  if ((dragging === null || dragging === void 0 ? void 0 : dragging.draggedCellOrientation) === 'col') {
+    var _dragging$initialOffs2;
+    // Apply the initial offset to maintain handle position
+    var adjustedX = dragging.mousePos + ((_dragging$initialOffs2 = dragging.initialOffset) !== null && _dragging$initialOffs2 !== void 0 ? _dragging$initialOffs2 : 0);
+    var clampedX = clamp(adjustedX, table.x, table.right - cell.width);
+    return new DOMRect(clampedX, table.y, cell.width, table.height);
+  }
+  return new DOMRect(cell.x, table.y, cell.width, table.height);
+}
+
+/**
+ * Creates a DOMRect for cell handle positioning
+ */
+function makeCellRect(cell) {
+  return new DOMRect(cell.x, cell.y, cell.width, 0);
+}
+
+/**
+ * Gets the placement configuration for different handle orientations
+ */
+function getPlacement(orientation) {
+  switch (orientation) {
+    case 'row':
+      return 'left';
+    case 'col':
+      return 'top';
+    case 'cell':
+    default:
+      return 'bottom-end';
+  }
+}
+
+/**
+ * Gets the offset configuration for different handle orientations
+ */
+function getOffset(orientation) {
+  switch (orientation) {
+    case 'row':
+      return 4;
+    case 'col':
+      return 4;
+    case 'cell':
+    default:
+      return {
+        mainAxis: 1,
+        crossAxis: -1
+      };
+  }
+}
+
+/**
+ * Factory function to create DOMRect based on orientation
+ */
+function rectFactory(orientation, cell, table, dragging) {
+  switch (orientation) {
+    case 'row':
+      return makeRowRect(cell, table, dragging);
+    case 'col':
+      return makeColRect(cell, table, dragging);
+    case 'cell':
+    default:
+      return makeCellRect(cell);
+  }
+}
+
+/**
+ * Hook for positioning individual table handles using Floating UI React
+ */
+export function useTableHandlePosition(orientation, show, referencePosCell, referencePosTable, draggingState) {
+  var placement = useMemo(function () {
+    return getPlacement(orientation);
+  }, [orientation]);
+  var offsetValue = useMemo(function () {
+    return getOffset(orientation);
+  }, [orientation]);
+  var _useFloating = useFloating({
+      open: show,
+      placement: placement,
+      middleware: [offset(offsetValue), size({
+        apply: function apply(_ref) {
+          var _ref2, _referencePosCell$wid, _ref3, _referencePosCell$hei;
+          var rects = _ref.rects,
+            elements = _ref.elements;
+          if (!elements.floating) return;
+          var refWidth = (_ref2 = orientation === 'col' ? (_referencePosCell$wid = referencePosCell === null || referencePosCell === void 0 ? void 0 : referencePosCell.width) !== null && _referencePosCell$wid !== void 0 ? _referencePosCell$wid : referencePosTable === null || referencePosTable === void 0 ? void 0 : referencePosTable.width : referencePosTable === null || referencePosTable === void 0 ? void 0 : referencePosTable.width) !== null && _ref2 !== void 0 ? _ref2 : rects.reference.width;
+          var refHeight = (_ref3 = orientation === 'row' ? (_referencePosCell$hei = referencePosCell === null || referencePosCell === void 0 ? void 0 : referencePosCell.height) !== null && _referencePosCell$hei !== void 0 ? _referencePosCell$hei : referencePosTable === null || referencePosTable === void 0 ? void 0 : referencePosTable.height : referencePosTable === null || referencePosTable === void 0 ? void 0 : referencePosTable.height) !== null && _ref3 !== void 0 ? _ref3 : rects.reference.height;
+
+          // Set CSS custom properties for styling
+          elements.floating.style.setProperty('--table-handle-ref-width', "".concat(refWidth, "px"));
+          elements.floating.style.setProperty('--table-handle-ref-height', "".concat(refHeight, "px"));
+
+          // Set the main size dimension based on orientation
+          var mainSize = orientation === 'row' ? refHeight : refWidth;
+          elements.floating.style.setProperty('--table-handle-available-size', "".concat(mainSize, "px"));
+        }
+      })]
+    }),
+    refs = _useFloating.refs,
+    update = _useFloating.update,
+    context = _useFloating.context,
+    floatingStyles = _useFloating.floatingStyles;
+  var _useTransitionStyles = useTransitionStyles(context),
+    isMounted = _useTransitionStyles.isMounted,
+    styles = _useTransitionStyles.styles;
+
+  // Provide a virtual reference rect to Floating UI
+  // Use a function that always returns the latest values to ensure autoUpdate works correctly
+  useEffect(function () {
+    // Nothing to reference yet
+    if (!referencePosCell || !referencePosTable) {
+      refs.setReference(null);
+      return;
+    }
+
+    // Ignore cell handle while dragging (matches original behavior)
+    if (draggingState && orientation === 'cell') {
+      refs.setReference(null);
+      return;
+    }
+
+    // Create a virtual element that always returns the latest rect values
+    // This ensures autoUpdate can detect changes when scrolling
+    refs.setReference({
+      getBoundingClientRect: function getBoundingClientRect() {
+        // Always use the latest values from closure
+        if (!referencePosCell || !referencePosTable) {
+          return new DOMRect();
+        }
+        return rectFactory(orientation, referencePosCell, referencePosTable, draggingState);
+      }
+    });
+  }, [refs, orientation, referencePosCell, referencePosTable, draggingState]);
+
+  // Update position when reference positions change
+  useEffect(function () {
+    if (!show || !referencePosCell || !referencePosTable) return;
+    update();
+  }, [update, show, orientation, referencePosCell, referencePosTable, draggingState]);
+  return useMemo(function () {
+    return {
+      isMounted: isMounted,
+      ref: refs.setFloating,
+      style: _objectSpread(_objectSpread({
+        display: 'flex'
+      }, styles), floatingStyles)
+    };
+  }, [isMounted, refs.setFloating, styles, floatingStyles]);
+}
+
+/**
+ * Hook for managing positioning of all table handles (row, column, and cell)
+ */
+export function useTableHandlePositioning(show, referencePosCell, referencePosTable, draggingState) {
+  var rowHandle = useTableHandlePosition('row', show, referencePosCell, referencePosTable, draggingState);
+  var colHandle = useTableHandlePosition('col', show, referencePosCell, referencePosTable, draggingState);
+  var cellHandle = useTableHandlePosition('cell', show, referencePosCell, referencePosTable, draggingState);
+  return useMemo(function () {
+    return {
+      rowHandle: rowHandle,
+      colHandle: colHandle,
+      cellHandle: cellHandle
+    };
+  }, [rowHandle, colHandle, cellHandle]);
+}

package/dist/extension/component/TableHandle/use-table-handle-state.d.ts

@@ -0,0 +1,22 @@
+import type { Editor } from '@tiptap/react';
+import type { TableHandlesState } from '../../node/TableHandler/plugin';
+export interface UseTableHandleStateConfig {
+    /**
+     * The Tiptap editor instance. If omitted, the hook will use
+     * the context/editor from `useTiptapEditor`.
+     */
+    editor?: Editor | null;
+    /**
+     * Initial state of the table handles
+     */
+    initialState?: TableHandlesState | null;
+    /**
+     * Only update state when specific fields change
+     */
+    watchFields?: (keyof TableHandlesState)[];
+    /**
+     * Callback when state changes
+     */
+    onStateChange?: (state: TableHandlesState | null) => void;
+}
+export declare function useTableHandleState(config?: UseTableHandleStateConfig): TableHandlesState | null;

package/dist/extension/component/TableHandle/use-table-handle-state.js

@@ -0,0 +1,45 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useEffect, useState, useCallback, useRef } from 'react';
+export function useTableHandleState() {
+  var config = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var providedEditor = config.editor,
+    _config$initialState = config.initialState,
+    initialState = _config$initialState === void 0 ? null : _config$initialState,
+    watchFields = config.watchFields,
+    onStateChange = config.onStateChange;
+  var editor = providedEditor;
+  var _useState = useState(initialState),
+    _useState2 = _slicedToArray(_useState, 2),
+    state = _useState2[0],
+    setState = _useState2[1];
+  var prevStateRef = useRef(initialState);
+  var updateState = useCallback(function (newState) {
+    if (watchFields && prevStateRef.current) {
+      var shouldUpdate = watchFields.some(function (field) {
+        return prevStateRef.current[field] !== newState[field];
+      });
+      if (!shouldUpdate) return;
+    }
+    setState(newState);
+    prevStateRef.current = newState;
+    onStateChange === null || onStateChange === void 0 || onStateChange(newState);
+  }, [watchFields, onStateChange]);
+  useEffect(function () {
+    if (!editor) {
+      setState(null);
+      prevStateRef.current = null;
+      onStateChange === null || onStateChange === void 0 || onStateChange(null);
+      return;
+    }
+    editor.on('tableHandleState', updateState);
+    return function () {
+      editor.off('tableHandleState', updateState);
+    };
+  }, [editor, onStateChange, updateState]);
+  return state;
+}

package/dist/extension/component/TableSelectionOverlay/index.d.ts

@@ -0,0 +1,16 @@
+import type { Editor } from '@tiptap/react';
+import React from 'react';
+export interface TableSelectionOverlayProps {
+    editor?: Editor | null;
+    cellMenu?: React.ComponentType<{
+        onOpenChange?: (isOpen: boolean) => void;
+        editor?: Editor | null;
+        onResizeStart?: (handle: ResizeHandle) => (event: React.MouseEvent) => void;
+    }>;
+    showResizeHandles?: boolean;
+    onMenuOpenChange?: (isOpen: boolean) => void;
+}
+type ResizeHandle = 'tl' | 'tr' | 'bl' | 'br' | null;
+export declare function useResizeOverlay(editor: Editor | null, updateSelectionRect: () => void): void;
+export declare const TableSelectionOverlay: React.FC<TableSelectionOverlayProps>;
+export {};