jodit 3.11.3 → 3.12.2

package/src/langs/it.js

@@ -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
  */
 
 module.exports = {

package/src/langs/ja.js

@@ -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
  */
 
 module.exports = {

package/src/langs/ko.js

@@ -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
  */
 
 module.exports = {

package/src/langs/nl.js

@@ -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
  */
 
 module.exports = {

package/src/langs/pl.js

@@ -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
  */
 
 module.exports = {

package/src/langs/pt_br.js

@@ -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
  */
 
 module.exports = {

package/src/langs/ru.js

@@ -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
  */
 
 module.exports = {

package/src/langs/tr.js

@@ -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
  */
 
 module.exports = {

package/src/langs/zh_cn.js

@@ -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
  */
 
 module.exports = {

package/src/langs/zh_tw.js

@@ -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
  */
 
 module.exports = {

package/src/modules/README.md

@@ -0,0 +1 @@
+Jodit modules

package/src/modules/context-menu/README.md

@@ -0,0 +1 @@
+Module for displaying the context menu.

package/src/modules/context-menu/context-menu.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/modules/context-menu/context-menu.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:modules/context-menu/README.md]]
+ * @packageDocumentation
+ * @module modules/context-menu
  */
 
 import './context-menu.less';

package/src/modules/dialog/README.md

@@ -0,0 +1,45 @@
+The Jodit dialog system allows you to create modals with title, footer, and content.
+Each dialog is created as a separate inheritor component [[View]].
+
+Several basic wrappers are available out of the box to quickly create basic windows: [[Alert]]/[[Confirm]]/[[Prompt]]
+
+```js
+Jodit.Alert('Hello world!', () => {
+	// After OK
+});
+Jodit.Confirm("Are you sure?", "Confirm Dialog", (yes) => {
+  if (yes) {
+    // do something
+  }
+});
+Jodit.Prompt("Enter your name", "Prompt Dialog", (name) => {
+  if (name.length < 3) {
+    Jodit.Alert("The name must be at least 3 letters");
+    return false;
+  }
+  // do something
+});
+```
+
+Each of these wrappers returns an [[IDialog]] object, and you can expand the open window.
+
+```js
+const dialog = Jodit.Alert('Hello world!', () => {
+	// After OK
+});
+dialog.setContent('Buy buy world! =)')
+```
+
+> Note that you do not need to call the [[Dialog.open]] method.
+
+For a simpler setup, you can immediately create an instance [[Dialog]] and already fully manage its contents:
+
+```js
+const dialog = new Jodit.modules.Dialog();
+dialog.setHeader('The header!')
+dialog.setContent('Content')
+dialog.setFooter([new Jodit.modules.UIButton(dialog).onAction(() => {
+	dialog.close();
+})]);
+dialog.open();
+```

package/src/modules/dialog/alert.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 modules/dialog
  */
 
 import { Dialog } from './dialog';

package/src/modules/dialog/confirm.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 modules/dialog
  */
 
 import { Dialog } from './dialog';

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

package/src/modules/dialog/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:modules/dialog/README.md]]
+ * @packageDocumentation
+ * @module modules/dialog
  */
 
 export { Dialog } from './dialog';

package/src/modules/dialog/prompt.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 modules/dialog
  */
 
 import { Dialog } from './dialog';

package/src/modules/file-browser/{README.MD → README.md}

@@ -1,6 +1,117 @@
-# FileBrowser
+Module for working with remote images or just files. Allows you to upload / delete / rename files on the server.
 
-Image and file browser on the server.
+> A prerequisite for the module to work is the server side. Jodit offers its own implementation in php [jodit-connectors](https://github.com/xdan/jodit-connectors). The module will not work without the server side.
+
+You can write the backend yourself, it must support [API](https://github.com/xdan/jodit-connectors#api)
+Module settings allow you to override behavior for your server-side implementation.
+
+For example, by default, the server side returns a list of files in this format:
+
+```json
+{
+	"success": true,
+	"time": "2021-12-23 16:30:01",
+	"data": {
+		"sources": [
+			{
+				"baseurl": "https://xdsoft.net/jodit/finder/files/",
+				"path": "/folder/somepath/",
+				"files": [
+					{
+						"name": "pexels-sachin-c-nair-954929.jpg",
+						"type": "image"
+					},
+					{
+						"name": "pexels-james-wheeler-417074.jpg",
+						"type": "image"
+					}
+				],
+				"name": "default"
+			}
+		],
+		"code": 220
+	}
+}
+```
+
+But what if your server returns such data for example?
+
+```json
+[
+	{
+		"name": "pexels-sachin-c-nair-954929.jpg",
+		"type": "image"
+	},
+	{
+		"name": "pexels-james-wheeler-417074.jpg",
+		"type": "image"
+	}
+]
+```
+
+In this case, you can add the setting [[IFileBrowser.ajax.process]] or define the same setting for a specific handle,
+for example, to get a list [[IFileBrowser.items]]
+
+```js
+Jodit.make('#editor', {
+	filebrowser: {
+		ajax: {
+			url: 'https://sitename.com/connector/index.php', // this parameter is required
+			process: resp => {
+				return {
+					success: true,
+					time: '2021-12-23 16:30:01',
+					data: {
+						sources: [
+							{
+								baseurl:
+									'https://xdsoft.net/jodit/finder/files/',
+								path: '/folder/somepath/',
+								files: resp,
+								name: 'default'
+							}
+						],
+						code: 220
+					}
+				};
+			}
+		}
+	}
+});
+```
+
+but in that case all the responses of the all endpoints will be processed by this function. Better to handle the response for a specific handle:
+
+```js
+Jodit.make('#editor', {
+	filebrowser: {
+		ajax: {
+			url: 'https://sitename.com/connector/index.php'
+		},
+		// a request for a list of files will be handled in a special way
+		items: {
+			process: resp => {
+				return {
+					success: true,
+					time: '2021-12-23 16:30:01',
+					data: {
+						sources: [
+							{
+								baseurl:
+									'https://xdsoft.net/jodit/finder/files/',
+								path: '/folder/somepath/',
+								files: resp,
+								name: 'default'
+							}
+						],
+						code: 220
+					}
+				};
+			}
+		}
+	}
+});
+```
 
 ## Settings
 
@@ -80,14 +191,13 @@ Jodit.make('#editor', {
     data obtained after administration of the server. Must return this PlainObject format
 
 ```js
- {
-    files: resp.files || [], // {array} The names of files or folders, files can
-    be ['image.jpg', 'image.jpg2', 'image3.jpg' ...] and [{file: 'image.jpg', thumb: '_thumbs/image.jpg'},
-    {file: 'image2.jpg', thumb: '_thumbs/image2.jpg'} ...]
-    path: resp.path, // {string} Real relative path
-    baseurl: resp.baseurl, // {string} Base url for filebrowser
-    error: resp.error, // {int}
-    msg: resp.msg // {string}
+const response = {
+	files: resp.files || [], // {array} The names of files or folders,
+	// files canbe ['image.jpg', 'image.jpg2', 'image3.jpg' ...] and [{file: 'image.jpg', thumb: '_thumbs/image.jpg'}, {file: 'image2.jpg', thumb: '_thumbs/image2.jpg'} ...]
+	path: resp.path, // {string} Real relative path
+	baseurl: resp.baseurl, // {string} Base url for filebrowser
+	error: resp.error, // {int}
+	msg: resp.msg // {string}
 };
 ```
 
@@ -127,59 +237,59 @@ Example:
 
 ```js
 // default values
-{
-    isSuccess: function (resp) {
-        return !resp.error;
-    },
-    getMessage: function (resp) {
-        return resp.msg;
-    },
-    ajax: {
-        url: '',
-        async: true,
-        data: {},
-        contentType : 'application/x-www-form-urlencoded; charset=UTF-8',
-        headers : {},
-        method : 'POST',
-        processData  : true,
-        dataType: 'json',
-        headers: {},
-        prepareData: function (data) {
-            return data;
-        },
-        process: function (resp) {
-            return {
-                files: resp.files || [],
-                path: resp.path,
-                baseurl: resp.baseurl,
-                error: resp.error,
-                msg: resp.msg
-            };
-        }
-    },
-    resize: {
-        data: {action: 'imageResize'},
-    },
-    crop: {
-        data: {action: 'imageCrop'},
-    },
-    create: {
-        data: {action: 'folderCreate'},
-    },
-    move: {
-        data: {action: 'fileMove'},
-    },
-    remove: {
-        data: {action: 'fileRemove'},
-    },
-    items: {
-        data: {action: 'files'},
-    },
-    folders: {
-        data: {action: 'folders'},
-    },
-    uploader: null // use default Uploader's settings
-}
+const options = {
+	isSuccess: function (resp) {
+		return !resp.error;
+	},
+	getMessage: function (resp) {
+		return resp.msg;
+	},
+	ajax: {
+		url: '',
+		async: true,
+		data: {},
+		contentType: 'application/x-www-form-urlencoded; charset=UTF-8',
+		headers: {},
+		method: 'POST',
+		processData: true,
+		dataType: 'json',
+		headers: {},
+		prepareData: function (data) {
+			return data;
+		},
+		process: function (resp) {
+			return {
+				files: resp.files || [],
+				path: resp.path,
+				baseurl: resp.baseurl,
+				error: resp.error,
+				msg: resp.msg
+			};
+		}
+	},
+	resize: {
+		data: { action: 'imageResize' }
+	},
+	crop: {
+		data: { action: 'imageCrop' }
+	},
+	create: {
+		data: { action: 'folderCreate' }
+	},
+	move: {
+		data: { action: 'fileMove' }
+	},
+	remove: {
+		data: { action: 'fileRemove' }
+	},
+	items: {
+		data: { action: 'files' }
+	},
+	folders: {
+		data: { action: 'folders' }
+	},
+	uploader: null // use default Uploader's settings
+};
 ```
 
 Example:

package/src/modules/file-browser/builders/context-menu.ts

@@ -1,10 +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 type { FileBrowser } from '../file-browser';
+/**
+ * @module modules/file-browser
+ */
+
+import type { IFileBrowser } from '../../../types';
 import { Dialog } from '../../dialog';
 
 import { Dom } from '../../../core/dom';
@@ -21,7 +25,7 @@ const CLASS_PREVIEW = 'jodit-filebrowser-preview',
 		Icon.get('angle-' + right) +
 		'</a>';
 
-export default (self: FileBrowser): ((e: DragEvent) => boolean | void) => {
+export default (self: IFileBrowser): ((e: DragEvent) => boolean | void) => {
 	if (!self.o.contextMenu) {
 		return () => {};
 	}

package/src/modules/file-browser/builders/item.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 modules/file-browser
  */
 
 import type {

package/src/modules/file-browser/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 modules/file-browser
  */
 
 import { Config } from '../../config';

package/src/modules/file-browser/data-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 modules/file-browser
  */
 
 import type {

package/src/modules/file-browser/factories.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 modules/file-browser
  */
 
 import type {