@ckeditor/ckeditor5-media-embed 40.0.0 → 40.1.0

package/src/index.d.ts

@@ -1,15 +1,15 @@
-/**
- * @license Copyright (c) 2003-2023, 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
- */
-export { default as MediaEmbed } from './mediaembed';
-export { default as MediaEmbedEditing } from './mediaembedediting';
-export { default as MediaEmbedUI } from './mediaembedui';
-export { default as AutoMediaEmbed } from './automediaembed';
-export { default as MediaEmbedToolbar } from './mediaembedtoolbar';
-export type { MediaEmbedConfig } from './mediaembedconfig';
-export type { default as MediaEmbedCommand } from './mediaembedcommand';
-import './augmentation';
+/**
+ * @license Copyright (c) 2003-2023, 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
+ */
+export { default as MediaEmbed } from './mediaembed';
+export { default as MediaEmbedEditing } from './mediaembedediting';
+export { default as MediaEmbedUI } from './mediaembedui';
+export { default as AutoMediaEmbed } from './automediaembed';
+export { default as MediaEmbedToolbar } from './mediaembedtoolbar';
+export type { MediaEmbedConfig } from './mediaembedconfig';
+export type { default as MediaEmbedCommand } from './mediaembedcommand';
+import './augmentation';

package/src/index.js

@@ -1,13 +1,13 @@
-/**
- * @license Copyright (c) 2003-2023, 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
- */
-export { default as MediaEmbed } from './mediaembed';
-export { default as MediaEmbedEditing } from './mediaembedediting';
-export { default as MediaEmbedUI } from './mediaembedui';
-export { default as AutoMediaEmbed } from './automediaembed';
-export { default as MediaEmbedToolbar } from './mediaembedtoolbar';
-import './augmentation';
+/**
+ * @license Copyright (c) 2003-2023, 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
+ */
+export { default as MediaEmbed } from './mediaembed';
+export { default as MediaEmbedEditing } from './mediaembedediting';
+export { default as MediaEmbedUI } from './mediaembedui';
+export { default as AutoMediaEmbed } from './automediaembed';
+export { default as MediaEmbedToolbar } from './mediaembedtoolbar';
+import './augmentation';

package/src/mediaembed.d.ts

@@ -1,34 +1,34 @@
-/**
- * @license Copyright (c) 2003-2023, 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/mediaembed
- */
-import { Plugin } from 'ckeditor5/src/core';
-import { Widget } from 'ckeditor5/src/widget';
-import MediaEmbedEditing from './mediaembedediting';
-import AutoMediaEmbed from './automediaembed';
-import MediaEmbedUI from './mediaembedui';
-import '../theme/mediaembed.css';
-/**
- * The media embed plugin.
- *
- * For a detailed overview, check the {@glink features/media-embed Media Embed feature documentation}.
- *
- * This is a "glue" plugin which loads the following plugins:
- *
- * * The {@link module:media-embed/mediaembedediting~MediaEmbedEditing media embed editing feature},
- * * 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 {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof MediaEmbedEditing, typeof MediaEmbedUI, typeof AutoMediaEmbed, typeof Widget];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "MediaEmbed";
-}
+/**
+ * @license Copyright (c) 2003-2023, 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/mediaembed
+ */
+import { Plugin } from 'ckeditor5/src/core';
+import { Widget } from 'ckeditor5/src/widget';
+import MediaEmbedEditing from './mediaembedediting';
+import AutoMediaEmbed from './automediaembed';
+import MediaEmbedUI from './mediaembedui';
+import '../theme/mediaembed.css';
+/**
+ * The media embed plugin.
+ *
+ * For a detailed overview, check the {@glink features/media-embed Media Embed feature documentation}.
+ *
+ * This is a "glue" plugin which loads the following plugins:
+ *
+ * * The {@link module:media-embed/mediaembedediting~MediaEmbedEditing media embed editing feature},
+ * * 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 {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof MediaEmbedEditing, typeof MediaEmbedUI, typeof AutoMediaEmbed, typeof Widget];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "MediaEmbed";
+}

package/src/mediaembed.js

@@ -1,38 +1,38 @@
-/**
- * @license Copyright (c) 2003-2023, 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/mediaembed
- */
-import { Plugin } from 'ckeditor5/src/core';
-import { Widget } from 'ckeditor5/src/widget';
-import MediaEmbedEditing from './mediaembedediting';
-import AutoMediaEmbed from './automediaembed';
-import MediaEmbedUI from './mediaembedui';
-import '../theme/mediaembed.css';
-/**
- * The media embed plugin.
- *
- * For a detailed overview, check the {@glink features/media-embed Media Embed feature documentation}.
- *
- * This is a "glue" plugin which loads the following plugins:
- *
- * * The {@link module:media-embed/mediaembedediting~MediaEmbedEditing media embed editing feature},
- * * 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 {
-    /**
-     * @inheritDoc
-     */
-    static get requires() {
-        return [MediaEmbedEditing, MediaEmbedUI, AutoMediaEmbed, Widget];
-    }
-    /**
-     * @inheritDoc
-     */
-    static get pluginName() {
-        return 'MediaEmbed';
-    }
-}
+/**
+ * @license Copyright (c) 2003-2023, 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/mediaembed
+ */
+import { Plugin } from 'ckeditor5/src/core';
+import { Widget } from 'ckeditor5/src/widget';
+import MediaEmbedEditing from './mediaembedediting';
+import AutoMediaEmbed from './automediaembed';
+import MediaEmbedUI from './mediaembedui';
+import '../theme/mediaembed.css';
+/**
+ * The media embed plugin.
+ *
+ * For a detailed overview, check the {@glink features/media-embed Media Embed feature documentation}.
+ *
+ * This is a "glue" plugin which loads the following plugins:
+ *
+ * * The {@link module:media-embed/mediaembedediting~MediaEmbedEditing media embed editing feature},
+ * * 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 {
+    /**
+     * @inheritDoc
+     */
+    static get requires() {
+        return [MediaEmbedEditing, MediaEmbedUI, AutoMediaEmbed, Widget];
+    }
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'MediaEmbed';
+    }
+}

