@ckeditor/ckeditor5-utils 44.3.0-alpha.7 → 45.0.0-alpha.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-utils",
-  "version": "44.3.0-alpha.7",
+  "version": "45.0.0-alpha.0",
   "description": "Miscellaneous utilities used by CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -12,9 +12,8 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-ui": "44.3.0-alpha.7",
-    "@types/lodash-es": "4.17.12",
-    "lodash-es": "4.17.21"
+    "@ckeditor/ckeditor5-ui": "45.0.0-alpha.0",
+    "es-toolkit": "1.32.0"
   },
   "author": "CKSource (http://cksource.com/)",
   "license": "SEE LICENSE IN LICENSE.md",

package/src/ckeditorerror.js

@@ -39,6 +39,14 @@ export const DOCUMENTATION_URL = 'https://ckeditor.com/docs/ckeditor5/latest/sup
  * ```
  */
 export default class CKEditorError extends Error {
+    /**
+     * A context of the error by which the Watchdog is able to determine which editor crashed.
+     */
+    context;
+    /**
+     * The additional error data passed to the constructor. Undefined if none was passed.
+     */
+    data;
     /**
      * Creates an instance of the CKEditorError class.
      *

package/src/collection.js

@@ -22,6 +22,43 @@ import isIterable from './isiterable.js';
  * @typeParam T The type of the collection element.
  */
 export default class Collection extends /* #__PURE__ */ EmitterMixin() {
+    /**
+     * The internal list of items in the collection.
+     */
+    _items;
+    /**
+     * The internal map of items in the collection.
+     */
+    _itemMap;
+    /**
+     * The name of the property which is considered to identify an item.
+     */
+    _idProperty;
+    /**
+     * A collection instance this collection is bound to as a result
+     * of calling {@link #bindTo} method.
+     */
+    _bindToCollection;
+    /**
+     * A helper mapping external items of a bound collection ({@link #bindTo})
+     * and actual items of this collection. It provides information
+     * necessary to properly remove items bound to another collection.
+     *
+     * See {@link #_bindToInternalToExternalMap}.
+     */
+    _bindToExternalToInternalMap;
+    /**
+     * A helper mapping items of this collection to external items of a bound collection
+     * ({@link #bindTo}). It provides information necessary to manage the bindings, e.g.
+     * to avoid loops in two–way bindings.
+     *
+     * See {@link #_bindToExternalToInternalMap}.
+     */
+    _bindToInternalToExternalMap;
+    /**
+     * Stores indexes of skipped items from bound external collection.
+     */
+    _skippedIndexesFromExternal;
     constructor(initialItemsOrOptions = {}, options = {}) {
         super();
         const hasInitialItems = isIterable(initialItemsOrOptions);

package/src/config.js

@@ -5,13 +5,17 @@
 /**
  * @module utils/config
  */
-import { isPlainObject, isElement, cloneDeepWith } from 'lodash-es';
+import { isPlainObject, isElement, cloneDeepWith } from 'es-toolkit/compat';
 /**
  * Handles a configuration dictionary.
  *
  * @typeParam Cfg A type of the configuration dictionary.
  */
 export default class Config {
+    /**
+     * Store for the whole configuration.
+     */
+    _config;
     /**
      * Creates an instance of the {@link ~Config} class.
      *

package/src/dom/createelement.js

@@ -6,7 +6,7 @@
  * @module utils/dom/createelement
  */
 import isIterable from '../isiterable.js';
-import { isString } from 'lodash-es';
+import { isString } from 'es-toolkit/compat';
 /**
  * Creates an HTML or SVG element with attributes and children elements.
  *

package/src/dom/emittermixin.js

@@ -111,6 +111,8 @@ export default function DomEmitterMixin(base) {
  *                                fire( click, DOM Event )
  */
 class ProxyEmitter extends /* #__PURE__ */ EmitterMixin() {
+    _domNode;
+    _options;
     /**
      * @param node DOM Node that fires events.
      * @param options Additional options.
@@ -128,6 +130,10 @@ class ProxyEmitter extends /* #__PURE__ */ EmitterMixin() {
         // And given options.
         this._options = options;
     }
+    /**
+     * Collection of native DOM listeners.
+     */
+    _domListeners;
     /**
      * Registers a callback function to be executed when an event is fired.
      *

package/src/dom/position.js

@@ -8,7 +8,7 @@
 import global from './global.js';
 import Rect from './rect.js';
 import getPositionedAncestor from './getpositionedancestor.js';
-import { isFunction } from 'lodash-es';
+import { isFunction } from 'es-toolkit/compat';
 // @if CK_DEBUG_POSITION // const {
 // @if CK_DEBUG_POSITION // 	default: RectDrawer,
 // @if CK_DEBUG_POSITION // 	diagonalStylesBlack,
@@ -234,6 +234,12 @@ function getBestPosition(positions, options) {
  * in DOM, they will make it display it in the right place in the viewport.
  */
 class PositionObject {
+    name;
+    config;
+    _positioningFunctionCoordinates;
+    _options;
+    _cachedRect;
+    _cachedAbsoluteRect;
     /**
      * Creates an instance of the {@link module:utils/dom/position~PositionObject} class.
      *

package/src/dom/rect.js

@@ -18,6 +18,48 @@ const rectProperties = ['top', 'right', 'bottom', 'left', 'width', 'height'];
  * to manipulate the rect and compare it against other rect instances.
  */
 export default class Rect {
+    /**
+     * The "top" value of the rect.
+     *
+     * @readonly
+     */
+    top;
+    /**
+     * The "right" value of the rect.
+     *
+     * @readonly
+     */
+    right;
+    /**
+     * The "bottom" value of the rect.
+     *
+     * @readonly
+     */
+    bottom;
+    /**
+     * The "left" value of the rect.
+     *
+     * @readonly
+     */
+    left;
+    /**
+     * The "width" value of the rect.
+     *
+     * @readonly
+     */
+    width;
+    /**
+     * The "height" value of the rect.
+     *
+     * @readonly
+     */
+    height;
+    /**
+     * The object this rect is for.
+     *
+     * @readonly
+     */
+    _source;
     /**
      * Creates an instance of rect.
      *

package/src/dom/resizeobserver.js

@@ -23,6 +23,23 @@ import global from './global.js';
  * under the hood.
  */
 class ResizeObserver {
+    /**
+     * The element observed by this observer.
+     */
+    _element;
+    /**
+     * The callback executed each time {@link #_element} is resized.
+     */
+    _callback;
+    /**
+     * The single native observer instance shared across all {@link module:utils/dom/resizeobserver~ResizeObserver} instances.
+     */
+    static _observerInstance = null;
+    /**
+     * A mapping of native DOM elements and their callbacks shared across all
+     * {@link module:utils/dom/resizeobserver~ResizeObserver} instances.
+     */
+    static _elementCallbacks = null;
     /**
      * Creates an instance of the `ResizeObserver` class.
      *
@@ -115,13 +132,4 @@ class ResizeObserver {
         });
     }
 }
-/**
- * The single native observer instance shared across all {@link module:utils/dom/resizeobserver~ResizeObserver} instances.
- */
-ResizeObserver._observerInstance = null;
-/**
- * A mapping of native DOM elements and their callbacks shared across all
- * {@link module:utils/dom/resizeobserver~ResizeObserver} instances.
- */
-ResizeObserver._elementCallbacks = null;
 export default ResizeObserver;

package/src/elementreplacer.js

@@ -10,6 +10,10 @@
  * the original elements from the DOM.
  */
 export default class ElementReplacer {
+    /**
+     * The elements replaced by {@link #replace} and their replacements.
+     */
+    _replacedElements;
     constructor() {
         this._replacedElements = [];
     }

package/src/eventinfo.js

@@ -11,6 +11,43 @@ import spy from './spy.js';
  * manipulate it.
  */
 export default class EventInfo {
+    /**
+     * The object that fired the event.
+     */
+    source;
+    /**
+     * The event name.
+     */
+    name;
+    /**
+     * Path this event has followed. See {@link module:utils/emittermixin~Emitter#delegate}.
+     */
+    path;
+    /**
+     * Stops the event emitter to call further callbacks for this event interaction.
+     */
+    stop;
+    /**
+     * Removes the current callback from future interactions of this event.
+     */
+    off;
+    /**
+     * The value which will be returned by {@link module:utils/emittermixin~Emitter#fire}.
+     *
+     * It's `undefined` by default and can be changed by an event listener:
+     *
+     * ```ts
+     * dataController.fire( 'getSelectedContent', ( evt ) => {
+     * 	// This listener will make `dataController.fire( 'getSelectedContent' )`
+     * 	// always return an empty DocumentFragment.
+     * 	evt.return = new DocumentFragment();
+     *
+     * 	// Make sure no other listeners are executed.
+     * 	evt.stop();
+     * } );
+     * ```
+     */
+    return;
     /**
      * @param source The emitter.
      * @param name The event name.

package/src/focustracker.d.ts

@@ -2,7 +2,7 @@
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
-import { type View } from '@ckeditor/ckeditor5-ui';
+import type { View } from '@ckeditor/ckeditor5-ui';
 declare const FocusTracker_base: import("./mix.js").Mixed<{
     new (): import("./observablemixin.js").Observable;
     prototype: import("./observablemixin.js").Observable;

package/src/focustracker.js

@@ -9,7 +9,7 @@
 import DomEmitterMixin from './dom/emittermixin.js';
 import ObservableMixin from './observablemixin.js';
 import CKEditorError from './ckeditorerror.js';
-import { isElement as _isElement } from 'lodash-es';
+import { isElement as _isElement } from 'es-toolkit/compat';
 /**
  * Allows observing a group of DOM `Element`s or {@link module:ui/view~View view instances} whether at least one of them (or their child)
  * is focused.
@@ -24,25 +24,25 @@ import { isElement as _isElement } from 'lodash-es';
  * Check out the {@glink framework/deep-dive/ui/focus-tracking "Deep dive into focus tracking"} guide to learn more.
  */
 export default class FocusTracker extends /* #__PURE__ */ DomEmitterMixin(/* #__PURE__ */ ObservableMixin()) {
+    /**
+     * List of registered DOM elements.
+     *
+     * @internal
+     */
+    _elements = new Set();
+    /**
+     * List of views with external focus trackers that contribute to the state of this focus tracker.
+     *
+     * @internal
+     */
+    _externalViews = new Set();
+    /**
+     * Asynchronous blur event timeout.
+     */
+    _blurTimeout = null;
     // @if CK_DEBUG_FOCUSTRACKER // public _label?: string;
     constructor() {
         super();
-        /**
-         * List of registered DOM elements.
-         *
-         * @internal
-         */
-        this._elements = new Set();
-        /**
-         * List of views with external focus trackers that contribute to the state of this focus tracker.
-         *
-         * @internal
-         */
-        this._externalViews = new Set();
-        /**
-         * Asynchronous blur event timeout.
-         */
-        this._blurTimeout = null;
         this.set('isFocused', false);
         this.set('focusedElement', null);
         // @if CK_DEBUG_FOCUSTRACKER // FocusTracker._instances.push( this );

package/src/index.d.ts

@@ -20,7 +20,7 @@ export { default as abortableDebounce, type AbortableFunc } from './abortabledeb
 export { default as count } from './count.js';
 export { default as compareArrays } from './comparearrays.js';
 export { default as createElement } from './dom/createelement.js';
-export { default as Config } from './config.js';
+export { default as Config, type GetSubConfig } from './config.js';
 export { default as isIterable } from './isiterable.js';
 export { default as DomEmitterMixin, type DomEmitter } from './dom/emittermixin.js';
 export { default as findClosestScrollableAncestor } from './dom/findclosestscrollableancestor.js';

package/src/keystrokehandler.js

@@ -43,6 +43,10 @@ import { getCode, parseKeystroke } from './keyboard.js';
  *
  */
 export default class KeystrokeHandler {
+    /**
+     * Listener used to listen to events for easier keystroke handler destruction.
+     */
+    _listener;
     /**
      * Creates an instance of the keystroke handler.
      */

package/src/locale.js

@@ -13,6 +13,85 @@ import { getLanguageDirection } from './language.js';
  * Represents the localization services.
  */
 export default class Locale {
+    /**
+     * The editor UI language code in the [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) format.
+     *
+     * If the {@link #contentLanguage content language} was not specified in the `Locale` constructor,
+     * it also defines the language of the content.
+     */
+    uiLanguage;
+    /**
+     * Text direction of the {@link #uiLanguage editor UI language}. Either `'ltr'` or `'rtl'`.
+     */
+    uiLanguageDirection;
+    /**
+     * The editor content language code in the [ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) format.
+     *
+     * Usually the same as the {@link #uiLanguage editor language}, it can be customized by passing an optional
+     * argument to the `Locale` constructor.
+     */
+    contentLanguage;
+    /**
+     * Text direction of the {@link #contentLanguage editor content language}.
+     *
+     * If the content language was passed directly to the `Locale` constructor, this property represents the
+     * direction of that language.
+     *
+     * If the {@link #contentLanguage editor content language} was derived from the {@link #uiLanguage editor language},
+     * the content language direction is the same as the {@link #uiLanguageDirection UI language direction}.
+     *
+     * The value is either `'ltr'` or `'rtl'`.
+     */
+    contentLanguageDirection;
+    /**
+     * Translates the given message to the {@link #uiLanguage}. This method is also available in
+     * {@link module:core/editor/editor~Editor#t `Editor`} and {@link module:ui/view~View#t `View`}.
+     *
+     * This method's context is statically bound to the `Locale` instance and **should always be called as a function**:
+     *
+     * ```ts
+     * const t = locale.t;
+     * t( 'Label' );
+     * ```
+     *
+     * The message can be either a string or an object implementing the {@link module:utils/translation-service~Message} interface.
+     *
+     * The message may contain placeholders (`%<index>`) for value(s) that are passed as a `values` parameter.
+     * For an array of values, the `%<index>` will be changed to an element of that array at the given index.
+     * For a single value passed as the second argument, only the `%0` placeholders will be changed to the provided value.
+     *
+     * ```ts
+     * t( 'Created file "%0" in %1ms.', [ fileName, timeTaken ] );
+     * t( 'Created file "%0", fileName );
+     * ```
+     *
+     * The message supports plural forms. To specify the plural form, use the `plural` property. Singular or plural form
+     * will be chosen depending on the first value from the passed `values`. The value of the `plural` property is used
+     * as a default plural translation when the translation for the target language is missing.
+     *
+     * ```ts
+     * t( { string: 'Add a space', plural: 'Add %0 spaces' }, 1 ); // 'Add a space' for the English language.
+     * t( { string: 'Add a space', plural: 'Add %0 spaces' }, 5 ); // 'Add 5 spaces' for the English language.
+     * t( { string: '%1 a space', plural: '%1 %0 spaces' }, [ 2, 'Add' ] ); // 'Add 2 spaces' for the English language.
+     *
+     * t( { string: 'Add a space', plural: 'Add %0 spaces' }, 1 ); // 'Dodaj spację' for the Polish language.
+     * t( { string: 'Add a space', plural: 'Add %0 spaces' }, 5 ); // 'Dodaj 5 spacji' for the Polish language.
+     * t( { string: '%1 a space', plural: '%1 %0 spaces' }, [ 2, 'Add' ] ); // 'Dodaj 2 spacje' for the Polish language.
+     * ```
+     *
+     *  * The message should provide an ID using the `id` property when the message strings are not unique and their
+     * translations should be different.
+     *
+     * ```ts
+     * translate( 'en', { string: 'image', id: 'ADD_IMAGE' } );
+     * translate( 'en', { string: 'image', id: 'AN_IMAGE' } );
+     * ```
+     */
+    t;
+    /**
+     * Object that contains translations.
+     */
+    translations;
     /**
      * Creates a new instance of the locale class. Learn more about
      * {@glink getting-started/setup/ui-language configuring the language of the editor}.

package/src/observablemixin.js

@@ -8,7 +8,7 @@
  */
 import EmitterMixin from './emittermixin.js';
 import CKEditorError from './ckeditorerror.js';
-import { isObject } from 'lodash-es';
+import { isObject } from 'es-toolkit/compat';
 const observablePropertiesSymbol = Symbol('observableProperties');
 const boundObservablesSymbol = Symbol('boundObservables');
 const boundPropertiesSymbol = Symbol('boundProperties');
@@ -204,6 +204,10 @@ export default function ObservableMixin(base) {
             }
             super.stopListening(emitter, event, callback);
         }
+        [observablePropertiesSymbol];
+        [decoratedMethods];
+        [boundPropertiesSymbol];
+        [boundObservablesSymbol];
     }
     return Mixin;
 }

package/src/translation-service.js

@@ -4,7 +4,7 @@
  */
 import CKEditorError from './ckeditorerror.js';
 import global from './dom/global.js';
-import { merge } from 'lodash-es';
+import { merge } from 'es-toolkit/compat';
 /* istanbul ignore else -- @preserve */
 if (!global.window.CKEDITOR_TRANSLATIONS) {
     global.window.CKEDITOR_TRANSLATIONS = {};

package/src/version.d.ts

@@ -2,7 +2,7 @@
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
-declare const version = "44.3.0-alpha.7";
+declare const version = "45.0.0-alpha.0";
 export default version;
 export declare const releaseDate: Date;
 declare global {

package/src/version.js

@@ -6,10 +6,10 @@
  * @module utils/version
  */
 import CKEditorError from './ckeditorerror.js';
-const version = '44.3.0-alpha.7';
+const version = '45.0.0-alpha.0';
 export default version;
 // The second argument is not a month. It is `monthIndex` and starts from `0`.
-export const releaseDate = new Date(2025, 2, 5);
+export const releaseDate = new Date(2025, 2, 26);
 /* istanbul ignore next -- @preserve */
 if (globalThis.CKEDITOR_VERSION) {
     /**
@@ -43,14 +43,14 @@ if (globalThis.CKEDITOR_VERSION) {
      *
      * - **New installation methods (NIM)** – Imports from the `ckeditor5` and `ckeditor5-premium-features` packages.
      * - **Optimized build** for the new installation methods &ndash; Imports from the `@ckeditor/ckeditor5-<NAME>/dist/index.js`.
-     * - **Predefined builds** (legacy) &ndash; Imports from the `@ckeditor/ckeditor5-build-<NAME>` packages.
+     * - **Predefined builds** (no longer supported) &ndash; Imports from the `@ckeditor/ckeditor5-build-<NAME>` packages.
      * - **Default imports** (legacy) &ndash; Imports from the `@ckeditor/ckeditor5-<NAME>` packages (default export).
      * - **`src`** (legacy) &ndash; Imports from the `@ckeditor/ckeditor5-<NAME>/src/*`.
      * - **DLL builds** (legacy) &ndash; Imports from the `ckeditor5/build/<NAME>` and `@ckeditor/ckeditor5-<NAME>/build/*`.
      *
      * The best way to avoid duplicate modules is to avoid mixing these installation methods. For example, if you use imports
      * specific to the optimized build, you should use them for all CKEditor&nbsp;5 packages. In addition, since
-     * the Predefined and DLL builds already include the core of the editor, they cannot be used with other types of imports.
+     * the DLL builds already include the core of the editor, they cannot be used with other types of imports.
      *
      * Here is a matrix showing which installation methods are compatible with each other:
      *
@@ -89,11 +89,15 @@ if (globalThis.CKEDITOR_VERSION) {
      * </details>
      *
      * <details>
-     * <summary>(Legacy) Predefined builds</summary>
+     * <summary>(Deprecated) Predefined builds</summary>
      *
-     * If you use the {@glink getting-started/legacy/installation-methods/predefined-builds Predefined builds},
-     * you cannot import any additional plugins. These builds already include the editor's core
-     * and selected plugins and importing additional ones will cause some modules to be bundled and loaded twice.
+     * **As of April, 2025 predefined build are no longer supported. Please refer to the
+     * {@glink getting-started/index Quick Start} guide
+     * to choose one of the modern installation and integration methods available**.
+     *
+     * If you use the predefined builds, you cannot import any additional plugins.
+     * These builds already include the editor's core and selected plugins and importing additional
+     * ones will cause some modules to be bundled and loaded twice.
      *
      * Examples of valid and invalid import paths:
      *
@@ -106,13 +110,9 @@ if (globalThis.CKEDITOR_VERSION) {
      * import '@ckeditor/ckeditor5-highlight/build/highlight'; // ❌
      * ```
      *
-     * If you are missing some features from the
-     * {@glink getting-started/legacy/installation-methods/predefined-builds#plugins-included-in-the-predefined-builds list of plugins},
-     * you should switch to the {@glink updating/nim-migration/migration-to-new-installation-methods new installation methods}
+     * If you are missing some features from the list of plugins, you should switch to the
+     * {@glink updating/nim-migration/migration-to-new-installation-methods new installation methods}
      * which do not have this limitation.
-     * If you cannot migrate to the new installation methods, try the
-     * {@glink getting-started/legacy/installation-methods/predefined-builds#superbuild superbuild} instead.
-     * This build contains all the editor features.
      * </details>
      *
      * <details>
@@ -123,8 +123,7 @@ if (globalThis.CKEDITOR_VERSION) {
      * the `@ckeditor/ckeditor5-<NAME>/src/*` files, it is not recommended as it can make migration to the new installation
      * methods more difficult.
      *
-     * If you use this installation method, you should not import code from the `ckeditor5`, `ckeditor5-premium-features`,
-     * or `@ckeditor/ckeditor5-build-<NAME>` packages.
+     * If you use this installation method, you should not import code from the `ckeditor5` or `ckeditor5-premium-features` packages.
      *
      * Examples of valid and invalid import paths:
      *