@ckeditor/ckeditor5-media-embed 41.3.1 → 41.4.0

package/dist/types/utils.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @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-oss-license
+ */
+/**
+ * @module media-embed/utils
+ */
+import type { ViewContainerElement, Element, Model, Selectable, Selection, DowncastWriter, ViewDocumentSelection, ViewElement, DocumentSelection } from 'ckeditor5/src/engine.js';
+import type MediaRegistry from './mediaregistry.js';
+/**
+ * Converts a given {@link module:engine/view/element~Element} to a media embed widget:
+ * * Adds a {@link module:engine/view/element~Element#_setCustomProperty custom property} allowing to recognize the media widget element.
+ * * Calls the {@link module:widget/utils~toWidget} function with the proper element's label creator.
+ *
+ * @param writer An instance of the view writer.
+ * @param label The element's label.
+ */
+export declare function toMediaWidget(viewElement: ViewElement, writer: DowncastWriter, label: string): ViewElement;
+/**
+ * Returns a media widget editing view element if one is selected.
+ */
+export declare function getSelectedMediaViewWidget(selection: ViewDocumentSelection): ViewElement | null;
+/**
+ * Checks if a given view element is a media widget.
+ */
+export declare function isMediaWidget(viewElement: ViewElement): boolean;
+/**
+ * Creates a view element representing the media. Either a "semantic" one for the data pipeline:
+ *
+ * ```html
+ * <figure class="media">
+ * 	<oembed url="foo"></oembed>
+ * </figure>
+ * ```
+ *
+ * or a "non-semantic" (for the editing view pipeline):
+ *
+ * ```html
+ * <figure class="media">
+ * 	<div data-oembed-url="foo">[ non-semantic media preview for "foo" ]</div>
+ * </figure>
+ * ```
+ */
+export declare function createMediaFigureElement(writer: DowncastWriter, registry: MediaRegistry, url: string, options: MediaOptions): ViewContainerElement;
+/**
+ * Returns a selected media element in the model, if any.
+ */
+export declare function getSelectedMediaModelWidget(selection: Selection | DocumentSelection): Element | null;
+/**
+ * Creates a media element and inserts it into the model.
+ *
+ * **Note**: This method will use {@link module:engine/model/model~Model#insertContent `model.insertContent()`} logic of inserting content
+ * if no `insertPosition` is passed.
+ *
+ * @param url An URL of an embeddable media.
+ * @param findOptimalPosition If true it will try to find optimal position to insert media without breaking content
+ * in which a selection is.
+ */
+export declare function insertMedia(model: Model, url: string, selectable: Selectable, findOptimalPosition: boolean): void;
+/**
+ * Type for commonly grouped function parameters across this package.
+ */
+export type MediaOptions = {
+    elementName: string;
+    renderMediaPreview?: boolean;
+    renderForEditingView?: boolean;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-media-embed",
-  "version": "41.3.1",
+  "version": "41.4.0",
   "description": "Media embed feature for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -13,8 +13,8 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-ui": "41.3.1",
-    "ckeditor5": "41.3.1"
+    "@ckeditor/ckeditor5-ui": "41.4.0",
+    "ckeditor5": "41.4.0"
   },
   "author": "CKSource (http://cksource.com/)",
   "license": "GPL-2.0-or-later",
@@ -26,6 +26,7 @@
     "directory": "packages/ckeditor5-media-embed"
   },
   "files": [
+    "dist",
     "lang",
     "src/**/*.js",
     "src/**/*.d.ts",

package/src/mediaembedui.js

@@ -72,6 +72,10 @@ export default class MediaEmbedUI extends Plugin {
             });
             form.delegate('submit', 'cancel').to(dropdown);
             form.urlInputView.fieldView.bind('value').to(command, 'value');
+            // Update balloon position when form error changes.
+            form.urlInputView.on('change:errorText', () => {
+                editor.ui.update();
+            });
             // Form elements should be read-only when corresponding commands are disabled.
             form.urlInputView.bind('isEnabled').to(command, 'isEnabled');
         });

package/src/ui/mediaformview.js

@@ -31,7 +31,6 @@ export default class MediaFormView extends View {
         this.urlInputView = this._createUrlInput();
         this.saveButtonView = this._createButton(t('Save'), icons.check, 'ck-button-save');
         this.saveButtonView.type = 'submit';
-        this.saveButtonView.bind('isEnabled').to(this, 'mediaURLInputValue', value => !!value);
         this.cancelButtonView = this._createButton(t('Cancel'), icons.cancel, 'ck-button-cancel', 'cancel');
         this._focusables = new ViewCollection();
         this._focusCycler = new FocusCycler({