@ckeditor/ckeditor5-enter 40.0.0 → 40.1.0

package/LICENSE.md

@@ -2,7 +2,7 @@ Software License Agreement
 ==========================
 
 **CKEditor&nbsp;5 enter feature** – https://github.com/ckeditor/ckeditor5-enter <br>
-Copyright (c) 2003-2023, [CKSource Holding sp. z o.o.](https://cksource.com) All rights reserved.
+Copyright (c) 2003–2023, [CKSource Holding sp. z o.o.](https://cksource.com) All rights reserved.
 
 Licensed under the terms of [GNU General Public License Version 2 or later](http://www.gnu.org/licenses/gpl.html).
 
@@ -14,4 +14,4 @@ Where not otherwise indicated, all CKEditor content is authored by CKSource engi
 Trademarks
 ----------
 
-**CKEditor** is a trademark of [CKSource Holding sp. z o.o.](https://cksource.com) All other brand and product names are trademarks, registered trademarks or service marks of their respective holders.
+**CKEditor** is a trademark of [CKSource Holding sp. z o.o.](https://cksource.com) All other brand and product names are trademarks, registered trademarks, or service marks of their respective holders.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-enter",
-  "version": "40.0.0",
+  "version": "40.1.0",
   "description": "Enter feature for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -12,9 +12,9 @@
   ],
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-core": "40.0.0",
-    "@ckeditor/ckeditor5-engine": "40.0.0",
-    "@ckeditor/ckeditor5-utils": "40.0.0"
+    "@ckeditor/ckeditor5-core": "40.1.0",
+    "@ckeditor/ckeditor5-engine": "40.1.0",
+    "@ckeditor/ckeditor5-utils": "40.1.0"
   },
   "author": "CKSource (http://cksource.com/)",
   "license": "GPL-2.0-or-later",

package/src/augmentation.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
- */
-import type { Enter, ShiftEnter, EnterCommand, ShiftEnterCommand } from './index';
-declare module '@ckeditor/ckeditor5-core' {
-    interface PluginsMap {
-        [Enter.pluginName]: Enter;
-        [ShiftEnter.pluginName]: ShiftEnter;
-    }
-    interface CommandsMap {
-        enter: EnterCommand;
-        shiftEnter: ShiftEnterCommand;
-    }
-}
+/**
+ * @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 type { Enter, ShiftEnter, EnterCommand, ShiftEnterCommand } from './index';
+declare module '@ckeditor/ckeditor5-core' {
+    interface PluginsMap {
+        [Enter.pluginName]: Enter;
+        [ShiftEnter.pluginName]: ShiftEnter;
+    }
+    interface CommandsMap {
+        enter: EnterCommand;
+        shiftEnter: ShiftEnterCommand;
+    }
+}

package/src/augmentation.js

@@ -1,5 +1,5 @@
-/**
- * @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
- */
-export {};
+/**
+ * @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
+ */
+export {};

package/src/enter.d.ts

@@ -1,22 +1,22 @@
-/**
- * @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 enter/enter
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-/**
- * This plugin handles the <kbd>Enter</kbd> keystroke (hard line break) in the editor.
- *
- * See also the {@link module:enter/shiftenter~ShiftEnter} plugin.
- *
- * For more information about this feature see the {@glink api/enter package page}.
- */
-export default class Enter extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "Enter";
-    init(): 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
+ */
+/**
+ * @module enter/enter
+ */
+import { Plugin } from '@ckeditor/ckeditor5-core';
+/**
+ * This plugin handles the <kbd>Enter</kbd> keystroke (hard line break) in the editor.
+ *
+ * See also the {@link module:enter/shiftenter~ShiftEnter} plugin.
+ *
+ * For more information about this feature see the {@glink api/enter package page}.
+ */
+export default class Enter extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "Enter";
+    init(): void;
+}

package/src/enter.js

@@ -1,45 +1,45 @@
-/**
- * @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 enter/enter
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import EnterCommand from './entercommand';
-import EnterObserver from './enterobserver';
-/**
- * This plugin handles the <kbd>Enter</kbd> keystroke (hard line break) in the editor.
- *
- * See also the {@link module:enter/shiftenter~ShiftEnter} plugin.
- *
- * For more information about this feature see the {@glink api/enter package page}.
- */
-export default class Enter extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName() {
-        return 'Enter';
-    }
-    init() {
-        const editor = this.editor;
-        const view = editor.editing.view;
-        const viewDocument = view.document;
-        view.addObserver(EnterObserver);
-        editor.commands.add('enter', new EnterCommand(editor));
-        this.listenTo(viewDocument, 'enter', (evt, data) => {
-            // When not in composition, we handle the action, so prevent the default one.
-            // When in composition, it's the browser who modify the DOM (renderer is disabled).
-            if (!viewDocument.isComposing) {
-                data.preventDefault();
-            }
-            // The soft enter key is handled by the ShiftEnter plugin.
-            if (data.isSoft) {
-                return;
-            }
-            editor.execute('enter');
-            view.scrollToTheSelection();
-        }, { priority: 'low' });
-    }
-}
+/**
+ * @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 enter/enter
+ */
+import { Plugin } from '@ckeditor/ckeditor5-core';
+import EnterCommand from './entercommand';
+import EnterObserver from './enterobserver';
+/**
+ * This plugin handles the <kbd>Enter</kbd> keystroke (hard line break) in the editor.
+ *
+ * See also the {@link module:enter/shiftenter~ShiftEnter} plugin.
+ *
+ * For more information about this feature see the {@glink api/enter package page}.
+ */
+export default class Enter extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'Enter';
+    }
+    init() {
+        const editor = this.editor;
+        const view = editor.editing.view;
+        const viewDocument = view.document;
+        view.addObserver(EnterObserver);
+        editor.commands.add('enter', new EnterCommand(editor));
+        this.listenTo(viewDocument, 'enter', (evt, data) => {
+            // When not in composition, we handle the action, so prevent the default one.
+            // When in composition, it's the browser who modify the DOM (renderer is disabled).
+            if (!viewDocument.isComposing) {
+                data.preventDefault();
+            }
+            // The soft enter key is handled by the ShiftEnter plugin.
+            if (data.isSoft) {
+                return;
+            }
+            editor.execute('enter');
+            view.scrollToTheSelection();
+        }, { priority: 'low' });
+    }
+}

