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

package/dist/mediaembed.d.ts

@@ -14,7 +14,7 @@ import '../theme/mediaembed.css';
 /**
  * The media embed plugin.
  *
- * For a detailed overview, check the {@glink features/media-embed Media Embed feature documentation}.
+ * For a detailed overview, check the {@glink features/media-embed/media-embed Media Embed feature documentation}.
  *
  * This is a "glue" plugin which loads the following plugins:
  *

package/dist/mediaembedconfig.d.ts

@@ -10,11 +10,11 @@ import type { ArrayOrItem } from '@ckeditor/ckeditor5-utils';
 /**
  * The configuration of the media embed features.
  *
- * Read more about {@glink features/media-embed#configuration configuring the media embed feature}.
+ * Read more about {@glink features/media-embed/media-embed-configuration configuring the media embed feature}.
  *
  * ```ts
  * ClassicEditor
- * 	.create( editorElement, {
+ * 	.create( {
  * 			mediaEmbed: ... // Media embed feature options.
  * 	} )
  * 	.then( ... )
@@ -61,7 +61,7 @@ export interface MediaEmbedConfig {
      *
      * ```ts
      * ClassicEditor
-     * 	.create( editorElement, {
+     * 	.create( {
      * 		plugins: [ MediaEmbed, ... ],
      * 		mediaEmbed: {
      * 			providers: [
@@ -94,7 +94,7 @@ export interface MediaEmbedConfig {
      *
      * ```ts
      * ClassicEditor
-     * 	.create( editorElement, {
+     * 	.create( {
      * 		plugins: [ MediaEmbed, ... ],
      * 		mediaEmbed: {
      * 			extraProviders: [
@@ -194,9 +194,227 @@ export interface MediaEmbedConfig {
      * Items to be placed in the media embed toolbar.
      * This option requires adding {@link module:media-embed/mediaembedtoolbar~MediaEmbedToolbar} to the plugin list.
      *
-     * Read more about configuring toolbar in {@link module:core/editor/editorconfig~EditorConfig#toolbar}.
+     * Each entry is one of:
+     *
+     * * a component name (string) — including the built-in alignment buttons (e.g. `'mediaEmbed:alignCenter'`)
+     *   and built-in dropdowns (`'mediaEmbed:wrapText'`, `'mediaEmbed:breakText'`),
+     * * a custom split-button media style dropdown definition (object) following the
+     *   {@link module:media-embed/mediaembedconfig~MediaStyleDropdownDefinition} shape — registered
+     *   alongside the built-in dropdowns and inheriting the same auto-skip / fallback-defaultItem behavior,
+     * * a generic nested toolbar grouping (`{ label, items }`) — same shape as in
+     *   {@link module:core/editor/editorconfig~EditorConfig#toolbar `config.toolbar`}.
+     *
+     * ```ts
+     * mediaEmbed: {
+     * 	toolbar: [
+     * 		'mediaEmbed:alignCenter',
+     * 		{
+     * 			name: 'mediaEmbed:myAlignments',
+     * 			title: 'Alignment',
+     * 			items: [ 'mediaEmbed:alignBlockLeft', 'mediaEmbed:alignBlockRight' ],
+     * 			defaultItem: 'mediaEmbed:alignBlockLeft'
+     * 		}
+     * 	]
+     * }
+     * ```
+     */
+    toolbar?: Array<ToolbarConfigItem | MediaStyleDropdownDefinition>;
+    /**
+     * The {@link module:media-embed/mediaembedstyle~MediaEmbedStyle media embed style} feature configuration.
+     *
+     * Available out of the box: five built-in alignment styles — `'alignLeft'`, `'alignBlockLeft'`,
+     * `'alignCenter'` (default), `'alignBlockRight'`, `'alignRight'`.
+     *
+     * Restrict the set to a subset of built-ins:
+     *
+     * ```ts
+     * mediaEmbed: {
+     * 	styles: {
+     * 		options: [ 'alignBlockLeft', 'alignCenter', 'alignBlockRight' ]
+     * 	}
+     * }
+     * ```
+     *
+     * Override fields of a built-in by re-declaring with the same `name`:
+     *
+     * ```ts
+     * mediaEmbed: {
+     * 	styles: {
+     * 		options: [
+     * 			{ name: 'alignCenter', title: 'Center' },
+     * 			'alignLeft',
+     * 			'alignRight'
+     * 		]
+     * 	}
+     * }
+     * ```
+     *
+     * Register a custom (e.g. semantical) style by supplying a complete definition:
+     *
+     * ```ts
+     * import sideIcon from 'path/to/icon.svg';
+     *
+     * mediaEmbed: {
+     * 	styles: {
+     * 		options: [
+     * 			'alignCenter',
+     * 			{
+     * 				name: 'side',
+     * 				title: 'Side media',
+     * 				icon: sideIcon,
+     * 				className: 'media-style-side'
+     * 			}
+     * 		]
+     * 	}
+     * }
+     * ```
+     *
+     * When omitted, all five built-in styles are available.
+     */
+    styles?: MediaStyleConfig;
+}
+/**
+ * The configuration for the {@link module:media-embed/mediaembedstyle~MediaEmbedStyle} feature.
+ *
+ * See {@link module:media-embed/mediaembedconfig~MediaEmbedConfig#styles `config.mediaEmbed.styles`}
+ * for details and examples.
+ */
+export interface MediaStyleConfig {
+    /**
+     * A list of media style options. Each entry is either:
+     *
+     * * a string referencing a built-in style by name (`'alignLeft'`, `'alignBlockLeft'`,
+     *   `'alignCenter'`, `'alignBlockRight'`, `'alignRight'`),
+     * * an object overriding fields of a built-in (matched by `name`),
+     * * an object defining a new custom style.
+     *
+     * Defaults to all five built-in styles when omitted.
+     */
+    options?: Array<string | MediaStyleOptionDefinition>;
+}
+/**
+ * The definition of a single media style option used by the
+ * {@link module:media-embed/mediaembedstyle~MediaEmbedStyle media embed style} feature.
+ *
+ * To customize a built-in style, re-declare it with the same `name` — only the fields
+ * you set will be replaced; the rest are inherited from the built-in. To register a
+ * brand-new style, provide a fresh `name` and a complete definition (`title`, `icon`,
+ * and — unless `isDefault: true` — `className`).
+ *
+ * ```ts
+ * import sideIcon from 'path/to/icon.svg';
+ *
+ * const sideStyle = {
+ * 	name: 'side',
+ * 	title: 'Side media',
+ * 	icon: sideIcon,
+ * 	className: 'media-style-side'
+ * };
+ * ```
+ *
+ * Each option registers a toggle button under the name `'mediaEmbed:{name}'` in the
+ * {@link module:ui/componentfactory~ComponentFactory UI component factory}.
+ */
+export interface MediaStyleOptionDefinition {
+    /**
+     * The unique style name. It is used to:
+     *
+     * * reference a built-in style or define a custom one,
+     * * store the chosen style in the model as the `mediaStyle` attribute,
+     * * register the toolbar button under `'mediaEmbed:{name}'`.
+     */
+    name: string;
+    /**
+     * The button title. The title is wrapped in `editor.t()` at button creation,
+     * so titles that match keys in the official translation set will be localized
+     * automatically.
+     *
+     * Required when defining a custom style. Inherited from the built-in style with
+     * the matching `name` when overriding a built-in.
+     */
+    title?: string;
+    /**
+     * The button icon. Either an SVG XML source string, or one of the keys in
+     * `DEFAULT_ICONS` (`'inlineLeft'`, `'left'`, `'center'`, `'right'`, `'inlineRight'`)
+     * to use one of the icons shipped with the plugin.
+     *
+     * Required when defining a custom style. Inherited from the built-in style with
+     * the matching `name` when overriding a built-in.
+     */
+    icon?: string;
+    /**
+     * The CSS class added to the view `<figure>` when this style is applied. Required
+     * for every non-default style — default styles are encoded as the absence of the
+     * `mediaStyle` attribute, so they intentionally have no class.
+     *
+     * Inherited from the built-in style with the matching `name` when not set.
+     */
+    className?: string;
+    /**
+     * When `true`, this style is the default state — applying it removes the
+     * `mediaStyle` attribute from the model element (no class is written to the view).
+     * Default styles must not define a `className`.
+     *
+     * Inherited from the built-in style with the matching `name` when not set.
+     */
+    isDefault?: boolean;
+}
+/**
+ * A media style option resolved by the normalizer — built-in inheritance has been applied
+ * and {@link module:media-embed/mediaembedstyle/utils~normalizeStyles} has already verified
+ * the required fields. UI and editing internals consume this shape.
+ *
+ * @internal
+ */
+export type NormalizedMediaStyleOption = Required<Pick<MediaStyleOptionDefinition, 'name' | 'title' | 'icon'>> & Pick<MediaStyleOptionDefinition, 'className' | 'isDefault'>;
+/**
+ * The definition of a split-button dropdown that groups several media style buttons.
+ *
+ * Integrators can declare custom dropdowns inline in
+ * {@link module:media-embed/mediaembedconfig~MediaEmbedConfig#toolbar `config.mediaEmbed.toolbar`}
+ * alongside button-name strings; `defaultItem` is the discriminator that distinguishes a
+ * split-button media style dropdown from a generic toolbar grouping.
+ *
+ * ```ts
+ * mediaEmbed: {
+ * 	toolbar: [
+ * 		'mediaEmbed:alignCenter',
+ * 		{
+ * 			name: 'mediaEmbed:myAlignments',
+ * 			title: 'Alignment',
+ * 			items: [ 'mediaEmbed:alignBlockLeft', 'mediaEmbed:alignBlockRight' ],
+ * 			defaultItem: 'mediaEmbed:alignBlockLeft'
+ * 		}
+ * 	]
+ * }
+ * ```
+ *
+ * All names (`name`, `items[]`, `defaultItem`) use the full prefixed component-factory form.
+ * Items referencing styles that are not in the resolved
+ * {@link module:media-embed/mediaembedconfig~MediaEmbedConfig#styles `config.mediaEmbed.styles`} list
+ * are filtered out at registration time. A dropdown that ends up with fewer than two items is
+ * skipped. If the configured `defaultItem` was filtered out, the first surviving item is used.
+ */
+export interface MediaStyleDropdownDefinition {
+    /**
+     * The dropdown name. Registered as-is in the UI component factory, so it must use the
+     * `mediaEmbed:` prefix (for example, `'mediaEmbed:myAlignments'`).
+     */
+    name: string;
+    /**
+     * The dropdown title, used both for the split-button label and the dropdown arrow tooltip.
+     */
+    title: string;
+    /**
+     * Prefixed style names included in the dropdown (for example,
+     * `[ 'mediaEmbed:alignBlockLeft', 'mediaEmbed:alignBlockRight' ]`).
+     */
+    items: Array<string>;
+    /**
+     * The default child whose icon and label the split button mirrors when no child is active.
+     * Must be one of the `items`.
      */
-    toolbar?: Array<ToolbarConfigItem>;
+    defaultItem: string;
 }
 /**
  * The media embed provider descriptor. Used in
@@ -236,15 +454,20 @@ export interface MediaEmbedConfig {
  * }
  * ```
  *
- * To implement responsive media, you can use the following HTML structure:
+ * To implement responsive media, set an `aspect-ratio` on the iframe. The HTML `width` and
+ * `height` attributes act as the intrinsic size (useful for layout hints in containers like
+ * table cells), while CSS `width: 100%` and `height: auto` make the element scale with its
+ * container while preserving the declared aspect ratio. The iframe is wrapped in a plain
+ * `<div>` so external styles or queries that target this wrapper continue to work:
  *
  * ```ts
  * {
  * 	...
  * 	html: match =>
- * 		'<div style="position:relative; padding-bottom:100%; height:0">' +
- * 			'<iframe src="..." frameborder="0" ' +
- * 				'style="position:absolute; width:100%; height:100%; top:0; left:0">' +
+ * 		'<div>' +
+ * 			`<iframe src="..." width="1280" height="720" ` +
+ * 				`style="width: 100%; height: auto; aspect-ratio: 16 / 9; border: 0; display: block;" ` +
+ * 				'frameborder="0" allowfullscreen>' +
  * 			'</iframe>' +
  * 		'</div>'
  * }

package/dist/mediaembedresize/constants.d.ts

@@ -0,0 +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
+ */
+/**
+ * @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
+ */
+export declare const RESIZED_MEDIA_CLASS = "media_resized";

