@ckeditor/ckeditor5-image 44.1.0 → 44.2.0-alpha.0

package/dist/imageinline.d.ts

@@ -1,42 +0,0 @@
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-/**
- * @module image/imageinline
- */
-import { Plugin } from 'ckeditor5/src/core.js';
-import { Widget } from 'ckeditor5/src/widget.js';
-import ImageTextAlternative from './imagetextalternative.js';
-import ImageInlineEditing from './image/imageinlineediting.js';
-import ImageInsertUI from './imageinsert/imageinsertui.js';
-import '../theme/image.css';
-/**
- * The image inline plugin.
- *
- * This is a "glue" plugin which loads the following plugins:
- *
- * * {@link module:image/image/imageinlineediting~ImageInlineEditing},
- * * {@link module:image/imagetextalternative~ImageTextAlternative}.
- *
- * Usually, it is used in conjunction with other plugins from this package. See the {@glink api/image package page}
- * for more information.
- */
-export default class ImageInline extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof ImageInlineEditing, typeof Widget, typeof ImageTextAlternative, typeof ImageInsertUI];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "ImageInline";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-}

package/dist/imageinsert/imageinsertui.d.ts

@@ -1,90 +0,0 @@
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-/**
- * @module image/imageinsert/imageinsertui
- */
-import { Plugin, type Editor } from 'ckeditor5/src/core.js';
-import { type Observable } from 'ckeditor5/src/utils.js';
-import { type ButtonView, type DropdownView, type FocusableView, type MenuBarMenuListItemButtonView } from 'ckeditor5/src/ui.js';
-import ImageUtils from '../imageutils.js';
-/**
- * The image insert dropdown plugin.
- *
- * For a detailed overview, check the {@glink features/images/image-upload/image-upload Image upload feature}
- * and {@glink features/images/images-inserting Insert images via source URL} documentation.
- *
- * Adds the `'insertImage'` dropdown to the {@link module:ui/componentfactory~ComponentFactory UI component factory}
- * and also the `imageInsert` dropdown as an alias for backward compatibility.
- *
- * Adds the `'menuBar:insertImage'` sub-menu to the {@link module:ui/componentfactory~ComponentFactory UI component factory}, which is
- * by default added to the `'Insert'` menu.
- */
-export default class ImageInsertUI extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "ImageInsertUI";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof ImageUtils];
-    /**
-     * The dropdown view responsible for displaying the image insert UI.
-     */
-    dropdownView?: DropdownView;
-    /**
-     * Observable property used to alter labels while some image is selected and when it is not.
-     *
-     * @observable
-     */
-    isImageSelected: boolean;
-    /**
-     * Registered integrations map.
-     */
-    private _integrations;
-    /**
-     * @inheritDoc
-     */
-    constructor(editor: Editor);
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * Registers the insert image dropdown integration.
-     */
-    registerIntegration({ name, observable, buttonViewCreator, formViewCreator, menuBarButtonViewCreator, requiresForm }: {
-        name: string;
-        observable: (Observable & {
-            isEnabled: boolean;
-        }) | (() => Observable & {
-            isEnabled: boolean;
-        });
-        buttonViewCreator: (isOnlyOne: boolean) => ButtonView;
-        formViewCreator: (isOnlyOne: boolean) => FocusableView;
-        menuBarButtonViewCreator: (isOnlyOne: boolean) => MenuBarMenuListItemButtonView;
-        requiresForm?: boolean;
-    }): void;
-    /**
-     * Creates the toolbar component.
-     */
-    private _createToolbarComponent;
-    /**
-     * Creates the menu bar component.
-     */
-    private _createMenuBarComponent;
-    /**
-     * Validates the integrations list.
-     */
-    private _prepareIntegrations;
-}

package/dist/imageinsert/imageinsertviaurlui.d.ts

@@ -1,74 +0,0 @@
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-/**
- * @module image/imageinsert/imageinsertviaurlui
- */
-import { Plugin } from 'ckeditor5/src/core.js';
-import { Dialog } from 'ckeditor5/src/ui.js';
-import ImageInsertUI from './imageinsertui.js';
-/**
- * The image insert via URL plugin (UI part).
- *
- * The plugin introduces two UI components to the {@link module:ui/componentfactory~ComponentFactory UI component factory}:
- *
- * * the `'insertImageViaUrl'` toolbar button,
- * * the `'menuBar:insertImageViaUrl'` menu bar component.
- *
- * It also integrates with the `insertImage` toolbar component and `menuBar:insertImage` menu component, which are default components
- * through which inserting image via URL is available.
- */
-export default class ImageInsertViaUrlUI extends Plugin {
-    private _imageInsertUI;
-    private _formView?;
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "ImageInsertViaUrlUI";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof ImageInsertUI, typeof Dialog];
-    init(): void;
-    /**
-     * @inheritDoc
-     */
-    afterInit(): void;
-    /**
-     * Creates the base for various kinds of the button component provided by this feature.
-     */
-    private _createInsertUrlButton;
-    /**
-     * Creates a simple toolbar button, with an icon and a tooltip.
-     */
-    private _createToolbarButton;
-    /**
-     * Creates a button for the dropdown view, with an icon, text and no tooltip.
-     */
-    private _createDropdownButton;
-    /**
-     * Creates a button for the menu bar.
-     */
-    private _createMenuBarButton;
-    /**
-     * Creates the form view used to submit the image URL.
-     */
-    private _createInsertUrlView;
-    /**
-     * Shows the insert image via URL form view in a modal.
-     */
-    private _showModal;
-    /**
-     * Executes appropriate command depending on selection and form value.
-     */
-    private _handleSave;
-}

