tiptap-notion-editor 0.5.0

package/lib/components/extensions/mention/types.d.ts

@@ -0,0 +1,12 @@
+/** Một mục hiển thị trong dropdown `@mention`. */
+export type MentionItem = {
+    /** Giá trị được ghi vào document — thường là id người dùng. */
+    id: string;
+    /** Chuỗi hiển thị trong dropdown và trong nội dung. */
+    label: string;
+};
+/**
+ * Nguồn dữ liệu cho `@mention`. App chủ tự quyết gọi API hay lọc danh sách
+ * có sẵn; package không giả định gì về backend.
+ */
+export type MentionSource = (query: string) => MentionItem[] | Promise<MentionItem[]>;

package/lib/components/extensions/slash-command/MenuListGroup.d.ts

@@ -0,0 +1,9 @@
+import { BlockGroupItem, BlockItem } from '../../blocks/types';
+interface CommandListItemsProps {
+    groups: BlockGroupItem[];
+    flatCommands: BlockItem[];
+    selectedIndex: number;
+    onSelectIndex: (index: number) => void;
+}
+export declare const MenuListGroup: ({ groups, flatCommands, selectedIndex, onSelectIndex, }: CommandListItemsProps) => import("react").JSX.Element;
+export {};

package/lib/components/extensions/slash-command/SlashMenu.d.ts

@@ -0,0 +1,11 @@
+import { Editor, Range } from '@tiptap/core';
+import { BlockGroupItem, BlockItem } from '../../blocks/types';
+type CommandListProps = {
+    items: BlockGroupItem[];
+    command: (item: BlockItem) => void;
+    editor: Editor;
+    range: Range;
+    query: string;
+};
+declare const SlashMenu: import('react').ForwardRefExoticComponent<CommandListProps & import('react').RefAttributes<unknown>>;
+export default SlashMenu;

package/lib/components/extensions/slash-command/items.d.ts

@@ -0,0 +1,3 @@
+import { BlockGroupItem } from '../../blocks/types';
+import { Messages } from '../../../i18n';
+export declare const createBlockItems: (t: Messages) => BlockGroupItem[];

package/lib/components/extensions/slash-command/slash-command.d.ts

@@ -0,0 +1,7 @@
+import { SuggestionOptions } from '@tiptap/suggestion';
+import { Extension } from '@tiptap/core';
+export type SlashCommandOptions = {
+    suggestion: Omit<SuggestionOptions, 'editor'>;
+};
+declare const SlashCommand: Extension<SlashCommandOptions, any>;
+export { SlashCommand };

package/lib/components/extensions/slash-command/suggestion.d.ts

@@ -0,0 +1,3 @@
+import { SuggestionOptions } from '@tiptap/suggestion';
+import { Messages } from '../../../i18n';
+export declare const createSlashSuggestion: (t: Messages) => Omit<SuggestionOptions, "editor">;

package/lib/components/icons.d.ts

@@ -0,0 +1,5 @@
+export declare const InsertLeftColumn: (props: any) => import("react").JSX.Element;
+export declare const InsertRightColumn: (props: any) => import("react").JSX.Element;
+export declare const InsertRowAbove: (props: any) => import("react").JSX.Element;
+export declare const InsertRowBelow: (props: any) => import("react").JSX.Element;
+export declare const TableMergeIcon: (props: any) => import("react").JSX.Element;

package/lib/components/node/attachment/AttachmentNode.d.ts