package/dist/mediaembedresize/mediaembedresizeediting.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @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';
+/**
+ * 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;
+}

package/dist/mediaembedresize/mediaembedresizehandles.d.ts

@@ -0,0 +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';
+/**
+ * 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;
+}

package/dist/mediaembedresize/resizemediaembedcommand.d.ts

@@ -0,0 +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
+ */
+/**
+ * @module media-embed/mediaembedresize/resizemediaembedcommand
+ */
+import { Command } from '@ckeditor/ckeditor5-core';
+/**
+ * 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;
+}

package/dist/mediaembedresize.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @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
+ */
+import { Plugin } from '@ckeditor/ckeditor5-core';
+import { MediaEmbedResizeEditing } from './mediaembedresize/mediaembedresizeediting.js';
+import { MediaEmbedResizeHandles } from './mediaembedresize/mediaembedresizehandles.js';
+import '../theme/mediaembedresize.css';
+/**
+ * The media embed resize plugin.
+ *
+ * It adds a possibility to resize each media embed using handles.
+ */
+export declare class MediaEmbedResize extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof MediaEmbedResizeEditing, typeof MediaEmbedResizeHandles];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "MediaEmbedResize";
+    /**
+     * @inheritDoc
+     */
+    static get isOfficialPlugin(): true;
+}

