@ckeditor/ckeditor5-code-block 48.8.1-alpha.4 → 49.0.0-alpha.1

package/dist/translations/ug.js

@@ -2,4 +2,4 @@
  * @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
  */
-export default {"ug":{"dictionary":{"Insert code block":"كود بۆلىكى قىستۇر","Plain text":"ساپ تېكىست","Leaving %0 code snippet":"","Entering %0 code snippet":"","Entering code snippet":"","Leaving code snippet":"","Code block":""},getPluralForm(n){return 0;}}}
+export default {"ug":{"dictionary":{"Insert code block":"كود بۆلىكى قىستۇر","Plain text":"ساپ تېكىست","Leaving %0 code snippet":"","Entering %0 code snippet":"","Entering code snippet":"","Leaving code snippet":"","Code block":""}}}

package/dist/translations/ug.umd.js

@@ -4,8 +4,10 @@
  */
 
 ( e => {
-const { [ 'ug' ]: { dictionary, getPluralForm } } = {"ug":{"dictionary":{"Insert code block":"كود بۆلىكى قىستۇر","Plain text":"ساپ تېكىست","Leaving %0 code snippet":"","Entering %0 code snippet":"","Entering code snippet":"","Leaving code snippet":"","Code block":""},getPluralForm(n){return 0;}}};
+const { [ 'ug' ]: translations } = {"ug":{"dictionary":{"Insert code block":"كود بۆلىكى قىستۇر","Plain text":"ساپ تېكىست","Leaving %0 code snippet":"","Entering %0 code snippet":"","Entering code snippet":"","Leaving code snippet":"","Code block":""}}};
 e[ 'ug' ] ||= { dictionary: {}, getPluralForm: null };
-e[ 'ug' ].dictionary = Object.assign( e[ 'ug' ].dictionary, dictionary );
-e[ 'ug' ].getPluralForm = getPluralForm;
+e[ 'ug' ].dictionary = Object.assign( e[ 'ug' ].dictionary, translations.dictionary );
+if ( translations.getPluralForm ) {
+e[ 'ug' ].getPluralForm = translations.getPluralForm;
+}
 } )( window.CKEDITOR_TRANSLATIONS ||= {} );

package/dist/translations/uk.js

@@ -2,4 +2,4 @@
  * @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
  */
-export default {"uk":{"dictionary":{"Insert code block":"Вставте блок коду","Plain text":"Простий текст","Leaving %0 code snippet":"Вихід з фрагменту коду %0","Entering %0 code snippet":"Вхід у фрагмент коду %0","Entering code snippet":"Вхід у фрагмент коду","Leaving code snippet":"Вихід з фрагменту коду","Code block":"Блок коду"},getPluralForm(n){return (n % 10 == 1 && n % 100 != 11 ? 0 : n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 10 || n % 100 >= 20) ? 1 : 2);}}}
+export default {"uk":{"dictionary":{"Insert code block":"Вставте блок коду","Plain text":"Простий текст","Leaving %0 code snippet":"Вихід з фрагменту коду %0","Entering %0 code snippet":"Вхід у фрагмент коду %0","Entering code snippet":"Вхід у фрагмент коду","Leaving code snippet":"Вихід з фрагменту коду","Code block":"Блок коду"}}}

package/dist/translations/uk.umd.js

@@ -4,8 +4,10 @@
  */
 
 ( e => {
-const { [ 'uk' ]: { dictionary, getPluralForm } } = {"uk":{"dictionary":{"Insert code block":"Вставте блок коду","Plain text":"Простий текст","Leaving %0 code snippet":"Вихід з фрагменту коду %0","Entering %0 code snippet":"Вхід у фрагмент коду %0","Entering code snippet":"Вхід у фрагмент коду","Leaving code snippet":"Вихід з фрагменту коду","Code block":"Блок коду"},getPluralForm(n){return (n % 10 == 1 && n % 100 != 11 ? 0 : n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 10 || n % 100 >= 20) ? 1 : 2);}}};
+const { [ 'uk' ]: translations } = {"uk":{"dictionary":{"Insert code block":"Вставте блок коду","Plain text":"Простий текст","Leaving %0 code snippet":"Вихід з фрагменту коду %0","Entering %0 code snippet":"Вхід у фрагмент коду %0","Entering code snippet":"Вхід у фрагмент коду","Leaving code snippet":"Вихід з фрагменту коду","Code block":"Блок коду"}}};
 e[ 'uk' ] ||= { dictionary: {}, getPluralForm: null };
-e[ 'uk' ].dictionary = Object.assign( e[ 'uk' ].dictionary, dictionary );
-e[ 'uk' ].getPluralForm = getPluralForm;
+e[ 'uk' ].dictionary = Object.assign( e[ 'uk' ].dictionary, translations.dictionary );
+if ( translations.getPluralForm ) {
+e[ 'uk' ].getPluralForm = translations.getPluralForm;
+}
 } )( window.CKEDITOR_TRANSLATIONS ||= {} );

