jodit 3.15.2 → 3.16.2

package/src/plugins/spellcheck/config.ts

@@ -0,0 +1,34 @@
+/*!
+ * Jodit Editor (https://xdsoft.net/jodit/)
+ * Released under MIT see LICENSE.txt in the project root for license information.
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * @module plugins/spellcheck
+ */
+
+import type { IControlType, IJodit } from 'jodit/types';
+import { Config } from 'jodit/config';
+
+declare module 'jodit/config' {
+	interface Config {
+		/**
+		 * Options specifies whether the editor is to have its spelling and grammar checked or not
+		 * @see {@link http://www.w3schools.com/tags/att_global_spellcheck.asp}
+		 */
+		spellcheck: boolean;
+	}
+}
+
+Config.prototype.spellcheck = false;
+
+Config.prototype.controls.spellcheck = {
+	isActive(e: IJodit): boolean {
+		return e.o.spellcheck;
+	},
+	icon: require('./spellcheck.svg'),
+	name: 'spellcheck',
+	command: 'toggleSpellcheck',
+	tooltip: 'Spellchecking'
+} as IControlType;

package/src/plugins/spellcheck/spellcheck.svg

@@ -0,0 +1,4 @@
+<svg viewBox="0 0 48 48" xmlns="http://www.w3.org/2000/svg">
+	<path
+		d="M24.89 32h4.18L18.86 6h-3.71L4.93 32h4.18l2.25-6h11.29l2.24 6zM12.86 22L17 10.95 21.14 22h-8.28zm30.31 1.17L27 39.34 19.66 32l-2.83 2.83L27 45l19-19-2.83-2.83z"/>
+</svg>

package/src/plugins/spellcheck/spellcheck.ts

@@ -0,0 +1,48 @@
+/*!
+ * Jodit Editor (https://xdsoft.net/jodit/)
+ * Released under MIT see LICENSE.txt in the project root for license information.
+ * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
+ */
+
+/**
+ * [[include:plugins/spellcheck/README.md]]
+ * @packageDocumentation
+ * @module plugins/spellcheck
+ */
+
+import type { IJodit } from 'jodit/types';
+import { Plugin } from 'jodit/core/plugin';
+import { attr } from 'jodit/core/helpers/utils/utils';
+import { autobind } from 'jodit/core/decorators';
+
+import './config';
+
+export class spellcheck extends Plugin {
+	override buttons: Plugin['buttons'] = [
+		{
+			group: 'state',
+			name: 'spellcheck'
+		}
+	];
+
+	protected afterInit(jodit: IJodit): void {
+		jodit.e.on(
+			'afterInit afterAddPlace prepareWYSIWYGEditor',
+			this.toggleSpellcheck
+		);
+		this.toggleSpellcheck();
+
+		jodit.registerCommand('toggleSpellcheck', () => {
+			this.jodit.o.spellcheck = !this.jodit.o.spellcheck;
+			this.toggleSpellcheck();
+			this.j.e.fire('updateToolbar');
+		});
+	}
+
+	@autobind
+	private toggleSpellcheck(): void {
+		attr(this.jodit.editor, 'spellcheck', this.jodit.o.spellcheck);
+	}
+
+	protected beforeDestruct(jodit: IJodit): void {}
+}

package/src/plugins/sticky/sticky.ts