@@ -0,0 +1,38 @@
+import { Node } from '@tiptap/core';
+export type AttachmentAttributes = {
+    /**
+     * Id do storage của app chủ cấp, dùng khi tệp không có URL cố định.
+     *
+     * Storage riêng tư thường chỉ phát URL ngắn hạn, nên nhúng URL vào nội dung
+     * là bảo đảm nó hỏng sau vài phút. Lưu id rồi hỏi app chủ lúc người dùng bấm
+     * tải — xem prop `onOpenAttachment`.
+     */
+    fileId: string | null;
+    /** URL công khai, dùng khi app chủ lưu ở storage công khai. */
+    src: string | null;
+    /** Tên hiển thị. Thường là tên file gốc. */
+    name: string | null;
+    /** Kích thước tính bằng byte, để hiển thị. Không có thì bỏ dòng đó. */
+    size: number | null;
+    /** MIME type, dùng để chọn biểu tượng. */
+    mime: string | null;
+};
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        attachment: {
+            /** Chèn một file đã có URL vào document. */
+            setAttachment: (attrs: Partial<AttachmentAttributes>) => ReturnType;
+        };
+    }
+}
+/**
+ * Khối file đính kèm: Word, PDF, bảng tính, zip…
+ *
+ * Node chỉ giữ URL và vài thông tin để hiển thị. Việc đưa file lên R2 là của
+ * app chủ — package nhận URL đã có, đúng như ảnh.
+ *
+ * Ảnh có node riêng (`image`) vì nó hiển thị nội dung trực tiếp; file thường
+ * chỉ có thể hiện thành một thẻ để tải về, nên tách node cho rõ.
+ */
+export declare const AttachmentNode: Node<any, any>;
+export default AttachmentNode;

package/lib/components/node/attachment/AttachmentNodeView.d.ts

@@ -0,0 +1,3 @@
+import { NodeViewProps } from '@tiptap/react';
+export declare function AttachmentNodeView({ node, selected }: NodeViewProps): import("react").JSX.Element;
+export default AttachmentNodeView;

package/lib/components/node/attachment/AttachmentUploadNode.d.ts

@@ -0,0 +1,37 @@
+import { Node } from '@tiptap/react';
+/**
+ * Kết quả tải lên một tệp đính kèm.
+ *
+ * Trả `src` khi storage cấp URL cố định, trả `fileId` khi storage riêng tư
+ * chỉ phát URL ngắn hạn — nhúng URL đó vào nội dung là bảo đảm nó hỏng sau vài
+ * phút. Trả thẳng một chuỗi được hiểu là `src`, cho tương thích ngược.
+ */
+export type UploadedAttachment = {
+    src?: string;
+    fileId?: string;
+};
+export type AttachmentUploadFunction = (file: File, onProgress?: (event: {
+    progress: number;
+}) => void, signal?: AbortSignal) => Promise<string | UploadedAttachment>;
+export interface AttachmentUploadNodeOptions {
+    /** Loại file được nhận. Mặc định mọi loại. */
+    accept?: string;
+    /** Số file tối đa mỗi lần. */
+    limit?: number;
+    /** Dung lượng tối đa mỗi file, tính bằng byte. */
+    maxSize?: number;
+    /**
+     * Hàm đưa file lên và trả về URL công khai. App chủ cung cấp — package không
+     * tự gọi storage nào.
+     */
+    upload?: AttachmentUploadFunction;
+    onError?: (error: Error) => void;
+    onSuccess?: (url: string) => void;
+    HTMLAttributes: Record<string, unknown>;
+}
+/**
+ * Ô trống chờ chọn file. Upload xong thì tự thay chính nó bằng node
+ * `attachment` mang URL trả về.
+ */
+export declare const AttachmentUploadNode: Node<AttachmentUploadNodeOptions, any>;
+export default AttachmentUploadNode;

package/lib/components/node/attachment/AttachmentUploadNodeView.d.ts

@@ -0,0 +1,3 @@
+import { NodeViewProps } from '@tiptap/react';
+export declare function AttachmentUploadNodeView(props: NodeViewProps): import("react").JSX.Element;
+export default AttachmentUploadNodeView;

package/lib/components/node/attachment/context.d.ts

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+import { AttachmentAttributes } from './AttachmentNode';
+export type AttachmentHandlers = {
+    /**
+     * Mở một tệp không có URL công khai.
+     *
+     * Node view chạy ngoài cây props của NotionEditor nên handler đi qua context.
+     * Package không biết storage nào cả — nó đưa lại đúng thuộc tính đã lưu và
+     * để app chủ quyết định lấy nội dung ra sao.
+     */
+    onOpenAttachment?: (attachment: AttachmentAttributes) => void;
+};
+export declare const AttachmentHandlersProvider: ({ onOpenAttachment, children, }: AttachmentHandlers & {
+    children: ReactNode;
+}) => import("react").JSX.Element;
+export declare const useAttachmentHandlers: () => AttachmentHandlers;