package/dist/translations/ur.js

@@ -2,4 +2,4 @@
  * @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
  */
-export default {"ur":{"dictionary":{"Insert code block":"کوڈ خانہ نصب کیرں","Plain text":"سادہ متن","Leaving %0 code snippet":"","Entering %0 code snippet":"","Entering code snippet":"","Leaving code snippet":"","Code block":""},getPluralForm(n){return (n != 1);}}}
+export default {"ur":{"dictionary":{"Insert code block":"کوڈ خانہ نصب کیرں","Plain text":"سادہ متن","Leaving %0 code snippet":"","Entering %0 code snippet":"","Entering code snippet":"","Leaving code snippet":"","Code block":""}}}

package/dist/translations/ur.umd.js

@@ -4,8 +4,10 @@
  */
 
 ( e => {
-const { [ 'ur' ]: { dictionary, getPluralForm } } = {"ur":{"dictionary":{"Insert code block":"کوڈ خانہ نصب کیرں","Plain text":"سادہ متن","Leaving %0 code snippet":"","Entering %0 code snippet":"","Entering code snippet":"","Leaving code snippet":"","Code block":""},getPluralForm(n){return (n != 1);}}};
+const { [ 'ur' ]: translations } = {"ur":{"dictionary":{"Insert code block":"کوڈ خانہ نصب کیرں","Plain text":"سادہ متن","Leaving %0 code snippet":"","Entering %0 code snippet":"","Entering code snippet":"","Leaving code snippet":"","Code block":""}}};
 e[ 'ur' ] ||= { dictionary: {}, getPluralForm: null };
-e[ 'ur' ].dictionary = Object.assign( e[ 'ur' ].dictionary, dictionary );
-e[ 'ur' ].getPluralForm = getPluralForm;
+e[ 'ur' ].dictionary = Object.assign( e[ 'ur' ].dictionary, translations.dictionary );
+if ( translations.getPluralForm ) {
+e[ 'ur' ].getPluralForm = translations.getPluralForm;
+}
 } )( window.CKEDITOR_TRANSLATIONS ||= {} );

package/dist/translations/uz.js

@@ -2,4 +2,4 @@
  * @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
  */
-export default {"uz":{"dictionary":{"Insert code block":"Kodni kiritish","Plain text":"Oddiy matn","Leaving %0 code snippet":"","Entering %0 code snippet":"","Entering code snippet":"","Leaving code snippet":"","Code block":""},getPluralForm(n){return (n > 1);}}}
+export default {"uz":{"dictionary":{"Insert code block":"Kodni kiritish","Plain text":"Oddiy matn","Leaving %0 code snippet":"","Entering %0 code snippet":"","Entering code snippet":"","Leaving code snippet":"","Code block":""}}}

package/dist/translations/uz.umd.js

