@tiptap/extension-highlight 3.0.0 → 3.0.2-beta.0

package/dist/packages/core/src/Extension.d.ts

@@ -1,343 +0,0 @@
-import { Plugin, Transaction } from '@tiptap/pm/state';
-import { Editor } from './Editor.js';
-import { ExtensionConfig } from './index.js';
-import { InputRule } from './InputRule.js';
-import { Mark } from './Mark.js';
-import { Node } from './Node.js';
-import { PasteRule } from './PasteRule.js';
-import { Extensions, GlobalAttributes, KeyboardShortcutCommand, ParentConfig, RawCommands } from './types.js';
-declare module '@tiptap/core' {
-    interface ExtensionConfig<Options = any, Storage = any> {
-        [key: string]: any;
-        /**
-         * The extension name - this must be unique.
-         * It will be used to identify the extension.
-         *
-         * @example 'myExtension'
-         */
-        name: string;
-        /**
-         * The priority of your extension. The higher, the later it will be called
-         * and will take precedence over other extensions with a lower priority.
-         * @default 1000
-         * @example 1001
-         */
-        priority?: number;
-        /**
-         * The default options for this extension.
-         * @example
-         * defaultOptions: {
-         *   myOption: 'foo',
-         *   myOtherOption: 10,
-         * }
-         */
-        defaultOptions?: Options;
-        /**
-         * This method will add options to this extension
-         * @see https://tiptap.dev/docs/editor/guide/custom-extensions#settings
-         * @example
-         * addOptions() {
-         *  return {
-         *    myOption: 'foo',
-         *    myOtherOption: 10,
-         * }
-         */
-        addOptions?: (this: {
-            name: string;
-            parent: Exclude<ParentConfig<ExtensionConfig<Options, Storage>>['addOptions'], undefined>;
-        }) => Options;
-        /**
-         * The default storage this extension can save data to.
-         * @see https://tiptap.dev/docs/editor/guide/custom-extensions#storage
-         * @example
-         * defaultStorage: {
-         *   prefetchedUsers: [],
-         *   loading: false,
-         * }
-         */
-        addStorage?: (this: {
-            name: string;
-            options: Options;
-            parent: Exclude<ParentConfig<ExtensionConfig<Options, Storage>>['addStorage'], undefined>;
-        }) => Storage;
-        /**
-         * This function adds globalAttributes to specific nodes.
-         * @see https://tiptap.dev/docs/editor/guide/custom-extensions#global-attributes
-         * @example
-         * addGlobalAttributes() {
-         *   return [
-         *     {
-                 // Extend the following extensions
-         *       types: [
-         *         'heading',
-         *         'paragraph',
-         *       ],
-         *       // … with those attributes
-         *       attributes: {
-         *         textAlign: {
-         *           default: 'left',
-         *           renderHTML: attributes => ({
-         *             style: `text-align: ${attributes.textAlign}`,
-         *           }),
-         *           parseHTML: element => element.style.textAlign || 'left',
-         *         },
-         *       },
-         *     },
-         *   ]
-         * }
-         */
-        addGlobalAttributes?: (this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            extensions: (Node | Mark)[];
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['addGlobalAttributes'];
-        }) => GlobalAttributes;
-        /**
-         * This function adds commands to the editor
-         * @see https://tiptap.dev/docs/editor/guide/custom-extensions#commands
-         * @example
-         * addCommands() {
-         *   return {
-         *     myCommand: () => ({ chain }) => chain().setMark('type', 'foo').run(),
-         *   }
-         * }
-         */
-        addCommands?: (this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            editor: Editor;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['addCommands'];
-        }) => Partial<RawCommands>;
-        /**
-         * This function registers keyboard shortcuts.
-         * @see https://tiptap.dev/docs/editor/guide/custom-extensions#keyboard-shortcuts
-         * @example
-         * addKeyboardShortcuts() {
-         *   return {
-         *     'Mod-l': () => this.editor.commands.toggleBulletList(),
-         *   }
-         * },
-         */
-        addKeyboardShortcuts?: (this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            editor: Editor;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['addKeyboardShortcuts'];
-        }) => {
-            [key: string]: KeyboardShortcutCommand;
-        };
-        /**
-         * This function adds input rules to the editor.
-         * @see https://tiptap.dev/docs/editor/guide/custom-extensions#input-rules
-         * @example
-         * addInputRules() {
-         *   return [
-         *     markInputRule({
-         *       find: inputRegex,
-         *       type: this.type,
-         *     }),
-         *   ]
-         * },
-         */
-        addInputRules?: (this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            editor: Editor;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['addInputRules'];
-        }) => InputRule[];
-        /**
-         * This function adds paste rules to the editor.
-         * @see https://tiptap.dev/docs/editor/guide/custom-extensions#paste-rules
-         * @example
-         * addPasteRules() {
-         *   return [
-         *     markPasteRule({
-         *       find: pasteRegex,
-         *       type: this.type,
-         *     }),
-         *   ]
-         * },
-         */
-        addPasteRules?: (this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            editor: Editor;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['addPasteRules'];
-        }) => PasteRule[];
-        /**
-         * This function adds Prosemirror plugins to the editor
-         * @see https://tiptap.dev/docs/editor/guide/custom-extensions#prosemirror-plugins
-         * @example
-         * addProseMirrorPlugins() {
-         *   return [
-         *     customPlugin(),
-         *   ]
-         * }
-         */
-        addProseMirrorPlugins?: (this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            editor: Editor;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['addProseMirrorPlugins'];
-        }) => Plugin[];
-        /**
-         * This function adds additional extensions to the editor. This is useful for
-         * building extension kits.
-         * @example
-         * addExtensions() {
-         *   return [
-         *     BulletList,
-         *     OrderedList,
-         *     ListItem
-         *   ]
-         * }
-         */
-        addExtensions?: (this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['addExtensions'];
-        }) => Extensions;
-        /**
-         * This function extends the schema of the node.
-         * @example
-         * extendNodeSchema() {
-         *   return {
-         *     group: 'inline',
-         *     selectable: false,
-         *   }
-         * }
-         */
-        extendNodeSchema?: ((this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['extendNodeSchema'];
-        }, extension: Node) => Record<string, any>) | null;
-        /**
-         * This function extends the schema of the mark.
-         * @example
-         * extendMarkSchema() {
-         *   return {
-         *     group: 'inline',
-         *     selectable: false,
-         *   }
-         * }
-         */
-        extendMarkSchema?: ((this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['extendMarkSchema'];
-        }, extension: Mark) => Record<string, any>) | null;
-        /**
-         * The editor is not ready yet.
-         */
-        onBeforeCreate?: ((this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            editor: Editor;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['onBeforeCreate'];
-        }) => void) | null;
-        /**
-         * The editor is ready.
-         */
-        onCreate?: ((this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            editor: Editor;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['onCreate'];
-        }) => void) | null;
-        /**
-         * The content has changed.
-         */
-        onUpdate?: ((this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            editor: Editor;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['onUpdate'];
-        }) => void) | null;
-        /**
-         * The selection has changed.
-         */
-        onSelectionUpdate?: ((this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            editor: Editor;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['onSelectionUpdate'];
-        }) => void) | null;
-        /**
-         * The editor state has changed.
-         */
-        onTransaction?: ((this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            editor: Editor;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['onTransaction'];
-        }, props: {
-            transaction: Transaction;
-        }) => void) | null;
-        /**
-         * The editor is focused.
-         */
-        onFocus?: ((this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            editor: Editor;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['onFocus'];
-        }, props: {
-            event: FocusEvent;
-        }) => void) | null;
-        /**
-         * The editor isn’t focused anymore.
-         */
-        onBlur?: ((this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            editor: Editor;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['onBlur'];
-        }, props: {
-            event: FocusEvent;
-        }) => void) | null;
-        /**
-         * The editor is destroyed.
-         */
-        onDestroy?: ((this: {
-            name: string;
-            options: Options;
-            storage: Storage;
-            editor: Editor;
-            parent: ParentConfig<ExtensionConfig<Options, Storage>>['onDestroy'];
-        }) => void) | null;
-    }
-}
-/**
- * The Extension class is the base class for all extensions.
- * @see https://tiptap.dev/api/extensions#create-a-new-extension
- */
-export declare class Extension<Options = any, Storage = any> {
-    type: string;
-    name: string;
-    parent: Extension | null;
-    child: Extension | null;
-    options: Options;
-    storage: Storage;
-    config: ExtensionConfig;
-    constructor(config?: Partial<ExtensionConfig<Options, Storage>>);
-    static create<O = any, S = any>(config?: Partial<ExtensionConfig<O, S>>): Extension<O, S>;
-    configure(options?: Partial<Options>): Extension<any, any>;
-    extend<ExtendedOptions = Options, ExtendedStorage = Storage>(extendedConfig?: Partial<ExtensionConfig<ExtendedOptions, ExtendedStorage>>): Extension<ExtendedOptions, ExtendedStorage>;
-}