package/src/entercommand.d.ts

@@ -1,52 +1,52 @@
-/**
- * @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 enter/entercommand
- */
-import { Command } from '@ckeditor/ckeditor5-core';
-import type { Writer } from '@ckeditor/ckeditor5-engine';
-/**
- * Enter command used by the {@link module:enter/enter~Enter Enter feature} to handle the <kbd>Enter</kbd> keystroke.
- */
-export default class EnterCommand extends Command {
-    /**
-     * @inheritDoc
-     */
-    execute(): void;
-    /**
-     * Splits a block where the document selection is placed, in the way how the <kbd>Enter</kbd> key is expected to work:
-     *
-     * ```
-     * <p>Foo[]bar</p>   ->   <p>Foo</p><p>[]bar</p>
-     * <p>Foobar[]</p>   ->   <p>Foobar</p><p>[]</p>
-     * <p>Fo[ob]ar</p>   ->   <p>Fo</p><p>[]ar</p>
-     * ```
-     *
-     * In some cases, the split will not happen:
-     *
-     * ```
-     * // The selection parent is a limit element:
-     * <figcaption>A[bc]d</figcaption>   ->   <figcaption>A[]d</figcaption>
-     *
-     * // The selection spans over multiple elements:
-     * <h>x[x</h><p>y]y<p>   ->   <h>x</h><p>[]y</p>
-     * ```
-     *
-     * @param writer Writer to use when performing the enter action.
-     * @returns Boolean indicating if the block was split.
-     */
-    enterBlock(writer: Writer): boolean;
-}
-/**
- * Fired after the the {@link module:enter/entercommand~EnterCommand} is finished executing.
- *
- * @eventName ~EnterCommand#afterExecute
- */
-export type EnterCommandAfterExecuteEvent = {
-    name: 'afterExecute';
-    args: [{
-        writer: Writer;
-    }];
-};
+/**
+ * @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 enter/entercommand
+ */
+import { Command } from '@ckeditor/ckeditor5-core';
+import type { Writer } from '@ckeditor/ckeditor5-engine';
+/**
+ * Enter command used by the {@link module:enter/enter~Enter Enter feature} to handle the <kbd>Enter</kbd> keystroke.
+ */
+export default class EnterCommand extends Command {
+    /**
+     * @inheritDoc
+     */
+    execute(): void;
+    /**
+     * Splits a block where the document selection is placed, in the way how the <kbd>Enter</kbd> key is expected to work:
+     *
+     * ```
+     * <p>Foo[]bar</p>   ->   <p>Foo</p><p>[]bar</p>
+     * <p>Foobar[]</p>   ->   <p>Foobar</p><p>[]</p>
+     * <p>Fo[ob]ar</p>   ->   <p>Fo</p><p>[]ar</p>
+     * ```
+     *
+     * In some cases, the split will not happen:
+     *
+     * ```
+     * // The selection parent is a limit element:
+     * <figcaption>A[bc]d</figcaption>   ->   <figcaption>A[]d</figcaption>
+     *
+     * // The selection spans over multiple elements:
+     * <h>x[x</h><p>y]y<p>   ->   <h>x</h><p>[]y</p>
+     * ```
+     *
+     * @param writer Writer to use when performing the enter action.
+     * @returns Boolean indicating if the block was split.
+     */
+    enterBlock(writer: Writer): boolean;
+}
+/**
+ * Fired after the the {@link module:enter/entercommand~EnterCommand} is finished executing.
+ *
+ * @eventName ~EnterCommand#afterExecute
+ */
+export type EnterCommandAfterExecuteEvent = {
+    name: 'afterExecute';
+    args: [{
+        writer: Writer;
+    }];
+};