@@ -4,8 +4,10 @@
  */
 
 ( e => {
-const { [ 'uz' ]: { dictionary, getPluralForm } } = {"uz":{"dictionary":{"Insert code block":"Kodni kiritish","Plain text":"Oddiy matn","Leaving %0 code snippet":"","Entering %0 code snippet":"","Entering code snippet":"","Leaving code snippet":"","Code block":""},getPluralForm(n){return (n > 1);}}};
+const { [ 'uz' ]: translations } = {"uz":{"dictionary":{"Insert code block":"Kodni kiritish","Plain text":"Oddiy matn","Leaving %0 code snippet":"","Entering %0 code snippet":"","Entering code snippet":"","Leaving code snippet":"","Code block":""}}};
 e[ 'uz' ] ||= { dictionary: {}, getPluralForm: null };
-e[ 'uz' ].dictionary = Object.assign( e[ 'uz' ].dictionary, dictionary );
-e[ 'uz' ].getPluralForm = getPluralForm;
+e[ 'uz' ].dictionary = Object.assign( e[ 'uz' ].dictionary, translations.dictionary );
+if ( translations.getPluralForm ) {
+e[ 'uz' ].getPluralForm = translations.getPluralForm;
+}
 } )( window.CKEDITOR_TRANSLATIONS ||= {} );

package/dist/translations/vi.js

@@ -2,4 +2,4 @@
  * @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
  */
-export default {"vi":{"dictionary":{"Insert code block":"Chèn khối mã","Plain text":"Văn bản thuần","Leaving %0 code snippet":"Đang rời khỏi đoạn mã snippet %0","Entering %0 code snippet":"Đang nhập đoạn mã snippet %0","Entering code snippet":"Đang nhập đoạn mã snippet","Leaving code snippet":"Đang rời khỏi đoạn mã snippet","Code block":"Khối mã"},getPluralForm(n){return 0;}}}
+export default {"vi":{"dictionary":{"Insert code block":"Chèn khối mã","Plain text":"Văn bản thuần","Leaving %0 code snippet":"Đang rời khỏi đoạn mã snippet %0","Entering %0 code snippet":"Đang nhập đoạn mã snippet %0","Entering code snippet":"Đang nhập đoạn mã snippet","Leaving code snippet":"Đang rời khỏi đoạn mã snippet","Code block":"Khối mã"}}}

package/dist/translations/vi.umd.js

@@ -4,8 +4,10 @@
  */
 
 ( e => {
-const { [ 'vi' ]: { dictionary, getPluralForm } } = {"vi":{"dictionary":{"Insert code block":"Chèn khối mã","Plain text":"Văn bản thuần","Leaving %0 code snippet":"Đang rời khỏi đoạn mã snippet %0","Entering %0 code snippet":"Đang nhập đoạn mã snippet %0","Entering code snippet":"Đang nhập đoạn mã snippet","Leaving code snippet":"Đang rời khỏi đoạn mã snippet","Code block":"Khối mã"},getPluralForm(n){return 0;}}};
+const { [ 'vi' ]: translations } = {"vi":{"dictionary":{"Insert code block":"Chèn khối mã","Plain text":"Văn bản thuần","Leaving %0 code snippet":"Đang rời khỏi đoạn mã snippet %0","Entering %0 code snippet":"Đang nhập đoạn mã snippet %0","Entering code snippet":"Đang nhập đoạn mã snippet","Leaving code snippet":"Đang rời khỏi đoạn mã snippet","Code block":"Khối mã"}}};
 e[ 'vi' ] ||= { dictionary: {}, getPluralForm: null };
-e[ 'vi' ].dictionary = Object.assign( e[ 'vi' ].dictionary, dictionary );
-e[ 'vi' ].getPluralForm = getPluralForm;
+e[ 'vi' ].dictionary = Object.assign( e[ 'vi' ].dictionary, translations.dictionary );
+if ( translations.getPluralForm ) {
+e[ 'vi' ].getPluralForm = translations.getPluralForm;
+}
 } )( window.CKEDITOR_TRANSLATIONS ||= {} );

package/dist/translations/zh-cn.js

@@ -2,4 +2,4 @@
  * @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
  */
-export default {"zh-cn":{"dictionary":{"Insert code block":"插入代码块","Plain text":"纯文本","Leaving %0 code snippet":"正在退出 %0 代码片段","Entering %0 code snippet":"正在输入 %0 代码片段","Entering code snippet":"正在输入代码片段","Leaving code snippet":"正在退出代码片段","Code block":"代码块"},getPluralForm(n){return 0;}}}
+export default {"zh-cn":{"dictionary":{"Insert code block":"插入代码块","Plain text":"纯文本","Leaving %0 code snippet":"正在退出 %0 代码片段","Entering %0 code snippet":"正在输入 %0 代码片段","Entering code snippet":"正在输入代码片段","Leaving code snippet":"正在退出代码片段","Code block":"代码块"}}}

