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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-heading",
-  "version": "45.2.1-alpha.9",
+  "version": "46.0.0-alpha.0",
   "description": "Headings feature for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -13,13 +13,13 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@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-paragraph": "45.2.1-alpha.9",
-    "@ckeditor/ckeditor5-ui": "45.2.1-alpha.9",
-    "@ckeditor/ckeditor5-utils": "45.2.1-alpha.9",
-    "ckeditor5": "45.2.1-alpha.9"
+    "@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-paragraph": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-ui": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-utils": "46.0.0-alpha.0",
+    "ckeditor5": "46.0.0-alpha.0"
   },
   "author": "CKSource (http://cksource.com/)",
   "license": "SEE LICENSE IN LICENSE.md",

package/src/augmentation.d.ts

@@ -2,7 +2,7 @@
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
-import type { Heading, HeadingCommand, HeadingConfig, HeadingEditing, HeadingUI, Title, TitleConfig } from './index.js';
+import type { Heading, HeadingCommand, HeadingConfig, HeadingEditing, HeadingTitleConfig, HeadingUI, Title } from './index.js';
 declare module '@ckeditor/ckeditor5-core' {
     interface EditorConfig {
         /**
@@ -14,9 +14,9 @@ declare module '@ckeditor/ckeditor5-core' {
         /**
          * The configuration of the {@link module:heading/title~Title title feature}.
          *
-         * Read more in {@link module:heading/title~TitleConfig}.
+         * Read more in {@link module:heading/title~HeadingTitleConfig}.
          */
-        title?: TitleConfig;
+        title?: HeadingTitleConfig;
     }
     interface PluginsMap {
         [Heading.pluginName]: Heading;

package/src/heading.d.ts

@@ -6,8 +6,8 @@
  * @module heading/heading
  */
 import { Plugin } from 'ckeditor5/src/core.js';
-import HeadingEditing from './headingediting.js';
-import HeadingUI from './headingui.js';
+import { HeadingEditing } from './headingediting.js';
+import { HeadingUI } from './headingui.js';
 import '../theme/heading.css';
 /**
  * The headings feature.
@@ -20,7 +20,7 @@ import '../theme/heading.css';
  *
  * @extends module:core/plugin~Plugin
  */
-export default class Heading extends Plugin {
+export declare class Heading extends Plugin {
     /**
      * @inheritDoc
      */

package/src/heading.js

@@ -6,8 +6,8 @@
  * @module heading/heading
  */
 import { Plugin } from 'ckeditor5/src/core.js';
-import HeadingEditing from './headingediting.js';
-import HeadingUI from './headingui.js';
+import { HeadingEditing } from './headingediting.js';
+import { HeadingUI } from './headingui.js';
 import '../theme/heading.css';
 /**
  * The headings feature.
@@ -20,7 +20,7 @@ import '../theme/heading.css';
  *
  * @extends module:core/plugin~Plugin
  */
-export default class Heading extends Plugin {
+export class Heading extends Plugin {
     /**
      * @inheritDoc
      */

package/src/headingbuttonsui.d.ts

@@ -39,7 +39,7 @@ import { Plugin } from 'ckeditor5/src/core.js';
  * It is possible to use custom icons by providing `icon` config option in {@link module:heading/headingconfig~HeadingOption}.
  * For the default configuration standard icons are used.
  */
-export default class HeadingButtonsUI extends Plugin {
+export declare class HeadingButtonsUI extends Plugin {
     /**
      * @inheritDoc
      */

package/src/headingbuttonsui.js

@@ -50,7 +50,7 @@ const defaultIcons = /* #__PURE__ */ (() => ({
  * It is possible to use custom icons by providing `icon` config option in {@link module:heading/headingconfig~HeadingOption}.
  * For the default configuration standard icons are used.
  */
-export default class HeadingButtonsUI extends Plugin {
+export class HeadingButtonsUI extends Plugin {
     /**
      * @inheritDoc
      */

package/src/headingcommand.d.ts

@@ -9,7 +9,7 @@ import { Command, type Editor } from 'ckeditor5/src/core.js';
 /**
  * The heading command. It is used by the {@link module:heading/heading~Heading heading feature} to apply headings.
  */
-export default class HeadingCommand extends Command {
+export declare class HeadingCommand extends Command {
     /**
      * If the selection starts in a heading (which {@link #modelElements is supported by this command})
      * the value is set to the name of that heading model element.

package/src/headingcommand.js

@@ -10,7 +10,7 @@ import { first } from 'ckeditor5/src/utils.js';
 /**
  * The heading command. It is used by the {@link module:heading/heading~Heading heading feature} to apply headings.
  */
-export default class HeadingCommand extends Command {
+export class HeadingCommand extends Command {
     /**
      * Set of defined model's elements names that this command support.
      * See {@link module:heading/headingconfig~HeadingOption}.

package/src/headingediting.d.ts

@@ -12,7 +12,7 @@ import { Paragraph } from 'ckeditor5/src/paragraph.js';
  * This class represents the engine part of the heading feature. See also {@link module:heading/heading~Heading}.
  * It introduces `heading1`-`headingN` commands which allow to convert paragraphs into headings.
  */
-export default class HeadingEditing extends Plugin {
+export declare class HeadingEditing extends Plugin {
     /**
      * @inheritDoc
      */

package/src/headingediting.js

@@ -8,14 +8,14 @@
 import { Plugin } from 'ckeditor5/src/core.js';
 import { Paragraph } from 'ckeditor5/src/paragraph.js';
 import { priorities } from 'ckeditor5/src/utils.js';
-import HeadingCommand from './headingcommand.js';
+import { HeadingCommand } from './headingcommand.js';
 const defaultModelElement = 'paragraph';
 /**
  * The headings engine feature. It handles switching between block formats – headings and paragraph.
  * This class represents the engine part of the heading feature. See also {@link module:heading/heading~Heading}.
  * It introduces `heading1`-`headingN` commands which allow to convert paragraphs into headings.
  */
-export default class HeadingEditing extends Plugin {
+export class HeadingEditing extends Plugin {
     /**
      * @inheritDoc
      */

package/src/headingui.d.ts

@@ -10,7 +10,7 @@ import '../theme/heading.css';
 /**
  * The headings UI feature. It introduces the `headings` dropdown.
  */
-export default class HeadingUI extends Plugin {
+export declare class HeadingUI extends Plugin {
     /**
      * @inheritDoc
      */

package/src/headingui.js

@@ -6,14 +6,14 @@
  * @module heading/headingui
  */
 import { Plugin } from 'ckeditor5/src/core.js';
-import { ViewModel, createDropdown, addListToDropdown, MenuBarMenuListItemView, MenuBarMenuListView, MenuBarMenuView, MenuBarMenuListItemButtonView } from 'ckeditor5/src/ui.js';
+import { UIModel, createDropdown, addListToDropdown, MenuBarMenuListItemView, MenuBarMenuListView, MenuBarMenuView, MenuBarMenuListItemButtonView } from 'ckeditor5/src/ui.js';
 import { Collection } from 'ckeditor5/src/utils.js';
 import { getLocalizedOptions } from './utils.js';
 import '../theme/heading.css';
 /**
  * The headings UI feature. It introduces the `headings` dropdown.
  */
-export default class HeadingUI extends Plugin {
+export class HeadingUI extends Plugin {
     /**
      * @inheritDoc
      */
@@ -45,7 +45,7 @@ export default class HeadingUI extends Plugin {
             for (const option of options) {
                 const def = {
                     type: 'button',
-                    model: new ViewModel({
+                    model: new UIModel({
                         label: option.title,
                         class: option.class,
                         role: 'menuitemradio',

package/src/index.d.ts

@@ -5,12 +5,13 @@
 /**
  * @module heading
  */
-export { default as Heading } from './heading.js';
+export { Heading } from './heading.js';
 export type { HeadingOption, HeadingElementOption } from './headingconfig.js';
-export { default as HeadingEditing } from './headingediting.js';
-export { default as HeadingUI } from './headingui.js';
-export { default as HeadingButtonsUI } from './headingbuttonsui.js';
-export { default as Title, type TitleConfig } from './title.js';
-export type { HeadingConfig } from './headingconfig.js';
-export type { default as HeadingCommand } from './headingcommand.js';
+export { HeadingEditing } from './headingediting.js';
+export { HeadingUI } from './headingui.js';
+export { HeadingButtonsUI } from './headingbuttonsui.js';
+export { HeadingCommand } from './headingcommand.js';
+export { Title, type HeadingTitleConfig } from './title.js';
+export type { HeadingConfig, HeadingParagraphOption } from './headingconfig.js';
+export { getLocalizedOptions as _getLocalizedHeadingOptions } from './utils.js';
 import './augmentation.js';

package/src/index.js

@@ -5,9 +5,11 @@
 /**
  * @module heading
  */
-export { default as Heading } from './heading.js';
-export { default as HeadingEditing } from './headingediting.js';
-export { default as HeadingUI } from './headingui.js';
-export { default as HeadingButtonsUI } from './headingbuttonsui.js';
-export { default as Title } from './title.js';
+export { Heading } from './heading.js';
+export { HeadingEditing } from './headingediting.js';
+export { HeadingUI } from './headingui.js';
+export { HeadingButtonsUI } from './headingbuttonsui.js';
+export { HeadingCommand } from './headingcommand.js';
+export { Title } from './title.js';
+export { getLocalizedOptions as _getLocalizedHeadingOptions } from './utils.js';
 import './augmentation.js';

package/src/title.d.ts

@@ -11,7 +11,7 @@ import { Plugin } from 'ckeditor5/src/core.js';
  *
  * It splits the document into `Title` and `Body` sections.
  */
-export default class Title extends Plugin {
+export declare class Title extends Plugin {
     /**
      * A reference to an empty paragraph in the body
      * created when there is no element in the body for the placeholder purposes.
@@ -109,11 +109,11 @@ export default class Title extends Plugin {
  *
  * See {@link module:core/editor/editorconfig~EditorConfig all editor configuration options}.
  */
-export interface TitleConfig {
+export interface HeadingTitleConfig {
     /**
      * Defines a custom value of the placeholder for the title field.
      *
-     * Read more in {@link module:heading/title~TitleConfig}.
+     * Read more in {@link module:heading/title~HeadingTitleConfig}.
      */
     placeholder?: string;
 }

package/src/title.js

@@ -7,7 +7,7 @@
  */
 import { Plugin } from 'ckeditor5/src/core.js';
 import { first } from 'ckeditor5/src/utils.js';
-import { DowncastWriter, enablePlaceholder, hidePlaceholder, needsPlaceholder, showPlaceholder } from 'ckeditor5/src/engine.js';
+import { ViewDowncastWriter, enableViewPlaceholder, hideViewPlaceholder, needsViewPlaceholder, showViewPlaceholder } from 'ckeditor5/src/engine.js';
 // A list of element names that should be treated by the Title plugin as title-like.
 // This means that an element of a type from this list will be changed to a title element
 // when it is the first element in the root.
@@ -17,7 +17,7 @@ const titleLikeElements = new Set(['paragraph', 'heading1', 'heading2', 'heading
  *
  * It splits the document into `Title` and `Body` sections.
  */
-export default class Title extends Plugin {
+export class Title extends Plugin {
     /**
      * A reference to an empty paragraph in the body
      * created when there is no element in the body for the placeholder purposes.
@@ -127,7 +127,7 @@ export default class Title extends Plugin {
         const rootName = options.rootName ? options.rootName : undefined;
         const root = editor.model.document.getRoot(rootName);
         const view = editor.editing.view;
-        const viewWriter = new DowncastWriter(view.document);
+        const viewWriter = new ViewDowncastWriter(view.document);
         const rootRange = model.createRangeIn(root);
         const viewDocumentFragment = viewWriter.createDocumentFragment();
         // Find all markers that intersects with body.
@@ -275,7 +275,7 @@ export default class Title extends Plugin {
         editor.editing.downcastDispatcher.on('insert:title-content', (evt, data, conversionApi) => {
             const element = conversionApi.mapper.toViewElement(data.item);
             element.placeholder = titlePlaceholder;
-            enablePlaceholder({
+            enableViewPlaceholder({
                 view,
                 element,
                 keepOnFocus: true
@@ -298,7 +298,7 @@ export default class Title extends Plugin {
                 // If body element has changed we need to disable placeholder on the previous element and enable on the new one.
                 if (body !== oldBody) {
                     if (oldBody) {
-                        hidePlaceholder(writer, oldBody);
+                        hideViewPlaceholder(writer, oldBody);
                         writer.removeAttribute('data-placeholder', oldBody);
                     }
                     writer.setAttribute('data-placeholder', bodyPlaceholder, body);
@@ -307,12 +307,12 @@ export default class Title extends Plugin {
                 }
                 // Then we need to display placeholder if it is needed.
                 // See: https://github.com/ckeditor/ckeditor5/issues/8689.
-                if (needsPlaceholder(body, true) && viewRoot.childCount === 2 && body.name === 'p') {
-                    hasChanged = showPlaceholder(writer, body) ? true : hasChanged;
+                if (needsViewPlaceholder(body, true) && viewRoot.childCount === 2 && body.name === 'p') {
+                    hasChanged = showViewPlaceholder(writer, body) ? true : hasChanged;
                 }
                 else {
                     // Or hide if it is not needed.
-                    hasChanged = hidePlaceholder(writer, body) ? true : hasChanged;
+                    hasChanged = hideViewPlaceholder(writer, body) ? true : hasChanged;
                 }
             }
             return hasChanged;

package/src/utils.d.ts

@@ -14,5 +14,7 @@ import type { HeadingOption } from './headingconfig.js';
  *
  * Note: The reason behind this method is that there is no way to use {@link module:utils/locale~Locale#t}
  * when the user configuration is defined because the editor does not exist yet.
+ *
+ * @internal
  */
 export declare function getLocalizedOptions(editor: Editor): Array<HeadingOption>;

package/src/utils.js

@@ -9,6 +9,8 @@
  *
  * Note: The reason behind this method is that there is no way to use {@link module:utils/locale~Locale#t}
  * when the user configuration is defined because the editor does not exist yet.
+ *
+ * @internal
  */
 export function getLocalizedOptions(editor) {
     const t = editor.t;