package/src/mediaembedcommand.d.ts

@@ -1,36 +1,36 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-import { Command } from 'ckeditor5/src/core';
-/**
- * The insert media command.
- *
- * The command is registered by the {@link module:media-embed/mediaembedediting~MediaEmbedEditing} as `'mediaEmbed'`.
- *
- * To insert media at the current selection, execute the command and specify the URL:
- *
- * ```ts
- * editor.execute( 'mediaEmbed', 'http://url.to.the/media' );
- * ```
- */
-export default class MediaEmbedCommand extends Command {
-    /**
-     * Media url.
-     */
-    value: string | undefined;
-    /**
-     * @inheritDoc
-     */
-    refresh(): void;
-    /**
-     * Executes the command, which either:
-     *
-     * * updates the URL of the selected media,
-     * * inserts the new media into the editor and puts the selection around it.
-     *
-     * @fires execute
-     * @param url The URL of the media.
-     */
-    execute(url: string): void;
-}
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import { Command } from 'ckeditor5/src/core';
+/**
+ * The insert media command.
+ *
+ * The command is registered by the {@link module:media-embed/mediaembedediting~MediaEmbedEditing} as `'mediaEmbed'`.
+ *
+ * To insert media at the current selection, execute the command and specify the URL:
+ *
+ * ```ts
+ * editor.execute( 'mediaEmbed', 'http://url.to.the/media' );
+ * ```
+ */
+export default class MediaEmbedCommand extends Command {
+    /**
+     * Media url.
+     */
+    value: string | undefined;
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * Executes the command, which either:
+     *
+     * * updates the URL of the selected media,
+     * * inserts the new media into the editor and puts the selection around it.
+     *
+     * @fires execute
+     * @param url The URL of the media.
+     */
+    execute(url: string): void;
+}

package/src/mediaembedcommand.js