package/lib/components/node/attachment/index.d.ts

@@ -0,0 +1,3 @@
+export { AttachmentNode, type AttachmentAttributes } from './AttachmentNode';
+export { AttachmentUploadNode, type AttachmentUploadFunction, type AttachmentUploadNodeOptions, type UploadedAttachment, } from './AttachmentUploadNode';
+export { AttachmentHandlersProvider, type AttachmentHandlers, } from './context';

package/lib/components/node/image/CustomImage.d.ts

@@ -0,0 +1 @@
+export declare const CustomImage: import('@tiptap/core').Node<import('@tiptap/extension-image').ImageOptions, any>;

package/lib/components/node/image/ImageNodeView.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+import { NodeViewProps } from '@tiptap/react';
+export declare const IMAGE_MAX_WIDTH = 600;
+export declare const IMAGE_MAX_HEIGHT = 400;
+export default function ImageNodeView({ node, editor, updateAttributes, getPos, }: NodeViewProps): React.JSX.Element;

package/lib/components/node/image-upload/drop-zone-content.d.ts

@@ -0,0 +1,4 @@
+export declare const DropZoneContent: React.FC<{
+    maxSize: number;
+    limit: number;
+}>;

package/lib/components/node/image-upload/hooks.d.ts

@@ -0,0 +1,7 @@
+import { FileItem, UploadOptions } from './types';
+export declare function useFileUpload(options: UploadOptions): {
+    fileItems: FileItem[];
+    uploadFiles: (files: File[]) => Promise<string[]>;
+    removeFileItem: (fileId: string) => void;
+    clearAllFiles: () => void;
+};

package/lib/components/node/image-upload/image-drop-area.d.ts

@@ -0,0 +1,15 @@
+interface ImageUploadDragAreaProps {
+    /**
+     * Callback function triggered when files are dropped or selected
+     * @param {File[]} files - Array of File objects that were dropped or selected
+     */
+    onFile: (files: File[]) => void;
+    /**
+     * Optional child elements to render inside the drag area
+     * @optional
+     * @default undefined
+     */
+    children?: React.ReactNode;
+}
+export declare const ImageUploadDragArea: React.FC<ImageUploadDragAreaProps>;
+export {};

package/lib/components/node/image-upload/image-preview.d.ts

@@ -0,0 +1,13 @@
+import { FileItem } from './types';
+interface ImageUploadPreviewProps {
+    /**
+     * The file item to preview
+     */
+    fileItem: FileItem;
+    /**
+     * Callback to remove this file from upload queue
+     */
+    onRemove: () => void;
+}
+export declare const ImageUploadPreview: React.FC<ImageUploadPreviewProps>;
+export {};

package/lib/components/node/image-upload/image-upload-node-extension.d.ts

@@ -0,0 +1,58 @@
+import { Node } from '@tiptap/react';
+import { NodeType } from '@tiptap/pm/model';
+export type UploadFunction = (file: File, onProgress?: (event: {
+    progress: number;
+}) => void, abortSignal?: AbortSignal) => Promise<string>;
+export interface ImageUploadNodeOptions {
+    /**
+     * The type of the node.
+     * @default 'image'
+     */
+    type?: string | NodeType | undefined;
+    /**
+     * Acceptable file types for upload.
+     * @default 'image/*'
+     */
+    accept?: string;
+    /**
+     * Maximum number of files that can be uploaded.
+     * @default 1
+     */
+    limit?: number;
+    /**
+     * Maximum file size in bytes (0 for unlimited).
+     * @default 0
+     */
+    maxSize?: number;
+    /**
+     * Function to handle the upload process.
+     */
+    upload?: UploadFunction;
+    /**
+     * Callback for upload errors.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Callback for successful uploads.
+     */
+    onSuccess?: (url: string) => void;
+    /**
+     * HTML attributes to add to the image element.
+     * @default {}
+     * @example { class: 'foo' }
+     */
+    HTMLAttributes: Record<string, unknown>;
+}
+declare module "@tiptap/react" {
+    interface Commands<ReturnType> {
+        imageUpload: {
+            setImageUploadNode: (options?: ImageUploadNodeOptions) => ReturnType;
+        };
+    }
+}
+/**
+ * A Tiptap node extension that creates an image upload component.
+ * @see registry/tiptap-node/image-upload-node/image-upload-node
+ */
+export declare const ImageUploadNode: Node<ImageUploadNodeOptions, any>;
+export default ImageUploadNode;

