@ckeditor/ckeditor5-core 44.3.0 → 45.0.0-alpha.1

package/lang/translations/zh-cn.po

@@ -142,3 +142,55 @@ msgstr "请尝试使用不同的短语或检查拼写。"
 msgctxt "The label of the source editing related features used in toolbar buttons."
 msgid "Source"
 msgstr "源"
+
+msgctxt "Label for the Insert button."
+msgid "Insert"
+msgstr ""
+
+msgctxt "Label for the Update button."
+msgid "Update"
+msgstr ""
+
+msgctxt "Label for the Back button."
+msgid "Back"
+msgstr ""
+
+msgctxt "Part of the date label used to describe the past days of the week (e.g., 'Last Monday'). Used for comments and suggestions."
+msgid "Last"
+msgstr ""
+
+msgctxt "Label for \"Today\". Used as a date label for comments and suggestions."
+msgid "Today"
+msgstr ""
+
+msgctxt "Label for \"Yesterday\". Used as a date label for comments and suggestions."
+msgid "Yesterday"
+msgstr ""
+
+msgctxt "Name of \"Monday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Monday') for comments and suggestions."
+msgid "Monday"
+msgstr ""
+
+msgctxt "Name of \"Tuesday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Tuesday') for comments and suggestions."
+msgid "Tuesday"
+msgstr ""
+
+msgctxt "Name of \"Wednesday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Wednesday') for comments and suggestions."
+msgid "Wednesday"
+msgstr ""
+
+msgctxt "Name of \"Thursday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Thursday') for comments and suggestions."
+msgid "Thursday"
+msgstr ""
+
+msgctxt "Name of \"Friday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Friday') for comments and suggestions."
+msgid "Friday"
+msgstr ""
+
+msgctxt "Name of \"Saturday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Saturday') for comments and suggestions."
+msgid "Saturday"
+msgstr ""
+
+msgctxt "Name of \"Sunday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Sunday') for comments and suggestions."
+msgid "Sunday"
+msgstr ""

package/lang/translations/zh.po

@@ -142,3 +142,55 @@ msgstr "請嘗試其他詞彙或確認拼寫是否正確。"
 msgctxt "The label of the source editing related features used in toolbar buttons."
 msgid "Source"
 msgstr "原始碼"
+
+msgctxt "Label for the Insert button."
+msgid "Insert"
+msgstr ""
+
+msgctxt "Label for the Update button."
+msgid "Update"
+msgstr ""
+
+msgctxt "Label for the Back button."
+msgid "Back"
+msgstr ""
+
+msgctxt "Part of the date label used to describe the past days of the week (e.g., 'Last Monday'). Used for comments and suggestions."
+msgid "Last"
+msgstr ""
+
+msgctxt "Label for \"Today\". Used as a date label for comments and suggestions."
+msgid "Today"
+msgstr ""
+
+msgctxt "Label for \"Yesterday\". Used as a date label for comments and suggestions."
+msgid "Yesterday"
+msgstr ""
+
+msgctxt "Name of \"Monday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Monday') for comments and suggestions."
+msgid "Monday"
+msgstr ""
+
+msgctxt "Name of \"Tuesday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Tuesday') for comments and suggestions."
+msgid "Tuesday"
+msgstr ""
+
+msgctxt "Name of \"Wednesday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Wednesday') for comments and suggestions."
+msgid "Wednesday"
+msgstr ""
+
+msgctxt "Name of \"Thursday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Thursday') for comments and suggestions."
+msgid "Thursday"
+msgstr ""
+
+msgctxt "Name of \"Friday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Friday') for comments and suggestions."
+msgid "Friday"
+msgstr ""
+
+msgctxt "Name of \"Saturday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Saturday') for comments and suggestions."
+msgid "Saturday"
+msgstr ""
+
+msgctxt "Name of \"Sunday\" day of the week. Used as a part of the date label for days of the week (e.g., 'Last Sunday') for comments and suggestions."
+msgid "Sunday"
+msgstr ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-core",
-  "version": "44.3.0",
+  "version": "45.0.0-alpha.1",
   "description": "The core architecture of CKEditor 5 – the best browser-based rich text editor.",
   "keywords": [
     "wysiwyg",
@@ -24,11 +24,11 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-engine": "44.3.0",
-    "@ckeditor/ckeditor5-ui": "44.3.0",
-    "@ckeditor/ckeditor5-utils": "44.3.0",
-    "@ckeditor/ckeditor5-watchdog": "44.3.0",
-    "lodash-es": "4.17.21"
+    "@ckeditor/ckeditor5-engine": "45.0.0-alpha.1",
+    "@ckeditor/ckeditor5-ui": "45.0.0-alpha.1",
+    "@ckeditor/ckeditor5-utils": "45.0.0-alpha.1",
+    "@ckeditor/ckeditor5-watchdog": "45.0.0-alpha.1",
+    "es-toolkit": "1.32.0"
   },
   "author": "CKSource (http://cksource.com/)",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -44,7 +44,6 @@
     "lang",
     "src/**/*.js",
     "src/**/*.d.ts",