package/dist/packages/core/src/ExtensionManager.d.ts

@@ -1,55 +0,0 @@
-import { Schema } from '@tiptap/pm/model';
-import { Plugin } from '@tiptap/pm/state';
-import type { Editor } from './Editor.js';
-import { Extensions, RawCommands } from './types.js';
-export declare class ExtensionManager {
-    editor: Editor;
-    schema: Schema;
-    extensions: Extensions;
-    splittableMarks: string[];
-    constructor(extensions: Extensions, editor: Editor);
-    /**
-     * Returns a flattened and sorted extension list while
-     * also checking for duplicated extensions and warns the user.
-     * @param extensions An array of Tiptap extensions
-     * @returns An flattened and sorted array of Tiptap extensions
-     */
-    static resolve(extensions: Extensions): Extensions;
-    /**
-     * Create a flattened array of extensions by traversing the `addExtensions` field.
-     * @param extensions An array of Tiptap extensions
-     * @returns A flattened array of Tiptap extensions
-     */
-    static flatten(extensions: Extensions): Extensions;
-    /**
-     * Sort extensions by priority.
-     * @param extensions An array of Tiptap extensions
-     * @returns A sorted array of Tiptap extensions by priority
-     */
-    static sort(extensions: Extensions): Extensions;
-    /**
-     * Get all commands from the extensions.
-     * @returns An object with all commands where the key is the command name and the value is the command function
-     */
-    get commands(): RawCommands;
-    /**
-     * Get all registered Prosemirror plugins from the extensions.
-     * @returns An array of Prosemirror plugins
-     */
-    get plugins(): Plugin[];
-    /**
-     * Get all attributes from the extensions.
-     * @returns An array of attributes
-     */
-    get attributes(): import("@tiptap/core").ExtensionAttribute[];
-    /**
-     * Get all node views from the extensions.
-     * @returns An object with all node views where the key is the node name and the value is the node view function
-     */
-    get nodeViews(): any;
-    /**
-     * Go through all extensions, create extension storages & setup marks
-     * & bind editor event listener.
-     */
-    private setupExtensions;
-}