package/lib/components/node/image-upload/image-upload-node-view.d.ts

@@ -0,0 +1,2 @@
+import { NodeViewProps } from '@tiptap/react';
+export declare const ImageUploadNode: React.FC<NodeViewProps>;

package/lib/components/node/image-upload/index.d.ts

@@ -0,0 +1 @@
+export * from '../image-upload/image-upload-node-extension';

package/lib/components/node/image-upload/types.d.ts

@@ -0,0 +1,66 @@
+export interface FileItem {
+    /**
+     * Unique identifier for the file item
+     */
+    id: string;
+    /**
+     * The actual File object being uploaded
+     */
+    file: File;
+    /**
+     * Current upload progress as a percentage (0-100)
+     */
+    progress: number;
+    /**
+     * Current status of the file upload process
+     * @default "uploading"
+     */
+    status: "uploading" | "success" | "error";
+    /**
+     * URL to the uploaded file, available after successful upload
+     * @optional
+     */
+    url?: string;
+    /**
+     * Controller that can be used to abort the upload process
+     * @optional
+     */
+    abortController?: AbortController;
+}
+export interface UploadOptions {
+    /**
+     * Maximum allowed file size in bytes
+     */
+    maxSize: number;
+    /**
+     * Maximum number of files that can be uploaded
+     */
+    limit: number;
+    /**
+     * String specifying acceptable file types (MIME types or extensions)
+     * @example ".jpg,.png,image/jpeg" or "image/*"
+     */
+    accept: string;
+    /**
+     * Function that handles the actual file upload process
+     * @param {File} file - The file to be uploaded
+     * @param {Function} onProgress - Callback function to report upload progress
+     * @param {AbortSignal} signal - Signal that can be used to abort the upload
+     * @returns {Promise<string>} Promise resolving to the URL of the uploaded file
+     */
+    upload: (file: File, onProgress: (event: {
+        progress: number;
+    }) => void, signal: AbortSignal) => Promise<string>;
+    /**
+     * Callback triggered when a file is uploaded successfully
+     * @param {string} url - URL of the successfully uploaded file
+     * @optional
+     */
+    onSuccess?: (url: string) => void;
+    /**
+     * Callback triggered when an error occurs during upload
+     * @param {Error} error - The error that occurred
+     * @optional
+     */
+    onError?: (error: Error) => void;
+}

package/lib/components/node/table-node/AddRowButton.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+import { Editor } from '@tiptap/react';
+export declare function AddRowButton({ editor }: {
+    editor: Editor;
+}): React.JSX.Element;

package/lib/components/node/table-node/CustomTable.d.ts

@@ -0,0 +1 @@
+export declare const CustomTable: import('@tiptap/core').Node<import('@tiptap/extension-table').TableOptions, any>;

package/lib/components/node/table-node/TableAddRowColumnHandle.d.ts

@@ -0,0 +1,7 @@
+import { TableAddRowPluginProps } from './plugins/add-row-plugin';
+export interface TableAddRowColumnHandleProps {
+    ref?: React.ForwardedRef<HTMLDivElement>;
+    children: React.ReactNode;
+    pluginProps: Omit<TableAddRowPluginProps, "element">;
+}
+export declare const TableAddRowColumnHandle: ({ ref, children, pluginProps, }: TableAddRowColumnHandleProps) => import('react').ReactPortal;

package/lib/components/node/table-node/TableHandle.d.ts

@@ -0,0 +1,4 @@
+import { Editor } from '@tiptap/core';
+export declare const TableHandle: ({ editor }: {
+    editor: Editor | null;
+}) => import("react").JSX.Element | null;

