@ckeditor/ckeditor5-media-embed 45.2.1-alpha.9 → 46.0.0-alpha.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-media-embed",
-  "version": "45.2.1-alpha.9",
+  "version": "46.0.0-alpha.0",
   "description": "Media embed feature for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -13,16 +13,16 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-clipboard": "45.2.1-alpha.9",
-    "@ckeditor/ckeditor5-core": "45.2.1-alpha.9",
-    "@ckeditor/ckeditor5-engine": "45.2.1-alpha.9",
-    "@ckeditor/ckeditor5-icons": "45.2.1-alpha.9",
-    "@ckeditor/ckeditor5-typing": "45.2.1-alpha.9",
-    "@ckeditor/ckeditor5-ui": "45.2.1-alpha.9",
-    "@ckeditor/ckeditor5-undo": "45.2.1-alpha.9",
-    "@ckeditor/ckeditor5-utils": "45.2.1-alpha.9",
-    "@ckeditor/ckeditor5-widget": "45.2.1-alpha.9",
-    "ckeditor5": "45.2.1-alpha.9"
+    "@ckeditor/ckeditor5-clipboard": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-core": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-engine": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-icons": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-typing": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-ui": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-undo": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-utils": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-widget": "46.0.0-alpha.0",
+    "ckeditor5": "46.0.0-alpha.0"
   },
   "author": "CKSource (http://cksource.com/)",
   "license": "SEE LICENSE IN LICENSE.md",

package/src/automediaembed.d.ts

@@ -13,7 +13,7 @@ import { Undo } from 'ckeditor5/src/undo.js';
  * The auto-media embed plugin. It recognizes media links in the pasted content and embeds
  * them shortly after they are injected into the document.
  */