package/dist/imageinsert/ui/imageinsertformview.d.ts

@@ -1,60 +0,0 @@
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-/**
- * @module image/imageinsert/ui/imageinsertformview
- */
-import { View, ViewCollection, FocusCycler, type FocusableView } from 'ckeditor5/src/ui.js';
-import { FocusTracker, KeystrokeHandler, type Locale } from 'ckeditor5/src/utils.js';
-import '../../../theme/imageinsert.css';
-/**
- * The view displayed in the insert image dropdown.
- *
- * See {@link module:image/imageinsert/imageinsertui~ImageInsertUI}.
- */
-export default class ImageInsertFormView extends View {
-    /**
-     * Tracks information about DOM focus in the form.
-     */
-    readonly focusTracker: FocusTracker;
-    /**
-     * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
-     */
-    readonly keystrokes: KeystrokeHandler;
-    /**
-     * A collection of views that can be focused in the form.
-     */
-    protected readonly _focusables: ViewCollection<FocusableView>;
-    /**
-     * Helps cycling over {@link #_focusables} in the form.
-     */
-    protected readonly _focusCycler: FocusCycler;
-    /**
-     * A collection of the defined integrations for inserting the images.
-     */
-    private readonly children;
-    /**
-     * Creates a view for the dropdown panel of {@link module:image/imageinsert/imageinsertui~ImageInsertUI}.
-     *
-     * @param locale The localization services instance.
-     * @param integrations An integrations object that contains components (or tokens for components) to be shown in the panel view.
-     */
-    constructor(locale: Locale, integrations?: Array<FocusableView>);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Focuses the first {@link #_focusables focusable} in the form.
-     */
-    focus(): void;
-}

package/dist/imageinsert/ui/imageinserturlview.d.ts

@@ -1,68 +0,0 @@
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-/**
- * @module image/imageinsert/ui/imageinserturlview
- */
-import { View, LabeledFieldView, type InputTextView } from 'ckeditor5/src/ui.js';
-import { KeystrokeHandler, type Locale } from 'ckeditor5/src/utils.js';
-/**
- * The insert an image via URL view.
- *
- * See {@link module:image/imageinsert/imageinsertviaurlui~ImageInsertViaUrlUI}.
- */
-export default class ImageInsertUrlView extends View {
-    /**
-     * The URL input field view.
-     */
-    urlInputView: LabeledFieldView<InputTextView>;
-    /**
-     * The value of the URL input.
-     *
-     * @observable
-     */
-    imageURLInputValue: string;
-    /**
-     * Observable property used to alter labels while some image is selected and when it is not.
-     *
-     * @observable
-     */
-    isImageSelected: boolean;
-    /**
-     * Observable property indicating whether the form interactive elements should be enabled.
-     *
-     * @observable
-     */
-    isEnabled: boolean;
-    /**
-     * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
-     */
-    readonly keystrokes: KeystrokeHandler;
-    /**
-     * Creates a view for the dropdown panel of {@link module:image/imageinsert/imageinsertui~ImageInsertUI}.
-     *
-     * @param locale The localization services instance.
-     */
-    constructor(locale: Locale);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Creates the {@link #urlInputView}.
-     */
-    private _createUrlInputView;
-    /**
-     * Focuses the view.
-     */
-    focus(): void;
-}

package/dist/imageinsert.d.ts

@@ -1,41 +0,0 @@
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-/**
- * @module image/imageinsert
- */
-import { Plugin } from 'ckeditor5/src/core.js';
-import ImageUpload from './imageupload.js';
-import ImageInsertViaUrl from './imageinsertviaurl.js';
-import ImageInsertUI from './imageinsert/imageinsertui.js';
-/**
- * The image insert plugin.
- *
- * For a detailed overview, check the {@glink features/images/image-upload/image-upload Image upload feature}
- * and {@glink features/images/images-inserting Insert images via source URL} documentation.
- *
- * This plugin does not do anything directly, but it loads a set of specific plugins
- * to enable image uploading or inserting via implemented integrations:
- *
- * * {@link module:image/imageupload~ImageUpload}
- * * {@link module:image/imageinsert/imageinsertui~ImageInsertUI}
- */
-export default class ImageInsert extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "ImageInsert";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof ImageUpload, typeof ImageInsertViaUrl, typeof ImageInsertUI];
-}

package/dist/imageinsertviaurl.d.ts