package/dist/mediaembedstyle/constants.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @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 type { MediaStyleDropdownDefinition, NormalizedMediaStyleOption } from '../mediaembedconfig.js';
+/**
+ * Built-in style options provided by the plugin. Integrators can refer to these by
+ * name in {@link module:media-embed/mediaembedconfig~MediaEmbedConfig#styles `config.mediaEmbed.styles`}
+ * to opt out, override individual fields, or coexist with custom styles.
+ *
+ * @internal
+ */
+export declare const DEFAULT_OPTIONS: Record<string, NormalizedMediaStyleOption>;
+/**
+ * Short icon-name aliases that can be used as the `icon` value in a media style
+ * option definition. Matches the alias set exposed by the image styles feature so
+ * the two APIs feel symmetrical.
+ *
+ * @internal
+ */
+export declare const DEFAULT_ICONS: Record<string, string>;
+/**
+ * Built-in dropdown groupings. Each entry references built-in style component names. If any
+ * items are filtered out by configuration, the dropdown is rebuilt from the remaining names
+ * (or skipped entirely if fewer than two remain).
+ *
+ * @internal
+ */
+export declare const DEFAULT_DROPDOWN_DEFINITIONS: Array<MediaStyleDropdownDefinition>;

package/dist/mediaembedstyle/mediaembedstylecommand.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @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/mediaembedstyle/mediaembedstylecommand
+ */
+import { Command, type Editor } from '@ckeditor/ckeditor5-core';
+import type { NormalizedMediaStyleOption } from '../mediaembedconfig.js';
+/**
+ * The media embed style command. It is used to apply a style option (e.g. an alignment) to a
+ * selected media embed.
+ *
+ * The set of accepted style values comes from the resolved
+ * {@link module:media-embed/mediaembedconfig~MediaEmbedConfig#styles `config.mediaEmbed.styles`}
+ * options. Values not in that set are silently rejected by {@link #execute}.
+ */
+export declare class MediaEmbedStyleCommand extends Command {
+    /**
+     * The currently-applied style name. `false` when no style applies — either no media is
+     * selected, or the selected media has no `mediaStyle` attribute and no style in
+     * {@link module:media-embed/mediaembedconfig~MediaEmbedConfig#styles `config.mediaEmbed.styles`}
+     * is marked `isDefault: true`.
+     */
+    value: string | false;
+    /**
+     * Resolved styles indexed by `name`. Used to look up the `isDefault` flag at execute time
+     * (any default-marked style clears the attribute) and to validate that a requested style
+     * is part of the resolved options list.
+     */
+    private readonly _styles;
+    /**
+     * The `name` of the first style with `isDefault: true` in the resolved options, or `null`
+     * when the integrator did not designate a default. Exposed via {@link #value} when the
+     * selected media has no `mediaStyle` attribute, so the default-state UI button can light up.
+     * Does not gate the "clear attribute" branch in {@link #execute} — that uses the per-style
+     * `isDefault` flag so multi-default configs behave consistently with the downcast.
+     */
+    private readonly _defaultStyleName;
+    /**
+     * Creates an instance of the media embed style command.
+     *
+     * @param editor The editor instance.
+     * @param styles The resolved list of style options that this command will accept.
+     */
+    constructor(editor: Editor, styles: Array<NormalizedMediaStyleOption>);
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * Executes the command and applies the chosen style to the currently selected media embed.
+     *
+     * ```ts
+     * editor.execute( 'mediaStyle', { value: 'alignLeft' } );
+     * editor.execute( 'mediaStyle', { value: 'alignCenter' } ); // removes the attribute — alignCenter is the built-in default
+     * editor.execute( 'mediaStyle', { value: null } );          // removes the attribute
+     * ```
+     *
+     * The default style is encoded on the model as the absence of the `mediaStyle` attribute.
+     * Passing any `isDefault: true` style name (or `null`) therefore clears the attribute. Values
+     * that are neither falsy, an `isDefault` style, nor present in the resolved options list are
+     * silently rejected.
+     *
+     * @param options
+     * @param options.value The name of the style to apply, or `null` to clear the alignment.
+     * @fires execute
+     */
+    execute(options: {
+        value: string | null;
+    }): void;
+}

package/dist/mediaembedstyle/mediaembedstyleediting.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @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';
+import type { NormalizedMediaStyleOption } from '../mediaembedconfig.js';
+/**
+ * The media embed style engine plugin. It extends the schema with the `mediaStyle` attribute,
+ * registers the {@link module:media-embed/mediaembedstyle/mediaembedstylecommand~MediaEmbedStyleCommand} command,
+ * and adds the converters that apply alignment CSS classes to the figure.
+ */
+export declare class MediaEmbedStyleEditing extends Plugin {
+    /**
+     * The resolved list of media style options. Built once from
+     * {@link module:media-embed/mediaembedconfig~MediaEmbedConfig#styles `config.mediaEmbed.styles`}
+     * during {@link #init} and consumed by both the command and the UI plugin (single source of truth).
+     *
+     * @internal
+     * @readonly
+     */
+    normalizedStyles: Array<NormalizedMediaStyleOption>;
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof MediaEmbedEditing];
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "MediaEmbedStyleEditing";
+    /**
+     * @inheritDoc
+     */
+    static get isOfficialPlugin(): true;
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+    /**
+     * Registers the downcast and upcast converters for the `mediaStyle` attribute.
+     */
+    private _registerConverters;
+}