package/dist/translations/zh-cn.umd.js

@@ -4,8 +4,10 @@
  */
 
 ( e => {
-const { [ 'zh-cn' ]: { dictionary, getPluralForm } } = {"zh-cn":{"dictionary":{"Insert code block":"插入代码块","Plain text":"纯文本","Leaving %0 code snippet":"正在退出 %0 代码片段","Entering %0 code snippet":"正在输入 %0 代码片段","Entering code snippet":"正在输入代码片段","Leaving code snippet":"正在退出代码片段","Code block":"代码块"},getPluralForm(n){return 0;}}};
+const { [ 'zh-cn' ]: translations } = {"zh-cn":{"dictionary":{"Insert code block":"插入代码块","Plain text":"纯文本","Leaving %0 code snippet":"正在退出 %0 代码片段","Entering %0 code snippet":"正在输入 %0 代码片段","Entering code snippet":"正在输入代码片段","Leaving code snippet":"正在退出代码片段","Code block":"代码块"}}};
 e[ 'zh-cn' ] ||= { dictionary: {}, getPluralForm: null };
-e[ 'zh-cn' ].dictionary = Object.assign( e[ 'zh-cn' ].dictionary, dictionary );
-e[ 'zh-cn' ].getPluralForm = getPluralForm;
+e[ 'zh-cn' ].dictionary = Object.assign( e[ 'zh-cn' ].dictionary, translations.dictionary );
+if ( translations.getPluralForm ) {
+e[ 'zh-cn' ].getPluralForm = translations.getPluralForm;
+}
 } )( window.CKEDITOR_TRANSLATIONS ||= {} );

package/dist/translations/zh.js

@@ -2,4 +2,4 @@
  * @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
  */
-export default {"zh":{"dictionary":{"Insert code block":"插入程式碼區塊","Plain text":"純文字","Leaving %0 code snippet":"離開 %0 程式碼片段","Entering %0 code snippet":"進入 %0 程式碼片段","Entering code snippet":"進入程式碼片段","Leaving code snippet":"離開程式碼片段","Code block":"程式碼區塊"},getPluralForm(n){return 0;}}}
+export default {"zh":{"dictionary":{"Insert code block":"插入程式碼區塊","Plain text":"純文字","Leaving %0 code snippet":"離開 %0 程式碼片段","Entering %0 code snippet":"進入 %0 程式碼片段","Entering code snippet":"進入程式碼片段","Leaving code snippet":"離開程式碼片段","Code block":"程式碼區塊"}}}

package/dist/translations/zh.umd.js

@@ -4,8 +4,10 @@
  */
 
 ( e => {
-const { [ 'zh' ]: { dictionary, getPluralForm } } = {"zh":{"dictionary":{"Insert code block":"插入程式碼區塊","Plain text":"純文字","Leaving %0 code snippet":"離開 %0 程式碼片段","Entering %0 code snippet":"進入 %0 程式碼片段","Entering code snippet":"進入程式碼片段","Leaving code snippet":"離開程式碼片段","Code block":"程式碼區塊"},getPluralForm(n){return 0;}}};
+const { [ 'zh' ]: translations } = {"zh":{"dictionary":{"Insert code block":"插入程式碼區塊","Plain text":"純文字","Leaving %0 code snippet":"離開 %0 程式碼片段","Entering %0 code snippet":"進入 %0 程式碼片段","Entering code snippet":"進入程式碼片段","Leaving code snippet":"離開程式碼片段","Code block":"程式碼區塊"}}};
 e[ 'zh' ] ||= { dictionary: {}, getPluralForm: null };
-e[ 'zh' ].dictionary = Object.assign( e[ 'zh' ].dictionary, dictionary );
-e[ 'zh' ].getPluralForm = getPluralForm;
+e[ 'zh' ].dictionary = Object.assign( e[ 'zh' ].dictionary, translations.dictionary );
+if ( translations.getPluralForm ) {
+e[ 'zh' ].getPluralForm = translations.getPluralForm;
+}
 } )( window.CKEDITOR_TRANSLATIONS ||= {} );

