@ckeditor/ckeditor5-widget 0.0.0-nightly-20250613.0 → 0.0.0-nightly-20250614.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-widget",
-  "version": "0.0.0-nightly-20250613.0",
+  "version": "0.0.0-nightly-20250614.0",
   "description": "Widget API for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -12,13 +12,13 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-core": "0.0.0-nightly-20250613.0",
-    "@ckeditor/ckeditor5-engine": "0.0.0-nightly-20250613.0",
-    "@ckeditor/ckeditor5-enter": "0.0.0-nightly-20250613.0",
-    "@ckeditor/ckeditor5-icons": "0.0.0-nightly-20250613.0",
-    "@ckeditor/ckeditor5-ui": "0.0.0-nightly-20250613.0",
-    "@ckeditor/ckeditor5-utils": "0.0.0-nightly-20250613.0",
-    "@ckeditor/ckeditor5-typing": "0.0.0-nightly-20250613.0",
+    "@ckeditor/ckeditor5-core": "0.0.0-nightly-20250614.0",
+    "@ckeditor/ckeditor5-engine": "0.0.0-nightly-20250614.0",
+    "@ckeditor/ckeditor5-enter": "0.0.0-nightly-20250614.0",
+    "@ckeditor/ckeditor5-icons": "0.0.0-nightly-20250614.0",
+    "@ckeditor/ckeditor5-ui": "0.0.0-nightly-20250614.0",
+    "@ckeditor/ckeditor5-utils": "0.0.0-nightly-20250614.0",
+    "@ckeditor/ckeditor5-typing": "0.0.0-nightly-20250614.0",
     "es-toolkit": "1.38.0"
   },
   "author": "CKSource (http://cksource.com/)",

package/src/highlightstack.d.ts