package/lib/components/node/table-node/TableMenuHandle.d.ts

@@ -0,0 +1,7 @@
+import { TableMenuHandlePluginProps } from './plugins/table-menu-handle-plugin';
+export interface TableMenuHandleProps {
+    ref?: React.ForwardedRef<HTMLDivElement>;
+    children: React.ReactNode;
+    pluginProps: Omit<TableMenuHandlePluginProps, "element">;
+}
+export declare const TableMenuHandle: ({ ref, children, pluginProps, }: TableMenuHandleProps) => import('react').ReactPortal;

package/lib/components/node/table-node/TableSelectionOverlay.d.ts

@@ -0,0 +1,7 @@
+import { TableSelectionOverlayPluginProps } from './plugins/table-selection-overlay';
+export interface TableSelectionOverlayProps {
+    ref?: React.ForwardedRef<HTMLDivElement>;
+    pluginProps: Omit<TableSelectionOverlayPluginProps, "element">;
+    children: React.ReactNode;
+}
+export declare function TableSelectionOverlay({ ref, children, pluginProps, }: TableSelectionOverlayProps): import('react').ReactPortal;

package/lib/components/node/table-node/plugins/add-row-plugin.d.ts

@@ -0,0 +1,9 @@
+import { Plugin, PluginKey } from '@tiptap/pm/state';
+import { Editor } from '@tiptap/react';
+import { TableControlState } from './plugin-keys';
+export interface TableAddRowPluginProps {
+    editor: Editor;
+    element: HTMLElement;
+    pluginKey: PluginKey<TableControlState>;
+}
+export declare function TableAddRowPlugin({ editor, element, pluginKey, }: TableAddRowPluginProps): Plugin<TableControlState>;

package/lib/components/node/table-node/plugins/plugin-keys.d.ts

@@ -0,0 +1,6 @@
+import { PluginKey } from '@tiptap/pm/state';
+export interface TableControlState {
+    visible: boolean;
+}
+export declare const addRowPluginKey: PluginKey<TableControlState>;
+export declare const addColumnPluginKey: PluginKey<TableControlState>;

package/lib/components/node/table-node/plugins/table-menu-handle-plugin.d.ts

@@ -0,0 +1,33 @@
+import { arrow, autoPlacement, flip, hide, inline, offset, shift, size } from '@floating-ui/dom';
+import { Plugin, PluginKey } from '@tiptap/pm/state';
+import { Editor } from '@tiptap/react';
+interface TableMenuHandlePluginState {
+    openedMenu: boolean;
+}
+export interface FloatingUIOptionsProps {
+    strategy?: "absolute" | "fixed";
+    placement?: "top" | "right" | "bottom" | "left" | "top-start" | "top-end" | "right-start" | "right-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end";
+    offset?: Parameters<typeof offset>[0] | boolean;
+    flip?: Parameters<typeof flip>[0] | boolean;
+    shift?: Parameters<typeof shift>[0] | boolean;
+    arrow?: Parameters<typeof arrow>[0] | false;
+    size?: Parameters<typeof size>[0] | boolean;
+    autoPlacement?: Parameters<typeof autoPlacement>[0] | boolean;
+    hide?: Parameters<typeof hide>[0] | boolean;
+    inline?: Parameters<typeof inline>[0] | boolean;
+    onShow?: () => void;
+    onHide?: () => void;
+    onUpdate?: () => void;
+    onDestroy?: () => void;
+}
+export interface TableMenuHandlePluginProps {
+    pluginKey: PluginKey<TableMenuHandlePluginState>;
+    editor: Editor;
+    element: HTMLElement;
+    menuType: "row" | "column";
+    options?: FloatingUIOptionsProps;
+}
+export declare const rowMenuPluginKey: PluginKey<TableMenuHandlePluginState>;
+export declare const columnMenuPluginKey: PluginKey<TableMenuHandlePluginState>;
+export declare const TableMenuHandlePlugin: ({ pluginKey, editor, element, menuType, options, }: TableMenuHandlePluginProps) => Plugin<TableMenuHandlePluginState>;
+export {};