@@ -1,71 +1,71 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-import { Command } from 'ckeditor5/src/core';
-import { findOptimalInsertionRange } from 'ckeditor5/src/widget';
-import { getSelectedMediaModelWidget, insertMedia } from './utils';
-/**
- * The insert media command.
- *
- * The command is registered by the {@link module:media-embed/mediaembedediting~MediaEmbedEditing} as `'mediaEmbed'`.
- *
- * To insert media at the current selection, execute the command and specify the URL:
- *
- * ```ts
- * editor.execute( 'mediaEmbed', 'http://url.to.the/media' );
- * ```
- */
-export default class MediaEmbedCommand extends Command {
-    /**
-     * @inheritDoc
-     */
-    refresh() {
-        const model = this.editor.model;
-        const selection = model.document.selection;
-        const selectedMedia = getSelectedMediaModelWidget(selection);
-        this.value = selectedMedia ? selectedMedia.getAttribute('url') : undefined;
-        this.isEnabled = isMediaSelected(selection) || isAllowedInParent(selection, model);
-    }
-    /**
-     * Executes the command, which either:
-     *
-     * * updates the URL of the selected media,
-     * * inserts the new media into the editor and puts the selection around it.
-     *
-     * @fires execute
-     * @param url The URL of the media.
-     */
-    execute(url) {
-        const model = this.editor.model;
-        const selection = model.document.selection;
-        const selectedMedia = getSelectedMediaModelWidget(selection);
-        if (selectedMedia) {
-            model.change(writer => {
-                writer.setAttribute('url', url, selectedMedia);
-            });
-        }
-        else {
-            insertMedia(model, url, selection, true);
-        }
-    }
-}
-/**
- * Checks if the media embed is allowed in the parent.
- */
-function isAllowedInParent(selection, model) {
-    const insertionRange = findOptimalInsertionRange(selection, model);
-    let parent = insertionRange.start.parent;
-    // The model.insertContent() will remove empty parent (unless it is a $root or a limit).
-    if (parent.isEmpty && !model.schema.isLimit(parent)) {
-        parent = parent.parent;
-    }
-    return model.schema.checkChild(parent, 'media');
-}
-/**
- * Checks if the media object is selected.
- */
-function isMediaSelected(selection) {
-    const element = selection.getSelectedElement();
-    return !!element && element.name === 'media';
-}
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import { Command } from 'ckeditor5/src/core';
+import { findOptimalInsertionRange } from 'ckeditor5/src/widget';
+import { getSelectedMediaModelWidget, insertMedia } from './utils';
+/**
+ * The insert media command.
+ *
+ * The command is registered by the {@link module:media-embed/mediaembedediting~MediaEmbedEditing} as `'mediaEmbed'`.
+ *
+ * To insert media at the current selection, execute the command and specify the URL:
+ *
+ * ```ts
+ * editor.execute( 'mediaEmbed', 'http://url.to.the/media' );
+ * ```
+ */
+export default class MediaEmbedCommand extends Command {
+    /**
+     * @inheritDoc
+     */
+    refresh() {
+        const model = this.editor.model;
+        const selection = model.document.selection;
+        const selectedMedia = getSelectedMediaModelWidget(selection);
+        this.value = selectedMedia ? selectedMedia.getAttribute('url') : undefined;
+        this.isEnabled = isMediaSelected(selection) || isAllowedInParent(selection, model);
+    }
+    /**
+     * Executes the command, which either:
+     *
+     * * updates the URL of the selected media,
+     * * inserts the new media into the editor and puts the selection around it.
+     *
+     * @fires execute
+     * @param url The URL of the media.
+     */
+    execute(url) {
+        const model = this.editor.model;
+        const selection = model.document.selection;
+        const selectedMedia = getSelectedMediaModelWidget(selection);
+        if (selectedMedia) {
+            model.change(writer => {
+                writer.setAttribute('url', url, selectedMedia);
+            });
+        }
+        else {
+            insertMedia(model, url, selection, true);
+        }
+    }
+}
+/**
+ * Checks if the media embed is allowed in the parent.
+ */
+function isAllowedInParent(selection, model) {
+    const insertionRange = findOptimalInsertionRange(selection, model);
+    let parent = insertionRange.start.parent;
+    // The model.insertContent() will remove empty parent (unless it is a $root or a limit).
+    if (parent.isEmpty && !model.schema.isLimit(parent)) {
+        parent = parent.parent;
+    }
+    return model.schema.checkChild(parent, 'media');
+}
+/**
+ * Checks if the media object is selected.
+ */
+function isMediaSelected(selection) {
+    const element = selection.getSelectedElement();
+    return !!element && element.name === 'media';
+}