@ckeditor/ckeditor5-core 34.2.0 → 35.0.0

package/lang/translations/ur.po

@@ -43,3 +43,7 @@ msgstr "0% میں سے 1%"
 msgctxt "A generic error message displayed on upload failure. The file name is concatenated to this text."
 msgid "Cannot upload file:"
 msgstr "فائل اپلوڈ نہیں ہو سکی:"
+
+msgctxt "Accessible label of the specific editing area of the editor acting as a root of the entire application."
+msgid "Rich Text Editor. Editing area: %0"
+msgstr "خانۂ ترمیم۔ علاقۂ ترمیم 0%"

package/lang/translations/uz.po

@@ -43,3 +43,7 @@ msgstr ""
 msgctxt "A generic error message displayed on upload failure. The file name is concatenated to this text."
 msgid "Cannot upload file:"
 msgstr ""
+
+msgctxt "Accessible label of the specific editing area of the editor acting as a root of the entire application."
+msgid "Rich Text Editor. Editing area: %0"
+msgstr ""

package/lang/translations/vi.po

@@ -26,7 +26,7 @@ msgstr "Xóa màu"
 
 msgctxt "The label used by a button next to the color palette in the color picker that restores the default value if the default table properties are specified."
 msgid "Restore default"
-msgstr ""
+msgstr "Khôi phục giá trị mặc định"
 
 msgctxt "Label for the Save button."
 msgid "Save"
@@ -43,3 +43,7 @@ msgstr "%0 đến %1"
 msgctxt "A generic error message displayed on upload failure. The file name is concatenated to this text."
 msgid "Cannot upload file:"
 msgstr "Không thể tải file:"
+
+msgctxt "Accessible label of the specific editing area of the editor acting as a root of the entire application."
+msgid "Rich Text Editor. Editing area: %0"
+msgstr "Trình chỉnh sửa Văn bản dạng RTF. Vùng chỉnh sửa:  %0"

package/lang/translations/zh-cn.po

@@ -43,3 +43,7 @@ msgstr "第 %0 步，共 %1 步"
 msgctxt "A generic error message displayed on upload failure. The file name is concatenated to this text."
 msgid "Cannot upload file:"
 msgstr "无法上传的文件："
+
+msgctxt "Accessible label of the specific editing area of the editor acting as a root of the entire application."
+msgid "Rich Text Editor. Editing area: %0"
+msgstr "富文本编辑器。编辑区域：%0"

package/lang/translations/zh.po

@@ -43,3 +43,7 @@ msgstr "%0/%1"
 msgctxt "A generic error message displayed on upload failure. The file name is concatenated to this text."
 msgid "Cannot upload file:"
 msgstr "無法上傳檔案："
