jodit 3.10.2 → 3.12.2

package/src/plugins/{ordered-list.ts → ordered-list/ordered-list.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, Nullable } from '../types';
-import { Config } from '../config';
-import { Dom } from '../core/dom';
-import { dataBind, toArray } from '../core/helpers';
-import { Plugin } from '../core/plugin';
-import { autobind } from '../core/decorators';
+/**
+ * @module plugins/ordered-list
+ */
+
+import type { IControlType, IJodit, Nullable } from '../../types';
+import { Config } from '../../config';
+import { Dom } from '../../core/dom';
+import { dataBind, toArray } from '../../core/helpers';
+import { Plugin } from '../../core/plugin';
+import { autobind } from '../../core/decorators';
 
 const exec: IControlType<IJodit>['exec'] = (jodit, _, { control }): void => {
 	const key = `button${control.command}`;

package/src/plugins/placeholder/placeholder.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/placeholder/placeholder.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/placeholder
  */
 
 import './placeholder.less';

package/src/plugins/{powered-by-jodit.ts → powered-by-jodit/powered-by-jodit.ts}

@@ -1,13 +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';
+/**
+ * @module plugins/powered-by-jodit
+ */
+
+import type { IJodit } from '../../types';
 
-declare module '../config' {
+declare module '../../config' {
 	interface Config {
+		/**
+		 * Hide the link to the Jodit site at the bottom of the editor
+		 */
 		hidePoweredByJodit: boolean;
 	}
 }

package/src/plugins/print/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/print
  */
 
 export * from './preview';

package/src/plugins/print/preview.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/print
  */
 
 import type { IControlType, IDialog, IJodit } from '../../types';

package/src/plugins/print/print.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/print
  */
 
 import type { IControlType, IJodit } from '../../types';

package/src/plugins/{redo-undo.ts → redo-undo/redo-undo.ts}

@@ -1,13 +1,17 @@
 /*!
  * 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, IPlugin } from '../types/';
-import { Config } from '../config';
-import * as consts from '../core/constants';
-import { Plugin } from '../core/plugin';
+/**
+ * @module plugins/redo-undo
+ */
+
+import type { IControlType, IJodit, IPlugin } from '../../types/';
+import { Config } from '../../config';
+import * as consts from '../../core/constants';
+import { Plugin } from '../../core/plugin';
 
 Config.prototype.controls.redo = {
 	mode: consts.MODE_SPLIT,

package/src/plugins/resizer/resizer.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/resizer/resizer.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/resizer
  */
 
 import './resizer.less';
@@ -308,9 +312,14 @@ export class resizer extends Plugin {
 		key: 'width' | 'height',
 		value: number | string
 	): void {
-		if (Dom.isImage(element) && this.j.o.resizer.forImageChangeAttributes) {
+		const changeAttrs =
+			Dom.isImage(element) && this.j.o.resizer.forImageChangeAttributes;
+
+		if (changeAttrs) {
 			attr(element, key, value);
-		} else {
+		}
+
+		if (!changeAttrs || element.style[key]) {
 			css(element, key, value);
 		}
 	}

package/src/plugins/search/search.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/search/search.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/search
  */
 
 import './search.less';

package/src/plugins/{select.ts → select/select.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 { IJodit, Nullable } from '../types';
-import { Plugin } from '../core/plugin';
-import { autobind, watch } from '../core/decorators';
-import { camelCase } from '../core/helpers';
-import { Dom } from '../core/dom';
-import { Popup, UIElement } from '../core/ui';
+/**
+ * @module plugins/select
+ */
+
+import type { IJodit, Nullable } from '../../types';
+import { Plugin } from '../../core/plugin';
+import { autobind, watch } from '../../core/decorators';
+import { camelCase } from '../../core/helpers';
+import { Dom } from '../../core/dom';
+import { Popup, UIElement } from '../../core/ui';
 
 /* eslint-disable tsdoc/syntax */
 
@@ -70,7 +74,6 @@ export class select extends Plugin {
 	}
 
 	/**
-	 *
 	 * @event outsideClick(e) - when user clicked in the outside of editor
 	 */
 	@watch('ow:click')

package/src/plugins/size/config.ts

@@ -1,8 +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
  */
+
+/**
+ * @module plugins/size
+ */
+
 import { Config } from '../../config';
 
 declare module '../../config' {

package/src/plugins/size/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/size
  */
 
 import './config';

package/src/plugins/size/resize-handler.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/size
  */
 
 import type { IJodit, IPointBound } from '../../types';

package/src/plugins/size/size.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';
 @import (reference) '../../styles/mixins';

package/src/plugins/size/size.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/size
  */
 
 import './size.less';

package/src/plugins/source/README.md

@@ -0,0 +1,60 @@
+The plugin allows you to add the ability to directly edit HTML to the editor.
+The plugin connects the editor to the [Ace](https://ace.c9.io/)  page (default behavior).
+This is implemented through the connection of the CDN JS file. They are set in the settings in [[Config.sourceEditorCDNUrlsJS]]
+The appearance of the Ace editor can be set through its settings, option [[Config.sourceEditorNativeOptions]]
+
+For example, let's change the editor theme to light `Chrome`
+
+```js
+Jodit.make('#editor', {
+  sourceEditorNativeOptions: {
+    theme: 'chrome'
+  }
+})
+```
+
+The list of themes supported by `Ace` can be found on this page https://ace.c9.io/build/kitchen-sink.html
+
+Also, you can not use `Ace` but just use `Textarea`
+
+```js
+Jodit.make('#editor', {
+  sourceEditor: 'area'
+})
+```
+
+## Custom editor
+
+You can implement your own text editor implementation, for example you can use [CodeMirror](https://codemirror.net/)
+To do this, you need to add a class that will implement the interface [[ISourceEditor]] and register it with the plugin.
+
+```js
+class MirrorEditor {
+	constructor(jodit){}
+
+  getValue() {}
+  setValue(raw) {};
+  insertRaw(raw) {};
+
+  getSelectionEnd() {};
+  getSelectionStart() {};
+  setSelectionRange(start, end) {};
+
+  setPlaceHolder(title){}
+
+  focus() {
+  }
+
+  setReadOnly(isReadOnly) {}
+
+  selectAll() {}
+
+  get isReady() {};
+  onReadyAlways(callback) {};
+}
+
+Jodit.make('#editor', {
+  sourceEditor: (j) => new MirrorEditor(j)
+});
+```
+

package/src/plugins/source/config.ts

@@ -1,20 +1,34 @@
 /*!
  * 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';
+/**
+ * @module plugins/source
+ */
+
+import type { IControlType, IJodit, ISourceEditor } from '../../types';
 import { Config } from '../../config';
 import * as consts from '../../core/constants';
 import { IS_IE } from '../../core/constants';
 
 declare module '../../config' {
 	interface Config {
-		sourceEditor: 'area' | 'ace';
+		sourceEditor: 'area' | 'ace' | ((jodit: IJodit) => ISourceEditor);
 
 		/**
 		 * Options for [ace](https://ace.c9.io/#config) editor
+		 * @example
+		 * ```js
+		 * Jodit.make('#editor', {
+		 * 	showGutter: true,
+		 * 	theme: 'ace/theme/idle_fingers',
+		 * 	mode: 'ace/mode/html',
+		 * 	wrap: true,
+§		 * 	highlightActiveLine: true
+		 * })
+		 * ```
 		 */
 		sourceEditorNativeOptions: {
 			showGutter: boolean;
@@ -23,6 +37,7 @@ declare module '../../config' {
 			wrap: string | boolean | number;
 			highlightActiveLine: boolean;
 		};
+
 		/**
 		 * Beautify HTML then it possible
 		 */

package/src/plugins/source/const.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/source
  */
 
 export const SOURCE_CONSUMER = 'source-consumer';

package/src/plugins/source/editor/engines/ace.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/source
  */
 
 import type { IJodit, ISourceEditor } from '../../../../types';

package/src/plugins/source/editor/engines/area.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/source
  */
 
 import type { IJodit, ISourceEditor } from '../../../../types';

package/src/plugins/source/editor/engines/custom.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/source
  */
 
 import type { ISourceEditor } from '../../../../types';

package/src/plugins/source/editor/engines/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/source
  */
 
 export * from './area';

package/src/plugins/source/editor/factory.ts

@@ -1,14 +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
+ */
+
+/**
+ * @module plugins/source
  */
 
 import type { CallbackFunction, IJodit, ISourceEditor } from '../../../types';
 import { AceEditor, TextAreaEditor } from './engines';
+import { isFunction } from '../../../core/helpers';
 
 export function createSourceEditor(
-	type: 'ace' | 'mirror' | 'area',
+	type: 'ace' | 'mirror' | 'area' | ((jodit: IJodit) => ISourceEditor),
 	editor: IJodit,
 	container: HTMLElement,
 	toWYSIWYG: CallbackFunction,
@@ -16,25 +21,29 @@ export function createSourceEditor(
 ): ISourceEditor {
 	let sourceEditor: ISourceEditor;
 
-	switch (type) {
-		case 'ace':
-			if (!editor.o.shadowRoot) {
-				sourceEditor = new AceEditor(
+	if (isFunction(type)) {
+		sourceEditor = type(editor);
+	} else {
+		switch (type) {
+			case 'ace':
+				if (!editor.o.shadowRoot) {
+					sourceEditor = new AceEditor(
+						editor,
+						container,
+						toWYSIWYG,
+						fromWYSIWYG
+					);
+					break;
+				}
+
+			default:
+				sourceEditor = new TextAreaEditor(
 					editor,
 					container,
 					toWYSIWYG,
 					fromWYSIWYG
 				);
-				break;
-			}
-
-		default:
-			sourceEditor = new TextAreaEditor(
-				editor,
-				container,
-				toWYSIWYG,
-				fromWYSIWYG
-			);
+		}
 	}
 
 	sourceEditor.init(editor);

package/src/plugins/source/editor/sourceEditor.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/source
  */
 
 import type { CallbackFunction, IJodit } from '../../../types';

package/src/plugins/source/index.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/source/README.md]]
+ * @packageDocumentation
+ * @module plugins/source
  */
 
 import './config';

package/src/plugins/source/source.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/source/source.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/source
  */
 
 import './source.less';

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

@@ -1,16 +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 { Nullable } from '../types';
-import { Config } from '../config';
-import { INVISIBLE_SPACE_REG_EXP, SPACE_REG_EXP } from '../core/constants';
-import { Plugin } from '../core/plugin';
-import { Dom } from '../core/dom';
+/**
+ * @module plugins/stat
+ */
+
+import type { Nullable } from '../../types';
+import { Config } from '../../config';
+import { INVISIBLE_SPACE_REG_EXP, SPACE_REG_EXP } from '../../core/constants';
+import { Plugin } from '../../core/plugin';
+import { Dom } from '../../core/dom';
 
-declare module '../config' {
+declare module '../../config' {
 	interface Config {
 		showCharsCounter: boolean;
 		countHTMLChars: boolean;

package/src/plugins/sticky/sticky.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';