package/lib/components/node/table-node/plugins/table-selection-overlay.d.ts

@@ -0,0 +1,10 @@
+import { Plugin, PluginKey } from '@tiptap/pm/state';
+import { Editor } from '@tiptap/react';
+import { FloatingUIOptionsProps } from './table-menu-handle-plugin';
+export interface TableSelectionOverlayPluginProps {
+    pluginKey: PluginKey;
+    editor: Editor;
+    element: HTMLElement;
+    options?: FloatingUIOptionsProps;
+}
+export declare const TableSelectionOverlayPlugin: ({ pluginKey, editor, element, options, }: TableSelectionOverlayPluginProps) => Plugin<any>;

package/lib/components/node/table-node/popover/AlignmentContent.d.ts

@@ -0,0 +1,4 @@
+import { Editor } from '@tiptap/core';
+export declare const AlignmentDropdown: ({ editor }: {
+    editor: Editor;
+}) => import("react").JSX.Element;

package/lib/components/node/table-node/popover/CellMenuPopover.d.ts

@@ -0,0 +1,4 @@
+import { Editor } from '@tiptap/core';
+export declare const CellMenuPopover: ({ editor }: {
+    editor: Editor;
+}) => import("react").JSX.Element;

package/lib/components/node/table-node/popover/Colors.d.ts

@@ -0,0 +1,4 @@
+import { Editor } from '@tiptap/core';
+export declare const ColorsDropdwon: ({ editor }: {
+    editor: Editor | null;
+}) => import("react").JSX.Element | undefined;

package/lib/components/node/table-node/popover/TableMenuItem.d.ts

@@ -0,0 +1,11 @@
+import { LucideIcon } from 'lucide-react';
+interface MenuItemProps {
+    icon: LucideIcon | any;
+    label: string;
+    onClick?: () => void;
+    variant?: "default" | "destructive";
+    disabled?: boolean;
+    className?: string;
+}
+export declare const TableMenuItem: ({ icon: Icon, label, onClick, variant, disabled, className }: MenuItemProps) => import("react").JSX.Element;
+export {};

package/lib/components/node/table-node/popover/TableMenuPopover.d.ts

@@ -0,0 +1,9 @@
+import { Editor } from '@tiptap/core';
+export declare const ITEM_CLASSNAME = "flex items-center gap-2 px-2.5 rounded-md text-sm font-medium transition-colors cursor-pointer w-full";
+interface TableMenuPopoverProps {
+    editor: Editor;
+    type: "row" | "column";
+    pluginKey: any;
+}
+export declare const TableMenuPopover: ({ editor, type, pluginKey, }: TableMenuPopoverProps) => import("react").JSX.Element;
+export {};

package/lib/components/node/table-node/table-kit.d.ts

@@ -0,0 +1,2 @@
+import { Extension } from '@tiptap/core';
+export declare const CustomTableKit: Extension<any, any>;

package/lib/components/node/table-node/utils/getActiveTableCellAlignment.d.ts

@@ -0,0 +1,14 @@
+import { Editor } from '@tiptap/core';
+type HorizontalAlign = "left" | "center" | "right" | "justify";
+type VerticalAlign = "top" | "middle" | "bottom";
+interface TableAlignmentState {
+    isInsideTable: boolean;
+    horizontal: HorizontalAlign;
+    vertical: VerticalAlign;
+}
+/**
+ * Extracts the active alignment values from the currently selected or focused table cell.
+ * Returns defaults if the selection is outside a table structure.
+ */
+export declare const getActiveTableCellAlignment: (editor: Editor | null) => TableAlignmentState;
+export {};

package/lib/components/node/table-node/utils/getTableColumnMeta.d.ts

@@ -0,0 +1,15 @@
+import { Editor } from '@tiptap/core';
+interface TableMatrixMeta {
+    isInsideTable: boolean;
+    currentColumnIndex: number;
+    isFirstColumn: boolean;
+    isLastColumn: boolean;
+    currentRowIndex: number;
+    isFirstRow: boolean;
+    isLastRow: boolean;
+}
+/**
+ * Calculates whether the current column is at the boundaries of the table.
+ */
+export declare const getTableColumnMeta: (editor: Editor | null) => TableMatrixMeta;
+export {};

