jodit 3.10.2 → 3.12.2

package/src/core/request/ajax.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:core/request/README.md]]
+ * @packageDocumentation
+ * @module request
  */
 
 import type {
@@ -30,6 +36,17 @@ import { Response } from './response';
 import './config';
 
 export class Ajax<T extends object = any> implements IAjax<T> {
+	constructor(readonly jodit: IViewBased, options: Partial<AjaxOptions>) {
+		this.options = ConfigProto(
+			options || {},
+			Config.prototype.defaultAjaxOptions
+		) as AjaxOptions;
+
+		this.xhr = this.o.xhr ? this.o.xhr() : new XMLHttpRequest();
+
+		jodit && jodit.e && jodit.e.on('beforeDestruct', () => this.destruct());
+	}
+
 	static log: IRequest[] = [];
 
 	private readonly xhr!: XMLHttpRequest;
@@ -97,16 +114,19 @@ export class Ajax<T extends object = any> implements IAjax<T> {
 						request,
 						xhr.status,
 						xhr.statusText,
-						xhr.responseText
+						!xhr.responseType ? xhr.responseText : xhr.response
 					)
 				);
 			};
 
+			xhr.onload = onResolve;
 			xhr.onabort = onReject;
 			xhr.onerror = onReject;
 			xhr.ontimeout = onReject;
 
