@kopexa/extension-table 17.0.45 → 17.1.0

package/dist/hooks/use-table-delete-row-column.d.mts

@@ -0,0 +1,87 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _kopexa_icons from '@kopexa/icons';
+import { Editor } from '@tiptap/react';
+import { Orientation } from '../lib/table-utils.mjs';
+import '@tiptap/pm/model';
+import '@tiptap/pm/state';
+import '@tiptap/pm/tables';
+
+interface UseTableDeleteRowColumnConfig {
+    /**
+     * The Tiptap editor instance. If omitted, the hook will use
+     * the context/editor from `useTiptapEditor`.
+     */
+    editor?: Editor | null;
+    /**
+     * The index of the row or column to delete.
+     */
+    index?: number;
+    /**
+     * Whether you're deleting a row or a column.
+     */
+    orientation?: Orientation;
+    /**
+     * The position of the table in the document.
+     */
+    tablePos?: number;
+    /**
+     * Hide the button when deletion isn't currently possible.
+     * @default false
+     */
+    hideWhenUnavailable?: boolean;
+    /**
+     * Callback function called after a successful delete.
+     */
+    onDeleted?: () => void;
+}
+/**
+ * Custom hook that provides **table row/column deletion**
+ * functionality for the Tiptap editor.
+ *
+ * @example
+ * ```tsx
+ * // Simple usage with default editor context
+ * function DeleteRowButton() {
+ *   const { isVisible, handleDelete } = useTableDeleteRowColumn({
+ *     index: 0,
+ *     orientation: "row",
+ *   })
+ *
+ *   if (!isVisible) return null
+ *
+ *   return <button onClick={handleDelete}>Delete Row</button>
+ * }
+ *
+ * // Advanced usage with custom editor instance
+ * function DeleteColumnButton({ editor }: { editor: Editor }) {
+ *   const { isVisible, handleDelete, label, canDeleteRowColumn, Icon } = useTableDeleteRowColumn({
+ *     editor,
+ *     index: 1,
+ *     orientation: "column",
+ *     hideWhenUnavailable: true,
+ *     onDeleted: () => console.log("Column deleted!"),
+ *   })
+ *
+ *   if (!isVisible) return null
+ *
+ *   return (
+ *     <button
+ *       onClick={handleDelete}
+ *       aria-disabled={!canDeleteRowColumn}
+ *       aria-label={label}
+ *     >
+ *       <Icon /> Delete Column
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+declare function useTableDeleteRowColumn(config: UseTableDeleteRowColumnConfig): {
+    isVisible: boolean;
+    canDeleteRowColumn: boolean;
+    handleDelete: () => boolean;
+    label: string;
+    Icon: ({ size, ...props }: _kopexa_icons.IconSvgProps) => react_jsx_runtime.JSX.Element;
+};
+
+export { type UseTableDeleteRowColumnConfig, useTableDeleteRowColumn };

package/dist/hooks/use-table-delete-row-column.d.ts

@@ -0,0 +1,87 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _kopexa_icons from '@kopexa/icons';
+import { Editor } from '@tiptap/react';
+import { Orientation } from '../lib/table-utils.js';
+import '@tiptap/pm/model';
+import '@tiptap/pm/state';
+import '@tiptap/pm/tables';
+
+interface UseTableDeleteRowColumnConfig {
+    /**
+     * The Tiptap editor instance. If omitted, the hook will use
+     * the context/editor from `useTiptapEditor`.
+     */
+    editor?: Editor | null;
+    /**
+     * The index of the row or column to delete.
+     */
+    index?: number;
+    /**
+     * Whether you're deleting a row or a column.
+     */
+    orientation?: Orientation;
+    /**
+     * The position of the table in the document.
+     */
+    tablePos?: number;
+    /**
+     * Hide the button when deletion isn't currently possible.
+     * @default false
+     */
+    hideWhenUnavailable?: boolean;
+    /**
+     * Callback function called after a successful delete.
+     */
+    onDeleted?: () => void;
+}
+/**
+ * Custom hook that provides **table row/column deletion**
+ * functionality for the Tiptap editor.
+ *
+ * @example
+ * ```tsx
+ * // Simple usage with default editor context
+ * function DeleteRowButton() {
+ *   const { isVisible, handleDelete } = useTableDeleteRowColumn({
+ *     index: 0,
+ *     orientation: "row",
+ *   })
+ *
+ *   if (!isVisible) return null
+ *
+ *   return <button onClick={handleDelete}>Delete Row</button>
+ * }
+ *
+ * // Advanced usage with custom editor instance
+ * function DeleteColumnButton({ editor }: { editor: Editor }) {
+ *   const { isVisible, handleDelete, label, canDeleteRowColumn, Icon } = useTableDeleteRowColumn({
+ *     editor,
+ *     index: 1,
+ *     orientation: "column",
+ *     hideWhenUnavailable: true,
+ *     onDeleted: () => console.log("Column deleted!"),
+ *   })
+ *
+ *   if (!isVisible) return null
+ *
+ *   return (
+ *     <button
+ *       onClick={handleDelete}
+ *       aria-disabled={!canDeleteRowColumn}
+ *       aria-label={label}
+ *     >
+ *       <Icon /> Delete Column
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+declare function useTableDeleteRowColumn(config: UseTableDeleteRowColumnConfig): {
+    isVisible: boolean;
+    canDeleteRowColumn: boolean;
+    handleDelete: () => boolean;
+    label: string;
+    Icon: ({ size, ...props }: _kopexa_icons.IconSvgProps) => react_jsx_runtime.JSX.Element;
+};
+
+export { type UseTableDeleteRowColumnConfig, useTableDeleteRowColumn };

package/dist/hooks/use-table-delete-row-column.js

@@ -0,0 +1,459 @@
+"use client";
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/use-table-delete-row-column.ts
+var use_table_delete_row_column_exports = {};
+__export(use_table_delete_row_column_exports, {
+  useTableDeleteRowColumn: () => useTableDeleteRowColumn
+});
+module.exports = __toCommonJS(use_table_delete_row_column_exports);
+var import_editor_utils = require("@kopexa/editor-utils");
+var import_i18n2 = require("@kopexa/i18n");
+var import_icons = require("@kopexa/icons");
+var import_tables2 = require("@tiptap/pm/tables");
+var import_react = require("react");
+
+// src/lib/table-utils.ts
+var import_shared_utils = require("@kopexa/shared-utils");
+var import_tables = require("@tiptap/pm/tables");
+function getTable(editor, tablePos) {
+  if (!editor) return null;
+  let table = null;
+  if (typeof tablePos === "number") {
+    const tableNode = editor.state.doc.nodeAt(tablePos);
+    if ((tableNode == null ? void 0 : tableNode.type.name) === "table") {
+      table = {
+        node: tableNode,
+        pos: tablePos,
+        start: tablePos + 1,
+        depth: editor.state.doc.resolve(tablePos).depth
+      };
+    }
+  }
+  if (!table) {
+    const { state } = editor;
+    const $from = state.doc.resolve(state.selection.from);
+    table = (0, import_tables.findTable)($from);
+  }
+  if (!table) return null;
+  const tableMap = import_tables.TableMap.get(table.node);
+  if (!tableMap) return null;
+  return { ...table, map: tableMap };
+}
+function selectCellsByCoords(editor, tablePos, coords, options = { mode: "state" }) {
+  if (!editor) return;
+  const table = getTable(editor, tablePos);
+  if (!table) return;
+  const { state } = editor;
+  const tableMap = table.map;
+  const cleanedCoords = coords.map((coord) => ({
+    row: (0, import_shared_utils.clamp)(coord.row, 0, tableMap.height - 1),
+    col: (0, import_shared_utils.clamp)(coord.col, 0, tableMap.width - 1)
+  })).filter((coord) => isWithinBounds(coord.row, coord.col, tableMap));
+  if (cleanedCoords.length === 0) {
+    return;
+  }
+  const allRows = cleanedCoords.map((coord) => coord.row);
+  const topRow = Math.min(...allRows);
+  const bottomRow = Math.max(...allRows);
+  const allCols = cleanedCoords.map((coord) => coord.col);
+  const leftCol = Math.min(...allCols);
+  const rightCol = Math.max(...allCols);
+  const getCellPositionFromMap = (row, col) => {
+    const cellOffset = tableMap.map[row * tableMap.width + col];
+    if (cellOffset === void 0) return null;
+    return tablePos + 1 + cellOffset;
+  };
+  const anchorPosition = getCellPositionFromMap(topRow, leftCol);
+  if (anchorPosition === null) return;
+  let headPosition = getCellPositionFromMap(bottomRow, rightCol);
+  if (headPosition === null) return;
+  if (headPosition === anchorPosition) {
+    let foundDifferentCell = false;
+    for (let row = bottomRow; row >= topRow && !foundDifferentCell; row--) {
+      for (let col = rightCol; col >= leftCol && !foundDifferentCell; col--) {
+        const candidatePosition = getCellPositionFromMap(row, col);
+        if (candidatePosition !== null && candidatePosition !== anchorPosition) {
+          headPosition = candidatePosition;
+          foundDifferentCell = true;
+        }
+      }
+    }
+  }
+  try {
+    const anchorRef = state.doc.resolve(anchorPosition);
+    const headRef = state.doc.resolve(headPosition);
+    const cellSelection = new import_tables.CellSelection(anchorRef, headRef);
+    const transaction = state.tr.setSelection(cellSelection);
+    return applySelectionWithMode(state, transaction, options);
+  } catch (error) {
+    console.error("Failed to create cell selection:", error);
+    return;
+  }
+}
+function isWithinBounds(row, col, map) {
+  return row >= 0 && row < map.height && col >= 0 && col < map.width;
+}
+function applySelectionWithMode(state, transaction, options) {
+  var _a;
+  const mode = (_a = options.mode) != null ? _a : "state";
+  switch (mode) {
+    case "dispatch": {
+      const dispatchOptions = options;
+      if (typeof dispatchOptions.dispatch === "function") {
+        dispatchOptions.dispatch(transaction);
+      }
+      return;
+    }
+    case "transaction":
+      return transaction;
+    default:
+      return state.apply(transaction);
+  }
+}
+function getTableSelectionType(editor, index, orientation, tablePos) {
+  if (typeof index === "number" && orientation) {
+    return { orientation, index };
+  }
+  if (!editor) return null;
+  const { state } = editor;
+  const table = getTable(editor, tablePos);
+  if (!table) return null;
+  if (state.selection instanceof import_tables.CellSelection) {
+    const rect = (0, import_tables.selectedRect)(state);
+    const map = import_tables.TableMap.get(table.node);
+    const width = rect.right - rect.left;
+    const height = rect.bottom - rect.top;
+    if (height === 1 && width === map.width) {
+      return { orientation: "row", index: rect.top };
+    }
+    if (width === 1 && height === map.height) {
+      return { orientation: "column", index: rect.left };
+    }
+    return null;
+  }
+  return null;
+}
+
+// src/messages.ts
+var import_i18n = require("@kopexa/i18n");
+var messages = (0, import_i18n.defineMessages)({
+  // Row/Column actions (aria labels)
+  row_actions: {
+    id: "editor.table.row_actions",
+    defaultMessage: "Row actions",
+    description: "ARIA label for row actions menu button"
+  },
+  column_actions: {
+    id: "editor.table.column_actions",
+    defaultMessage: "Column actions",
+    description: "ARIA label for column actions menu button"
+  },
+  cell_options: {
+    id: "editor.table.cell_options",
+    defaultMessage: "Table cells option",
+    description: "ARIA label for cell options menu button"
+  },
+  // Alignment
+  alignment: {
+    id: "editor.table.alignment",
+    defaultMessage: "Alignment",
+    description: "Label for alignment submenu"
+  },
+  align_left: {
+    id: "editor.table.align_left",
+    defaultMessage: "Align left",
+    description: "Label for align left action"
+  },
+  align_center: {
+    id: "editor.table.align_center",
+    defaultMessage: "Align center",
+    description: "Label for align center action"
+  },
+  align_right: {
+    id: "editor.table.align_right",
+    defaultMessage: "Align right",
+    description: "Label for align right action"
+  },
+  justify: {
+    id: "editor.table.justify",
+    defaultMessage: "Justify",
+    description: "Label for justify action"
+  },
+  align_top: {
+    id: "editor.table.align_top",
+    defaultMessage: "Align top",
+    description: "Label for vertical align top action"
+  },
+  align_middle: {
+    id: "editor.table.align_middle",
+    defaultMessage: "Align middle",
+    description: "Label for vertical align middle action"
+  },
+  align_bottom: {
+    id: "editor.table.align_bottom",
+    defaultMessage: "Align bottom",
+    description: "Label for vertical align bottom action"
+  },
+  // Add row/column
+  insert_row_above: {
+    id: "editor.table.insert_row_above",
+    defaultMessage: "Insert row above",
+    description: "Label for insert row above action"
+  },
+  insert_row_below: {
+    id: "editor.table.insert_row_below",
+    defaultMessage: "Insert row below",
+    description: "Label for insert row below action"
+  },
+  insert_column_left: {
+    id: "editor.table.insert_column_left",
+    defaultMessage: "Insert column left",
+    description: "Label for insert column left action"
+  },
+  insert_column_right: {
+    id: "editor.table.insert_column_right",
+    defaultMessage: "Insert column right",
+    description: "Label for insert column right action"
+  },
+  // Delete row/column
+  delete_row: {
+    id: "editor.table.delete_row",
+    defaultMessage: "Delete row",
+    description: "Label for delete row action"
+  },
+  delete_column: {
+    id: "editor.table.delete_column",
+    defaultMessage: "Delete column",
+    description: "Label for delete column action"
+  },
+  // Move row/column
+  move_row_up: {
+    id: "editor.table.move_row_up",
+    defaultMessage: "Move row up",
+    description: "Label for move row up action"
+  },
+  move_row_down: {
+    id: "editor.table.move_row_down",
+    defaultMessage: "Move row down",
+    description: "Label for move row down action"
+  },
+  move_column_left: {
+    id: "editor.table.move_column_left",
+    defaultMessage: "Move column left",
+    description: "Label for move column left action"
+  },
+  move_column_right: {
+    id: "editor.table.move_column_right",
+    defaultMessage: "Move column right",
+    description: "Label for move column right action"
+  },
+  // Sort
+  sort_row_asc: {
+    id: "editor.table.sort_row_asc",
+    defaultMessage: "Sort row A-Z",
+    description: "Label for sort row ascending action"
+  },
+  sort_row_desc: {
+    id: "editor.table.sort_row_desc",
+    defaultMessage: "Sort row Z-A",
+    description: "Label for sort row descending action"
+  },
+  sort_column_asc: {
+    id: "editor.table.sort_column_asc",
+    defaultMessage: "Sort column A-Z",
+    description: "Label for sort column ascending action"
+  },
+  sort_column_desc: {
+    id: "editor.table.sort_column_desc",
+    defaultMessage: "Sort column Z-A",
+    description: "Label for sort column descending action"
+  },
+  // Duplicate
+  duplicate_row: {
+    id: "editor.table.duplicate_row",
+    defaultMessage: "Duplicate row",
+    description: "Label for duplicate row action"
+  },
+  duplicate_column: {
+    id: "editor.table.duplicate_column",
+    defaultMessage: "Duplicate column",
+    description: "Label for duplicate column action"
+  },
+  // Header
+  header_row: {
+    id: "editor.table.header_row",
+    defaultMessage: "Header row",
+    description: "Label for toggle header row action"
+  },
+  header_column: {
+    id: "editor.table.header_column",
+    defaultMessage: "Header column",
+    description: "Label for toggle header column action"
+  },
+  // Merge/Split
+  merge_cells: {
+    id: "editor.table.merge_cells",
+    defaultMessage: "Merge cells",
+    description: "Label for merge cells action"
+  },
+  split_cell: {
+    id: "editor.table.split_cell",
+    defaultMessage: "Split cell",
+    description: "Label for split cell action"
+  },
+  // Clear contents
+  clear_row_contents: {
+    id: "editor.table.clear_row_contents",
+    defaultMessage: "Clear row contents",
+    description: "Label for clear row contents action"
+  },
+  clear_column_contents: {
+    id: "editor.table.clear_column_contents",
+    defaultMessage: "Clear column contents",
+    description: "Label for clear column contents action"
+  },
+  clear_contents: {
+    id: "editor.table.clear_contents",
+    defaultMessage: "Clear contents",
+    description: "Label for clear contents action (generic)"
+  }
+});
+
+// src/hooks/use-table-delete-row-column.ts
+var REQUIRED_EXTENSIONS = ["table"];
+var deleteMessageKeys = {
+  row: messages.delete_row,
+  column: messages.delete_column
+};
+function canDeleteRowColumn({
+  editor,
+  index,
+  orientation,
+  tablePos
+}) {
+  if (!editor || !editor.isEditable || !(0, import_editor_utils.isExtensionAvailable)(editor, REQUIRED_EXTENSIONS)) {
+    return false;
+  }
+  try {
+    const table = getTable(editor, tablePos);
+    if (!table) return false;
+    const selectionType = getTableSelectionType(editor, index, orientation);
+    if (!selectionType) return false;
+    return true;
+  } catch {
+    return false;
+  }
+}
+function tableDeleteRowColumn({
+  editor,
+  index,
+  orientation,
+  tablePos
+}) {
+  if (!canDeleteRowColumn({ editor, index, orientation, tablePos }) || !editor) {
+    return false;
+  }
+  try {
+    const selectionType = getTableSelectionType(editor, index, orientation);
+    if (!selectionType) return false;
+    const { orientation: finalOrientation, index: finalIndex } = selectionType;
+    const isRow = finalOrientation === "row";
+    const dispatch = (tr) => editor.view.dispatch(tr);
+    const deleteOperation = isRow ? import_tables2.deleteRow : import_tables2.deleteColumn;
+    if (editor.state.selection instanceof import_tables2.CellSelection) {
+      return deleteOperation(editor.state, dispatch);
+    }
+    const table = getTable(editor, tablePos);
+    if (!table) return false;
+    const cellCoords = isRow ? { row: finalIndex, col: 0 } : { row: 0, col: finalIndex };
+    const cellState = selectCellsByCoords(editor, table.pos, [cellCoords], {
+      mode: "state"
+    });
+    if (!cellState) return false;
+    return deleteOperation(cellState, dispatch);
+  } catch (error) {
+    console.error(`Error deleting table row/column:`, error);
+    return false;
+  }
+}
+function shouldShowButton({
+  editor,
+  index,
+  orientation,
+  hideWhenUnavailable,
+  tablePos
+}) {
+  if (!editor || !editor.isEditable) return false;
+  if (!(0, import_editor_utils.isExtensionAvailable)(editor, REQUIRED_EXTENSIONS)) return false;
+  return hideWhenUnavailable ? canDeleteRowColumn({ editor, index, orientation, tablePos }) : true;
+}
+function useTableDeleteRowColumn(config) {
+  const {
+    editor: providedEditor,
+    index,
+    orientation,
+    tablePos,
+    hideWhenUnavailable = false,
+    onDeleted
+  } = config;
+  const { editor } = (0, import_editor_utils.useTiptapEditor)(providedEditor);
+  const intl = (0, import_i18n2.useSafeIntl)();
+  const selectionType = getTableSelectionType(editor, index, orientation);
+  const isVisible = shouldShowButton({
+    editor,
+    index,
+    orientation,
+    hideWhenUnavailable
+  });
+  const canPerformDelete = canDeleteRowColumn({
+    editor,
+    index,
+    orientation,
+    tablePos
+  });
+  const handleDelete = (0, import_react.useCallback)(() => {
+    const success = tableDeleteRowColumn({
+      editor,
+      index,
+      orientation,
+      tablePos
+    });
+    if (success) onDeleted == null ? void 0 : onDeleted();
+    return success;
+  }, [editor, index, orientation, tablePos, onDeleted]);
+  const label = (0, import_react.useMemo)(() => {
+    return intl.formatMessage(
+      deleteMessageKeys[(selectionType == null ? void 0 : selectionType.orientation) || "row"]
+    );
+  }, [intl, selectionType]);
+  return {
+    isVisible,
+    canDeleteRowColumn: canPerformDelete,
+    handleDelete,
+    label,
+    Icon: import_icons.TrashIcon
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useTableDeleteRowColumn
+});

package/dist/hooks/use-table-delete-row-column.mjs

@@ -0,0 +1,11 @@
+"use client";
+"use client";
+import {
+  useTableDeleteRowColumn
+} from "../chunk-ZVPJDJBO.mjs";
+import "../chunk-CN73TYHV.mjs";
+import "../chunk-5B5XIL2G.mjs";
+import "../chunk-WKV76XOR.mjs";
+export {
+  useTableDeleteRowColumn
+};

package/dist/hooks/use-table-duplicate-row-column.d.mts

@@ -0,0 +1,49 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _kopexa_icons from '@kopexa/icons';
+import { Editor } from '@tiptap/react';
+import { Orientation } from '../lib/table-utils.mjs';
+import '@tiptap/pm/model';
+import '@tiptap/pm/state';
+import '@tiptap/pm/tables';
+
+interface UseTableDuplicateRowColumnConfig {
+    /**
+     * The Tiptap editor instance. If omitted, the hook will use
+     * the context/editor from `useTiptapEditor`.
+     */
+    editor?: Editor | null;
+    /**
+     * The index of the row or column to duplicate.
+     */
+    index?: number;
+    /**
+     * Whether you're duplicating a row or a column.
+     */
+    orientation?: Orientation;
+    /**
+     * The position of the table in the document.
+     */
+    tablePos?: number;
+    /**
+     * Hide the button when duplication isn't currently possible.
+     * @default false
+     */
+    hideWhenUnavailable?: boolean;
+    /**
+     * Callback function called after a successful duplication.
+     */
+    onDuplicated?: () => void;
+}
+/**
+ * Custom hook that provides **table row/column duplication**
+ * functionality for the Tiptap editor.
+ */
+declare function useTableDuplicateRowColumn(config: UseTableDuplicateRowColumnConfig): {
+    isVisible: boolean;
+    canDuplicateRowColumn: boolean;
+    handleDuplicate: () => boolean;
+    label: string;
+    Icon: ({ size, ...props }: _kopexa_icons.IconSvgProps) => react_jsx_runtime.JSX.Element;
+};
+
+export { type UseTableDuplicateRowColumnConfig, useTableDuplicateRowColumn };