package/lib/components/node/table-node/utils/getTableContext.d.ts

@@ -0,0 +1,16 @@
+import { EditorState } from '@tiptap/pm/state';
+import { TableMap } from '@tiptap/pm/tables';
+import { Node as ProsemirrorNode } from '@tiptap/pm/model';
+export interface TableActionContext {
+    tableNode: ProsemirrorNode;
+    tablePos: number;
+    map: TableMap;
+    cellPos: number;
+    cellRect: {
+        top: number;
+        bottom: number;
+        left: number;
+        right: number;
+    };
+}
+export declare const getTableContext: (state: EditorState) => TableActionContext | null;

package/lib/components/node/table-node/utils/index.d.ts

@@ -0,0 +1,17 @@
+import { Editor } from '@tiptap/core';
+/**
+ * Checks if any cell in the currently active column contains text content.
+ * Used to enable/disable A-Z and Z-A sorting actions.
+ */
+export declare const isCurrentColumnSortable: (editor: Editor | null) => boolean;
+type TableDimension = 'column' | 'row';
+/**
+ * Checks if there is any text available inside the active column or row.
+ * Returns true if content is found, allowing you to enable "Clear Content" buttons.
+ *
+ * @param editor The active Tiptap Editor instance.
+ * @param dimension The structure to check ('column' | 'row').
+ * @returns boolean
+ */
+export declare const hasTableDimensionContent: (editor: Editor | null, dimension: TableDimension) => boolean;
+export {};

package/lib/components/node/table-node/utils/table.d.ts

@@ -0,0 +1,51 @@
+import { Editor } from '@tiptap/react';
+/**
+ * Inserts a blank row at the very bottom of a table without changing selection.
+ */
+export declare function insertRowAtBottom(editor: Editor, tablePos: number, trackHistory?: boolean): boolean;
+/**
+ * Deletes the last row of a table if it is completely empty.
+ */
+export declare function deleteEmptyRowFromBottom(editor: Editor, tablePos: number, trackHistory?: boolean): boolean;
+/**
+ * Appends a structural blank column at the far right edge of a targeted table pos.
+ */
+export declare function insertColumnAtRight(editor: Editor, tablePos: number, addToHistory?: boolean): boolean;
+/**
+ * Removes the column on the far right edge if it contains no content.
+ */
+export declare function deleteEmptyColumnFromRight(editor: Editor, tablePos: number, trackHistory?: boolean): boolean;
+/**
+ * Moves the currently active table column left or right.
+ */
+export declare const moveActiveColumn: (editor: Editor, direction: "left" | "right") => boolean;
+/**
+ * Moves the currently active table row up or down.
+ */
+export declare const moveActiveRow: (editor: Editor, direction: "up" | "down") => boolean;
+/**
+ * Duplicates the active row, copying its structure and contents cleanly.
+ */
+export declare const duplicateActiveRow: (editor: Editor) => boolean;
+/**
+ * Duplicates the active column, copying cell nodes down the vertical stack.
+ */
+export declare const duplicateActiveColumn: (editor: Editor) => boolean;
+interface CellStylingOptions {
+    backgroundColor?: string;
+    textColor?: string;
+}
+export declare const setTableCellStyles: (editor: Editor, options: CellStylingOptions) => boolean;
+type HorizontalAlign = 'left' | 'center' | 'right' | 'justify';
+type VerticalAlign = 'top' | 'middle' | 'bottom';
+interface CellAlignmentOptions {
+    horizontal?: HorizontalAlign;
+    vertical?: VerticalAlign;
+}
+export declare const setTableCellAlignment: (editor: Editor, options: CellAlignmentOptions) => boolean;
+/**
+ * Sorts table rows based on the text properties of the active column.
+ * Skips the first row if it consists purely of tableHeaders.
+ */
+export declare const sortActiveColumn: (editor: Editor, order: "asc" | "desc") => boolean;
+export {};