@ckeditor/ckeditor5-media-embed 48.2.0 → 48.3.0-alpha.0

package/dist/mediaembedediting.d.ts

@@ -1,35 +1,35 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module media-embed/mediaembedediting
- */
-import { Plugin, type Editor } from '@ckeditor/ckeditor5-core';
-import { MediaRegistry } from './mediaregistry.js';
-import '../theme/mediaembedediting.css';
+* @module media-embed/mediaembedediting
+*/
+import { Plugin, type Editor } from "@ckeditor/ckeditor5-core";
+import { MediaRegistry } from "./mediaregistry.js";
+import "../theme/mediaembedediting.css";
 /**
- * The media embed editing feature.
- */
+* The media embed editing feature.
+*/
 export declare class MediaEmbedEditing extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "MediaEmbedEditing";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * The media registry managing the media providers in the editor.
-     */
-    registry: MediaRegistry;
-    /**
-     * @inheritDoc
-     */
-    constructor(editor: Editor);
-    /**
-     * @inheritDoc
-     */
-    init(): void;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "MediaEmbedEditing";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* The media registry managing the media providers in the editor.
+	*/
+	registry: MediaRegistry;
+	/**
+	* @inheritDoc
+	*/
+	constructor(editor: Editor);
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
 }

package/dist/mediaembedresize/constants.d.ts

@@ -1,17 +1,17 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module media-embed/mediaembedresize/constants
- */
+* @module media-embed/mediaembedresize/constants
+*/
 /**
- * The view class applied to a resized media embed figure.
- *
- * Shared between the editing plugin (which toggles it via downcast of `resizedWidth` and consumes
- * it on upcast) and the handles plugin (which adds it during drag and strips it on commit), so
- * both layers agree on the exact class name.
- *
- * @internal
- */
+* The view class applied to a resized media embed figure.
+*
+* Shared between the editing plugin (which toggles it via downcast of `resizedWidth` and consumes
+* it on upcast) and the handles plugin (which adds it during drag and strips it on commit), so
+* both layers agree on the exact class name.
+*
+* @internal
+*/
 export declare const RESIZED_MEDIA_CLASS = "media_resized";

package/dist/mediaembedresize/mediaembedcustomresizeui.d.ts

@@ -0,0 +1,64 @@
+/**
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+/**
+* @module media-embed/mediaembedresize/mediaembedcustomresizeui
+*/
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { ContextualBalloon } from "@ckeditor/ckeditor5-ui";
+/**
+* The custom resize media embed UI plugin.
+*
+* The plugin uses the {@link module:ui/panel/balloon/contextualballoon~ContextualBalloon}.
+*/
+export declare class MediaEmbedCustomResizeUI extends Plugin {
+	/**
+	* The contextual balloon plugin instance.
+	*/
+	private _balloon?;
+	/**
+	* A form used to set the custom resize width.
+	*/
+	private _form?;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[ContextualBalloon]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "MediaEmbedCustomResizeUI";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* Creates the {@link module:media-embed/mediaembedresize/ui/mediaembedcustomresizeformview~MediaEmbedCustomResizeFormView} form.
+	*/
+	private _createForm;
+	/**
+	* Shows the {@link #_form} in the {@link #_balloon}.
+	*
+	* @internal
+	*/
+	_showForm(unit: string): void;
+	/**
+	* Removes the {@link #_form} from the {@link #_balloon}.
+	*
+	* @param focusEditable Controls whether the editing view is focused afterwards.
+	*/
+	private _hideForm;
+	/**
+	* Returns `true` when the {@link #_form} is the visible view in the {@link #_balloon}.
+	*/
+	private get _isVisible();
+	/**
+	* Returns `true` when the {@link #_form} is in the {@link #_balloon}.
+	*/
+	private get _isInBalloon();
+}

package/dist/mediaembedresize/mediaembedresizebuttons.d.ts

