@ckeditor/ckeditor5-utils 45.2.1 → 46.0.0-alpha.0

package/src/dom/getpositionedancestor.js

@@ -5,13 +5,13 @@
 /**
  * @module utils/dom/getpositionedancestor
  */
-import global from './global.js';
+import { global } from './global.js';
 /**
  * For a given element, returns the nearest ancestor element which CSS position is not "static".
  *
  * @param element The native DOM element to be checked.
  */
-export default function getPositionedAncestor(element) {
+export function getPositionedAncestor(element) {
     if (!element || !element.parentNode) {
         return null;
     }

package/src/dom/getrangefrommouseevent.d.ts

@@ -11,7 +11,7 @@
  * @param domEvent The mouse event.
  * @returns The DOM range.
  */
-export default function getRangeFromMouseEvent(domEvent: MouseEvent & {
+export declare function getRangeFromMouseEvent(domEvent: MouseEvent & {
     rangeParent?: HTMLElement;
     rangeOffset?: number;
 }): Range | null;

package/src/dom/getrangefrommouseevent.js

@@ -11,7 +11,7 @@
  * @param domEvent The mouse event.
  * @returns The DOM range.
  */
-export default function getRangeFromMouseEvent(domEvent) {
+export function getRangeFromMouseEvent(domEvent) {
     if (!domEvent.target) {
         return null;
     }

package/src/dom/getvisualviewportoffset.d.ts

@@ -5,7 +5,7 @@
 /**
  * Returns the visual viewport offsets to adjust elements with `position: fixed` style.
  */
-export default function getVisualViewportOffset(): {
+export declare function getVisualViewportOffset(): {
     left: number;
     top: number;
 };

package/src/dom/getvisualviewportoffset.js

@@ -5,12 +5,12 @@
 /**
  * @module utils/dom/getvisualviewportoffset
  */
-import global from './global.js';
-import env from '../env.js';
+import { global } from './global.js';
+import { env } from '../env.js';
 /**
  * Returns the visual viewport offsets to adjust elements with `position: fixed` style.
  */
-export default function getVisualViewportOffset() {
+export function getVisualViewportOffset() {
     const visualViewport = global.window.visualViewport;
     if (!visualViewport || !(env.isiOS || env.isSafari)) {
         return { left: 0, top: 0 };

package/src/dom/global.d.ts

@@ -28,5 +28,5 @@ export interface GlobalType {
  * console.log( global.window.innerWidth );
  * ```
  */
-declare let globalVar: GlobalType;
-export default globalVar;
+declare let global: GlobalType;
+export { global };

package/src/dom/global.js

@@ -18,10 +18,10 @@
  * console.log( global.window.innerWidth );
  * ```
  */
-let globalVar; // named globalVar instead of global: https://github.com/ckeditor/ckeditor5/issues/12971
+let global; // named globalVar instead of global: https://github.com/ckeditor/ckeditor5/issues/12971
 // In some environments window and document API might not be available.
 try {
-    globalVar = { window, document };
+    global = { window, document };
 }
 catch {
     // It's not possible to mock a window object to simulate lack of a window object without writing extremely convoluted code.
@@ -30,6 +30,6 @@ catch {
     // We only handle this so loading editor in environments without window and document doesn't fail.
     // For better DX we shouldn't introduce mixed types and require developers to check the type manually.
     // This module should not be used on purpose in any environment outside browser.
-    globalVar = { window: {}, document: {} };
+    global = { window: {}, document: {} };
 }
-export default globalVar;
+export { global };

package/src/dom/indexof.d.ts

@@ -11,4 +11,4 @@
  * @param node Node which index is tested.
  * @returns Index of the node in the parent element. Returns 0 if node has no parent.
  */
-export default function indexOf(node: Node): number;
+export declare function indexOf(node: Node): number;

package/src/dom/indexof.js

@@ -11,7 +11,7 @@
  * @param node Node which index is tested.
  * @returns Index of the node in the parent element. Returns 0 if node has no parent.
  */
-export default function indexOf(node) {
+export function indexOf(node) {
     let index = 0;
     while (node.previousSibling) {
         node = node.previousSibling;

package/src/dom/insertat.d.ts

@@ -12,4 +12,4 @@
  * @param index Insertions index.
  * @param nodeToInsert Node to insert.
  */
-export default function insertAt(parentElement: Element, index: number, nodeToInsert: Node): void;
+export declare function insertAt(parentElement: Element, index: number, nodeToInsert: Node): void;

package/src/dom/insertat.js

@@ -12,6 +12,6 @@
  * @param index Insertions index.
  * @param nodeToInsert Node to insert.
  */
-export default function insertAt(parentElement, index, nodeToInsert) {
+export function insertAt(parentElement, index, nodeToInsert) {
     parentElement.insertBefore(nodeToInsert, parentElement.childNodes[index] || null);
 }

package/src/dom/iscomment.d.ts

@@ -8,4 +8,4 @@
 /**
  * Checks whether the object is a native DOM Comment node.
  */
-export default function isComment(obj: any): obj is Comment;
+export declare function isComment(obj: any): obj is Comment;

package/src/dom/iscomment.js

@@ -8,6 +8,6 @@
 /**
  * Checks whether the object is a native DOM Comment node.
  */
-export default function isComment(obj) {
+export function isComment(obj) {
     return obj && obj.nodeType === Node.COMMENT_NODE;
 }

package/src/dom/isnode.d.ts

@@ -8,4 +8,4 @@
 /**
  * Checks if the object is a native DOM Node.
  */
-export default function isNode(obj: any): obj is Node;
+export declare function isNode(obj: any): obj is Node;

package/src/dom/isnode.js

@@ -8,7 +8,7 @@
 /**
  * Checks if the object is a native DOM Node.
  */
-export default function isNode(obj) {
+export function isNode(obj) {
     if (obj) {
         if (obj.defaultView) {
             return obj instanceof obj.defaultView.Document;

package/src/dom/isrange.d.ts

@@ -8,4 +8,4 @@
 /**
  * Checks if the object is a native DOM Range.
  */
-export default function isRange(obj: unknown): obj is Range;
+export declare function isRange(obj: unknown): obj is Range;

package/src/dom/isrange.js

@@ -8,6 +8,6 @@
 /**
  * Checks if the object is a native DOM Range.
  */
-export default function isRange(obj) {
+export function isRange(obj) {
     return Object.prototype.toString.apply(obj) == '[object Range]';
 }

package/src/dom/istext.d.ts

@@ -8,4 +8,4 @@
 /**
  * Checks if the object is a native DOM Text node.
  */
-export default function isText(obj: unknown): obj is Text;
+export declare function isText(obj: unknown): obj is Text;

package/src/dom/istext.js

@@ -8,6 +8,6 @@
 /**
  * Checks if the object is a native DOM Text node.
  */
-export default function isText(obj) {
+export function isText(obj) {
     return Object.prototype.toString.call(obj) == '[object Text]';
 }

package/src/dom/isvalidattributename.d.ts

@@ -7,4 +7,4 @@
  *
  * @param name Attribute name.
  */
-export default function isValidAttributeName(name: string): boolean;
+export declare function isValidAttributeName(name: string): boolean;

package/src/dom/isvalidattributename.js

@@ -5,13 +5,13 @@
 /**
  * @module utils/dom/isvalidattributename
  */
-import global from './global.js';
+import { global } from './global.js';
 /**
  * Checks if the given attribute name is valid in terms of HTML.
  *
  * @param name Attribute name.
  */
-export default function isValidAttributeName(name) {
+export function isValidAttributeName(name) {
     try {
         global.document.createAttribute(name);
     }

package/src/dom/isvisible.d.ts

@@ -12,4 +12,4 @@
  * **Note**: This helper does not check whether the element is hidden by cropping, overflow, etc..
  * To check that, use {@link module:utils/dom/rect~Rect} instead.
  */
-export default function isVisible(element: Text | HTMLElement | null | undefined): boolean;
+export declare function isVisible(element: Text | HTMLElement | null | undefined): boolean;

package/src/dom/isvisible.js

@@ -5,7 +5,7 @@
 /**
  * @module utils/dom/isvisible
  */
-import isText from './istext.js';
+import { isText } from './istext.js';
 /**
  * Checks whether the element is visible to the user in DOM:
  *
@@ -16,7 +16,7 @@ import isText from './istext.js';
  * **Note**: This helper does not check whether the element is hidden by cropping, overflow, etc..
  * To check that, use {@link module:utils/dom/rect~Rect} instead.
  */
-export default function isVisible(element) {
+export function isVisible(element) {
     if (!element) {
         return false;
     }

package/src/dom/iswindow.d.ts

@@ -8,4 +8,4 @@
 /**
  * Checks if the object is a native DOM Window.
  */
-export default function isWindow(obj: unknown): obj is Window;
+export declare function isWindow(obj: unknown): obj is Window;

package/src/dom/iswindow.js

@@ -8,7 +8,7 @@
 /**
  * Checks if the object is a native DOM Window.
  */
-export default function isWindow(obj) {
+export function isWindow(obj) {
     const stringifiedObject = Object.prototype.toString.apply(obj);
     // Returns `true` for the `window` object in browser environments.
     if (stringifiedObject == '[object Window]') {

package/src/dom/position.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 Rect, { type RectSource } from './rect.js';
+import { Rect, type RectSource } from './rect.js';
 /**
  * Calculates the `position: absolute` coordinates of a given element so it can be positioned with respect to the
  * target in the visually most efficient way, taking various restrictions like viewport or limiter geometry
@@ -71,7 +71,7 @@ import Rect, { type RectSource } from './rect.js';
  *
  * @param options The input data and configuration of the helper.
  */
-export declare function getOptimalPosition({ element, target, positions, limiter, fitInViewport, viewportOffsetConfig }: Options): DomPoint | null;
+export declare function getOptimalPosition({ element, target, positions, limiter, fitInViewport, viewportOffsetConfig }: DomOptimalPositionOptions): DomPoint | null;
 /**
  * A position object which instances are created and used by the {@link module:utils/dom/position~getOptimalPosition} helper.
  *
@@ -105,7 +105,7 @@ export interface DomPoint {
 /**
  * The `getOptimalPosition()` helper options.
  */
-export interface Options {
+export interface DomOptimalPositionOptions {
     /**
      * Element that is to be positioned.
      */
@@ -182,11 +182,11 @@ export interface Options {
  * @param viewportRect The rect of the visual browser viewport.
  * @returns When the function returns `null`, it will not be considered by {@link module:utils/dom/position~getOptimalPosition}.
  */
-export type PositioningFunction = (elementRect: Rect, targetRect: Rect, viewportRect: Rect, limiterRect?: Rect) => PositioningFunctionResult | null;
+export type PositioningFunction = (elementRect: Rect, targetRect: Rect, viewportRect: Rect, limiterRect?: Rect) => DomPositioningFunctionResult | null;
 /**
  * The result of {@link module:utils/dom/position~PositioningFunction}.
  */
-export interface PositioningFunctionResult {
+export interface DomPositioningFunctionResult {
     /**
      * The `top` value of the element rect that would represent the position.
      */

package/src/dom/position.js

@@ -5,9 +5,9 @@
 /**
  * @module utils/dom/position
  */
-import global from './global.js';
-import Rect from './rect.js';
-import getPositionedAncestor from './getpositionedancestor.js';
+import { global } from './global.js';
+import { Rect } from './rect.js';
+import { getPositionedAncestor } from './getpositionedancestor.js';
 import { isFunction } from 'es-toolkit/compat';
 // @if CK_DEBUG_POSITION // const {
 // @if CK_DEBUG_POSITION // 	default: RectDrawer,

package/src/dom/rect.d.ts

@@ -7,7 +7,7 @@
  * the native `object.getBoundingClientRect()` method. Provides a set of methods
  * to manipulate the rect and compare it against other rect instances.
  */
-export default class Rect {
+export declare class Rect {
     /**
      * The "top" value of the rect.
      *
@@ -181,11 +181,11 @@ export default class Rect {
 /**
  * A source of {@link module:utils/dom/rect~Rect}.
  */
-export type RectSource = HTMLElement | Range | Window | RectLike;
+export type RectSource = HTMLElement | Range | Window | DomRectLike;
 /**
  * An object that describes properties of `ClientRect` object.
  */
-export interface RectLike {
+export interface DomRectLike {
     readonly top: number;
     readonly right: number;
     readonly bottom: number;

package/src/dom/rect.js

@@ -5,19 +5,19 @@
 /**
  * @module utils/dom/rect
  */
-import isRange from './isrange.js';
-import isWindow from './iswindow.js';
-import getBorderWidths from './getborderwidths.js';
-import isText from './istext.js';
-import getPositionedAncestor from './getpositionedancestor.js';
-import global from './global.js';
+import { isRange } from './isrange.js';
+import { isWindow } from './iswindow.js';
+import { getBorderWidths } from './getborderwidths.js';
+import { isText } from './istext.js';
+import { getPositionedAncestor } from './getpositionedancestor.js';
+import { global } from './global.js';
 const rectProperties = ['top', 'right', 'bottom', 'left', 'width', 'height'];
 /**
  * A helper class representing a `ClientRect` object, e.g. value returned by
  * the native `object.getBoundingClientRect()` method. Provides a set of methods
  * to manipulate the rect and compare it against other rect instances.
  */
-export default class Rect {
+export class Rect {
     /**
      * The "top" value of the rect.
      *

package/src/dom/remove.d.ts

@@ -10,4 +10,4 @@
  *
  * @param node Node to remove.
  */
-export default function remove(node: Node): void;
+export declare function remove(node: Node): void;

package/src/dom/remove.js

@@ -10,7 +10,7 @@
  *
  * @param node Node to remove.
  */
-export default function remove(node) {
+export function remove(node) {
     const parent = node.parentNode;
     if (parent) {
         parent.removeChild(node);

package/src/dom/resizeobserver.d.ts

@@ -18,7 +18,7 @@
  * It uses the [native DOM resize observer](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver)
  * under the hood.
  */
-export default class ResizeObserver {
+export declare class ResizeObserver {
     /**
      * The element observed by this observer.
      */

package/src/dom/resizeobserver.js

@@ -5,7 +5,7 @@
 /**
  * @module utils/dom/resizeobserver
  */
-import global from './global.js';
+import { global } from './global.js';
 /**
  * A helper class which instances allow performing custom actions when native DOM elements are resized.
  *
@@ -132,4 +132,4 @@ class ResizeObserver {
         });
     }
 }
-export default ResizeObserver;
+export { ResizeObserver };

package/src/dom/scroll.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
  */
-type IfTrue<T> = T extends true ? true : never;
+export type IfTrue<T> = T extends true ? true : never;
 /**
  * Makes any page `HTMLElement` or `Range` (`target`) visible inside the browser viewport.
  * This helper will scroll all `target` ancestors and the web browser viewport to reveal the target to
@@ -70,4 +70,3 @@ export declare function scrollViewportToShowTarget<T extends boolean, U extends
  * scrolling the whole page.
  */
 export declare function scrollAncestorsToShowTarget(target: HTMLElement | Range, ancestorOffset?: number, limiterElement?: HTMLElement): void;
-export {};

package/src/dom/scroll.js

@@ -5,9 +5,9 @@
 /**
  * @module utils/dom/scroll
  */
-import isRange from './isrange.js';
-import Rect from './rect.js';
-import isText from './istext.js';
+import { isRange } from './isrange.js';
+import { Rect } from './rect.js';
+import { isText } from './istext.js';
 /**
  * Makes any page `HTMLElement` or `Range` (`target`) visible inside the browser viewport.
  * This helper will scroll all `target` ancestors and the web browser viewport to reveal the target to

package/src/dom/setdatainelement.d.ts

@@ -11,4 +11,4 @@
  * @param el The element in which the data will be set.
  * @param data The data string.
  */
-export default function setDataInElement(el: HTMLElement, data: string): void;
+export declare function setDataInElement(el: HTMLElement, data: string): void;

package/src/dom/setdatainelement.js

@@ -11,7 +11,7 @@
  * @param el The element in which the data will be set.
  * @param data The data string.
  */
-export default function setDataInElement(el, data) {
+export function setDataInElement(el, data) {
     if (el instanceof HTMLTextAreaElement) {
         el.value = data;
     }

package/src/dom/tounit.d.ts

@@ -11,7 +11,7 @@
  *
  * @param unit An unit like "px" or "em".
  */
-export default function toUnit(unit: string): ToUnitHelper;
+export declare function toUnit(unit: string): ToUnitHelper;
 /**
  * A function, which adds a pre–defined trailing `unit`
  * to the passed `value`.

package/src/dom/tounit.js

@@ -11,6 +11,6 @@
  *
  * @param unit An unit like "px" or "em".
  */
-export default function toUnit(unit) {
+export function toUnit(unit) {
     return value => value + unit;
 }

package/src/elementreplacer.d.ts

@@ -9,7 +9,7 @@
  * Utility class allowing to hide existing HTML elements or replace them with given ones in a way that doesn't remove
  * the original elements from the DOM.
  */
-export default class ElementReplacer {
+export declare class ElementReplacer {
     /**
      * The elements replaced by {@link #replace} and their replacements.
      */

package/src/elementreplacer.js

@@ -9,7 +9,7 @@
  * Utility class allowing to hide existing HTML elements or replace them with given ones in a way that doesn't remove
  * the original elements from the DOM.
  */
-export default class ElementReplacer {
+export class ElementReplacer {
     /**
      * The elements replaced by {@link #replace} and their replacements.
      */

package/src/emittermixin.d.ts

@@ -5,7 +5,7 @@
 /**
  * @module utils/emittermixin
  */
-import EventInfo from './eventinfo.js';
+import { EventInfo } from './eventinfo.js';
 import { type PriorityString } from './priorities.js';
 import type { Constructor, Mixed } from './mix.js';
 import './version.js';
@@ -29,7 +29,7 @@ import './version.js';
  *
  * @label EXTENDS
  */
-export default function EmitterMixin<Base extends Constructor>(base: Base): Mixed<Base, Emitter>;
+export declare function EmitterMixin<Base extends Constructor>(base: Base): Mixed<Base, Emitter>;
 /**
  * Mixin that injects the {@link ~Emitter events API} into its host.
  *
@@ -48,7 +48,7 @@ export default function EmitterMixin<Base extends Constructor>(base: Base): Mixe
  *
  * @label NO_ARGUMENTS
  */
-export default function EmitterMixin(): {
+export declare function EmitterMixin(): {
     new (): Emitter;
     prototype: Emitter;
 };

package/src/emittermixin.js

@@ -5,18 +5,18 @@
 /**
  * @module utils/emittermixin
  */
-import EventInfo from './eventinfo.js';
-import uid from './uid.js';
-import priorities from './priorities.js';
-import insertToPriorityArray from './inserttopriorityarray.js';
+import { EventInfo } from './eventinfo.js';
+import { uid } from './uid.js';
+import { priorities } from './priorities.js';
+import { insertToPriorityArray } from './inserttopriorityarray.js';
 // To check if component is loaded more than once.
 import './version.js';
-import CKEditorError from './ckeditorerror.js';
+import { CKEditorError } from './ckeditorerror.js';
 const _listeningTo = Symbol('listeningTo');
 const _emitterId = Symbol('emitterId');
 const _delegations = Symbol('delegations');
 const defaultEmitterClass = /* #__PURE__ */ EmitterMixin(Object);
-export default function EmitterMixin(base) {
+export function EmitterMixin(base) {
     if (!base) {
         return defaultEmitterClass;
     }
@@ -241,14 +241,6 @@ export default function EmitterMixin(base) {
     }
     return Mixin;
 }
-// Backward compatibility with `mix`
-([
-    'on', 'once', 'off', 'listenTo',
-    'stopListening', 'fire', 'delegate', 'stopDelegating',
-    '_addEventListener', '_removeEventListener'
-]).forEach(key => {
-    EmitterMixin[key] = defaultEmitterClass.prototype[key];
-});
 /**
  * Checks if `listeningEmitter` listens to an emitter with given `listenedToEmitterId` and if so, returns that emitter.
  * If not, returns `null`.