package/dist/packages/core/src/InputRule.d.ts

@@ -1,42 +0,0 @@
-import { EditorState, Plugin } from '@tiptap/pm/state';
-import { Editor } from './Editor.js';
-import { CanCommands, ChainedCommands, ExtendedRegExpMatchArray, Range, SingleCommands } from './types.js';
-export type InputRuleMatch = {
-    index: number;
-    text: string;
-    replaceWith?: string;
-    match?: RegExpMatchArray;
-    data?: Record<string, any>;
-};
-export type InputRuleFinder = RegExp | ((text: string) => InputRuleMatch | null);
-export declare class InputRule {
-    find: InputRuleFinder;
-    handler: (props: {
-        state: EditorState;
-        range: Range;
-        match: ExtendedRegExpMatchArray;
-        commands: SingleCommands;
-        chain: () => ChainedCommands;
-        can: () => CanCommands;
-    }) => void | null;
-    constructor(config: {
-        find: InputRuleFinder;
-        handler: (props: {
-            state: EditorState;
-            range: Range;
-            match: ExtendedRegExpMatchArray;
-            commands: SingleCommands;
-            chain: () => ChainedCommands;
-            can: () => CanCommands;
-        }) => void | null;
-    });
-}
-/**
- * Create an input rules plugin. When enabled, it will cause text
- * input that matches any of the given rules to trigger the rule’s
- * action.
- */
-export declare function inputRulesPlugin(props: {
-    editor: Editor;
-    rules: InputRule[];
-}): Plugin;