@@ -0,0 +1,54 @@
+/**
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+/**
+* @module media-embed/mediaembedresize/mediaembedresizebuttons
+*/
+import { Plugin, type Editor, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { MediaEmbedResizeEditing } from "./mediaembedresizeediting.js";
+/**
+* The media embed resize buttons plugin.
+*
+* It adds a possibility to resize media embeds using the toolbar dropdown or individual buttons,
+* depending on the plugin configuration.
+*/
+export declare class MediaEmbedResizeButtons extends Plugin {
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[MediaEmbedResizeEditing]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "MediaEmbedResizeButtons";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	private readonly _resizeUnit;
+	/**
+	* @inheritDoc
+	*/
+	constructor(editor: Editor);
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	/**
+	* Creates a standalone button component for the given resize option.
+	*/
+	private _registerMediaEmbedResizeButton;
+	/**
+	* Creates the dropdown component containing all resize options.
+	*/
+	private _registerMediaEmbedResizeDropdown;
+	/**
+	* Returns a label for the given resize option.
+	*/
+	private _getOptionLabelValue;
+	/**
+	* Returns list item definitions for the resize dropdown.
+	*/
+	private _getResizeDropdownListItemDefinitions;
+}

package/dist/mediaembedresize/mediaembedresizeediting.d.ts

@@ -1,47 +1,51 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import { MediaEmbedEditing } from '../mediaembedediting.js';
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+import { Plugin, type Editor, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { MediaEmbedEditing } from "../mediaembedediting.js";
 /**
- * The media embed resize editing feature.
- *
- * It adds the ability to resize each media embed using handles.
- */
+* The media embed resize editing feature.
+*
+* It adds the ability to resize each media embed using handles.
+*/
 export declare class MediaEmbedResizeEditing extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof MediaEmbedEditing];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "MediaEmbedResizeEditing";
-    /**
-     * @inheritDoc
-     * @internal
-     */
-    static get licenseFeatureCode(): string;
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get isPremiumPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * @inheritDoc
-     */
-    afterInit(): void;
-    private _registerSchema;
-    /**
-     * Registers media embed resize converters.
-     */
-    private _registerConverters;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[MediaEmbedEditing]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "MediaEmbedResizeEditing";
+	/**
+	* @inheritDoc
+	* @internal
+	*/
+	static get licenseFeatureCode(): string;
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	constructor(editor: Editor);
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	/**
+	* @inheritDoc
+	*/
+	afterInit(): void;
+	private _registerSchema;
+	/**
+	* Registers media embed resize converters.
+	*/
+	private _registerConverters;
 }

package/dist/mediaembedresize/mediaembedresizehandles.d.ts

@@ -1,42 +1,42 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import { WidgetResize } from '@ckeditor/ckeditor5-widget';
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { WidgetResize } from "@ckeditor/ckeditor5-widget";
 /**
- * The media embed resize by handles feature.
- *
- * It adds the ability to resize each media embed using handles.
- */
+* The media embed resize by handles feature.
+*
+* It adds the ability to resize each media embed using handles.
+*/
 export declare class MediaEmbedResizeHandles extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof WidgetResize];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "MediaEmbedResizeHandles";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * Attaches a resizer to every newly inserted media widget. Walks only the ranges
-     * reported by the differ — never the whole document — so unrelated inserts (e.g.
-     * pressing Enter to create a paragraph) cost only the differ check.
-     *
-     * Each resizer's `isEnabled` is bound to the plugin in {@link #_attachResizer},
-     * so it auto-tracks the resize command's state.
-     */
-    private _setupResizerCreator;
-    /**
-     * Attaches a resizer to a single media widget.
-     */
-    private _attachResizer;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[WidgetResize]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "MediaEmbedResizeHandles";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	/**
+	* Attaches a resizer to every newly inserted media widget. Walks only the ranges
+	* reported by the differ — never the whole document — so unrelated inserts (e.g.
+	* pressing Enter to create a paragraph) cost only the differ check.
+	*
+	* Each resizer's `isEnabled` is bound to the plugin in {@link #_attachResizer},
+	* so it auto-tracks the resize command's state.
+	*/
+	private _setupResizerCreator;
+	/**
+	* Attaches a resizer to a single media widget.
+	*/
+	private _attachResizer;
 }

package/dist/mediaembedresize/resizemediaembedcommand.d.ts