package/dist/utils.d.ts

@@ -1,193 +1,193 @@
 /**
- * @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
- */
+* @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 code-block/utils
- */
-import type { Editor } from '@ckeditor/ckeditor5-core';
-import type { CodeBlockLanguageDefinition } from './codeblockconfig.js';
-import type { ModelDocumentSelection, ModelElement, Model, ModelPosition, ModelSchema, ModelText, ViewUpcastWriter, ViewDocumentFragment } from '@ckeditor/ckeditor5-engine';
-import { type LocaleTranslate } from '@ckeditor/ckeditor5-utils';
+* @module code-block/utils
+*/
+import type { Editor } from "@ckeditor/ckeditor5-core";
+import type { CodeBlockLanguageDefinition } from "./codeblockconfig.js";
+import type { ModelDocumentSelection, ModelElement, Model, ModelPosition, ModelSchema, ModelText, ViewUpcastWriter, ViewDocumentFragment } from "@ckeditor/ckeditor5-engine";
+import { type LocaleTranslate } from "@ckeditor/ckeditor5-utils";
 /**
- * Returns code block languages as defined in `config.codeBlock.languages` but processed:
- *
- * * To consider the editor localization, i.e. to display {@link module:code-block/codeblockconfig~CodeBlockLanguageDefinition}
- * in the correct language. 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.
- * * To make sure each definition has a CSS class associated with it even if not specified
- * in the original configuration.
- *
- * @internal
- */
+* Returns code block languages as defined in `config.codeBlock.languages` but processed:
+*
+* * To consider the editor localization, i.e. to display {@link module:code-block/codeblockconfig~CodeBlockLanguageDefinition}
+* in the correct language. 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.
+* * To make sure each definition has a CSS class associated with it even if not specified
+* in the original configuration.
+*
+* @internal
+*/
 export declare function getNormalizedAndLocalizedLanguageDefinitions(editor: Editor): Array<CodeBlockLanguageDefinition>;
 /**
- * Returns an object associating certain language definition properties with others. For instance:
- *
- * For:
- *
- * ```ts
- * const definitions = {
- * 	{ language: 'php', class: 'language-php', label: 'PHP' },
- * 	{ language: 'javascript', class: 'js', label: 'JavaScript' },
- * };
- *
- * getPropertyAssociation( definitions, 'class', 'language' );
- * ```
- *
- * returns:
- *
- * ```ts
- * {
- * 	'language-php': 'php',
- * 	'js': 'javascript'
- * }
- * ```
- *
- * and
- *
- * ```ts
- * getPropertyAssociation( definitions, 'language', 'label' );
- * ```
- *
- * returns:
- *
- * ```ts
- * {
- * 	'php': 'PHP',
- * 	'javascript': 'JavaScript'
- * }
- * ```
- *
- * @internal
- */
+* Returns an object associating certain language definition properties with others. For instance:
+*
+* For:
+*
+* ```ts
+* const definitions = {
+* 	{ language: 'php', class: 'language-php', label: 'PHP' },
+* 	{ language: 'javascript', class: 'js', label: 'JavaScript' },
+* };
+*
+* getPropertyAssociation( definitions, 'class', 'language' );
+* ```
+*
+* returns:
+*
+* ```ts
+* {
+* 	'language-php': 'php',
+* 	'js': 'javascript'
+* }
+* ```
+*
+* and
+*
+* ```ts
+* getPropertyAssociation( definitions, 'language', 'label' );
+* ```
+*
+* returns:
+*
+* ```ts
+* {
+* 	'php': 'PHP',
+* 	'javascript': 'JavaScript'
+* }
+* ```
+*
+* @internal
+*/
 export declare function getPropertyAssociation(languageDefs: Array<CodeBlockLanguageDefinition>, key: keyof CodeBlockLanguageDefinition, value: keyof CodeBlockLanguageDefinition): Record<string, string>;
 /**
- * For a given model text node, it returns white spaces that precede other characters in that node.
- * This corresponds to the indentation part of the code block line.
- *
- * @internal
- */
+* For a given model text node, it returns white spaces that precede other characters in that node.
+* This corresponds to the indentation part of the code block line.
+*
+* @internal
+*/
 export declare function getLeadingWhiteSpaces(textNode: ModelText): string;
 /**
- * For plain text containing the code (a snippet), it returns a document fragment containing
- * view text nodes separated by `<br>` elements (in place of new line characters "\n"), for instance:
- *
- * Input:
- *
- * ```ts
- * "foo()\n
- * bar()"
- * ```
- *
- * Output:
- *
- * ```html
- * <DocumentFragment>
- * 	"foo()"
- * 	<br/>
- * 	"bar()"
- * </DocumentFragment>
- * ```
- *
- * @param text The raw code text to be converted.
- * @internal
- */
+* For plain text containing the code (a snippet), it returns a document fragment containing
+* view text nodes separated by `<br>` elements (in place of new line characters "\n"), for instance:
+*
+* Input:
+*
+* ```ts
+* "foo()\n
+* bar()"
+* ```
+*
+* Output:
+*
+* ```html
+* <DocumentFragment>
+* 	"foo()"
+* 	<br/>
+* 	"bar()"
+* </DocumentFragment>
+* ```
+*
+* @param text The raw code text to be converted.
+* @internal
+*/
 export declare function rawSnippetTextToViewDocumentFragment(writer: ViewUpcastWriter, text: string): ViewDocumentFragment;
 /**
- * Returns an array of all model positions within the selection that represent code block lines.
- *
- * If the selection is collapsed, it returns the exact selection anchor position:
- *
- * ```html
- * <codeBlock>[]foo</codeBlock>        ->     <codeBlock>^foo</codeBlock>
- * <codeBlock>foo[]bar</codeBlock>     ->     <codeBlock>foo^bar</codeBlock>
- * ```
- *
- * Otherwise, it returns positions **before** each text node belonging to all code blocks contained by the selection:
- *
- * ```html
- * <codeBlock>                                <codeBlock>
- *     foo[bar                                   ^foobar
- *     <softBreak></softBreak>         ->        <softBreak></softBreak>
- *     baz]qux                                   ^bazqux
- * </codeBlock>                               </codeBlock>
- * ```
- *
- * It also works across other non–code blocks:
- *
- * ```html
- * <codeBlock>                                <codeBlock>
- *     foo[bar                                   ^foobar
- * </codeBlock>                               </codeBlock>
- * <paragraph>text</paragraph>         ->     <paragraph>text</paragraph>
- * <codeBlock>                                <codeBlock>
- *     baz]qux                                   ^bazqux
- * </codeBlock>                               </codeBlock>
- * ```
- *
- * **Note:** The positions are in reverse order so they do not get outdated when iterating over them and
- * the writer inserts or removes elements at the same time.
- *
- * **Note:** The position is located after the leading white spaces in the text node.
- *
- * @internal
- */
+* Returns an array of all model positions within the selection that represent code block lines.
+*
+* If the selection is collapsed, it returns the exact selection anchor position:
+*
+* ```html
+* <codeBlock>[]foo</codeBlock>        ->     <codeBlock>^foo</codeBlock>
+* <codeBlock>foo[]bar</codeBlock>     ->     <codeBlock>foo^bar</codeBlock>
+* ```
+*
+* Otherwise, it returns positions **before** each text node belonging to all code blocks contained by the selection:
+*
+* ```html
+* <codeBlock>                                <codeBlock>
+*     foo[bar                                   ^foobar
+*     <softBreak></softBreak>         ->        <softBreak></softBreak>
+*     baz]qux                                   ^bazqux
+* </codeBlock>                               </codeBlock>
+* ```
+*
+* It also works across other non–code blocks:
+*
+* ```html
+* <codeBlock>                                <codeBlock>
+*     foo[bar                                   ^foobar
+* </codeBlock>                               </codeBlock>
+* <paragraph>text</paragraph>         ->     <paragraph>text</paragraph>
+* <codeBlock>                                <codeBlock>
+*     baz]qux                                   ^bazqux
+* </codeBlock>                               </codeBlock>
+* ```
+*
+* **Note:** The positions are in reverse order so they do not get outdated when iterating over them and
+* the writer inserts or removes elements at the same time.
+*
+* **Note:** The position is located after the leading white spaces in the text node.
+*
+* @internal
+*/
 export declare function getIndentOutdentPositions(model: Model): Array<ModelPosition>;
 /**
- * Checks if any of the blocks within the model selection is a code block.
- *
- * @internal
- */
+* Checks if any of the blocks within the model selection is a code block.
+*
+* @internal
+*/
 export declare function isModelSelectionInCodeBlock(selection: ModelDocumentSelection): boolean;
 /**
- * Checks if an {@link module:engine/model/element~ModelElement Element} can become a code block.
- *
- * @param schema Model's schema.
- * @param element The element to be checked.
- * @returns Check result.
- * @internal
- */
+* Checks if an {@link module:engine/model/element~ModelElement Element} can become a code block.
+*
+* @param schema Model's schema.
+* @param element The element to be checked.
+* @returns Check result.
+* @internal
+*/
 export declare function canBeCodeBlock(schema: ModelSchema, element: ModelElement): boolean;
 /**
- * Get the translated message read by the screen reader when you enter or exit an element with your cursor.
- *
- * @internal
- */
-export declare function getCodeBlockAriaAnnouncement(t: LocaleTranslate, languageDefs: Array<CodeBlockLanguageDefinition>, element: ModelElement, direction: 'enter' | 'leave'): string;
+* Get the translated message read by the screen reader when you enter or exit an element with your cursor.
+*
+* @internal
+*/
+export declare function getCodeBlockAriaAnnouncement(t: LocaleTranslate, languageDefs: Array<CodeBlockLanguageDefinition>, element: ModelElement, direction: "enter" | "leave"): string;
 /**
- * For given position, finds the closest position that is at the beginning of a line of code and returns a text node that is at the
- * beginning of the line (or `null` if there's no text node at the beginning of a given line).
- *
- * Line beings at the start of a code block element and after each `softBreak` element.
- *
- * Note: even though code block doesn't allow inline elements other than `<softBreak>` by default, some features may overwrite this rule,
- * so such inline elements are taken into account.
- *
- * Some examples of expected results:
- *
- * ```
- * <codeBlock>^</codeBlock>                                ->   null
- * <codeBlock>^foobar</codeBlock>                          ->   <codeBlock>[foobar]</codeBlock>
- * <codeBlock>foobar^</codeBlock>                          ->   <codeBlock>[foobar]</codeBlock>
- * <codeBlock>foo^bar</codeBlock>                          ->   <codeBlock>[foobar]</codeBlock>
- * <codeBlock>foo^<softBreak />bar</codeBlock>             ->   <codeBlock>[foo]<softBreak />bar</codeBlock>
- * <codeBlock>foo<softBreak />bar^</codeBlock>             ->   <codeBlock>foo<softBreak />[bar]</codeBlock>
- * <codeBlock>foo<softBreak />b^ar</codeBlock>             ->   <codeBlock>foo<softBreak />[bar]</codeBlock>
- * <codeBlock>foo<softBreak />^bar</codeBlock>             ->   <codeBlock>foo<softBreak />[bar]</codeBlock>
- * <codeBlock>^<element /></codeBlock>                     ->   null
- * <codeBlock><element />^</codeBlock>                     ->   null
- * <codeBlock>foo^<element /></codeBlock>                  ->   <codeBlock>[foo]<element /></codeBlock>
- * <codeBlock>foo<element />^</codeBlock>                  ->   <codeBlock>[foo]<element /></codeBlock>
- * <codeBlock>foo<element />bar^</codeBlock>               ->   <codeBlock>[foo]<element />bar</codeBlock>
- * <codeBlock><element />bar^</codeBlock>                  ->   null
- * <codeBlock>foo<softBreak />^<softBreak /></codeBlock>   ->   null
- * <codeBlock>foo<softBreak />^<element /></codeBlock>     ->   null
- * <codeBlock>foo<softBreak /><element />^</codeBlock>     ->   null
- * <codeBlock>foo<softBreak />bar<element />^</codeBlock>  ->   <codeBlock>foo<softBreak />[bar]<element /></codeBlock>
- * <codeBlock>foo<softBreak /><element />ba^r</codeBlock>  ->   null
- * ```
- *
- * @internal
- */
+* For given position, finds the closest position that is at the beginning of a line of code and returns a text node that is at the
+* beginning of the line (or `null` if there's no text node at the beginning of a given line).
+*
+* Line beings at the start of a code block element and after each `softBreak` element.
+*
+* Note: even though code block doesn't allow inline elements other than `<softBreak>` by default, some features may overwrite this rule,
+* so such inline elements are taken into account.
+*
+* Some examples of expected results:
+*
+* ```
+* <codeBlock>^</codeBlock>                                ->   null
+* <codeBlock>^foobar</codeBlock>                          ->   <codeBlock>[foobar]</codeBlock>
+* <codeBlock>foobar^</codeBlock>                          ->   <codeBlock>[foobar]</codeBlock>
+* <codeBlock>foo^bar</codeBlock>                          ->   <codeBlock>[foobar]</codeBlock>
+* <codeBlock>foo^<softBreak />bar</codeBlock>             ->   <codeBlock>[foo]<softBreak />bar</codeBlock>
+* <codeBlock>foo<softBreak />bar^</codeBlock>             ->   <codeBlock>foo<softBreak />[bar]</codeBlock>
+* <codeBlock>foo<softBreak />b^ar</codeBlock>             ->   <codeBlock>foo<softBreak />[bar]</codeBlock>
+* <codeBlock>foo<softBreak />^bar</codeBlock>             ->   <codeBlock>foo<softBreak />[bar]</codeBlock>
+* <codeBlock>^<element /></codeBlock>                     ->   null
+* <codeBlock><element />^</codeBlock>                     ->   null
+* <codeBlock>foo^<element /></codeBlock>                  ->   <codeBlock>[foo]<element /></codeBlock>
+* <codeBlock>foo<element />^</codeBlock>                  ->   <codeBlock>[foo]<element /></codeBlock>
+* <codeBlock>foo<element />bar^</codeBlock>               ->   <codeBlock>[foo]<element />bar</codeBlock>
+* <codeBlock><element />bar^</codeBlock>                  ->   null
+* <codeBlock>foo<softBreak />^<softBreak /></codeBlock>   ->   null
+* <codeBlock>foo<softBreak />^<element /></codeBlock>     ->   null
+* <codeBlock>foo<softBreak /><element />^</codeBlock>     ->   null
+* <codeBlock>foo<softBreak />bar<element />^</codeBlock>  ->   <codeBlock>foo<softBreak />[bar]<element /></codeBlock>
+* <codeBlock>foo<softBreak /><element />ba^r</codeBlock>  ->   null
+* ```
+*
+* @internal
+*/
 export declare function getTextNodeAtLineStart(position: ModelPosition, model: Model): ModelText | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-code-block",
-  "version": "48.8.1-alpha.4",
+  "version": "49.0.0-alpha.1",
   "description": "Code block feature for CKEditor 5.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "CKSource (http://cksource.com/)",
@@ -26,13 +26,13 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@ckeditor/ckeditor5-core": "48.8.1-alpha.4",
-    "@ckeditor/ckeditor5-clipboard": "48.8.1-alpha.4",
-    "@ckeditor/ckeditor5-engine": "48.8.1-alpha.4",
-    "@ckeditor/ckeditor5-enter": "48.8.1-alpha.4",
-    "@ckeditor/ckeditor5-icons": "48.8.1-alpha.4",
-    "@ckeditor/ckeditor5-ui": "48.8.1-alpha.4",
-    "@ckeditor/ckeditor5-utils": "48.8.1-alpha.4"
+    "@ckeditor/ckeditor5-core": "49.0.0-alpha.1",
+    "@ckeditor/ckeditor5-clipboard": "49.0.0-alpha.1",
+    "@ckeditor/ckeditor5-engine": "49.0.0-alpha.1",
+    "@ckeditor/ckeditor5-enter": "49.0.0-alpha.1",
+    "@ckeditor/ckeditor5-icons": "49.0.0-alpha.1",
+    "@ckeditor/ckeditor5-ui": "49.0.0-alpha.1",
+    "@ckeditor/ckeditor5-utils": "49.0.0-alpha.1"
   },
   "files": [
     "dist",