@@ -3,7 +3,7 @@
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import type { DowncastWriter, HighlightDescriptor } from '@ckeditor/ckeditor5-engine';
-declare const HighlightStack_base: {
+declare const WidgetHighlightStack_base: {
     new (): import("@ckeditor/ckeditor5-utils").Emitter;
     prototype: import("@ckeditor/ckeditor5-utils").Emitter;
 };
@@ -18,7 +18,7 @@ declare const HighlightStack_base: {
  *
  * This way, highlight will be applied with the same rules it is applied on texts.
  */
-export declare class HighlightStack extends /* #__PURE__ */ HighlightStack_base {
+export declare class WidgetHighlightStack extends /* #__PURE__ */ WidgetHighlightStack_base {
     private readonly _stack;
     /**
      * Adds highlight descriptor to the stack.
@@ -46,18 +46,18 @@ export declare class HighlightStack extends /* #__PURE__ */ HighlightStack_base
     private _removeDescriptor;
 }
 /**
- * Fired when top element on {@link module:widget/highlightstack~HighlightStack} has been changed
+ * Fired when top element on {@link module:widget/highlightstack~WidgetHighlightStack} has been changed
  *
- * @eventName ~HighlightStack#change:top
+ * @eventName ~WidgetHighlightStack#change:top
  */
-export type HighlightStackChangeEvent = {
+export type WidgetHighlightStackChangeEvent = {
     name: 'change' | 'change:top';
-    args: [HighlightStackChangeEventData];
+    args: [WidgetHighlightStackChangeEventData];
 };
 /**
  * Additional information about the change.
  */
-export type HighlightStackChangeEventData = {
+export type WidgetHighlightStackChangeEventData = {
     /**
      * Old highlight descriptor. It will be `undefined` when first descriptor is added to the stack.
      */

package/src/highlightstack.js

@@ -17,7 +17,7 @@ import { EmitterMixin } from '@ckeditor/ckeditor5-utils';
  *
  * This way, highlight will be applied with the same rules it is applied on texts.
  */
-export class HighlightStack extends /* #__PURE__ */ EmitterMixin() {
+export class WidgetHighlightStack extends /* #__PURE__ */ EmitterMixin() {
     _stack = [];
     /**
      * Adds highlight descriptor to the stack.

package/src/index.d.ts

@@ -7,9 +7,12 @@
  */
 export { Widget } from './widget.js';
 export { WidgetToolbarRepository } from './widgettoolbarrepository.js';
-export { WidgetResize } from './widgetresize.js';
+export { WidgetResize, type WidgetResizerOptions } from './widgetresize.js';
 export { WidgetTypeAround } from './widgettypearound/widgettypearound.js';
 export { WIDGET_CLASS_NAME, WIDGET_SELECTED_CLASS_NAME, isWidget, toWidget, setHighlightHandling, setLabel, getLabel, toWidgetEditable, findOptimalInsertionRange, viewToModelPositionOutsideModelElement, calculateResizeHostAncestorWidth, calculateResizeHostPercentageWidth } from './utils.js';
+export { WidgetHighlightStack, type WidgetHighlightStackChangeEvent, type WidgetHighlightStackChangeEventData } from './highlightstack.js';
+export { verticalWidgetNavigationHandler } from './verticalnavigation.js';
+export { WidgetResizer, type WidgetResizerBeginEvent, type WidgetResizerCancelEvent, type WidgetResizerCommitEvent, type WidgetResizerUpdateSizeEvent } from './widgetresize/resizer.js';
 export { SizeView as _WidgetSizeView } from './widgetresize/sizeview.js';
-export { TYPE_AROUND_SELECTION_ATTRIBUTE as _WIDGET_TYPE_AROUND_SELECTION_ATTRIBUTE, getClosestTypeAroundDomButton as _getClosestWidgetTypeAroundDomButton, getTypeAroundButtonPosition as _getWidgetTypeAroundButtonPosition, getClosestWidgetViewElement as _getClosestWidgetViewElement, getTypeAroundFakeCaretPosition as _getWidgetTypeAroundFakeCaretPosition } from './widgettypearound/utils.js';
+export { TYPE_AROUND_SELECTION_ATTRIBUTE as _WIDGET_TYPE_AROUND_SELECTION_ATTRIBUTE, getClosestTypeAroundDomButton as _getClosestWidgetTypeAroundDomButton, getTypeAroundButtonPosition as _getWidgetTypeAroundButtonPosition, getClosestWidgetViewElement as _getClosestWidgetViewElement, getTypeAroundFakeCaretPosition as _getWidgetTypeAroundFakeCaretPosition, isTypeAroundWidget } from './widgettypearound/utils.js';
 import './augmentation.js';

package/src/index.js

@@ -10,6 +10,9 @@ export { WidgetToolbarRepository } from './widgettoolbarrepository.js';
 export { WidgetResize } from './widgetresize.js';
 export { WidgetTypeAround } from './widgettypearound/widgettypearound.js';
 export { WIDGET_CLASS_NAME, WIDGET_SELECTED_CLASS_NAME, isWidget, toWidget, setHighlightHandling, setLabel, getLabel, toWidgetEditable, findOptimalInsertionRange, viewToModelPositionOutsideModelElement, calculateResizeHostAncestorWidth, calculateResizeHostPercentageWidth } from './utils.js';
+export { WidgetHighlightStack } from './highlightstack.js';
+export { verticalWidgetNavigationHandler } from './verticalnavigation.js';
+export { WidgetResizer } from './widgetresize/resizer.js';
 export { SizeView as _WidgetSizeView } from './widgetresize/sizeview.js';
-export { TYPE_AROUND_SELECTION_ATTRIBUTE as _WIDGET_TYPE_AROUND_SELECTION_ATTRIBUTE, getClosestTypeAroundDomButton as _getClosestWidgetTypeAroundDomButton, getTypeAroundButtonPosition as _getWidgetTypeAroundButtonPosition, getClosestWidgetViewElement as _getClosestWidgetViewElement, getTypeAroundFakeCaretPosition as _getWidgetTypeAroundFakeCaretPosition } from './widgettypearound/utils.js';
+export { TYPE_AROUND_SELECTION_ATTRIBUTE as _WIDGET_TYPE_AROUND_SELECTION_ATTRIBUTE, getClosestTypeAroundDomButton as _getClosestWidgetTypeAroundDomButton, getTypeAroundButtonPosition as _getWidgetTypeAroundButtonPosition, getClosestWidgetViewElement as _getClosestWidgetViewElement, getTypeAroundFakeCaretPosition as _getWidgetTypeAroundFakeCaretPosition, isTypeAroundWidget } from './widgettypearound/utils.js';
 import './augmentation.js';

package/src/utils.d.ts

@@ -67,7 +67,7 @@ export declare function toWidget(element: ViewElement, writer: DowncastWriter, o
     hasSelectionHandle?: boolean;
 }): ViewElement;
 /**
- * Sets highlight handling methods. Uses {@link module:widget/highlightstack~HighlightStack} to
+ * Sets highlight handling methods. Uses {@link module:widget/highlightstack~WidgetHighlightStack} to
  * properly determine which highlight descriptor should be used at given time.
  */
 export declare function setHighlightHandling(element: ViewElement, writer: DowncastWriter, add?: (element: ViewElement, descriptor: HighlightDescriptor, writer: DowncastWriter) => void, remove?: (element: ViewElement, descriptor: HighlightDescriptor, writer: DowncastWriter) => void): void;

package/src/utils.js

@@ -8,7 +8,7 @@
 import { IconDragHandle } from '@ckeditor/ckeditor5-icons';
 import { Rect, CKEditorError, toArray } from '@ckeditor/ckeditor5-utils';
 import { IconView } from '@ckeditor/ckeditor5-ui';
-import { HighlightStack } from './highlightstack.js';
+import { WidgetHighlightStack } from './highlightstack.js';
 import { getTypeAroundFakeCaretPosition } from './widgettypearound/utils.js';
 /**
  * CSS class added to each widget element.
@@ -127,11 +127,11 @@ function removeHighlight(element, descriptor, writer) {
     }
 }
 /**
- * Sets highlight handling methods. Uses {@link module:widget/highlightstack~HighlightStack} to
+ * Sets highlight handling methods. Uses {@link module:widget/highlightstack~WidgetHighlightStack} to
  * properly determine which highlight descriptor should be used at given time.
  */
 export function setHighlightHandling(element, writer, add = addHighlight, remove = removeHighlight) {
-    const stack = new HighlightStack();
+    const stack = new WidgetHighlightStack();
     stack.on('change:top', (evt, data) => {
         if (data.oldDescriptor) {
             remove(element, data.oldDescriptor, data.writer);

package/src/verticalnavigation.d.ts

@@ -12,4 +12,4 @@ import type { EditingController, ViewDocumentArrowKeyEvent } from '@ckeditor/cke
  *
  * @param editing The editing controller.
  */
-export declare function verticalNavigationHandler(editing: EditingController): GetCallback<ViewDocumentArrowKeyEvent>;
+export declare function verticalWidgetNavigationHandler(editing: EditingController): GetCallback<ViewDocumentArrowKeyEvent>;

package/src/verticalnavigation.js

@@ -11,7 +11,7 @@ import { keyCodes, Rect } from '@ckeditor/ckeditor5-utils';
  *
  * @param editing The editing controller.
  */
-export function verticalNavigationHandler(editing) {
+export function verticalWidgetNavigationHandler(editing) {
     const model = editing.model;
     return (evt, data) => {
         const arrowUpPressed = data.keyCode == keyCodes.arrowup;

package/src/widget.js

@@ -10,7 +10,7 @@ import { MouseObserver, TreeWalker } from '@ckeditor/ckeditor5-engine';
 import { Delete } from '@ckeditor/ckeditor5-typing';
 import { env, keyCodes, getLocalizedArrowKeyCodeDirection, getRangeFromMouseEvent } from '@ckeditor/ckeditor5-utils';
 import { WidgetTypeAround } from './widgettypearound/widgettypearound.js';
-import { verticalNavigationHandler } from './verticalnavigation.js';
+import { verticalWidgetNavigationHandler } from './verticalnavigation.js';
 import { getLabel, isWidget, WIDGET_SELECTED_CLASS_NAME } from './utils.js';
 import '../theme/widget.css';
 /**
@@ -141,7 +141,7 @@ export class Widget extends Plugin {
         this.listenTo(viewDocument, 'arrowKey', (...args) => {
             this._preventDefaultOnArrowKeyPress(...args);
         }, { context: '$root' });
-        this.listenTo(viewDocument, 'arrowKey', verticalNavigationHandler(this.editor.editing), { context: '$text' });
+        this.listenTo(viewDocument, 'arrowKey', verticalWidgetNavigationHandler(this.editor.editing), { context: '$text' });
         // Handle custom delete behaviour.
         this.listenTo(viewDocument, 'delete', (evt, data) => {
             if (this._handleDelete(data.direction == 'forward')) {

package/src/widgetresize/resizer.d.ts

@@ -4,15 +4,15 @@
  */
 import { Rect, type DecoratedMethodEvent } from '@ckeditor/ckeditor5-utils';
 import { ResizeState } from './resizerstate.js';
-import type { ResizerOptions } from '../widgetresize.js';
-declare const Resizer_base: {
+import type { WidgetResizerOptions } from '../widgetresize.js';
+declare const WidgetResizer_base: {
     new (): import("@ckeditor/ckeditor5-utils").Observable;
     prototype: import("@ckeditor/ckeditor5-utils").Observable;
 };
 /**
  * Represents a resizer for a single resizable object.
  */
-export declare class Resizer extends /* #__PURE__ */ Resizer_base {
+export declare class WidgetResizer extends /* #__PURE__ */ WidgetResizer_base {
     /**
      * Flag that indicates whether resizer can be used.
      *
@@ -51,13 +51,13 @@ export declare class Resizer extends /* #__PURE__ */ Resizer_base {
      */
     private _viewResizerWrapper;
     /**
-     * The width of the resized {@link module:widget/widgetresize~ResizerOptions#viewElement viewElement} before the resizing started.
+     * The width of the resized {@link module:widget/widgetresize~WidgetResizerOptions#viewElement viewElement} before the resizing started.
      */
     private _initialViewWidth;
     /**
      * @param options Resizer options.
      */
-    constructor(options: ResizerOptions);
+    constructor(options: WidgetResizerOptions);
     /**
      * Stores the state of the resizable host geometry, such as the original width, the currently proposed height, etc.
      *
@@ -159,19 +159,19 @@ export declare class Resizer extends /* #__PURE__ */ Resizer_base {
     private _appendSizeUI;
 }
 /**
- * @eventName ~Resizer#begin
+ * @eventName ~WidgetResizer#begin
  */
-export type ResizerBeginEvent = DecoratedMethodEvent<Resizer, 'begin'>;
+export type WidgetResizerBeginEvent = DecoratedMethodEvent<WidgetResizer, 'begin'>;
 /**
- * @eventName ~Resizer#cancel
+ * @eventName ~WidgetResizer#cancel
  */
-export type ResizerCancelEvent = DecoratedMethodEvent<Resizer, 'cancel'>;
+export type WidgetResizerCancelEvent = DecoratedMethodEvent<WidgetResizer, 'cancel'>;
 /**
- * @eventName ~Resizer#commit
+ * @eventName ~WidgetResizer#commit
  */
-export type ResizerCommitEvent = DecoratedMethodEvent<Resizer, 'commit'>;
+export type WidgetResizerCommitEvent = DecoratedMethodEvent<WidgetResizer, 'commit'>;
 /**
- * @eventName ~Resizer#updateSize
+ * @eventName ~WidgetResizer#updateSize
  */
-export type ResizerUpdateSizeEvent = DecoratedMethodEvent<Resizer, 'updateSize'>;
+export type WidgetResizerUpdateSizeEvent = DecoratedMethodEvent<WidgetResizer, 'updateSize'>;
 export {};

package/src/widgetresize/resizer.js

@@ -12,7 +12,7 @@ import { SizeView } from './sizeview.js';
 /**
  * Represents a resizer for a single resizable object.
  */
-export class Resizer extends /* #__PURE__ */ ObservableMixin() {
+export class WidgetResizer extends /* #__PURE__ */ ObservableMixin() {
     /**
      * Stores the state of the resizable host geometry, such as the original width, the currently proposed height, etc.
      *
@@ -32,7 +32,7 @@ export class Resizer extends /* #__PURE__ */ ObservableMixin() {
      */
     _viewResizerWrapper = null;
     /**
-     * The width of the resized {@link module:widget/widgetresize~ResizerOptions#viewElement viewElement} before the resizing started.
+     * The width of the resized {@link module:widget/widgetresize~WidgetResizerOptions#viewElement viewElement} before the resizing started.
      */
     _initialViewWidth;
     /**

package/src/widgetresize/resizerstate.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 { ResizerOptions } from '../widgetresize.js';
+import type { WidgetResizerOptions } from '../widgetresize.js';
 declare const ResizeState_base: {
     new (): import("@ckeditor/ckeditor5-utils").Observable;
     prototype: import("@ckeditor/ckeditor5-utils").Observable;
@@ -92,7 +92,7 @@ export declare class ResizeState extends /* #__PURE__ */ ResizeState_base {
     /**
      * @param options Resizer options.
      */
-    constructor(options: ResizerOptions);
+    constructor(options: WidgetResizerOptions);
     /**
      * The original width (pixels) of the resized object when the resize process was started.
      */

package/src/widgetresize/sizeview.d.ts

@@ -6,7 +6,7 @@
  * @module widget/widgetresize/sizeview
  */
 import { View } from '@ckeditor/ckeditor5-ui';
-import type { ResizerOptions } from '../widgetresize.js';
+import type { WidgetResizerOptions } from '../widgetresize.js';
 import { type ResizeState } from './resizerstate.js';
 /**
  * A view displaying the proposed new element size during the resizing.
@@ -47,7 +47,7 @@ export declare class SizeView extends View {
      * @param options An object defining the resizer options, used for setting the proper size label.
      * @param resizeState The `ResizeState` class instance, used for keeping the `SizeView` state up to date.
      */
-    _bindToState(options: ResizerOptions, resizeState: ResizeState): void;
+    _bindToState(options: WidgetResizerOptions, resizeState: ResizeState): void;
     /**
      * A method used for cleaning up. It removes the bindings and hides the view.
      *

package/src/widgetresize.d.ts

@@ -5,7 +5,7 @@
 /**
  * @module widget/widgetresize
  */
-import { Resizer } from './widgetresize/resizer.js';
+import { WidgetResizer } from './widgetresize/resizer.js';
 import { Plugin, type Editor } from '@ckeditor/ckeditor5-core';
 import { type Element, type ViewContainerElement } from '@ckeditor/ckeditor5-engine';
 import '../theme/widgetresize.css';
@@ -20,7 +20,7 @@ export declare class WidgetResize extends Plugin {
      *
      * @observable
      */
-    selectedResizer: Resizer | null;
+    selectedResizer: WidgetResizer | null;
     /**
      * References an active resizer.
      *
@@ -29,7 +29,7 @@ export declare class WidgetResize extends Plugin {
      * @internal
      * @observable
      */
-    _activeResizer: Resizer | null;
+    _activeResizer: WidgetResizer | null;
     /**
      * A map of resizers created using this plugin instance.
      */
@@ -59,7 +59,7 @@ export declare class WidgetResize extends Plugin {
     /**
      * Marks resizer as selected.
      */
-    select(resizer: Resizer): void;
+    select(resizer: WidgetResizer): void;
     /**
      * Deselects currently set resizer.
      */
@@ -67,13 +67,13 @@ export declare class WidgetResize extends Plugin {
     /**
      * @param options Resizer options.
      */
-    attachTo(options: ResizerOptions): Resizer;
+    attachTo(options: WidgetResizerOptions): WidgetResizer;
     /**
      * Returns a resizer created for a given view element (widget element).
      *
      * @param viewElement View element associated with the resizer.
      */
-    getResizerByViewElement(viewElement: ViewContainerElement): Resizer | undefined;
+    getResizerByViewElement(viewElement: ViewContainerElement): WidgetResizer | undefined;
     /**
      * Returns a resizer that contains a given resize handle.
      */
@@ -91,7 +91,7 @@ export declare class WidgetResize extends Plugin {
 /**
  * Interface describing a resizer. It allows to specify the resizing host, custom logic for calculating aspect ratio, etc.
  */
-export interface ResizerOptions {
+export interface WidgetResizerOptions {
     /**
      * Editor instance associated with the resizer.
      */
@@ -125,5 +125,5 @@ export interface ResizerOptions {
     onCommit: (newValue: string) => void;
     getResizeHost: (widgetWrapper: HTMLElement) => HTMLElement;
     getHandleHost: (widgetWrapper: HTMLElement) => HTMLElement;
-    isCentered?: (resizer: Resizer) => boolean;
+    isCentered?: (resizer: WidgetResizer) => boolean;
 }

package/src/widgetresize.js

@@ -5,7 +5,7 @@
 /**
  * @module widget/widgetresize
  */
-import { Resizer } from './widgetresize/resizer.js';
+import { WidgetResizer } from './widgetresize/resizer.js';
 import { Plugin } from '@ckeditor/ckeditor5-core';
 import { MouseObserver } from '@ckeditor/ckeditor5-engine';
 import { DomEmitterMixin, global } from '@ckeditor/ckeditor5-utils';
@@ -116,7 +116,7 @@ export class WidgetResize extends Plugin {
      * @param options Resizer options.
      */
     attachTo(options) {
-        const resizer = new Resizer(options);
+        const resizer = new WidgetResizer(options);
         const plugins = this.editor.plugins;
         resizer.attach();
         if (plugins.has('WidgetToolbarRepository')) {
@@ -165,7 +165,7 @@ export class WidgetResize extends Plugin {
      */
     _mouseDownListener(event, domEventData) {
         const resizeHandle = domEventData.domTarget;
-        if (!Resizer.isResizeHandle(resizeHandle)) {
+        if (!WidgetResizer.isResizeHandle(resizeHandle)) {
             return;
         }
         this._activeResizer = this._getResizerByHandle(resizeHandle) || null;