+
+msgctxt "Accessible label of the specific editing area of the editor acting as a root of the entire application."
+msgid "Rich Text Editor. Editing area: %0"
+msgstr "RTF 編輯器。編輯區：%0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-core",
-  "version": "34.2.0",
+  "version": "35.0.0",
   "description": "The core architecture of CKEditor 5 – the best browser-based rich text editor.",
   "keywords": [
     "wysiwyg",
@@ -23,25 +23,25 @@
   ],
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-engine": "^34.2.0",
-    "@ckeditor/ckeditor5-ui": "^34.2.0",
-    "@ckeditor/ckeditor5-utils": "^34.2.0",
+    "@ckeditor/ckeditor5-engine": "^35.0.0",
+    "@ckeditor/ckeditor5-ui": "^35.0.0",
+    "@ckeditor/ckeditor5-utils": "^35.0.0",
     "lodash-es": "^4.17.15"
   },
   "devDependencies": {
-    "@ckeditor/ckeditor5-autoformat": "^34.2.0",
-    "@ckeditor/ckeditor5-basic-styles": "^34.2.0",
-    "@ckeditor/ckeditor5-block-quote": "^34.2.0",
-    "@ckeditor/ckeditor5-editor-classic": "^34.2.0",
-    "@ckeditor/ckeditor5-essentials": "^34.2.0",
-    "@ckeditor/ckeditor5-heading": "^34.2.0",
-    "@ckeditor/ckeditor5-image": "^34.2.0",
-    "@ckeditor/ckeditor5-indent": "^34.2.0",
-    "@ckeditor/ckeditor5-link": "^34.2.0",
-    "@ckeditor/ckeditor5-list": "^34.2.0",
-    "@ckeditor/ckeditor5-media-embed": "^34.2.0",
-    "@ckeditor/ckeditor5-paragraph": "^34.2.0",
-    "@ckeditor/ckeditor5-table": "^34.2.0"
+    "@ckeditor/ckeditor5-autoformat": "^35.0.0",
+    "@ckeditor/ckeditor5-basic-styles": "^35.0.0",
+    "@ckeditor/ckeditor5-block-quote": "^35.0.0",
+    "@ckeditor/ckeditor5-editor-classic": "^35.0.0",
+    "@ckeditor/ckeditor5-essentials": "^35.0.0",
+    "@ckeditor/ckeditor5-heading": "^35.0.0",
+    "@ckeditor/ckeditor5-image": "^35.0.0",
+    "@ckeditor/ckeditor5-indent": "^35.0.0",
+    "@ckeditor/ckeditor5-link": "^35.0.0",
+    "@ckeditor/ckeditor5-list": "^35.0.0",
+    "@ckeditor/ckeditor5-media-embed": "^35.0.0",
+    "@ckeditor/ckeditor5-paragraph": "^35.0.0",
+    "@ckeditor/ckeditor5-table": "^35.0.0"
   },
   "engines": {
     "node": ">=14.0.0",
@@ -60,6 +60,7 @@
     "lang",
     "src",
     "theme",
-    "ckeditor5-metadata.json"
+    "ckeditor5-metadata.json",
+    "CHANGELOG.md"
   ]
 }

package/src/editor/editor.js

@@ -481,7 +481,7 @@ mix( Editor, ObservableMixin );
  * This error is thrown when trying to pass a `<textarea>` element to a `create()` function of an editor class.
  *
  * The only editor type which can be initialized on `<textarea>` elements is