-export default class AutoMediaEmbed extends Plugin {
+export declare class AutoMediaEmbed extends Plugin {
     /**
      * @inheritDoc
      */

package/src/automediaembed.js

@@ -6,19 +6,19 @@
  * @module media-embed/automediaembed
  */
 import { Plugin } from 'ckeditor5/src/core.js';
-import { LiveRange, LivePosition } from 'ckeditor5/src/engine.js';
+import { ModelLiveRange, ModelLivePosition } from 'ckeditor5/src/engine.js';
 import { Clipboard } from 'ckeditor5/src/clipboard.js';
 import { Delete } from 'ckeditor5/src/typing.js';
 import { Undo } from 'ckeditor5/src/undo.js';
 import { global } from 'ckeditor5/src/utils.js';
-import MediaEmbedEditing from './mediaembedediting.js';
+import { MediaEmbedEditing } from './mediaembedediting.js';
 import { insertMedia } from './utils.js';
 const URL_REGEXP = /^(?:http(s)?:\/\/)?[\w-]+\.[\w-.~:/?#[\]@!$&'()*+,;=%]+$/;
 /**
  * The auto-media embed plugin. It recognizes media links in the pasted content and embeds
  * them shortly after they are injected into the document.
  */
-export default class AutoMediaEmbed extends Plugin {
+export class AutoMediaEmbed extends Plugin {
     /**
      * @inheritDoc
      */
@@ -67,9 +67,9 @@ export default class AutoMediaEmbed extends Plugin {
         const clipboardPipeline = editor.plugins.get('ClipboardPipeline');
         this.listenTo(clipboardPipeline, 'inputTransformation', () => {
             const firstRange = modelDocument.selection.getFirstRange();
-            const leftLivePosition = LivePosition.fromPosition(firstRange.start);
+            const leftLivePosition = ModelLivePosition.fromPosition(firstRange.start);
             leftLivePosition.stickiness = 'toPrevious';
-            const rightLivePosition = LivePosition.fromPosition(firstRange.end);
+            const rightLivePosition = ModelLivePosition.fromPosition(firstRange.end);
             rightLivePosition.stickiness = 'toNext';
             modelDocument.once('change:data', () => {
                 this._embedMediaBetweenPositions(leftLivePosition, rightLivePosition);
@@ -97,8 +97,8 @@ export default class AutoMediaEmbed extends Plugin {
     _embedMediaBetweenPositions(leftPosition, rightPosition) {
         const editor = this.editor;
         const mediaRegistry = editor.plugins.get(MediaEmbedEditing).registry;
-        // TODO: Use marker instead of LiveRange & LivePositions.
-        const urlRange = new LiveRange(leftPosition, rightPosition);
+        // TODO: Use marker instead of ModelLiveRange & LivePositions.
+        const urlRange = new ModelLiveRange(leftPosition, rightPosition);
         const walker = urlRange.getWalker({ ignoreElementEnd: true });
         let url = '';
         for (const node of walker) {
@@ -124,7 +124,7 @@ export default class AutoMediaEmbed extends Plugin {
             return;
         }
         // Position won't be available in the `setTimeout` function so let's clone it.
-        this._positionToInsert = LivePosition.fromPosition(leftPosition);
+        this._positionToInsert = ModelLivePosition.fromPosition(leftPosition);
         // This action mustn't be executed if undo was called between pasting and auto-embedding.
         this._timeoutId = global.window.setTimeout(() => {
             editor.model.change(writer => {

package/src/converters.d.ts

@@ -3,7 +3,7 @@
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import type { DowncastDispatcher } from 'ckeditor5/src/engine.js';
-import type MediaRegistry from './mediaregistry.js';
+import { type MediaRegistry } from './mediaregistry.js';
 import type { MediaOptions } from './utils.js';
 /**
  * Returns a function that converts the model "url" attribute to the view representation.

package/src/index.d.ts

@@ -5,11 +5,16 @@
 /**
  * @module media-embed
  */
-export { default as MediaEmbed } from './mediaembed.js';
-export { default as MediaEmbedEditing } from './mediaembedediting.js';
-export { default as MediaEmbedUI } from './mediaembedui.js';
-export { default as AutoMediaEmbed } from './automediaembed.js';
-export { default as MediaEmbedToolbar } from './mediaembedtoolbar.js';
+export { MediaEmbed } from './mediaembed.js';
+export { MediaEmbedEditing } from './mediaembedediting.js';
+export { MediaEmbedUI } from './mediaembedui.js';
+export { AutoMediaEmbed } from './automediaembed.js';
+export { MediaEmbedToolbar } from './mediaembedtoolbar.js';
+export { MediaEmbedCommand } from './mediaembedcommand.js';
 export type { MediaEmbedConfig } from './mediaembedconfig.js';
-export type { default as MediaEmbedCommand } from './mediaembedcommand.js';
+export { modelToViewUrlAttributeConverter as _modelToViewUrlAttributeMediaConverter } from './converters.js';
+export { MediaFormView as _MediaFormView } from './ui/mediaformview.js';
+export { toMediaWidget as _toMediaWidget, getSelectedMediaViewWidget as _getSelectedMediaViewWidget, isMediaWidget as _isMediaWidget, createMediaFigureElement as _createMediaFigureElement, getSelectedMediaModelWidget as _getSelectedMediaModelWidget, insertMedia as _insertMedia, type MediaOptions } from './utils.js';
+export type { MediaEmbedProvider } from './mediaembedconfig.js';
+export { MediaRegistry } from './mediaregistry.js';
 import './augmentation.js';

package/src/index.js

@@ -5,9 +5,14 @@
 /**
  * @module media-embed
  */
-export { default as MediaEmbed } from './mediaembed.js';
-export { default as MediaEmbedEditing } from './mediaembedediting.js';
-export { default as MediaEmbedUI } from './mediaembedui.js';
-export { default as AutoMediaEmbed } from './automediaembed.js';
-export { default as MediaEmbedToolbar } from './mediaembedtoolbar.js';
+export { MediaEmbed } from './mediaembed.js';
+export { MediaEmbedEditing } from './mediaembedediting.js';
+export { MediaEmbedUI } from './mediaembedui.js';
+export { AutoMediaEmbed } from './automediaembed.js';
+export { MediaEmbedToolbar } from './mediaembedtoolbar.js';
+export { MediaEmbedCommand } from './mediaembedcommand.js';
+export { modelToViewUrlAttributeConverter as _modelToViewUrlAttributeMediaConverter } from './converters.js';
+export { MediaFormView as _MediaFormView } from './ui/mediaformview.js';
+export { toMediaWidget as _toMediaWidget, getSelectedMediaViewWidget as _getSelectedMediaViewWidget, isMediaWidget as _isMediaWidget, createMediaFigureElement as _createMediaFigureElement, getSelectedMediaModelWidget as _getSelectedMediaModelWidget, insertMedia as _insertMedia } from './utils.js';
+export { MediaRegistry } from './mediaregistry.js';
 import './augmentation.js';

package/src/mediaembed.d.ts

@@ -7,9 +7,9 @@
  */
 import { Plugin } from 'ckeditor5/src/core.js';
 import { Widget } from 'ckeditor5/src/widget.js';
-import MediaEmbedEditing from './mediaembedediting.js';
-import AutoMediaEmbed from './automediaembed.js';
-import MediaEmbedUI from './mediaembedui.js';
+import { MediaEmbedEditing } from './mediaembedediting.js';
+import { AutoMediaEmbed } from './automediaembed.js';
+import { MediaEmbedUI } from './mediaembedui.js';
 import '../theme/mediaembed.css';
 /**
  * The media embed plugin.
@@ -22,7 +22,7 @@ import '../theme/mediaembed.css';
  * * The {@link module:media-embed/mediaembedui~MediaEmbedUI media embed UI feature} and
  * * The {@link module:media-embed/automediaembed~AutoMediaEmbed auto-media embed feature}.
  */
-export default class MediaEmbed extends Plugin {
+export declare class MediaEmbed extends Plugin {
     /**
      * @inheritDoc
      */

package/src/mediaembed.js

@@ -7,9 +7,9 @@
  */
 import { Plugin } from 'ckeditor5/src/core.js';
 import { Widget } from 'ckeditor5/src/widget.js';
-import MediaEmbedEditing from './mediaembedediting.js';
-import AutoMediaEmbed from './automediaembed.js';
-import MediaEmbedUI from './mediaembedui.js';
+import { MediaEmbedEditing } from './mediaembedediting.js';
+import { AutoMediaEmbed } from './automediaembed.js';
+import { MediaEmbedUI } from './mediaembedui.js';
 import '../theme/mediaembed.css';
 /**
  * The media embed plugin.
@@ -22,7 +22,7 @@ import '../theme/mediaembed.css';
  * * The {@link module:media-embed/mediaembedui~MediaEmbedUI media embed UI feature} and
  * * The {@link module:media-embed/automediaembed~AutoMediaEmbed auto-media embed feature}.
  */
-export default class MediaEmbed extends Plugin {
+export class MediaEmbed extends Plugin {
     /**
      * @inheritDoc
      */

package/src/mediaembedcommand.d.ts

@@ -14,7 +14,7 @@ import { Command } from 'ckeditor5/src/core.js';
  * editor.execute( 'mediaEmbed', 'http://url.to.the/media' );
  * ```
  */
-export default class MediaEmbedCommand extends Command {
+export declare class MediaEmbedCommand extends Command {
     /**
      * Media url.
      */

package/src/mediaembedcommand.js

@@ -16,7 +16,7 @@ import { getSelectedMediaModelWidget, insertMedia } from './utils.js';
  * editor.execute( 'mediaEmbed', 'http://url.to.the/media' );
  * ```
  */
-export default class MediaEmbedCommand extends Command {
+export class MediaEmbedCommand extends Command {
     /**
      * @inheritDoc
      */

package/src/mediaembedediting.d.ts

@@ -6,12 +6,12 @@
  * @module media-embed/mediaembedediting
  */
 import { Plugin, type Editor } from 'ckeditor5/src/core.js';
-import MediaRegistry from './mediaregistry.js';
+import { MediaRegistry } from './mediaregistry.js';
 import '../theme/mediaembedediting.css';
 /**
  * The media embed editing feature.
  */
-export default class MediaEmbedEditing extends Plugin {
+export declare class MediaEmbedEditing extends Plugin {
     /**
      * @inheritDoc
      */

package/src/mediaembedediting.js

@@ -8,14 +8,14 @@
 import { Plugin } from 'ckeditor5/src/core.js';
 import { first } from 'ckeditor5/src/utils.js';
 import { modelToViewUrlAttributeConverter } from './converters.js';
-import MediaEmbedCommand from './mediaembedcommand.js';
-import MediaRegistry from './mediaregistry.js';
+import { MediaEmbedCommand } from './mediaembedcommand.js';
+import { MediaRegistry } from './mediaregistry.js';
 import { toMediaWidget, createMediaFigureElement } from './utils.js';
 import '../theme/mediaembedediting.css';
 /**
  * The media embed editing feature.
  */
-export default class MediaEmbedEditing extends Plugin {
+export class MediaEmbedEditing extends Plugin {
     /**
      * @inheritDoc
      */

package/src/mediaembedtoolbar.d.ts

@@ -14,7 +14,7 @@ import './mediaembedconfig.js';
  * Instances of toolbar components (e.g. buttons) are created based on the
  * {@link module:media-embed/mediaembedconfig~MediaEmbedConfig#toolbar `media.toolbar` configuration option}.
  */
-export default class MediaEmbedToolbar extends Plugin {
+export declare class MediaEmbedToolbar extends Plugin {
     /**
      * @inheritDoc
      */

package/src/mediaembedtoolbar.js

@@ -15,7 +15,7 @@ import './mediaembedconfig.js';
  * Instances of toolbar components (e.g. buttons) are created based on the
  * {@link module:media-embed/mediaembedconfig~MediaEmbedConfig#toolbar `media.toolbar` configuration option}.
  */
-export default class MediaEmbedToolbar extends Plugin {
+export class MediaEmbedToolbar extends Plugin {
     /**
      * @inheritDoc
      */

package/src/mediaembedui.d.ts

@@ -7,11 +7,11 @@
  */
 import { Plugin } from 'ckeditor5/src/core.js';
 import { Dialog } from 'ckeditor5/src/ui.js';
-import MediaEmbedEditing from './mediaembedediting.js';
+import { MediaEmbedEditing } from './mediaembedediting.js';
 /**
  * The media embed UI plugin.
  */
-export default class MediaEmbedUI extends Plugin {
+export declare class MediaEmbedUI extends Plugin {
     /**
      * @inheritDoc
      */

package/src/mediaembedui.js

@@ -8,12 +8,12 @@
 import { Plugin } from 'ckeditor5/src/core.js';
 import { IconMedia } from 'ckeditor5/src/icons.js';
 import { ButtonView, CssTransitionDisablerMixin, MenuBarMenuListItemButtonView, Dialog } from 'ckeditor5/src/ui.js';
-import MediaFormView from './ui/mediaformview.js';
-import MediaEmbedEditing from './mediaembedediting.js';
+import { MediaFormView } from './ui/mediaformview.js';
+import { MediaEmbedEditing } from './mediaembedediting.js';
 /**
  * The media embed UI plugin.
  */
-export default class MediaEmbedUI extends Plugin {
+export class MediaEmbedUI extends Plugin {
     /**
      * @inheritDoc
      */

package/src/mediaregistry.d.ts

@@ -3,17 +3,17 @@
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import { type Locale } from 'ckeditor5/src/utils.js';
-import type { DowncastWriter, ViewElement } from 'ckeditor5/src/engine.js';
+import type { ViewDowncastWriter, ViewElement } from 'ckeditor5/src/engine.js';
 import type { MediaEmbedConfig, MediaEmbedProvider } from './mediaembedconfig.js';
 import type { MediaOptions } from './utils.js';
 /**
  * A bridge between the raw media content provider definitions and the editor view content.
  *
- * It helps translating media URLs to corresponding {@link module:engine/view/element~Element view elements}.
+ * It helps translating media URLs to corresponding {@link module:engine/view/element~ViewElement view elements}.
  *
  * Mostly used by the {@link module:media-embed/mediaembedediting~MediaEmbedEditing} plugin.
  */
-export default class MediaRegistry {
+export declare class MediaRegistry {
     /**
      * The {@link module:utils/locale~Locale} instance.
      */
@@ -37,7 +37,7 @@ export default class MediaRegistry {
      */
     hasMedia(url: string): boolean;
     /**
-     * For the given media URL string and options, it returns the {@link module:engine/view/element~Element view element}
+     * For the given media URL string and options, it returns the {@link module:engine/view/element~ViewElement view element}
      * representing that media.
      *
      * **Note:** If no URL is specified, an empty view element is returned.
@@ -45,7 +45,7 @@ export default class MediaRegistry {
      * @param writer The view writer used to produce a view element.
      * @param url The URL to be translated into a view element.
      */
-    getMediaViewElement(writer: DowncastWriter, url: string, options: MediaOptions): ViewElement;
+    getMediaViewElement(writer: ViewDowncastWriter, url: string, options: MediaOptions): ViewElement;
     /**
      * Returns a `Media` instance for the given URL.
      *

package/src/mediaregistry.js

@@ -12,11 +12,11 @@ const mediaPlaceholderIconViewBox = '0 0 64 42';
 /**
  * A bridge between the raw media content provider definitions and the editor view content.
  *
- * It helps translating media URLs to corresponding {@link module:engine/view/element~Element view elements}.
+ * It helps translating media URLs to corresponding {@link module:engine/view/element~ViewElement view elements}.
  *
  * Mostly used by the {@link module:media-embed/mediaembedediting~MediaEmbedEditing} plugin.
  */
-export default class MediaRegistry {
+export class MediaRegistry {
     /**
      * The {@link module:utils/locale~Locale} instance.
      */
@@ -65,7 +65,7 @@ export default class MediaRegistry {
         return !!this._getMedia(url);
     }
     /**
-     * For the given media URL string and options, it returns the {@link module:engine/view/element~Element view element}
+     * For the given media URL string and options, it returns the {@link module:engine/view/element~ViewElement view element}
      * representing that media.
      *
      * **Note:** If no URL is specified, an empty view element is returned.
@@ -129,7 +129,7 @@ export default class MediaRegistry {
 /**
  * Represents media defined by the provider configuration.
  *
- * It can be rendered to the {@link module:engine/view/element~Element view element} and used in the editing or data pipeline.
+ * It can be rendered to the {@link module:engine/view/element~ViewElement view element} and used in the editing or data pipeline.
  */
 class Media {
     /**

package/src/ui/mediaformview.d.ts

@@ -14,7 +14,7 @@ import '../../theme/mediaform.css';
  *
  * See {@link module:media-embed/ui/mediaformview~MediaFormView}.
  */
-export default class MediaFormView extends View {
+export declare class MediaFormView extends View {
     /**
      * Tracks information about the DOM focus in the form.
      */

package/src/ui/mediaformview.js

@@ -16,7 +16,7 @@ import '../../theme/mediaform.css';
  *
  * See {@link module:media-embed/ui/mediaformview~MediaFormView}.
  */
-export default class MediaFormView extends View {
+export class MediaFormView extends View {
     /**
      * Tracks information about the DOM focus in the form.
      */

package/src/utils.d.ts

@@ -5,23 +5,29 @@
 /**
  * @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';
+import type { ViewContainerElement, ModelElement, Model, ModelSelectable, ModelSelection, ViewDowncastWriter, ViewDocumentSelection, ViewElement, ModelDocumentSelection } 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.
+ * Converts a given {@link module:engine/view/element~ViewElement} to a media embed widget:
+ * * Adds a {@link module:engine/view/element~ViewElement#_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.
+ * @internal
  */
-export declare function toMediaWidget(viewElement: ViewElement, writer: DowncastWriter, label: string): ViewElement;
+export declare function toMediaWidget(viewElement: ViewElement, writer: ViewDowncastWriter, label: string): ViewElement;
 /**
  * Returns a media widget editing view element if one is selected.
+ *
+ * @internal
  */
 export declare function getSelectedMediaViewWidget(selection: ViewDocumentSelection): ViewElement | null;
 /**
  * Checks if a given view element is a media widget.
+ *
+ * @internal
  */
 export declare function isMediaWidget(viewElement: ViewElement): boolean;
 /**
@@ -40,12 +46,16 @@ export declare function isMediaWidget(viewElement: ViewElement): boolean;
  * 	<div data-oembed-url="foo">[ non-semantic media preview for "foo" ]</div>
  * </figure>
  * ```
+ *
+ * @internal
  */
-export declare function createMediaFigureElement(writer: DowncastWriter, registry: MediaRegistry, url: string, options: MediaOptions): ViewContainerElement;
+export declare function createMediaFigureElement(writer: ViewDowncastWriter, registry: MediaRegistry, url: string, options: MediaOptions): ViewContainerElement;
 /**
  * Returns a selected media element in the model, if any.
+ *
+ * @internal
  */
-export declare function getSelectedMediaModelWidget(selection: Selection | DocumentSelection): Element | null;
+export declare function getSelectedMediaModelWidget(selection: ModelSelection | ModelDocumentSelection): ModelElement | null;
 /**
  * Creates a media element and inserts it into the model.
  *
@@ -55,8 +65,9 @@ export declare function getSelectedMediaModelWidget(selection: Selection | Docum
  * @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.
+ * @internal
  */
-export declare function insertMedia(model: Model, url: string, selectable: Selectable, findOptimalPosition: boolean): void;
+export declare function insertMedia(model: Model, url: string, selectable: ModelSelectable, findOptimalPosition: boolean): void;
 /**
  * Type for commonly grouped function parameters across this package.
  */

package/src/utils.js

@@ -4,12 +4,14 @@
  */
 import { isWidget, toWidget } from 'ckeditor5/src/widget.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.
+ * Converts a given {@link module:engine/view/element~ViewElement} to a media embed widget:
+ * * Adds a {@link module:engine/view/element~ViewElement#_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.
+ * @internal
  */
 export function toMediaWidget(viewElement, writer, label) {
     writer.setCustomProperty('media', true, viewElement);
@@ -17,6 +19,8 @@ export function toMediaWidget(viewElement, writer, label) {
 }
 /**
  * Returns a media widget editing view element if one is selected.
+ *
+ * @internal
  */
 export function getSelectedMediaViewWidget(selection) {
     const viewElement = selection.getSelectedElement();
@@ -27,6 +31,8 @@ export function getSelectedMediaViewWidget(selection) {
 }
 /**
  * Checks if a given view element is a media widget.
+ *
+ * @internal
  */
 export function isMediaWidget(viewElement) {
     return !!viewElement.getCustomProperty('media') && isWidget(viewElement);
@@ -47,6 +53,8 @@ export function isMediaWidget(viewElement) {
  * 	<div data-oembed-url="foo">[ non-semantic media preview for "foo" ]</div>
  * </figure>
  * ```
+ *
+ * @internal
  */
 export function createMediaFigureElement(writer, registry, url, options) {
     return writer.createContainerElement('figure', { class: 'media' }, [
@@ -56,6 +64,8 @@ export function createMediaFigureElement(writer, registry, url, options) {
 }
 /**
  * Returns a selected media element in the model, if any.
+ *
+ * @internal
  */
 export function getSelectedMediaModelWidget(selection) {
     const selectedElement = selection.getSelectedElement();
@@ -73,6 +83,7 @@ export function getSelectedMediaModelWidget(selection) {
  * @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.
+ * @internal
  */
 export function insertMedia(model, url, selectable, findOptimalPosition) {
     model.change(writer => {