@@ -22,7 +22,7 @@ declare module 'jodit/config' {
 		/**
 		 * @example
 		 * ```javascript
-		 * var editor = new Jodit('#someid', {
+		 * var editor = Jodit.make('#someid', {
 		 *  toolbarSticky: false
 		 * })
 		 * ```
@@ -37,7 +37,7 @@ declare module 'jodit/config' {
 		 *
 		 * @example
 		 * ```javascript
-		 * var editor = new Jodit('#someid', {
+		 * var editor = Jodit.make('#someid', {
 		 *  toolbarStickyOffset: 100
 		 * })
 		 * ```
@@ -54,7 +54,7 @@ export class sticky extends Plugin {
 	private isToolbarSticked: boolean = false;
 	private dummyBox?: HTMLElement;
 
-	private createDummy = (toolbar: HTMLElement) => {
+	private createDummy = (toolbar: HTMLElement): void => {
 		if (!isESNext && IS_IE && !this.dummyBox) {
 			this.dummyBox = this.j.c.div();
 			this.dummyBox.classList.add('jodit_sticky-dummy_toolbar');

package/src/plugins/table/resize-cells.ts

@@ -47,12 +47,12 @@ export class resizeCells extends Plugin {
 	private resizeDelta: number = 0;
 	private resizeHandler!: HTMLElement;
 
-	private showResizeHandle() {
+	private showResizeHandle(): void {
 		this.j.async.clearTimeout(this.hideTimeout);
 		this.j.workplace.appendChild(this.resizeHandler);
 	}
 
-	private hideResizeHandle() {
+	private hideResizeHandle(): void {
 		this.hideTimeout = this.j.async.setTimeout(
 			() => {
 				Dom.safeRemove(this.resizeHandler);
@@ -64,7 +64,7 @@ export class resizeCells extends Plugin {
 		);
 	}
 
-	private createResizeHandle = () => {
+	private createResizeHandle = (): void => {
 		if (!this.resizeHandler) {
 			this.resizeHandler = this.j.c.div('jodit-table-resizer');
 
@@ -97,7 +97,7 @@ export class resizeCells extends Plugin {
 	 * Click on resize handle
 	 */
 	@autobind
-	private onHandleMouseDown(event: MouseEvent) {
+	private onHandleMouseDown(event: MouseEvent): boolean | void {
 		if (this.j.isLocked) {
 			return;
 		}
@@ -166,7 +166,7 @@ export class resizeCells extends Plugin {
 	 * Mouse move after click on resize handle
 	 */
 	@autobind
-	private onMouseMove(event: MouseEvent) {
+	private onMouseMove(event: MouseEvent): void {
 		if (!this.drag) {
 			return;
 		}
@@ -235,14 +235,14 @@ export class resizeCells extends Plugin {
 			}
 		}
 
-		this.j.setEditorValue();
+		this.j.synchronizeValues();
 		this.j.s.focus();
 	}
 
 	/**
 	 * Resize only one column
 	 */
-	private resizeColumns() {
+	private resizeColumns(): void {
 		const delta = this.resizeDelta;
 
 		const marked: HTMLTableCellElement[] = [];
@@ -274,7 +274,7 @@ export class resizeCells extends Plugin {
 	/**
 	 * Resize whole table
 	 */
-	private resizeTable() {
+	private resizeTable(): void {
 		const delta = this.resizeDelta * (this.isRTL ? -1 : 1);
 
 		const width = this.workTable.offsetWidth,
@@ -316,7 +316,7 @@ export class resizeCells extends Plugin {
 	private setWorkCell(
 		cell: HTMLTableCellElement,
 		wholeTable: boolean | null = null
-	) {
+	): void {
 		this.wholeTable = wholeTable;
 
 		this.workCell = cell;
@@ -336,7 +336,7 @@ export class resizeCells extends Plugin {
 		cell: HTMLTableCellElement,
 		offsetX: number = 0,
 		delta: number = 0
-	) {
+	): void {
 		const box = offset(cell, this.j, this.j.ed);
 
 		if (offsetX > consts.NEARBY && offsetX < box.width - consts.NEARBY) {
@@ -435,7 +435,7 @@ export class resizeCells extends Plugin {
 	 * Add to every Table listeners
 	 */
 	@autobind
-	private observe(table: HTMLTableElement) {
+	private observe(table: HTMLTableElement): void {
 		if (dataBind(table, key)) {
 			return;
 		}

package/src/plugins/table/select-cells.ts

@@ -197,7 +197,7 @@ export class selectCells extends Plugin {
 		e.stopPropagation();
 
 		// Hack for FireFox for force redraw selection
-		(() => {
+		((): void => {
 			const n = this.j.createInside.fromHTML(
 				'<div style="color:rgba(0,0,0,0.01);width:0;height:0">&nbsp;</div>'
 			);
@@ -299,7 +299,7 @@ export class selectCells extends Plugin {
 	/**
 	 * Remove selection for all cells
 	 */
-	private unselectCells(currentCell?: Nullable<HTMLTableCellElement>) {
+	private unselectCells(currentCell?: Nullable<HTMLTableCellElement>): void {
 		const module = this.module;
 		const cells = module.getAllSelectedCells();
 

package/src/plugins/tooltip/tooltip.ts

@@ -79,7 +79,7 @@ export class tooltip extends Plugin {
 		this.setPosition(getPoint);
 	}
 
-	private setPosition(getPoint: () => IPoint) {
+	private setPosition(getPoint: () => IPoint): void {
 		const point = getPoint();
 
 		css(this.container, {

package/src/plugins/xpath/xpath.ts

@@ -31,7 +31,7 @@ Config.prototype.showXPathInStatusbar = true;
  * Show path to current element in status bar
  */
 export class xpath extends Plugin {
-	private onContext = (bindElement: Node, event: MouseEvent) => {
+	private onContext = (bindElement: Node, event: MouseEvent): boolean => {
 		if (!this.menu) {
 			this.menu = new ContextMenu(this.j);
 		}
@@ -40,19 +40,19 @@ export class xpath extends Plugin {
 			{
 				icon: 'bin',
 				title: bindElement === this.j.editor ? 'Clear' : 'Remove',
-				exec: () => {
+				exec: (): void => {
 					if (bindElement !== this.j.editor) {
 						Dom.safeRemove(bindElement);
 					} else {
 						this.j.value = '';
 					}
-					this.j.setEditorValue();
+					this.j.synchronizeValues();
 				}
 			},
 			{
 				icon: 'select-all',
 				title: 'Select',
-				exec: () => {
+				exec: (): void => {
 					this.j.s.select(bindElement);
 				}
 			}
@@ -61,7 +61,7 @@ export class xpath extends Plugin {
 		return false;
 	};
 
-	private onSelectPath = (bindElement: Node, event: MouseEvent) => {
+	private onSelectPath = (bindElement: Node, event: MouseEvent): boolean => {
 		this.j.s.focus();
 
 		const path = attr(event.target as HTMLElement, '-path') || '/';
@@ -110,14 +110,14 @@ export class xpath extends Plugin {
 
 	private selectAllButton?: IToolbarButton;
 
-	private removeSelectAll = () => {
+	private removeSelectAll = (): void => {
 		if (this.selectAllButton) {
 			this.selectAllButton.destruct();
 			delete this.selectAllButton;
 		}
 	};
 
-	private appendSelectAll = () => {
+	private appendSelectAll = (): void => {
 		this.removeSelectAll();
 
 		this.selectAllButton = makeButton(this.j, {
@@ -134,7 +134,7 @@ export class xpath extends Plugin {
 			);
 	};
 
-	private calcPathImd = () => {
+	private calcPathImd = (): void => {
 		if (this.isDestructed) {
 			return;
 		}

package/src/polyfills.ts

@@ -4,11 +4,12 @@
  * Copyright (c) 2013-2022 Valeriy Chupurnov. All rights reserved. https://xdsoft.net
  */
 
-import type { IDictionary } from 'jodit/types';
+import type { CanUndef, IDictionary } from 'jodit/types';
 
 import 'classlist-polyfill';
 import 'es6-promise/auto';
 import 'core-js/es/symbol';
+import 'core-js/es/array/find-index';
 
 if (!Array.from) {
 	Array.from = <T>(object: T[]): T[] => {
@@ -24,7 +25,7 @@ if (!Array.from) {
 
 // for ie11
 if (!Array.prototype.includes) {
-	Array.prototype.includes = function (value: any) {
+	Array.prototype.includes = function (value: any): boolean {
 		return this.indexOf(value) > -1;
 	};
 }
@@ -69,13 +70,13 @@ if (typeof Object.assign !== 'function') {
 }
 
 if (!Array.prototype.find) {
-	Array.prototype.find = function (value: any) {
+	Array.prototype.find = function <T>(value: T): CanUndef<T> {
 		return this.indexOf(value) > -1 ? value : undefined;
 	};
 }
 
 if (!String.prototype.endsWith) {
-	String.prototype.endsWith = function (value: any) {
+	String.prototype.endsWith = function (value: any): boolean {
 		return this[this.length - 1] === value;
 	};
 }

package/src/styles/icons/README.md

@@ -63,7 +63,7 @@ Create input element
 And define event `getIcon`:
 
 ```js
-const editor = new Jodit('#editor', {
+const editor = Jodit.make('#editor', {
 	events: {
 		getIcon: function (name, control, clearName) {
 			var code = name;
@@ -88,7 +88,7 @@ const editor = new Jodit('#editor', {
 For full replacing you can copy this code:
 
 ```js
-const editor = new Jodit('#editor', {
+const editor = Jodit.make('#editor', {
 	events: {
 		getIcon: function (name, control, clearName) {
 			var code = clearName;

package/src/types/async.d.ts

@@ -61,7 +61,17 @@ export interface IAsync extends IDestructible {
 		firstCallImmediately?: boolean
 	): CallbackFunction;
 
-	requestIdleCallback(fn: IdleRequestCallback): number;
-	requestIdlePromise(): RejectablePromise<number>;
+	requestIdleCallback(fn: IdleRequestCallback, options?: {timeout: number}): number;
+	requestIdlePromise(options?: {timeout: number}): RejectablePromise<number>;
 	cancelIdleCallback(request: number): void;
+
+	/**
+	 * Smart wrapper for `requestAnimationFrame`
+	 */
+	requestAnimationFrame(callback: FrameRequestCallback): number;
+
+	/**
+	 * Smart wrapper for `cancelAnimationFrame`
+	 */
+	cancelAnimationFrame(request: number): void;
 }

package/src/types/core.ts

@@ -13,4 +13,4 @@ import type { IComponent, IDictionary } from './types';
 export type DecoratorHandler = <T extends IComponent & IDictionary>(
 	target: T,
 	propertyKey: string
-) => void;
+) => void | PropertyDescriptor;

package/src/types/events.d.ts

@@ -171,9 +171,9 @@ interface IEventEmitter extends IDestructible {
 	 *  events.fire(document.body.querySelector('div'), 'click');
 	 * ```
 	 */
-	fire(subjectOrEvents: string, ...args: any[]): any;
+	fire(eventsList: string, ...args: any[]): any;
 	fire(
-		subjectOrEvents: object,
+		subject: object,
 		eventsList: string | Event,
 		...args: any[]
 	): any;
@@ -183,3 +183,7 @@ interface IEventEmitter extends IDestructible {
 		...args: any[]
 	): any;
 }
+
+export interface IObservable {
+	on(event: string | string[], callback: CallbackFunction): this;
+}

package/src/types/file-browser.d.ts

@@ -18,8 +18,7 @@ import type {
 import type { IUploader, IUploaderOptions } from './uploader';
 import type { IViewBased, IViewOptions } from './view';
 import type { IUIGroup } from './ui';
-import type { IObservable } from './observer';
-import type { IDialog } from './dialog';
+import type { IObservable } from './events';
 
 /**
  * The module creates a web browser dialog box. In a Web browser ,you can select an image, remove, drag it. Upload new

package/{types/types/observer.d.ts → src/types/history.d.ts}

@@ -15,16 +15,14 @@ import type {
 	SnapshotType
 } from './types';
 
-export interface IObservable {
-	on(event: string | string[], callback: CallbackFunction): this;
-}
-
 export interface ICommand {
+	tick: number;
 	undo(): void;
 	redo(): void;
 }
 
 export interface IStack {
+	readonly length: number;
 	clear(): void;
 	push(command: ICommand): void;
 	replace(command: ICommand): void;
@@ -36,17 +34,23 @@ export interface IStack {
 }
 
 export interface ISnapshot {
+	isBlocked: boolean;
 	make(): SnapshotType;
 	restoreOnlySelection(snapshot: SnapshotType): void;
 	restore(snapshot: SnapshotType): void;
 }
 
-export interface IObserver extends IComponent {
-	stack: IStack;
+export interface IHistory {
 	snapshot: ISnapshot;
+
 	redo(): void;
+	canRedo(): boolean;
 	undo(): void;
+	canUndo(): boolean;
+	readonly length: number;
+
+	processChanges(): void;
+
 	clear(): void;
-	replaceSnapshot(): void;
 	upTick(): void;
 }

package/src/types/index.d.ts

@@ -17,7 +17,7 @@ export * from './dialog';
 export * from './events';
 export * from './file-browser';
 export * from './jodit';
-export * from './observer';
+export * from './history';
 export * from './select';
 export * from './plugin';
 export * from './popup';

package/src/types/jodit.d.ts

@@ -10,7 +10,7 @@
 
 import { IViewOptions, IViewWithToolbar } from './view';
 import type { Config } from 'jodit/config';
-import type { CustomCommand, ICreate, IObserver, IStatusBar, Modes } from './';
+import type { CustomCommand, ICreate, IDestructible, IHistory, IStatusBar, Modes } from './';
 import type { IUploader } from './uploader';
 import type { IFileBrowser } from './file-browser';
 import { ISelect } from './select';
@@ -23,7 +23,7 @@ interface IWorkPlace {
 	statusbar: IStatusBar;
 	iframe?: HTMLIFrameElement | void;
 	editorWindow: Window;
-	observer: IObserver;
+	history: IHistory & IDestructible;
 	options: IViewOptions;
 }
 
@@ -31,13 +31,21 @@ interface IJodit extends IViewWithToolbar {
 	isJodit: true;
 
 	options: Config;
-	observer: IObserver;
+
+	history: IHistory;
+
+	/**
+	 * @deprecated Instead use `Jodit.history`
+	 */
+	observer: IHistory;
+
 	editor: HTMLElement;
 	element: HTMLElement;
 
 	getNativeEditorValue(): string;
 	getEditorValue(removeSelectionMarkers?: boolean, consumer?: string): string;
 	setEditorValue(value?: string): void;
+	synchronizeValues(): void;
 
 	getReadOnly(): boolean;
 	setReadOnly(enable: boolean): void;
@@ -82,7 +90,7 @@ interface IJodit extends IViewWithToolbar {
 	 *
 	 * @example
 	 * ```javascript
-	 * var editor = new Jodit('#editor');
+	 * var editor = Jodit.make('#editor');
 	 * console.log(editor.getRealMode());
 	 * ```
 	 */

package/src/types/toolbar.d.ts

@@ -44,7 +44,7 @@ interface IControlType<
 	 * @see copyformat plugin
 	 * @example
 	 * ```javascript
-	 * var editor = new Jodit('.selectorclass', {
+	 * var editor = Jodit.make('.selectorclass', {
 	 *     buttons: {
 	 *          checkbox: {
 	 *              data: {
@@ -82,7 +82,7 @@ interface IControlType<
 	 * @see copyformat plugin
 	 * @example
 	 * ```javascript
-	 * var editor = new Jodit('.selectorclass', {
+	 * var editor = Jodit.make('.selectorclass', {
 	 *     buttons: {
 	 *          checkbox: {
 	 *              data: {
@@ -117,7 +117,7 @@ interface IControlType<
 	 * (or array value) (see .[[Jodit.execCommand]] or define 'exec' function. See example
 	 * @example
 	 * ```javascript
-	 * new Jodit('#editor2', {
+	 * Jodit.make('#editor2', {
 	 *     buttons: Jodit.defaultOptions.buttons.concat([{
 	 *        name: 'listsss',
 	 *        iconURL: 'stuf/dummy.png',
@@ -164,7 +164,7 @@ interface IControlType<
 	 * String name for existing icons.
 	 * @example
 	 * ```javascript
-	 * var editor = new Jodit('.editor', {
+	 * var editor = Jodit.make('.editor', {
 	 *  buttons: [
 	 *      {
 	 *          icon: 'source',
@@ -216,7 +216,7 @@ interface IControlType<
 	 * After click on the button it will show popup element which consist value that this function returned
 	 * @example
 	 * ```javascript
-	 * var editor = new Jodit('.editor', {
+	 * var editor = Jodit.make('.editor', {
 	 *    buttons: [
 	 *      {
 	 *          icon: "insertCode",

package/src/types/types.d.ts

@@ -110,10 +110,10 @@ export interface IPointBound extends IPoint {
 }
 
 export interface ISelectionRange {
-	startContainer: Node | null;
-	startOffset: number | null;
-	endContainer: Node | null;
-	endOffset: number | null;
+	startContainer: Text;
+	startOffset: number;
+	endContainer: Text;
+	endOffset: number;
 }
 
 export interface IRGB {
@@ -275,3 +275,10 @@ declare global {
 		buffer?: IDictionary;
 	}
 }
+
+export interface FuzzySearch {
+	(needle: string, haystack: string, offset?: number, maxDistance?: number): [
+		number,
+		number
+	];
+}