jodit 3.11.2 → 3.12.4

package/src/plugins/about/about.less

@@ -1,7 +1,7 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
 @import (reference) '../../styles/variables';

package/src/plugins/about/about.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/about
  */
 
 import './about.less';

package/src/plugins/add-new-line/README.md

@@ -0,0 +1,6 @@
+# Plugin add-new-line
+
+Adds an interface element - a floating button that appears at the edges of images
+or tables and allows you to add a paragraph before or after them.
+
+This is convenient when there is no free space in front of the image to place the cursor.

package/src/plugins/add-new-line/add-new-line.less

@@ -1,7 +1,7 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
 @import (reference) '../../styles/variables';

package/src/plugins/add-new-line/add-new-line.ts

@@ -1,7 +1,13 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * [[include:plugins/add-new-line/README.md]]
+ * @packageDocumentation
+ * @module plugins/add-new-line
  */
 
 import './add-new-line.less';
@@ -30,6 +36,12 @@ declare module '../../config' {
 
 		/**
 		 * On dbl click on empty space of editor it add new P element
+		 * @example
+		 * ```js
+		 * Jodit.make('#editor', {
+		 *   addNewLineOnDBLClick: false // disable
+		 * })
+		 * ```
 		 */
 		addNewLineOnDBLClick: boolean;
 

package/src/plugins/{bold.ts → bold/bold.ts}

@@ -1,12 +1,16 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
-import type { IDictionary, IJodit, IControlType } from '../types';
-import { Config } from '../config';
-import { isArray } from '../core/helpers';
+/**
+ * @module plugins/bold
+ */
+
+import type { IDictionary, IJodit, IControlType } from '../../types';
+import { Config } from '../../config';
+import { isArray } from '../../core/helpers';
 
 Config.prototype.controls.subscript = {
 	tags: ['sub'],
@@ -55,7 +59,7 @@ Config.prototype.controls.strikethrough = {
 } as IControlType;
 
 /**
- * Bold plugin - change B to Strong, i to Em
+ * Adds `bold`,` strikethrough`, `underline` and` italic` buttons to Jodit
  */
 export function bold(editor: IJodit): void {
 	const callBack = (command: string): false => {

package/src/plugins/class-span/class-span.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/class-span
  */
 
 import type { IControlType, IJodit } from '../../types';

package/src/plugins/clipboard/clipboard.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/clipboard
  */
 
 import type { IJodit, IPlugin } from '../../types';

package/src/plugins/clipboard/config.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/clipboard
  */
 
 import type { IControlType, IJodit } from '../../types';
@@ -31,6 +35,13 @@ declare module '../../config' {
 		 * Ask before paste HTML in WYSIWYG mode
 		 */
 		askBeforePasteHTML: boolean;
+
+		/**
+		 * When the user inserts a piece of HTML, the plugin will ask - How to insert it.
+		 * If after that user insert the same fragment again, the previous option will be used without extra question.
+		 */
+		memorizeChoiceWhenPasteFragment: boolean;
+
 		processPasteHTML: boolean;
 
 		askBeforePasteFromWord: boolean;
@@ -62,6 +73,7 @@ Config.prototype.askBeforePasteHTML = true;
 Config.prototype.processPasteHTML = true;
 
 Config.prototype.askBeforePasteFromWord = true;
+Config.prototype.memorizeChoiceWhenPasteFragment = false;
 Config.prototype.processPasteFromWord = true;
 
 Config.prototype.nl2brInPlainText = true;

package/src/plugins/clipboard/copy-format.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/clipboard
  */
 
 import type { IDictionary, IJodit, IControlType } from '../../types';

package/src/plugins/clipboard/drag-and-drop-element.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/clipboard
  */
 
 import type { IViewComponent, Nullable } from '../../types';

package/src/plugins/clipboard/drag-and-drop.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/clipboard
  */
 
 /**
@@ -15,7 +19,7 @@ import { attr, ctrlKey, dataBind } from '../../core/helpers';
 import { Plugin } from '../../core/plugin';
 import { getDataTransfer } from './paste/helpers';
 import { autobind, throttle } from '../../core/decorators';
-import { FileBrowserFiles } from '../../modules/file-browser/ui';
+import { isFileBrowserFilesItem } from '../../modules/file-browser';
 
 /**
  * Process drag and drop image from FileBrowser and movev image inside the editor
@@ -67,12 +71,7 @@ export class DragAndDrop extends Plugin {
 		this.startDragPoint.x = event.clientX;
 		this.startDragPoint.y = event.clientY;
 
-		if (
-			Dom.isElement(target) &&
-			target.classList.contains(
-				FileBrowserFiles.prototype.getFullElName('item')
-			)
-		) {
+		if (isFileBrowserFilesItem(target)) {
 			target = target.querySelector('img') as HTMLElement;
 		}
 

package/src/plugins/clipboard/index.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/clipboard
  */
 
 import './config';

package/src/plugins/clipboard/paste/CHANGELOG.md

@@ -0,0 +1,17 @@
+Changelog
+=========
+
+> **Tags:**
+> - :boom:       [Breaking Change]
+> - :rocket:     [New Feature]
+> - :bug:        [Bug Fix]
+> - :memo:       [Documentation]
+> - :house:      [Internal]
+> - :nail_care:  [Polish]
+
+## (2022-01-06) @xdan
+
+#### :rocket: New Feature
+
+Added `memorizeChoiceWhenPasteFragment` option: When the user inserts a piece of HTML, the plugin will ask - How to insert it.
+If after that user insert the same fragment again, the previous option will be used without extra question.

package/src/plugins/clipboard/paste/README.md

@@ -0,0 +1,8 @@
+The plugin handles pasting text fragments from the clipboard.
+
+To disable the plugin, just select:
+```js
+Jodit.make('#editor', {
+  disablePlugins: ['paste']
+})
+```

package/src/plugins/clipboard/paste/helpers.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/clipboard/paste
  */
 
 import type { IJodit, Nullable } from '../../../types';

package/src/plugins/clipboard/paste/paste.ts

@@ -1,7 +1,13 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * [[include:plugins/clipboard/paste/README.md]]
+ * @packageDocumentation
+ * @module plugins/clipboard/paste
  */
 
 import type { InsertMode, PasteEvent } from '../config';
@@ -47,7 +53,7 @@ type PastedValue = {
  * Ask before paste HTML source
  */
 export class paste extends Plugin {
-	pasteStack: LimitedStack<PastedValue> = new LimitedStack(20);
+	private pasteStack: LimitedStack<PastedValue> = new LimitedStack(20);
 
 	/** @override **/
 	protected afterInit(jodit: IJodit): void {
@@ -165,17 +171,19 @@ export class paste extends Plugin {
 	 */
 	private processHTML(e: PasteEvent, html: string): boolean {
 		if (this.j.o.askBeforePasteHTML) {
-			const cached = this.pasteStack.find(
-				cachedItem => cachedItem.html === html
-			);
-
-			if (cached) {
-				this.insertByType(
-					e,
-					html,
-					cached.action || this.j.o.defaultActionOnPaste
+			if (this.j.o.memorizeChoiceWhenPasteFragment) {
+				const cached = this.pasteStack.find(
+					cachedItem => cachedItem.html === html
 				);
-				return true;
+
+				if (cached) {
+					this.insertByType(
+						e,
+						html,
+						cached.action || this.j.o.defaultActionOnPaste
+					);
+					return true;
+				}
 			}
 
 			this.askInsertTypeDialog(

package/src/plugins/clipboard/paste-storage/paste-storage.less

@@ -1,7 +1,7 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
 @import (reference) '../../../styles/variables';

package/src/plugins/clipboard/paste-storage/paste-storage.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/clipboard/paste-storage
  */
 
 import './paste-storage.less';

package/src/plugins/{color.ts → color/color.ts}

@@ -1,14 +1,18 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
-import type { IJodit, IControlType } from '../types';
-import { Config } from '../config';
-import { Dom } from '../modules/';
-import { css, dataBind, normalizeColor } from '../core/helpers/';
-import { ColorPickerWidget, TabOption, TabsWidget } from '../modules/widget';
+/**
+ * @module plugins/color
+ */
+
+import type { IJodit, IControlType } from '../../types';
+import { Config } from '../../config';
+import { Dom } from '../../modules/';
+import { css, dataBind, normalizeColor } from '../../core/helpers/';
+import { ColorPickerWidget, TabOption, TabsWidget } from '../../modules/widget';
 
 Config.prototype.controls.brush = {
 	update(button): void {

package/src/plugins/error-messages/error-messages.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/error-messages
  */
 
 import './errors-messages.less';

package/src/plugins/error-messages/errors-messages.less

@@ -1,7 +1,7 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
 @import (reference) '../../styles/variables';

package/src/plugins/fix/clean-html.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/fix
  */
 
 import type {
@@ -29,7 +33,7 @@ declare module '../../config' {
 			timeout: number;
 
 			/**
-			 * Replace   toWYSIWYG plain space
+			 * Replace   to plain space
 			 */
 			replaceNBSP: boolean;
 			fillEmptyParagraph: boolean;

package/src/plugins/fix/wrap-text-nodes.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/fix
  */
 
 import type { IJodit, Nullable } from '../../types';

package/src/plugins/focus/README.md

@@ -0,0 +1,3 @@
+# Autofocus plugin
+
+Autofocus plugin - set focus inside the editor after reload

package/src/plugins/{focus.ts → focus/focus.ts}

@@ -1,14 +1,20 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
-import type { IJodit } from '../types';
-import { Config } from '../config';
-import { Dom } from '../core/dom';
+/**
+ * [[include:plugins/focus/README.md]]
+ * @packageDocumentation
+ * @module plugins/focus
+ */
+
+import type { IJodit } from '../../types';
+import { Config } from '../../config';
+import { Dom } from '../../core/dom';
 
-declare module '../config' {
+declare module '../../config' {
 	interface Config {
 		autofocus: boolean;
 		cursorAfterAutofocus: 'start' | 'end';
@@ -31,9 +37,6 @@ Config.prototype.cursorAfterAutofocus = 'end';
  */
 Config.prototype.saveSelectionOnBlur = true;
 
-/**
- * Autofocus plugin - set focus inside the editor after reload
- */
 export function focus(editor: IJodit): void {
 	if (editor.o.saveSelectionOnBlur) {
 		editor.e

package/src/plugins/{font.ts → font/font.ts}

@@ -1,15 +1,19 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
-import type { IControlType, IJodit } from '../types/';
-import { Config } from '../config';
-import { Dom } from '../core/dom';
-import { css, memorizeExec, normalizeSize } from '../core/helpers/';
+/**
+ * @module plugins/font
+ */
+
+import type { IControlType, IJodit } from '../../types/';
+import { Config } from '../../config';
+import { Dom } from '../../core/dom';
+import { css, memorizeExec, normalizeSize } from '../../core/helpers/';
 
-declare module '../config' {
+declare module '../../config' {
 	interface Config {
 		defaultFontSizePoints: 'px' | 'pt';
 	}

package/src/plugins/format-block/CHANGELOG.md

@@ -0,0 +1,16 @@
+Changelog
+=========
+
+> **Tags:**
+> - :boom:       [Breaking Change]
+> - :rocket:     [New Feature]
+> - :bug:        [Bug Fix]
+> - :memo:       [Documentation]
+> - :house:      [Internal]
+> - :nail_care:  [Polish]
+
+## (2022-01-06) @xdan
+
+#### :rocket: New Feature
+
+Added PRE tag to the list of items

package/src/plugins/format-block/README.md

@@ -0,0 +1,40 @@
+Plugin for inserting or changing the type of a block element: p => h1, h1 => h2 etc
+
+All settings are reduced to adding a new field to `Config.prototype.controls.paragraph.list`
+
+```js
+Jodit.make('#editor', {
+	controls: {
+		paragraph: {
+			list: {
+				pre: 'Source code'
+			}
+		}
+	}
+});
+```
+
+If you want to completely override the list, you can do it with [[Jodit.atom]]
+
+```js
+Jodit.make('#editor', {
+	controls: {
+		paragraph: {
+			list: Jodit.atom({
+        p: 'Pharagraph',
+        h1: 'Heading 1',
+        h2: 'Heading 2',
+        h3: 'Heading 3',
+        h4: 'Heading 4',
+        h5: 'Heading 5',
+        h6: 'Heading 6',
+        blockquote: 'Quote',
+        div: 'Div',
+				pre: 'Source code'
+			})
+		}
+	}
+});
+```
+
+[//]: # (-   [Changelog](plugins/format-block/CHANGELOG.md))

package/src/plugins/{format-block.ts → format-block/format-block.ts}

@@ -1,13 +1,24 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
-import type { HTMLTagNames, IJodit, IControlType, IDictionary } from '../types';
-import { Config } from '../config';
-import { Dom } from '../modules/';
-import { memorizeExec } from '../core/helpers';
+/**
+ * [[include:plugins/format-block/README.md]]
+ * @packageDocumentation
+ * @module plugins/format-block
+ */
+
+import type {
+	HTMLTagNames,
+	IJodit,
+	IControlType,
+	IDictionary
+} from '../../types';
+import { Config } from '../../config';
+import { Dom } from '../../modules/';
+import { memorizeExec } from '../../core/helpers';
 
 Config.prototype.controls.paragraph = {
 	command: 'formatBlock',
@@ -55,7 +66,8 @@ Config.prototype.controls.paragraph = {
 		h2: 'Heading 2',
 		h3: 'Heading 3',
 		h4: 'Heading 4',
-		blockquote: 'Quote'
+		blockquote: 'Quote',
+		pre: 'Monospace'
 	},
 
 	isChildActive: (editor: IJodit, control: IControlType): boolean => {

package/src/plugins/fullsize/fullsize.less

@@ -1,7 +1,7 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
 @import (reference) '../../styles/variables';
@@ -13,7 +13,7 @@
 
 	html&,
 	body& {
-		overflow: initial !important;
+		overflow: hidden !important;
 		width: 0 !important;
 		height: 0 !important;
 	}

package/src/plugins/fullsize/fullsize.ts

@@ -1,7 +1,11 @@
 /*!
  * Jodit Editor (https://xdsoft.net/jodit/)
  * Released under MIT see LICENSE.txt in the project root for license information.
- * Copyright (c) 2013-2021 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/fullsize
  */
 
 import './fullsize.less';