@@ -1,40 +1,40 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module media-embed/mediaembedresize/resizemediaembedcommand
- */
-import { Command } from '@ckeditor/ckeditor5-core';
+* @module media-embed/mediaembedresize/resizemediaembedcommand
+*/
+import { Command } from "@ckeditor/ckeditor5-core";
 /**
- * The resize media embed command.
- */
+* The resize media embed command.
+*/
 export declare class ResizeMediaEmbedCommand extends Command {
-    /**
-     * The current width of the selected media embed, or `null` if not resized.
-     */
-    value: string | null;
-    /**
-     * @inheritDoc
-     */
-    refresh(): void;
-    /**
-     * Executes the command.
-     *
-     * ```ts
-     * // Sets the width as a percentage of the parent width:
-     * editor.execute( 'resizeMediaEmbed', { width: '50%' } );
-     *
-     * // Removes the resize and restores the default width:
-     * editor.execute( 'resizeMediaEmbed', { width: null } );
-     * ```
-     *
-     * @param options
-     * @param options.width The new width of the media embed as a CSS `width` value
-     * (e.g. `'50%'`), or `null` to remove the resize.
-     * @fires execute
-     */
-    execute(options: {
-        width: string | null;
-    }): void;
+	/**
+	* The current width of the selected media embed, or `null` if not resized.
+	*/
+	value: string | null;
+	/**
+	* @inheritDoc
+	*/
+	override refresh(): void;
+	/**
+	* Executes the command.
+	*
+	* ```ts
+	* // Sets the width as a percentage of the parent width:
+	* editor.execute( 'resizeMediaEmbed', { width: '50%' } );
+	*
+	* // Removes the resize and restores the default width:
+	* editor.execute( 'resizeMediaEmbed', { width: null } );
+	* ```
+	*
+	* @param options
+	* @param options.width The new width of the media embed as a CSS `width` value
+	* (e.g. `'50%'`), or `null` to remove the resize.
+	* @fires execute
+	*/
+	override execute(options: {
+		width: string | null;
+	}): void;
 }

package/dist/mediaembedresize/ui/mediaembedcustomresizeformview.d.ts

@@ -0,0 +1,118 @@
+/**
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+/**
+* @module media-embed/mediaembedresize/ui/mediaembedcustomresizeformview
+*/
+import { ButtonView, FocusCycler, LabeledFieldView, View, ViewCollection, type FocusableView, type InputNumberView } from "@ckeditor/ckeditor5-ui";
+import { FocusTracker, KeystrokeHandler, type Locale } from "@ckeditor/ckeditor5-utils";
+import "../../../theme/mediaembedcustomresizeform.css";
+/**
+* The MediaEmbedCustomResizeFormView class.
+*
+* @internal
+*/
+export declare class MediaEmbedCustomResizeFormView extends View {
+	/**
+	* Tracks information about the DOM focus in the form.
+	*/
+	readonly focusTracker: FocusTracker;
+	/**
+	* An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
+	*/
+	readonly keystrokes: KeystrokeHandler;
+	/**
+	* Resize unit shortcut.
+	*/
+	readonly unit: string;
+	/**
+	* The Back button view displayed in the header.
+	*/
+	backButtonView: ButtonView;
+	/**
+	* A button used to submit the form.
+	*/
+	saveButtonView: ButtonView;
+	/**
+	* An input with a label.
+	*/
+	labeledInput: LabeledFieldView<InputNumberView>;
+	/**
+	* A collection of child views.
+	*/
+	readonly children: ViewCollection;
+	/**
+	* A collection of views which can be focused in the form.
+	*/
+	protected readonly _focusables: ViewCollection<FocusableView>;
+	/**
+	* Helps cycling over {@link #_focusables} in the form.
+	*/
+	protected readonly _focusCycler: FocusCycler;
+	/**
+	* An array of form validators used by {@link #isValid}.
+	*/
+	private readonly _validators;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, unit: string, validators: Array<MediaEmbedCustomResizeFormValidatorCallback>);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	private _createBackButton;
+	private _createSaveButton;
+	private _createHeaderView;
+	private _createLabeledInputView;
+	/**
+	* Validates the form and returns `false` when some fields are invalid.
+	*/
+	isValid(): boolean;
+	/**
+	* Cleans up error and information text of {@link #labeledInput}.
+	*/
+	resetFormStatus(): void;
+	/**
+	* The native DOM `value` of the input element of {@link #labeledInput}.
+	*/
+	get rawSize(): string | null;
+	/**
+	* Get numeric value of size. Returns `null` if value is not a number.
+	*/
+	get parsedSize(): number | null;
+	/**
+	* Returns serialized media embed input size with unit.
+	* Returns `null` if value is not a number.
+	*/
+	get sizeWithUnits(): string | null;
+}
+/**
+* Callback used by {@link ~MediaEmbedCustomResizeFormView} to check if passed form value is valid.
+*
+* @internal
+*/
+export type MediaEmbedCustomResizeFormValidatorCallback = (form: MediaEmbedCustomResizeFormView) => string | undefined;
+/**
+* Fired when the form view is submitted.
+*
+* @eventName ~MediaEmbedCustomResizeFormView#submit
+*/
+export type MediaEmbedCustomResizeFormViewSubmitEvent = {
+	name: "submit";
+	args: [];
+};
+/**
+* Fired when the form view is canceled.
+*
+* @eventName ~MediaEmbedCustomResizeFormView#cancel
+*/
+export type MediaEmbedCustomResizeFormViewCancelEvent = {
+	name: "cancel";
+	args: [];
+};

