@ckeditor/ckeditor5-core 30.0.0 → 31.0.0

package/lang/translations/sr-latn.po

@@ -26,7 +26,7 @@ msgstr "Otkloni boju"
 
 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 "Vrati podrazumevano"
 
 msgctxt "Label for the Save button."
 msgid "Save"

package/lang/translations/sr.po

@@ -26,7 +26,7 @@ msgstr "Отклони боју"
 
 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 "Врати подразумевано"
 
 msgctxt "Label for the Save button."
 msgid "Save"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-core",
-  "version": "30.0.0",
+  "version": "31.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": "^30.0.0",
-    "@ckeditor/ckeditor5-ui": "^30.0.0",
-    "@ckeditor/ckeditor5-utils": "^30.0.0",
+    "@ckeditor/ckeditor5-engine": "^31.0.0",
+    "@ckeditor/ckeditor5-ui": "^31.0.0",
+    "@ckeditor/ckeditor5-utils": "^31.0.0",
     "lodash-es": "^4.17.15"
   },
   "devDependencies": {
-    "@ckeditor/ckeditor5-autoformat": "^30.0.0",
-    "@ckeditor/ckeditor5-basic-styles": "^30.0.0",
-    "@ckeditor/ckeditor5-block-quote": "^30.0.0",
-    "@ckeditor/ckeditor5-editor-classic": "^30.0.0",
-    "@ckeditor/ckeditor5-essentials": "^30.0.0",
-    "@ckeditor/ckeditor5-heading": "^30.0.0",
-    "@ckeditor/ckeditor5-image": "^30.0.0",
-    "@ckeditor/ckeditor5-indent": "^30.0.0",
-    "@ckeditor/ckeditor5-link": "^30.0.0",
-    "@ckeditor/ckeditor5-list": "^30.0.0",
-    "@ckeditor/ckeditor5-media-embed": "^30.0.0",
-    "@ckeditor/ckeditor5-paragraph": "^30.0.0",
-    "@ckeditor/ckeditor5-table": "^30.0.0"
+    "@ckeditor/ckeditor5-autoformat": "^31.0.0",
+    "@ckeditor/ckeditor5-basic-styles": "^31.0.0",
+    "@ckeditor/ckeditor5-block-quote": "^31.0.0",
+    "@ckeditor/ckeditor5-editor-classic": "^31.0.0",
+    "@ckeditor/ckeditor5-essentials": "^31.0.0",
+    "@ckeditor/ckeditor5-heading": "^31.0.0",
+    "@ckeditor/ckeditor5-image": "^31.0.0",
+    "@ckeditor/ckeditor5-indent": "^31.0.0",
+    "@ckeditor/ckeditor5-link": "^31.0.0",
+    "@ckeditor/ckeditor5-list": "^31.0.0",
+    "@ckeditor/ckeditor5-media-embed": "^31.0.0",
+    "@ckeditor/ckeditor5-paragraph": "^31.0.0",
+    "@ckeditor/ckeditor5-table": "^31.0.0"
   },
   "engines": {
     "node": ">=12.0.0",

package/src/command.js

@@ -20,7 +20,8 @@ import mix from '@ckeditor/ckeditor5-utils/src/mix';
  * Instances of registered commands can be retrieved from {@link module:core/editor/editor~Editor#commands `editor.commands`}.
  * The easiest way to execute a command is through {@link module:core/editor/editor~Editor#execute `editor.execute()`}.
  *
- * By default commands are disabled when the editor is in {@link module:core/editor/editor~Editor#isReadOnly read-only} mode.
+ * By default, commands are disabled when the editor is in {@link module:core/editor/editor~Editor#isReadOnly read-only} mode
+ * but commands with the {@link module:core/command~Command#affectsData `affectsData`} flag set to `false` will not be disabled.
  *
  * @mixes module:utils/observablemixin~ObservableMixin
  */
@@ -96,6 +97,21 @@ export default class Command {
 		 */
 		this.set( 'isEnabled', false );
 
+		/**
+		 * A flag indicating whether a command execution changes the editor data or not.
+		 *
+		 * Commands with `affectsData` set to `false` will not be automatically disabled in
+		 * {@link module:core/editor/editor~Editor#isReadOnly read-only mode} and
+		 * {@glink features/read-only#related-features other editor modes} with restricted user write permissions.
+		 *
+		 * **Note:** You do not have to set it for your every command. It will be `true` by default.
+		 *
+		 * @readonly
+		 * @default true
+		 * @member {Boolean} #affectsData
+		 */
+		this.affectsData = true;
+
 		/**
 		 * Holds identifiers for {@link #forceDisabled} mechanism.
 		 *
@@ -119,7 +135,7 @@ export default class Command {
 
 		// By default commands are disabled when the editor is in read-only mode.
 		this.listenTo( editor, 'change:isReadOnly', ( evt, name, value ) => {
-			if ( value ) {
+			if ( value && this.affectsData ) {
 				this.forceDisabled( 'readOnlyMode' );
 			} else {
 				this.clearForceDisabled( 'readOnlyMode' );

package/src/editor/editor.js

@@ -357,7 +357,8 @@ 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 {@glink builds/guides/overview#classic-editor classic editor}.
+ * The only editor type which can be initialized on `<textarea>` elements is
+ * the {@glink builds/guides/predefined-builds/overview#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

@@ -62,7 +62,7 @@
 /**
  * The list of plugins to load.
  *
- * If you use an {@glink builds/guides/overview editor build} you can define the list of plugins to load
+ * If you use an {@glink builds/guides/predefined-builds/overview editor build} you can define the list of plugins to load
  * using the names of plugins that are available:
  *
  *		const config = {
@@ -94,7 +94,7 @@
 
 /**
  * The list of additional plugins to load along those already available in the
- * {@glink builds/guides/overview editor build}. It extends the {@link #plugins `plugins`} configuration.
+ * {@glink builds/guides/predefined-builds/overview editor build}. It extends the {@link #plugins `plugins`} configuration.
  *
  *		function MyPlugin( editor ) {
  *			// ...
@@ -115,7 +115,7 @@
  */
 
 /**
- * The list of plugins which should not be loaded despite being available in an {@glink builds/guides/overview editor build}.
+ * The list of plugins which should not be loaded despite being available in an {@glink builds/guides/predefined-builds/overview editor build}.
  *
  *		const config = {
  *			removePlugins: [ 'Bold', 'Italic' ]