- * the {@glink installation/advanced/alternative-setups/predefined-builds#classic-editor classic editor}.
+ * the {@glink installation/getting-started/predefined-builds#classic-editor classic editor}.
  * This editor hides the passed element and inserts its own UI next to it. Other types of editors reuse the passed element as their root
  * editable element and therefore `<textarea>` is not appropriate for them. Use a `<div>` or another text container instead:
  *

package/src/editor/editorconfig.jsdoc

@@ -24,7 +24,7 @@
  *			.then( ... )
  *			.catch( ... );
  *
- * Check the {@glink installation/advanced/alternative-setups/predefined-builds Configuration guide} for more information
+ * Check the {@glink installation/getting-started/predefined-builds Configuration guide} for more information
  * about setting configuration options.
  *
  * @interface EditorConfig
@@ -66,7 +66,7 @@
 /**
  * The list of plugins to load.
  *
- * If you use an {@glink installation/advanced/alternative-setups/predefined-builds editor build} you can define the list of plugins to load
+ * If you use an {@glink installation/getting-started/predefined-builds editor build} you can define the list of plugins to load
  * using the names of plugins that are available:
  *
  *		const config = {
@@ -98,7 +98,7 @@
 
 /**
  * The list of additional plugins to load along those already available in the
- * {@glink installation/advanced/alternative-setups/predefined-builds editor build}. It extends the {@link #plugins `plugins`} configuration.
+ * {@glink installation/getting-started/predefined-builds editor build}. It extends the {@link #plugins `plugins`} configuration.
  *
  *		function MyPlugin( editor ) {
  *			// ...
@@ -110,7 +110,7 @@
  *
  * **Note:** This configuration works only for simple plugins which utilize the
  * {@link module:core/plugin~PluginInterface plugin interface} and have no dependencies. To extend a
- * build with complex features, create a {@glink installation/getting-started/quick-start#creating-custom-builds-with-online-builder custom build}.
+ * build with complex features, create a {@glink installation/getting-started/quick-start-other#creating-custom-builds-with-online-builder custom build}.
  *
  * **Note:** Make sure you include the new features in you toolbar configuration. Learn more
  * about the {@glink features/toolbar/toolbar toolbar setup}.
@@ -119,7 +119,7 @@
  */
 
 /**
- * The list of plugins which should not be loaded despite being available in an {@glink installation/advanced/alternative-setups/predefined-builds editor build}.
+ * The list of plugins which should not be loaded despite being available in an {@glink installation/getting-started/predefined-builds editor build}.
  *
  *		const config = {
  *			removePlugins: [ 'Bold', 'Italic' ]
@@ -327,3 +327,16 @@
  *
  * @member {Object} module:core/editor/editorconfig~EditorConfig#ui
  */
+
+ /**
+ * Enables updating the source element after the editor destroy.
+ *
+ * Enabling this option might have some security implications, as the editor doesn't have control over all data
+ * in the output.
+ *
+ * Be careful, especially while using 
+ * {@glink features/markdown Markdown}, {@glink features/general-html-support General HTML Support} or 
+ * {@glink features/html-embed HTML embed} features.
+ *
+ * @member {Boolean} module:core/editor/editorconfig~EditorConfig#updateSourceElementOnDestroy
+ */

package/src/editor/utils/elementapimixin.js

@@ -3,6 +3,8 @@
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 
+/* globals HTMLTextAreaElement */
+
 import CKEditorError from '@ckeditor/ckeditor5-utils/src/ckeditorerror';
 import setDataInElement from '@ckeditor/ckeditor5-utils/src/dom/setdatainelement';
 
@@ -20,7 +22,7 @@ const ElementApiMixin = {
 	/**
 	 * @inheritDoc
 	 */
-	updateSourceElement() {
+	updateSourceElement( data = this.data.get() ) {
 		if ( !this.sourceElement ) {
 			/**
 			 * Cannot update the source element of a detached editor.
@@ -36,7 +38,20 @@ const ElementApiMixin = {
 			);
 		}
 
-		setDataInElement( this.sourceElement, this.data.get() );
+		const shouldUpdateSourceElement = this.config.get( 'updateSourceElementOnDestroy' );
+		const isSourceElementTextArea = this.sourceElement instanceof HTMLTextAreaElement;
+
+		// The data returned by the editor might be unsafe, so we want to prevent rendering
+		// unsafe content inside the source element different than <textarea>, which is considered
+		// secure. This behaviour could be changed by setting the `updateSourceElementOnDestroy`
+		// configuration option to `true`.
+		if ( !shouldUpdateSourceElement && !isSourceElementTextArea ) {
+			setDataInElement( this.sourceElement, '' );
+
+			return;
+		}
+
+		setDataInElement( this.sourceElement, data );
 	}
 };
 
@@ -62,4 +77,6 @@ export default ElementApiMixin;
  * Updates the {@link #sourceElement editor source element}'s content with the data.
  *
  * @method #updateSourceElement
+ * @param {String} data The data that should be used to update the source element.
+ * By default, it is taken directly from the existing editor instance.
  */

package/src/plugincollection.js

@@ -344,7 +344,7 @@ export default class PluginCollection {
 			 * This is usually done in CKEditor 5 builds by setting the {@link module:core/editor/editor~Editor.builtinPlugins}
 			 * property.
 			 *
-			 * **If you see this warning when using one of the {@glink installation/advanced/alternative-setups/predefined-builds
+			 * **If you see this warning when using one of the {@glink installation/getting-started/predefined-builds
 			 * CKEditor 5 Builds}**,
 			 * it means that you try to enable a plugin which was not included in that build. This may be due to a typo
 			 * in the plugin name or simply because that plugin is not a part of this build. In the latter scenario,