package/src/entercommand.js

@@ -1,96 +1,96 @@
-/**
- * @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 enter/entercommand
- */
-import { Command } from '@ckeditor/ckeditor5-core';
-import { getCopyOnEnterAttributes } from './utils';
-/**
- * Enter command used by the {@link module:enter/enter~Enter Enter feature} to handle the <kbd>Enter</kbd> keystroke.
- */
-export default class EnterCommand extends Command {
-    /**
-     * @inheritDoc
-     */
-    execute() {
-        this.editor.model.change(writer => {
-            this.enterBlock(writer);
-            this.fire('afterExecute', { writer });
-        });
-    }
-    /**
-     * Splits a block where the document selection is placed, in the way how the <kbd>Enter</kbd> key is expected to work:
-     *
-     * ```
-     * <p>Foo[]bar</p>   ->   <p>Foo</p><p>[]bar</p>
-     * <p>Foobar[]</p>   ->   <p>Foobar</p><p>[]</p>
-     * <p>Fo[ob]ar</p>   ->   <p>Fo</p><p>[]ar</p>
-     * ```
-     *
-     * In some cases, the split will not happen:
-     *
-     * ```
-     * // The selection parent is a limit element:
-     * <figcaption>A[bc]d</figcaption>   ->   <figcaption>A[]d</figcaption>
-     *
-     * // The selection spans over multiple elements:
-     * <h>x[x</h><p>y]y<p>   ->   <h>x</h><p>[]y</p>
-     * ```
-     *
-     * @param writer Writer to use when performing the enter action.
-     * @returns Boolean indicating if the block was split.
-     */
-    enterBlock(writer) {
-        const model = this.editor.model;
-        const selection = model.document.selection;
-        const schema = model.schema;
-        const isSelectionEmpty = selection.isCollapsed;
-        const range = selection.getFirstRange();
-        const startElement = range.start.parent;
-        const endElement = range.end.parent;
-        // Don't touch the roots and other limit elements.
-        if (schema.isLimit(startElement) || schema.isLimit(endElement)) {
-            // Delete the selected content but only if inside a single limit element.
-            // Abort, when crossing limit elements boundary (e.g. <limit1>x[x</limit1>donttouchme<limit2>y]y</limit2>).
-            // This is an edge case and it's hard to tell what should actually happen because such a selection
-            // is not entirely valid.
-            if (!isSelectionEmpty && startElement == endElement) {
-                model.deleteContent(selection);
-            }
-            return false;
-        }
-        if (isSelectionEmpty) {
-            const attributesToCopy = getCopyOnEnterAttributes(writer.model.schema, selection.getAttributes());
-            splitBlock(writer, range.start);
-            writer.setSelectionAttribute(attributesToCopy);
-            return true;
-        }
-        else {
-            const leaveUnmerged = !(range.start.isAtStart && range.end.isAtEnd);
-            const isContainedWithinOneElement = (startElement == endElement);
-            model.deleteContent(selection, { leaveUnmerged });
-            if (leaveUnmerged) {
-                // Partially selected elements.
-                //
-                // <h>x[xx]x</h>		-> <h>x^x</h>			-> <h>x</h><h>^x</h>
-                if (isContainedWithinOneElement) {
-                    splitBlock(writer, selection.focus);
-                    return true;
-                }
-                // Selection over multiple elements.
-                //
-                // <h>x[x</h><p>y]y<p>	-> <h>x^</h><p>y</p>	-> <h>x</h><p>^y</p>
-                else {
-                    writer.setSelection(endElement, 0);
-                }
-            }
-        }
-        return false;
-    }
-}
-function splitBlock(writer, splitPos) {
-    writer.split(splitPos);
-    writer.setSelection(splitPos.parent.nextSibling, 0);
-}
+/**
+ * @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 enter/entercommand
+ */
+import { Command } from '@ckeditor/ckeditor5-core';
+import { getCopyOnEnterAttributes } from './utils';
+/**
+ * Enter command used by the {@link module:enter/enter~Enter Enter feature} to handle the <kbd>Enter</kbd> keystroke.
+ */
+export default class EnterCommand extends Command {
+    /**
+     * @inheritDoc
+     */
+    execute() {
+        this.editor.model.change(writer => {
+            this.enterBlock(writer);
+            this.fire('afterExecute', { writer });
+        });
+    }
+    /**
+     * Splits a block where the document selection is placed, in the way how the <kbd>Enter</kbd> key is expected to work:
+     *
+     * ```
+     * <p>Foo[]bar</p>   ->   <p>Foo</p><p>[]bar</p>
+     * <p>Foobar[]</p>   ->   <p>Foobar</p><p>[]</p>
+     * <p>Fo[ob]ar</p>   ->   <p>Fo</p><p>[]ar</p>
+     * ```
+     *
+     * In some cases, the split will not happen:
+     *
+     * ```
+     * // The selection parent is a limit element:
+     * <figcaption>A[bc]d</figcaption>   ->   <figcaption>A[]d</figcaption>
+     *
+     * // The selection spans over multiple elements:
+     * <h>x[x</h><p>y]y<p>   ->   <h>x</h><p>[]y</p>
+     * ```
+     *
+     * @param writer Writer to use when performing the enter action.
+     * @returns Boolean indicating if the block was split.
+     */
+    enterBlock(writer) {
+        const model = this.editor.model;
+        const selection = model.document.selection;
+        const schema = model.schema;
+        const isSelectionEmpty = selection.isCollapsed;
+        const range = selection.getFirstRange();
+        const startElement = range.start.parent;
+        const endElement = range.end.parent;
+        // Don't touch the roots and other limit elements.
+        if (schema.isLimit(startElement) || schema.isLimit(endElement)) {
+            // Delete the selected content but only if inside a single limit element.
+            // Abort, when crossing limit elements boundary (e.g. <limit1>x[x</limit1>donttouchme<limit2>y]y</limit2>).
+            // This is an edge case and it's hard to tell what should actually happen because such a selection
+            // is not entirely valid.
+            if (!isSelectionEmpty && startElement == endElement) {
+                model.deleteContent(selection);
+            }
+            return false;
+        }
+        if (isSelectionEmpty) {
+            const attributesToCopy = getCopyOnEnterAttributes(writer.model.schema, selection.getAttributes());
+            splitBlock(writer, range.start);
+            writer.setSelectionAttribute(attributesToCopy);
+            return true;
+        }
+        else {
+            const leaveUnmerged = !(range.start.isAtStart && range.end.isAtEnd);
+            const isContainedWithinOneElement = (startElement == endElement);
+            model.deleteContent(selection, { leaveUnmerged });
+            if (leaveUnmerged) {
+                // Partially selected elements.
+                //
+                // <h>x[xx]x</h>		-> <h>x^x</h>			-> <h>x</h><h>^x</h>
+                if (isContainedWithinOneElement) {
+                    splitBlock(writer, selection.focus);
+                    return true;
+                }
+                // Selection over multiple elements.
+                //
+                // <h>x[x</h><p>y]y<p>	-> <h>x^</h><p>y</p>	-> <h>x</h><p>^y</p>
+                else {
+                    writer.setSelection(endElement, 0);
+                }
+            }
+        }
+        return false;
+    }
+}
+function splitBlock(writer, splitPos) {
+    writer.split(splitPos);
+    writer.setSelection(splitPos.parent.nextSibling, 0);
+}