@@ -1,39 +0,0 @@
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-/**
- * @module image/imageinsertviaurl
- */
-import { Plugin } from 'ckeditor5/src/core.js';
-import ImageInsertUI from './imageinsert/imageinsertui.js';
-import ImageInsertViaUrlUI from './imageinsert/imageinsertviaurlui.js';
-/**
- * The image insert via URL plugin.
- *
- * For a detailed overview, check the {@glink features/images/images-inserting
- * Insert images via source URL} documentation.
- *
- * This plugin does not do anything directly, but it loads a set of specific plugins
- * to enable image inserting via implemented integrations:
- *
- * * {@link module:image/imageinsert/imageinsertui~ImageInsertUI},
- */
-export default class ImageInsertViaUrl extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "ImageInsertViaUrl";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof ImageInsertViaUrlUI, typeof ImageInsertUI];
-}

package/dist/imageresize/imagecustomresizeui.d.ts

@@ -1,69 +0,0 @@
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-/**
- * @module image/imageresize/imagecustomresizeui
- */
-import { Plugin } from 'ckeditor5/src/core.js';
-import { ContextualBalloon } from 'ckeditor5/src/ui.js';
-/**
- * The custom resize image UI plugin.
- *
- * The plugin uses the {@link module:ui/panel/balloon/contextualballoon~ContextualBalloon}.
- */
-export default class ImageCustomResizeUI extends Plugin {
-    /**
-     * The contextual balloon plugin instance.
-     */
-    private _balloon?;
-    /**
-     * A form containing a textarea and buttons, used to change the `alt` text value.
-     */
-    private _form?;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof ContextualBalloon];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "ImageCustomResizeUI";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Creates the {@link module:image/imageresize/ui/imagecustomresizeformview~ImageCustomResizeFormView}
-     * 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/imageresize/imageresizebuttons.d.ts

@@ -1,72 +0,0 @@
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @license Copyright (c) 2003-2024, 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 } from 'ckeditor5/src/core.js';
-import ImageResizeEditing from './imageresizeediting.js';
-/**
- * The image resize buttons plugin.
- *
- * It adds a possibility to resize images using the toolbar dropdown or individual buttons, depending on the plugin configuration.
- */
-export default class ImageResizeButtons extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof ImageResizeEditing];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "ImageResizeButtons";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * The resize unit.
-     * @default '%'
-     */
-    private readonly _resizeUnit;
-    /**
-     * @inheritDoc
-     */
-    constructor(editor: Editor);
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * A helper function that creates a standalone button component for the plugin.
-     *
-     * @param resizeOption A model of the resize option.
-     */
-    private _registerImageResizeButton;
-    /**
-     * A helper function that creates a dropdown component for the plugin containing all the resize options defined in
-     * the editor configuration.
-     *
-     * @param options An array of configured options.
-     */
-    private _registerImageResizeDropdown;
-    /**
-     * A helper function for creating an option label value string.
-     *
-     * @param option A resize option object.
-     * @param forTooltip An optional flag for creating a tooltip label.
-     * @returns A user-defined label combined from the numeric value and the resize unit or the default label
-     * for reset options (`Original`).
-     */
-    private _getOptionLabelValue;
-    /**
-     * A helper function that parses the resize options and returns list item definitions ready for use in the dropdown.
-     *
-     * @param options The resize options.
-     * @param command The resize image command.
-     * @returns Dropdown item definitions.
-     */
-    private _getResizeDropdownListItemDefinitions;
-}

package/dist/imageresize/imageresizeediting.d.ts

@@ -1,49 +0,0 @@
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-import { type Editor, Plugin } from 'ckeditor5/src/core.js';
-import ImageUtils from '../imageutils.js';
-/**
- * The image resize editing feature.
- *
- * It adds the ability to resize each image using handles or manually by
- * {@link module:image/imageresize/imageresizebuttons~ImageResizeButtons} buttons.
- */
-export default class ImageResizeEditing extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof ImageUtils];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "ImageResizeEditing";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    constructor(editor: Editor);
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * @inheritDoc
-     */
-    afterInit(): void;
-    private _registerSchema;
-    /**
-     * Registers image resize converters.
-     *
-     * @param imageType The type of the image.
-     */
-    private _registerConverters;
-}

package/dist/imageresize/imageresizehandles.d.ts

@@ -1,39 +0,0 @@
-/**
- * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @license Copyright (c) 2003-2024, 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 'ckeditor5/src/core.js';
-import { WidgetResize } from 'ckeditor5/src/widget.js';
-import ImageUtils from '../imageutils.js';
-/**
- * The image resize by handles feature.
- *
- * It adds the ability to resize each image using handles or manually by
- * {@link module:image/imageresize/imageresizebuttons~ImageResizeButtons} buttons.
- */
-export default class ImageResizeHandles extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof WidgetResize, typeof ImageUtils];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "ImageResizeHandles";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * Attaches the listeners responsible for creating a resizer for each image, except for images inside the HTML embed preview.
-     */
-    private _setupResizerCreator;
-}