-			xhr.onload = onResolve;
+			if (o.responseType) {
+				xhr.responseType = o.responseType;
+			}
 
 			xhr.onprogress = (e): void => {
 				let percentComplete = 0;
@@ -192,17 +212,6 @@ export class Ajax<T extends object = any> implements IAjax<T> {
 		return request;
 	}
 
-	constructor(readonly jodit: IViewBased, options: Partial<AjaxOptions>) {
-		this.options = ConfigProto(
-			options || {},
-			Config.prototype.defaultAjaxOptions
-		) as AjaxOptions;
-
-		this.xhr = this.o.xhr ? this.o.xhr() : new XMLHttpRequest();
-
-		jodit && jodit.e && jodit.e.on('beforeDestruct', () => this.destruct());
-	}
-
 	destruct(): void {
 		if (this.activated && !this.resolved) {
 			this.abort();

package/src/core/request/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 request
  */
 
 import type { AjaxOptions } from '../../types';

package/src/core/request/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 request
  */
 
 export * from './ajax';

package/src/core/request/response.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 request
  */
 
 import type { IRequest, IResponse } from '../../types';
@@ -15,13 +19,13 @@ export class Response<T> implements IResponse<T> {
 		return this.request.url;
 	}
 
-	private readonly body: string;
+	private readonly body: string | Blob;
 
 	constructor(
 		request: IRequest,
 		status: number,
 		statusText: string,
-		body: string
+		body: string | Blob
 	) {
 		this.request = request;
 		this.status = status;
@@ -30,10 +34,14 @@ export class Response<T> implements IResponse<T> {
 	}
 
 	async json(): Promise<T> {
-		return JSON.parse(this.body);
+		return JSON.parse(this.body as string);
 	}
 
 	text(): Promise<string> {
-		return Promise.resolve(this.body);
+		return Promise.resolve(this.body as string);
+	}
+
+	async blob(): Promise<Blob> {
+		return this.body as Blob;
 	}
 }

package/src/core/selection/README.md

@@ -0,0 +1,20 @@
+A module for working with the cursor, text selections, processing selections, inserting html in place of the cursor.
+most obvious use case
+
+## How to insert HTML into Jodit
+
+There is a family of methods for this.[[Select.prototype.insertHTML]], [[Select.prototype.insertNode]], [[Select.prototype.insertImage]].
+
+```js
+const jodit = Jodit.make('#editor');
+jodit.selection.insertHTML('<span>some html</span>')
+jodit.selection.insertNode(document.createElement('div')) // don't do that =) see [[core/create]]
+jodit.selection.insertImage('https://somesite.com/image.png')
+```
+
+## How to set focus in Jodit editor
+
+```js
+const jodit = Jodit.make('#editor');
+jodit.selection.focus()
+```

package/src/core/selection/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 selection
  */
 
 export * from './style/commit-style';

package/src/core/selection/select.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:core/selection/README.md]]
+ * @packageDocumentation
+ * @module selection
  */
 
 import type {
@@ -412,7 +418,7 @@ export class Select implements ISelect {
 
 			if (this.j.iframe) {
 				if (this.doc.readyState === 'complete') {
-					this.j.iframe.focus();
+					this.j.iframe.focus(options);
 				}
 			}
 

package/src/core/selection/style/api/element-has-same-style.ts

@@ -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 type { IStyle } from '../../../../types';
@@ -10,6 +10,7 @@ import { Dom } from '../../../dom';
 
 /**
  * Element has the same styles as in the commit
+ * @private
  */
 export function elementHasSameStyle(elm: Node, rules: IStyle): boolean {
 	return Boolean(

package/src/core/selection/style/api/extract.ts

@@ -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 type { IJodit } from '../../../../types';
@@ -23,6 +23,7 @@ import { Dom } from '../../../dom';
  * ```html
  * `<strong><span>some</span></strong><strong><span><font>SELECTED</font></span></strong><strong><span>test</span></strong>
  * ```
+ * @private
  */
 export function extractSelectedPart(
 	wrapper: HTMLElement,

package/src/core/selection/style/api/finite-state-machine.ts

@@ -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 type { CanUndef, IDictionary } from '../../../../types';

package/src/core/selection/style/api/get-suit-child.ts

@@ -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 type { Nullable } from '../../../../types';
@@ -16,6 +16,7 @@ import { isSuitElement } from './is-suit-element';
  * If the child matches then returns it.
  * @example
  * `<font><strong>selected</strong></font>`
+ * @private
  */
 export function getSuitChild(
 	style: CommitStyle,

package/src/core/selection/style/api/get-suit-parent.ts

@@ -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 type { Nullable } from '../../../../types';
@@ -16,6 +16,7 @@ import { isSuitElement } from './is-suit-element';
  * @param style - styles to be applied
  * @param node - checked item
  * @param root - editor root
+ * @private
  */
 export function getSuitParent(
 	style: CommitStyle,

package/src/core/selection/style/api/index.ts

@@ -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
  */
 
 export * from './toggle/toggle-css';

package/src/core/selection/style/api/is-inside-invisible-element.ts

@@ -1,13 +1,14 @@
 /*!
  * 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 { Dom } from '../../../dom';
 
 /**
  * Check if FONT inside STYLE or SCRIPT element
+ * @private
  */
 export function isInsideInvisibleElement(
 	font: HTMLElement,

package/src/core/selection/style/api/is-normal-node.ts

@@ -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 type { Nullable } from '../../../../types';
@@ -9,6 +9,7 @@ import { Dom } from '../../../dom';
 
 /**
  * Is normal usual element
+ * @private
  */
 export function isNormalNode(elm: Nullable<Node>): boolean {
 	return Boolean(elm && !Dom.isEmptyTextNode(elm) && !Dom.isTemporary(elm));

package/src/core/selection/style/api/is-suit-element.ts

@@ -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 type { Nullable } from '../../../../types';
 import type { CommitStyle } from '../commit-style';
@@ -20,6 +20,7 @@ import { Dom } from '../../../dom';
  * @param commitStyle - style commit
  * @param elm - checked item
  * @param strict - strict mode - false - the default tag is suitable for us if it is also in the commit
+ * @private
  */
 export function isSuitElement(
 	commitStyle: CommitStyle,

package/src/core/selection/style/api/toggle/toggle-css.ts

@@ -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 type { CommitMode, IJodit } from '../../../../../types';
@@ -20,6 +20,7 @@ import { getContainer } from '../../../../global';
 
 /**
  * Toggles css and classname
+ * @private
  */
 export function toggleCSS(
 	commitStyle: CommitStyle,
@@ -95,7 +96,7 @@ function getShadowRoot(jodit: IJodit): HTMLElement {
 		return dataBind(jodit, 'shadowRoot');
 	}
 
-	const container = getContainer(jodit, function Utils() {});
+	const container = getContainer(jodit);
 
 	const iframe = document.createElement('iframe');
 	css(iframe, {

package/src/core/selection/style/api/toggle/toggle-ordered-list.ts

@@ -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 type { IJodit, CommitMode } from '../../../../../types';
@@ -13,6 +13,7 @@ import { toggleCSS } from './toggle-css';
 
 /**
  * Replaces `ul->ol` or `ol->ul`, apply styles to the list, or remove a list item from it
+ * @private
  */
 export function toggleOrderedList(
 	style: CommitStyle,

package/src/core/selection/style/api/toggle-commit-styles.ts

@@ -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 type { CommitStyle } from '../commit-style';
@@ -10,6 +10,7 @@ import { Dom } from '../../../dom';
 /**
  * Add or remove styles to element
  * @param elm - The element to switch styles
+ * @private
  */
 export function toggleCommitStyles(
 	commitStyle: CommitStyle,

package/src/core/selection/style/api/unwrap-children.ts

@@ -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 type { CommitStyle } from '../commit-style';
@@ -12,6 +12,7 @@ import type { IDictionary } from '../../../../types';
 
 /**
  * Unwrap all suit elements inside
+ * @private
  */
 export function unwrapChildren(style: CommitStyle, font: HTMLElement): boolean {
 	const needUnwrap: Node[] = [];

package/src/core/selection/style/api/wrap-and-commit-style.ts

@@ -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 type { IJodit } from '../../../../types';
@@ -13,6 +13,7 @@ import { wrapOrderedList } from './wrap-ordered-list';
 
 /**
  * Replaces the parent tag with the applicable one, or wraps the text and also replaces the tag
+ * @private
  */
 export function wrapAndCommitStyle(
 	commitStyle: CommitStyle,

package/src/core/selection/style/api/wrap-ordered-list.ts

@@ -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 type { IJodit } from '../../../../types';
@@ -11,6 +11,7 @@ import type { CommitStyle } from '../commit-style';
 /**
  * Replaces non-leaf items with leaf items and either creates a new list or
  * adds a new item to the nearest old list
+ * @private
  */
 export function wrapOrderedList(
 	commitStyle: CommitStyle,

package/src/core/selection/style/api/wrap-unwrapped-text.ts

@@ -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 type { IJodit, Nullable } from '../../../../types';
@@ -10,6 +10,7 @@ import { Dom } from '../../../dom';
 
 /**
  * Wrap text or inline elements inside Block element
+ * @private
  */
 export function wrapUnwrappedText(
 	style: CommitStyle,

package/src/core/selection/style/apply-style.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 selection
  */
 
 import type { IJodit, Nullable, CanUndef, CommitMode } from '../../../types';

package/src/core/selection/style/commit-style.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 selection
  */
 
 import type { HTMLTagNames, IJodit, IStyleOptions } from '../../../types';

package/src/core/storage/README.md

@@ -0,0 +1,13 @@
+The module is designed to save information to the user's local storage.
+At startup, it is checked whether the user has allowed saving to persistent storage.
+
+> If not allowed, the module will use the [[MemoryStorageProvider]] strategy.
+
+```js
+const jodit = Jodit.make('#editor');
+jodit.storage.set('someKey', 1);
+
+// reload page
+
+jodit.storage.get('someKey'); // 1
+```

package/src/core/storage/engines/local-storage-provider.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 storage/local
  */
 
 import type {

package/src/core/storage/engines/memory-storage-provider.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 storage/memory
  */
 
 import type { IStorage, StorageValueType } from '../../../types';

package/src/core/storage/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 storage
  */
 
 export * from './engines/memory-storage-provider';

package/src/core/storage/storage.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:core/storage/README.md]]
+ * @packageDocumentation
+ * @module storage
  */
 
 import type { IStorage, StorageValueType } from '../../types';

package/src/core/traits/elms.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 traits
  */
 
 import type { IComponent, IContainer, IElms } from '../../types';

package/src/core/traits/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 traits
  */
 
 export * from './elms';

package/src/core/traits/mods.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 traits
  */
 
 import type { IComponent, IContainer, IDictionary, IMods } from '../../types';