package/src/enterobserver.d.ts

@@ -1,44 +1,44 @@
-/**
- * @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 enter/enterobserver
- */
-import { Observer, DomEventData, type View, type BubblingEvent } from '@ckeditor/ckeditor5-engine';
-/**
- * Enter observer introduces the {@link module:engine/view/document~Document#event:enter `Document#enter`} event.
- */
-export default class EnterObserver extends Observer {
-    /**
-     * @inheritDoc
-     */
-    constructor(view: View);
-    /**
-     * @inheritDoc
-     */
-    observe(): void;
-    /**
-     * @inheritDoc
-     */
-    stopObserving(): void;
-}
-/**
- * Fired when the user presses the <kbd>Enter</kbd> key.
- *
- * Note: This event is fired by the {@link module:enter/enterobserver~EnterObserver observer}
- * (usually registered by the {@link module:enter/enter~Enter Enter feature} and
- * {@link module:enter/shiftenter~ShiftEnter ShiftEnter feature}).
- *
- * @eventName module:engine/view/document~Document#enter
- */
-export type ViewDocumentEnterEvent = BubblingEvent<{
-    name: 'enter';
-    args: [EnterEventData];
-}>;
-export interface EnterEventData extends DomEventData<InputEvent> {
-    /**
-     * Whether it is a soft enter (<kbd>Shift</kbd>+<kbd>Enter</kbd>) or a hard enter (<kbd>Enter</kbd>).
-     */
-    isSoft: boolean;
-}
+/**
+ * @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 enter/enterobserver
+ */
+import { Observer, DomEventData, type View, type BubblingEvent } from '@ckeditor/ckeditor5-engine';
+/**
+ * Enter observer introduces the {@link module:engine/view/document~Document#event:enter `Document#enter`} event.
+ */
+export default class EnterObserver extends Observer {
+    /**
+     * @inheritDoc
+     */
+    constructor(view: View);
+    /**
+     * @inheritDoc
+     */
+    observe(): void;
+    /**
+     * @inheritDoc
+     */
+    stopObserving(): void;
+}
+/**
+ * Fired when the user presses the <kbd>Enter</kbd> key.
+ *
+ * Note: This event is fired by the {@link module:enter/enterobserver~EnterObserver observer}
+ * (usually registered by the {@link module:enter/enter~Enter Enter feature} and
+ * {@link module:enter/shiftenter~ShiftEnter ShiftEnter feature}).
+ *
+ * @eventName module:engine/view/document~Document#enter
+ */
+export type ViewDocumentEnterEvent = BubblingEvent<{
+    name: 'enter';
+    args: [EnterEventData];
+}>;
+export interface EnterEventData extends DomEventData<InputEvent> {
+    /**
+     * Whether it is a soft enter (<kbd>Shift</kbd>+<kbd>Enter</kbd>) or a hard enter (<kbd>Enter</kbd>).
+     */
+    isSoft: boolean;
+}