-    "theme",
     "CHANGELOG.md"
   ],
   "types": "src/index.d.ts",
@@ -65,7 +64,6 @@
       "default": "./src/*"
     },
     "./lang/*": "./lang/*",
-    "./theme/*": "./theme/*",
     "./package.json": "./package.json"
   }
 }

package/src/accessibility.js

@@ -18,28 +18,32 @@ export const DEFAULT_GROUP_ID = 'common';
  * and {@link #addKeystrokeInfos} methods.
  */
 export default class Accessibility {
+    /**
+     * Stores information about keystrokes brought by editor features for the users to interact with the editor, mainly
+     * keystroke combinations and their accessible labels.
+     *
+     * This information is particularly useful for screen reader and other assistive technology users. It gets displayed
+     * by the {@link module:ui/editorui/accessibilityhelp/accessibilityhelp~AccessibilityHelp Accessibility help} dialog.
+     *
+     * Keystrokes are organized in categories and groups. They can be added using ({@link #addKeystrokeInfoCategory},
+     * {@link #addKeystrokeInfoGroup}, and {@link #addKeystrokeInfos}) methods.
+     *
+     * Please note that:
+     * * two categories are always available:
+     *   * `'contentEditing'` for keystrokes related to content creation,
+     *   * `'navigation'` for keystrokes related to navigation in the UI and the content.
+     * * unless specified otherwise, new keystrokes are added into the `'contentEditing'` category and the `'common'`
+     * keystroke group within that category while using the {@link #addKeystrokeInfos} method.
+     */
+    keystrokeInfos = new Map();
+    /**
+     * The editor instance.
+     */
+    _editor;
     /**
      * @inheritDoc
      */
     constructor(editor) {
-        /**
-         * Stores information about keystrokes brought by editor features for the users to interact with the editor, mainly
-         * keystroke combinations and their accessible labels.
-         *
-         * This information is particularly useful for screen reader and other assistive technology users. It gets displayed
-         * by the {@link module:ui/editorui/accessibilityhelp/accessibilityhelp~AccessibilityHelp Accessibility help} dialog.
-         *
-         * Keystrokes are organized in categories and groups. They can be added using ({@link #addKeystrokeInfoCategory},
-         * {@link #addKeystrokeInfoGroup}, and {@link #addKeystrokeInfos}) methods.
-         *
-         * Please note that:
-         * * two categories are always available:
-         *   * `'contentEditing'` for keystrokes related to content creation,
-         *   * `'navigation'` for keystrokes related to navigation in the UI and the content.
-         * * unless specified otherwise, new keystrokes are added into the `'contentEditing'` category and the `'common'`
-         * keystroke group within that category while using the {@link #addKeystrokeInfos} method.
-         */
-        this.keystrokeInfos = new Map();
         this._editor = editor;
         const isMenuBarVisible = editor.config.get('menuBar.isVisible');
         const t = editor.locale.t;

package/src/command.js

@@ -20,6 +20,31 @@ import { ObservableMixin } from '@ckeditor/ckeditor5-utils';
  * but commands with the {@link module:core/command~Command#affectsData `affectsData`} flag set to `false` will not be disabled.
  */
 export default class Command extends /* #__PURE__ */ ObservableMixin() {
+    /**
+     * The editor on which this command will be used.
+     */
+    editor;
+    /**
+     * A flag indicating whether a command's `isEnabled` state should be changed depending on where the document
+     * selection is placed.
+     *
+     * By default, it is set to `true`. If the document selection is placed in a
+     * {@link module:engine/model/model~Model#canEditAt non-editable} place (such as non-editable root), the command becomes disabled.
+     *
+     * The flag should be changed to `false` in a concrete command's constructor if the command should not change its `isEnabled`
+     * accordingly to the document selection.
+     */
+    _isEnabledBasedOnSelection;
+    /**
+     * A flag indicating whether a command execution changes the editor data or not.
+     *
+     * @see #affectsData
+     */
+    _affectsData;
+    /**
+     * Holds identifiers for {@link #forceDisabled} mechanism.
+     */
+    _disableStack;
     /**
      * Creates a new `Command` instance.
      *

package/src/commandcollection.js

@@ -10,6 +10,10 @@ import { CKEditorError } from '@ckeditor/ckeditor5-utils';
  * Collection of commands. Its instance is available in {@link module:core/editor/editor~Editor#commands `editor.commands`}.
  */
 export default class CommandCollection {
+    /**
+     * Command map.
+     */
+    _commands;
     /**
      * Creates collection instance.
      */

package/src/context.js

@@ -35,6 +35,88 @@ import PluginCollection from './plugincollection.js';
  * See {@link ~Context.create `Context.create()`} for usage examples.
  */
 export default class Context {
+    /**
+     * Stores all the configurations specific to this context instance.
+     */
+    config;
+    /**
+     * The plugins loaded and in use by this context instance.
+     */
+    plugins;
+    locale;
+    /**
+     * Shorthand for {@link module:utils/locale~Locale#t}.
+     */
+    t;
+    /**
+     * A list of editors that this context instance is injected to.
+     */
+    editors;
+    /**
+     * The default configuration which is built into the `Context` class.
+     *
+     * It is used in CKEditor 5 builds featuring `Context` to provide the default configuration options which are later used during the
+     * context initialization.
+     *
+     * ```ts
+     * Context.defaultConfig = {
+     * 	foo: 1,
+     * 	bar: 2
+     * };
+     *
+     * Context
+     * 	.create()
+     * 	.then( context => {
+     * 		context.config.get( 'foo' ); // -> 1
+     * 		context.config.get( 'bar' ); // -> 2
+     * 	} );
+     *
+     * // The default options can be overridden by the configuration passed to create().
+     * Context
+     * 	.create( { bar: 3 } )
+     * 	.then( context => {
+     * 		context.config.get( 'foo' ); // -> 1
+     * 		context.config.get( 'bar' ); // -> 3
+     * 	} );
+     * ```
+     *
+     * See also {@link module:core/context~Context.builtinPlugins `Context.builtinPlugins`}
+     * and {@link module:core/editor/editor~Editor.defaultConfig `Editor.defaultConfig`}.
+     */
+    static defaultConfig;
+    /**
+     * An array of plugins built into the `Context` class.
+     *
+     * It is used in CKEditor 5 builds featuring `Context` to provide a list of context plugins which are later automatically initialized
+     * during the context initialization.
+     *
+     * They will be automatically initialized by `Context` unless `config.plugins` is passed.
+     *
+     * ```ts
+     * // Build some context plugins into the Context class first.
+     * Context.builtinPlugins = [ FooPlugin, BarPlugin ];
+     *
+     * // Normally, you need to define config.plugins, but since Context.builtinPlugins was
+     * // defined, now you can call create() without any configuration.
+     * Context
+     * 	.create()
+     * 	.then( context => {
+     * 		context.plugins.get( FooPlugin ); // -> An instance of the Foo plugin.
+     * 		context.plugins.get( BarPlugin ); // -> An instance of the Bar plugin.
+     * 	} );
+     * ```
+     *
+     * See also {@link module:core/context~Context.defaultConfig `Context.defaultConfig`}
+     * and {@link module:core/editor/editor~Editor.builtinPlugins `Editor.builtinPlugins`}.
+     */
+    static builtinPlugins;
+    /**
+     * Reference to the editor which created the context.
+     * Null when the context was created outside of the editor.
+     *
+     * It is used to destroy the context when removing the editor that has created the context.
+     */
+    _contextOwner = null;
     /**
      * Creates a context instance with a given configuration.
      *
@@ -43,13 +125,6 @@ export default class Context {
      * @param config The context configuration.
      */
     constructor(config) {
-        /**
-         * Reference to the editor which created the context.
-         * Null when the context was created outside of the editor.
-         *
-         * It is used to destroy the context when removing the editor that has created the context.
-         */
-        this._contextOwner = null;
         // We don't pass translations to the config, because its behavior of splitting keys
         // with dots (e.g. `resize.width` => `resize: { width }`) breaks the translations.
         const { translations, ...rest } = config || {};

package/src/contextplugin.js

@@ -21,6 +21,10 @@ import { ObservableMixin } from '@ckeditor/ckeditor5-utils';
  * * A context plugin MUST NOT require an {@link module:core/plugin~Plugin editor plugin}.
  */
 export default class ContextPlugin extends /* #__PURE__ */ ObservableMixin() {
+    /**
+     * The context or editor instance.
+     */
+    context;
     /**
      * Creates a new plugin instance.
      */

package/src/editingkeystrokehandler.js

@@ -20,6 +20,10 @@ import { KeystrokeHandler } from '@ckeditor/ckeditor5-utils';
  * ```
  */
 export default class EditingKeystrokeHandler extends KeystrokeHandler {
+    /**
+     * The editor instance.
+     */
+    editor;
     /**
      * Creates an instance of the keystroke handler.
      */

package/src/editor/editor.js

@@ -5,7 +5,7 @@
 /**
  * @module core/editor/editor
  */
-import { set, get } from 'lodash-es';
+import { set, get } from 'es-toolkit/compat';
 import { Config, CKEditorError, ObservableMixin, logError, parseBase64EncodedObject, releaseDate, toArray, uid, crc32 } from '@ckeditor/ckeditor5-utils';
 import { Conversion, DataController, EditingController, Model, StylesProcessor } from '@ckeditor/ckeditor5-engine';
 import { ContextWatchdog, EditorWatchdog } from '@ckeditor/ckeditor5-watchdog';
@@ -40,6 +40,184 @@ class Editor extends /* #__PURE__ */ ObservableMixin() {
     static get editorName() {
         return 'Editor';
     }
+    /**
+     * A namespace for the accessibility features of the editor.
+     */
+    accessibility;
+    /**
+     * Commands registered to the editor.
+     *
+     * Use the shorthand {@link #execute `editor.execute()`} method to execute commands:
+     *
+     * ```ts
+     * // Execute the bold command:
+     * editor.execute( 'bold' );
+     *
+     * // Check the state of the bold command:
+     * editor.commands.get( 'bold' ).value;
+     * ```
+     */
+    commands;
+    /**
+     * Stores all configurations specific to this editor instance.
+     *
+     * ```ts
+     * editor.config.get( 'image.toolbar' );
+     * // -> [ 'imageStyle:block', 'imageStyle:side', '|', 'toggleImageCaption', 'imageTextAlternative' ]
+     * ```
+     */
+    config;
+    /**
+     * Conversion manager through which you can register model-to-view and view-to-model converters.
+     *
+     * See the {@link module:engine/conversion/conversion~Conversion} documentation to learn how to add converters.
+     */
+    conversion;
+    /**
+     * The {@link module:engine/controller/datacontroller~DataController data controller}.
+     * Used e.g. for setting and retrieving the editor data.
+     */
+    data;
+    /**
+     * The {@link module:engine/controller/editingcontroller~EditingController editing controller}.
+     * Controls user input and rendering the content for editing.
+     */
+    editing;
+    /**
+     * The locale instance.
+     */
+    locale;
+    /**
+     * The editor's model.
+     *
+     * The central point of the editor's abstract data model.
+     */
+    model;
+    /**
+     * The plugins loaded and in use by this editor instance.
+     *
+     * ```ts
+     * editor.plugins.get( 'ClipboardPipeline' ); // -> An instance of the clipboard pipeline plugin.
+     * ```
+     */
+    plugins;
+    /**
+     * An instance of the {@link module:core/editingkeystrokehandler~EditingKeystrokeHandler}.
+     *
+     * It allows setting simple keystrokes:
+     *
+     * ```ts
+     * // Execute the bold command on Ctrl+E:
+     * editor.keystrokes.set( 'Ctrl+E', 'bold' );
+     *
+     * // Execute your own callback:
+     * editor.keystrokes.set( 'Ctrl+E', ( data, cancel ) => {
+     * 	console.log( data.keyCode );
+     *
+     * 	// Prevent the default (native) action and stop the underlying keydown event
+     * 	// so no other editor feature will interfere.
+     * 	cancel();
+     * } );
+     * ```
+     *
+     * Note: Certain typing-oriented keystrokes (like <kbd>Backspace</kbd> or <kbd>Enter</kbd>) are handled
+     * by a low-level mechanism and trying to listen to them via the keystroke handler will not work reliably.
+     * To handle these specific keystrokes, see the events fired by the
+     * {@link module:engine/view/document~Document editing view document} (`editor.editing.view.document`).
+     */
+    keystrokes;
+    /**
+     * Shorthand for {@link module:utils/locale~Locale#t}.
+     *
+     * @see module:utils/locale~Locale#t
+     */
+    t;
+    /**
+     * The default configuration which is built into the editor class.
+     *
+     * It is used in CKEditor 5 builds to provide the default configuration options which are later used during the editor initialization.
+     *
+     * ```ts
+     * ClassicEditor.defaultConfig = {
+     * 	foo: 1,
+     * 	bar: 2
+     * };
+     *
+     * ClassicEditor
+     * 	.create( sourceElement )
+     * 	.then( editor => {
+     * 		editor.config.get( 'foo' ); // -> 1
+     * 		editor.config.get( 'bar' ); // -> 2
+     * 	} );
+     *
+     * // The default options can be overridden by the configuration passed to create().
+     * ClassicEditor
+     * 	.create( sourceElement, { bar: 3 } )
+     * 	.then( editor => {
+     * 		editor.config.get( 'foo' ); // -> 1
+     * 		editor.config.get( 'bar' ); // -> 3
+     * 	} );
+     * ```
+     *
+     * See also {@link module:core/editor/editor~Editor.builtinPlugins}.
+     */
+    static defaultConfig;
+    /**
+     * An array of plugins built into this editor class.
+     *
+     * It is used in CKEditor 5 builds to provide a list of plugins which are later automatically initialized
+     * during the editor initialization.
+     *
+     * They will be automatically initialized by the editor, unless listed in `config.removePlugins` and
+     * unless `config.plugins` is passed.
+     *
+     * ```ts
+     * // Build some plugins into the editor class first.
+     * ClassicEditor.builtinPlugins = [ FooPlugin, BarPlugin ];
+     *
+     * // Normally, you need to define config.plugins, but since ClassicEditor.builtinPlugins was
+     * // defined, now you can call create() without any configuration.
+     * ClassicEditor
+     * 	.create( sourceElement )
+     * 	.then( editor => {
+     * 		editor.plugins.get( FooPlugin ); // -> An instance of the Foo plugin.
+     * 		editor.plugins.get( BarPlugin ); // -> An instance of the Bar plugin.
+     * 	} );
+     *
+     * ClassicEditor
+     * 	.create( sourceElement, {
+     * 		// Do not initialize these plugins (note: it is defined by a string):
+     * 		removePlugins: [ 'Foo' ]
+     * 	} )
+     * 	.then( editor => {
+     * 		editor.plugins.get( FooPlugin ); // -> Undefined.
+     * 		editor.config.get( BarPlugin ); // -> An instance of the Bar plugin.
+     * 	} );
+     *
+     * ClassicEditor
+     * 	.create( sourceElement, {
+     * 		// Load only this plugin. It can also be defined by a string if
+     * 		// this plugin was built into the editor class.
+     * 		plugins: [ FooPlugin ]
+     * 	} )
+     * 	.then( editor => {
+     * 		editor.plugins.get( FooPlugin ); // -> An instance of the Foo plugin.
+     * 		editor.config.get( BarPlugin ); // -> Undefined.
+     * 	} );
+     * ```
+     *
+     * See also {@link module:core/editor/editor~Editor.defaultConfig}.
+     */
+    static builtinPlugins;
+    /**
+     * The editor context.
+     * When it is not provided through the configuration, the editor creates it.
+     */
+    _context;
+    /**
+     * A set of lock IDs for the {@link #isReadOnly} getter.
+     */
+    _readOnlyLocks;
     /**
      * Creates a new instance of the editor class.
      *
@@ -545,6 +723,24 @@ class Editor extends /* #__PURE__ */ ObservableMixin() {
     static create(...args) {
         throw new Error('This is an abstract method.');
     }
+    /**
+     * The {@link module:core/context~Context} class.
+     *
+     * Exposed as static editor field for easier access in editor builds.
+     */
+    static Context = Context;
+    /**
+     * The {@link module:watchdog/editorwatchdog~EditorWatchdog} class.
+     *
+     * Exposed as static editor field for easier access in editor builds.
+     */
+    static EditorWatchdog = EditorWatchdog;
+    /**
+     * The {@link module:watchdog/contextwatchdog~ContextWatchdog} class.
+     *
+     * Exposed as static editor field for easier access in editor builds.
+     */
+    static ContextWatchdog = ContextWatchdog;
     _showLicenseError(reason, pluginName) {
         setTimeout(() => {
             if (reason == 'invalid') {
@@ -694,24 +890,6 @@ class Editor extends /* #__PURE__ */ ObservableMixin() {
         return response.json();
     }
 }
-/**
- * The {@link module:core/context~Context} class.
- *
- * Exposed as static editor field for easier access in editor builds.
- */
-Editor.Context = Context;
-/**
- * The {@link module:watchdog/editorwatchdog~EditorWatchdog} class.
- *
- * Exposed as static editor field for easier access in editor builds.
- */
-Editor.EditorWatchdog = EditorWatchdog;
-/**
- * The {@link module:watchdog/contextwatchdog~ContextWatchdog} class.
- *
- * Exposed as static editor field for easier access in editor builds.
- */
-Editor.ContextWatchdog = ContextWatchdog;
 export default Editor;
 function collectUsageData(editor) {
     const collectedData = getEditorUsageData(editor);

package/src/editor/utils/attachtoform.js

@@ -5,7 +5,7 @@
 /**
  * @module core/editor/utils/attachtoform
  */
-import { isFunction } from 'lodash-es';
+import { isFunction } from 'es-toolkit/compat';
 import { CKEditorError } from '@ckeditor/ckeditor5-utils';
 /**
  * Checks if the editor is initialized on a `<textarea>` element that belongs to a form. If yes, it updates the editor's element

package/src/editor/utils/elementapimixin.js

@@ -11,6 +11,7 @@ import { CKEditorError, setDataInElement } from '@ckeditor/ckeditor5-utils';
  */
 export default function ElementApiMixin(base) {
     class Mixin extends base {
+        sourceElement;
         updateSourceElement(data) {
             if (!this.sourceElement) {
                 /**