package/dist/mediaembedresize/utils/getselectedmediaembededitornodes.d.ts

@@ -0,0 +1,23 @@
+/**
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+/**
+* @module media-embed/mediaembedresize/utils/getselectedmediaembededitornodes
+*/
+import type { ViewElement, ModelElement } from "@ckeditor/ckeditor5-engine";
+import type { Editor } from "@ckeditor/ckeditor5-core";
+/**
+* Finds model, view and DOM element for selected media embed element.
+* Returns `null` if there is no media embed selected.
+*
+* @param editor Editor instance.
+* @internal
+*/
+export declare function getSelectedMediaEmbedEditorNodes(editor: Editor): MediaEmbedEditorNodes | null;
+type MediaEmbedEditorNodes = {
+	model: ModelElement;
+	view: ViewElement;
+	dom: HTMLElement;
+};
+export {};

package/dist/mediaembedresize/utils/getselectedmediaembedpossibleresizerange.d.ts

@@ -0,0 +1,25 @@
+/**
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+/**
+* @module media-embed/mediaembedresize/utils/getselectedmediaembedpossibleresizerange
+*/
+import type { Editor } from "@ckeditor/ckeditor5-core";
+/**
+* Returns the min and max resize values for the selected media embed in the specified unit.
+*
+* @param editor Editor instance.
+* @param targetUnit Unit in which dimension will be returned.
+* @returns Possible resize range in numeric form.
+* @internal
+*/
+export declare function getSelectedMediaEmbedPossibleResizeRange(editor: Editor, targetUnit: string): PossibleResizeMediaEmbedRange | null;
+/**
+* @internal
+*/
+export type PossibleResizeMediaEmbedRange = {
+	unit: string;
+	lower: number;
+	upper: number;
+};

package/dist/mediaembedresize/utils/getselectedmediaembedwidthinunits.d.ts

@@ -0,0 +1,21 @@
+/**
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+/**
+* @module media-embed/mediaembedresize/utils/getselectedmediaembedwidthinunits
+*/
+import { type _DimensionWithUnit } from "@ckeditor/ckeditor5-utils";
+import type { Editor } from "@ckeditor/ckeditor5-core";
+/**
+* Returns media embed width in specified units after resize.
+*
+* 	* If no media embed is selected or command is disabled, `null` will be returned.
+*	* If `targetUnit` percentage is passed then it will return width percentage relative to its ancestor.
+*
+* @param editor Editor instance.
+* @param targetUnit Unit in which dimension will be returned.
+* @returns Parsed media embed width after resize (with unit).
+* @internal
+*/
+export declare function getSelectedMediaEmbedWidthInUnits(editor: Editor, targetUnit: string): _DimensionWithUnit | null;