@ckeditor/ckeditor5-code-block 45.2.1 → 46.0.0-alpha.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-code-block",
-  "version": "45.2.1",
+  "version": "46.0.0-alpha.0",
   "description": "Code block feature for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -13,14 +13,14 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-core": "45.2.1",
-    "@ckeditor/ckeditor5-clipboard": "45.2.1",
-    "@ckeditor/ckeditor5-engine": "45.2.1",
-    "@ckeditor/ckeditor5-enter": "45.2.1",
-    "@ckeditor/ckeditor5-icons": "45.2.1",
-    "@ckeditor/ckeditor5-ui": "45.2.1",
-    "@ckeditor/ckeditor5-utils": "45.2.1",
-    "ckeditor5": "45.2.1"
+    "@ckeditor/ckeditor5-core": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-clipboard": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-engine": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-enter": "46.0.0-alpha.0",
+    "@ckeditor/ckeditor5-icons": "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/codeblock.d.ts

@@ -6,8 +6,8 @@
  * @module code-block/codeblock
  */
 import { Plugin } from 'ckeditor5/src/core.js';
-import CodeBlockEditing from './codeblockediting.js';
-import CodeBlockUI from './codeblockui.js';
+import { CodeBlockEditing } from './codeblockediting.js';
+import { CodeBlockUI } from './codeblockui.js';
 /**
  * The code block plugin.
  *
@@ -17,7 +17,7 @@ import CodeBlockUI from './codeblockui.js';
  * This is a "glue" plugin that loads the {@link module:code-block/codeblockediting~CodeBlockEditing code block editing feature}
  * and the {@link module:code-block/codeblockui~CodeBlockUI code block UI feature}.
  */
-export default class CodeBlock extends Plugin {
+export declare class CodeBlock extends Plugin {
     /**
      * @inheritDoc
      */

package/src/codeblock.js

@@ -6,8 +6,8 @@
  * @module code-block/codeblock
  */
 import { Plugin } from 'ckeditor5/src/core.js';
-import CodeBlockEditing from './codeblockediting.js';
-import CodeBlockUI from './codeblockui.js';
+import { CodeBlockEditing } from './codeblockediting.js';
+import { CodeBlockUI } from './codeblockui.js';
 /**
  * The code block plugin.
  *
@@ -17,7 +17,7 @@ import CodeBlockUI from './codeblockui.js';
  * This is a "glue" plugin that loads the {@link module:code-block/codeblockediting~CodeBlockEditing code block editing feature}
  * and the {@link module:code-block/codeblockui~CodeBlockUI code block UI feature}.
  */
-export default class CodeBlock extends Plugin {
+export class CodeBlock extends Plugin {
     /**
      * @inheritDoc
      */

package/src/codeblockcommand.d.ts

@@ -6,7 +6,7 @@ import { Command, type Editor } from 'ckeditor5/src/core.js';
 /**
  * The code block command plugin.
  */
-export default class CodeBlockCommand extends Command {
+export declare class CodeBlockCommand extends Command {
     /**
      * Contains the last used language.
      */

package/src/codeblockcommand.js

@@ -8,7 +8,7 @@ import { getNormalizedAndLocalizedLanguageDefinitions, canBeCodeBlock } from './
 /**
  * The code block command plugin.
  */
-export default class CodeBlockCommand extends Command {
+export class CodeBlockCommand extends Command {
     /**
      * Contains the last used language.
      */

package/src/codeblockediting.d.ts

@@ -12,7 +12,7 @@ import { ShiftEnter } from 'ckeditor5/src/enter.js';
  *
  * Introduces the `'codeBlock'` command and the `'codeBlock'` model element.
  */
-export default class CodeBlockEditing extends Plugin {
+export declare class CodeBlockEditing extends Plugin {
     /**
      * @inheritDoc
      */

package/src/codeblockediting.js

@@ -7,11 +7,11 @@
  */
 import { Plugin } from 'ckeditor5/src/core.js';
 import { ShiftEnter } from 'ckeditor5/src/enter.js';
-import { UpcastWriter } from 'ckeditor5/src/engine.js';
+import { ViewUpcastWriter } from 'ckeditor5/src/engine.js';
 import { ClipboardPipeline } from 'ckeditor5/src/clipboard.js';
-import CodeBlockCommand from './codeblockcommand.js';
-import IndentCodeBlockCommand from './indentcodeblockcommand.js';
-import OutdentCodeBlockCommand from './outdentcodeblockcommand.js';
+import { CodeBlockCommand } from './codeblockcommand.js';
+import { IndentCodeBlockCommand } from './indentcodeblockcommand.js';
+import { OutdentCodeBlockCommand } from './outdentcodeblockcommand.js';
 import { getNormalizedAndLocalizedLanguageDefinitions, getLeadingWhiteSpaces, rawSnippetTextToViewDocumentFragment, getCodeBlockAriaAnnouncement, getTextNodeAtLineStart } from './utils.js';
 import { modelToViewCodeBlockInsertion, modelToDataViewSoftBreakInsertion, dataViewToModelCodeBlockInsertion, dataViewToModelTextNewlinesInsertion, dataViewToModelOrphanNodeConsumer } from './converters.js';
 const DEFAULT_ELEMENT = 'paragraph';
@@ -20,7 +20,7 @@ const DEFAULT_ELEMENT = 'paragraph';
  *
  * Introduces the `'codeBlock'` command and the `'codeBlock'` model element.
  */
-export default class CodeBlockEditing extends Plugin {
+export class CodeBlockEditing extends Plugin {
     /**
      * @inheritDoc
      */
@@ -129,7 +129,7 @@ export default class CodeBlockEditing extends Plugin {
                 return;
             }
             const text = data.dataTransfer.getData('text/plain');
-            const writer = new UpcastWriter(editor.editing.view.document);
+            const writer = new ViewUpcastWriter(editor.editing.view.document);
             // Pass the view fragment to the default clipboardInput handler.
             data.content = rawSnippetTextToViewDocumentFragment(writer, text);
         });

package/src/codeblockui.d.ts

@@ -12,7 +12,7 @@ import '../theme/codeblock.css';
  *
  * Introduces the `'codeBlock'` dropdown.
  */
-export default class CodeBlockUI extends Plugin {
+export declare class CodeBlockUI extends Plugin {
     /**
      * @inheritDoc
      */

package/src/codeblockui.js

@@ -7,7 +7,7 @@
  */
 import { Plugin } from 'ckeditor5/src/core.js';
 import { Collection } from 'ckeditor5/src/utils.js';
-import { ViewModel, SplitButtonView, createDropdown, addListToDropdown, MenuBarMenuListItemButtonView, MenuBarMenuListView, MenuBarMenuView, MenuBarMenuListItemView } from 'ckeditor5/src/ui.js';
+import { UIModel, SplitButtonView, createDropdown, addListToDropdown, MenuBarMenuListItemButtonView, MenuBarMenuListView, MenuBarMenuView, MenuBarMenuListItemView } from 'ckeditor5/src/ui.js';
 import { IconCodeBlock } from 'ckeditor5/src/icons.js';
 import { getNormalizedAndLocalizedLanguageDefinitions } from './utils.js';
 import '../theme/codeblock.css';
@@ -16,7 +16,7 @@ import '../theme/codeblock.css';
  *
  * Introduces the `'codeBlock'` dropdown.
  */
-export default class CodeBlockUI extends Plugin {
+export class CodeBlockUI extends Plugin {
     /**
      * @inheritDoc
      */
@@ -117,7 +117,7 @@ export default class CodeBlockUI extends Plugin {
         for (const languageDef of normalizedLanguageDefs) {
             const definition = {
                 type: 'button',
-                model: new ViewModel({
+                model: new UIModel({
                     _codeBlockLanguage: languageDef.language,
                     label: languageDef.label,
                     role: 'menuitemradio',

package/src/converters.d.ts

@@ -33,6 +33,7 @@ import type { CodeBlockLanguageDefinition } from './codeblockconfig.js';
  * @param useLabels When `true`, the `<pre>` element will get a `data-language` attribute with a
  * human–readable label of the language. Used only in the editing.
  * @returns Returns a conversion callback.
+ * @internal
  */
 export declare function modelToViewCodeBlockInsertion(model: Model, languageDefs: Array<CodeBlockLanguageDefinition>, useLabels?: boolean): GetCallback<DowncastInsertEvent>;
 /**
@@ -51,6 +52,7 @@ export declare function modelToViewCodeBlockInsertion(model: Model, languageDefs
  * ```
  *
  * @returns Returns a conversion callback.
+ * @internal
  */
 export declare function modelToDataViewSoftBreakInsertion(model: Model): GetCallback<DowncastInsertEvent>;
 /**
@@ -70,6 +72,7 @@ export declare function modelToDataViewSoftBreakInsertion(model: Model): GetCall
  *
  * @param languageDefs The normalized language configuration passed to the feature.
  * @returns Returns a conversion callback.
+ * @internal
  */
 export declare function dataViewToModelCodeBlockInsertion(editingView: EditingView, languageDefs: Array<CodeBlockLanguageDefinition>): GetCallback<UpcastElementEvent>;
 /**
@@ -88,6 +91,7 @@ export declare function dataViewToModelCodeBlockInsertion(editingView: EditingVi
  * ```
  *
  * @returns {Function} Returns a conversion callback.
+ * @internal
  */
 export declare function dataViewToModelTextNewlinesInsertion(): GetCallback<UpcastTextEvent>;
 /**
@@ -122,5 +126,6 @@ export declare function dataViewToModelTextNewlinesInsertion(): GetCallback<Upca
  * ```
  *
  * @returns Returns a conversion callback.
+ * @internal
  */
 export declare function dataViewToModelOrphanNodeConsumer(): GetCallback<UpcastElementEvent>;

package/src/converters.js

@@ -28,6 +28,7 @@ import { getPropertyAssociation } from './utils.js';
  * @param useLabels When `true`, the `<pre>` element will get a `data-language` attribute with a
  * human–readable label of the language. Used only in the editing.
  * @returns Returns a conversion callback.
+ * @internal
  */
 export function modelToViewCodeBlockInsertion(model, languageDefs, useLabels = false) {
     // Language CSS classes:
@@ -86,6 +87,7 @@ export function modelToViewCodeBlockInsertion(model, languageDefs, useLabels = f
  * ```
  *
  * @returns Returns a conversion callback.
+ * @internal
  */
 export function modelToDataViewSoftBreakInsertion(model) {
     return (evt, data, conversionApi) => {
@@ -117,6 +119,7 @@ export function modelToDataViewSoftBreakInsertion(model) {
  *
  * @param languageDefs The normalized language configuration passed to the feature.
  * @returns Returns a conversion callback.
+ * @internal
  */
 export function dataViewToModelCodeBlockInsertion(editingView, languageDefs) {
     // Language names associated with CSS classes:
@@ -156,6 +159,7 @@ export function dataViewToModelCodeBlockInsertion(editingView, languageDefs) {
         for (const className of viewChildClasses) {
             const language = classesToLanguages[className];
             if (language) {
+                consumable.consume(viewCodeElement, { classes: [className] });
                 writer.setAttribute('language', language, codeBlock);
                 break;
             }
@@ -191,6 +195,7 @@ export function dataViewToModelCodeBlockInsertion(editingView, languageDefs) {
  * ```
  *
  * @returns {Function} Returns a conversion callback.
+ * @internal
  */
 export function dataViewToModelTextNewlinesInsertion() {
     return (evt, data, { consumable, writer }) => {
@@ -252,6 +257,7 @@ export function dataViewToModelTextNewlinesInsertion() {
  * ```
  *
  * @returns Returns a conversion callback.
+ * @internal
  */
 export function dataViewToModelOrphanNodeConsumer() {
     return (evt, data, { consumable }) => {

package/src/indentcodeblockcommand.d.ts

@@ -9,7 +9,7 @@ import { Command, type Editor } from 'ckeditor5/src/core.js';
 /**
  * The code block indentation increase command plugin.
  */
-export default class IndentCodeBlockCommand extends Command {
+export declare class IndentCodeBlockCommand extends Command {
     /**
      * A sequence of characters added to the line when the command is executed.
      */

package/src/indentcodeblockcommand.js

@@ -10,7 +10,7 @@ import { getIndentOutdentPositions, isModelSelectionInCodeBlock } from './utils.
 /**
  * The code block indentation increase command plugin.
  */
-export default class IndentCodeBlockCommand extends Command {
+export class IndentCodeBlockCommand extends Command {
     /**
      * A sequence of characters added to the line when the command is executed.
      */

package/src/index.d.ts

@@ -5,11 +5,13 @@
 /**
  * @module code-block
  */
-export { default as CodeBlock } from './codeblock.js';
-export { default as CodeBlockEditing } from './codeblockediting.js';
-export { default as CodeBlockUI } from './codeblockui.js';
-export type { default as CodeBlockCommand } from './codeblockcommand.js';
-export type { default as IndentCodeBlockCommand } from './indentcodeblockcommand.js';
-export type { default as OutdentCodeBlockCommand } from './outdentcodeblockcommand.js';
-export type { CodeBlockConfig } from './codeblockconfig.js';
+export { CodeBlock } from './codeblock.js';
+export { CodeBlockEditing } from './codeblockediting.js';
+export { CodeBlockUI } from './codeblockui.js';
+export { CodeBlockCommand } from './codeblockcommand.js';
+export { IndentCodeBlockCommand } from './indentcodeblockcommand.js';
+export { OutdentCodeBlockCommand } from './outdentcodeblockcommand.js';
+export type { CodeBlockConfig, CodeBlockLanguageDefinition } from './codeblockconfig.js';
+export { modelToViewCodeBlockInsertion as _modelToViewCodeBlockInsertion, modelToDataViewSoftBreakInsertion as _modelToDataViewCodeBlockSoftBreakInsertion, dataViewToModelCodeBlockInsertion as _dataViewToModelCodeBlockInsertion, dataViewToModelTextNewlinesInsertion as _dataViewToModelCodeBlockTextNewlinesInsertion, dataViewToModelOrphanNodeConsumer as _dataViewToModelCodeBlockOrphanNodeConsumer } from './converters.js';
+export { getNormalizedAndLocalizedLanguageDefinitions as _getNormalizedAndLocalizedCodeBlockLanguageDefinitions, getPropertyAssociation as _getCodeBlockPropertyAssociation, getLeadingWhiteSpaces as _getCodeBlockLeadingWhiteSpaces, rawSnippetTextToViewDocumentFragment as _rawCodeBlockSnippetTextToViewDocumentFragment, getIndentOutdentPositions as _getCodeBlockIndentOutdentPositions, isModelSelectionInCodeBlock as _isModelSelectionInCodeBlock, canBeCodeBlock as _canBeCodeBlock, getCodeBlockAriaAnnouncement as _getCodeBlockAriaAnnouncement, getTextNodeAtLineStart as _getCodeBlockTextNodeAtLineStart } from './utils.js';
 import './augmentation.js';

package/src/index.js

@@ -5,7 +5,12 @@
 /**
  * @module code-block
  */
-export { default as CodeBlock } from './codeblock.js';
-export { default as CodeBlockEditing } from './codeblockediting.js';
-export { default as CodeBlockUI } from './codeblockui.js';
+export { CodeBlock } from './codeblock.js';
+export { CodeBlockEditing } from './codeblockediting.js';
+export { CodeBlockUI } from './codeblockui.js';
+export { CodeBlockCommand } from './codeblockcommand.js';
+export { IndentCodeBlockCommand } from './indentcodeblockcommand.js';
+export { OutdentCodeBlockCommand } from './outdentcodeblockcommand.js';
+export { modelToViewCodeBlockInsertion as _modelToViewCodeBlockInsertion, modelToDataViewSoftBreakInsertion as _modelToDataViewCodeBlockSoftBreakInsertion, dataViewToModelCodeBlockInsertion as _dataViewToModelCodeBlockInsertion, dataViewToModelTextNewlinesInsertion as _dataViewToModelCodeBlockTextNewlinesInsertion, dataViewToModelOrphanNodeConsumer as _dataViewToModelCodeBlockOrphanNodeConsumer } from './converters.js';
+export { getNormalizedAndLocalizedLanguageDefinitions as _getNormalizedAndLocalizedCodeBlockLanguageDefinitions, getPropertyAssociation as _getCodeBlockPropertyAssociation, getLeadingWhiteSpaces as _getCodeBlockLeadingWhiteSpaces, rawSnippetTextToViewDocumentFragment as _rawCodeBlockSnippetTextToViewDocumentFragment, getIndentOutdentPositions as _getCodeBlockIndentOutdentPositions, isModelSelectionInCodeBlock as _isModelSelectionInCodeBlock, canBeCodeBlock as _canBeCodeBlock, getCodeBlockAriaAnnouncement as _getCodeBlockAriaAnnouncement, getTextNodeAtLineStart as _getCodeBlockTextNodeAtLineStart } from './utils.js';
 import './augmentation.js';

package/src/outdentcodeblockcommand.d.ts

@@ -6,7 +6,7 @@ import { Command, type Editor } from 'ckeditor5/src/core.js';
 /**
  * The code block indentation decrease command plugin.
  */
-export default class OutdentCodeBlockCommand extends Command {
+export declare class OutdentCodeBlockCommand extends Command {
     /**
      * A sequence of characters removed from the line when the command is executed.
      */

package/src/outdentcodeblockcommand.js

@@ -7,7 +7,7 @@ import { getLeadingWhiteSpaces, getIndentOutdentPositions, isModelSelectionInCod
 /**
  * The code block indentation decrease command plugin.
  */
-export default class OutdentCodeBlockCommand extends Command {
+export class OutdentCodeBlockCommand extends Command {
     /**
      * A sequence of characters removed from the line when the command is executed.
      */
@@ -100,9 +100,9 @@ export default class OutdentCodeBlockCommand extends Command {
 //		<codeBlock>    ^foo    bar</codeBlock>                      ->          <codeBlock>[    ]foo    bar</codeBlock>
 //
 // @param {<module:engine/model/model~Model>} model
-// @param {<module:engine/model/position~Position>} position
+// @param {<module:engine/model/position~ModelPosition>} position
 // @param {String} sequence
-// @returns {<module:engine/model/range~Range>|null}
+// @returns {<module:engine/model/range~ModelRange>|null}
 function getLastOutdentableSequenceRange(model, position, sequence) {
     // Positions start before each text node (code line). Get the node corresponding to the position.
     const nodeAtPosition = getTextNodeAtLineStart(position, model);

package/src/utils.d.ts

@@ -7,7 +7,7 @@
  */
 import type { Editor } from 'ckeditor5/src/core.js';
 import type { CodeBlockLanguageDefinition } from './codeblockconfig.js';
-import type { DocumentSelection, Element, Model, Position, Schema, Text, UpcastWriter, ViewDocumentFragment } from 'ckeditor5/src/engine.js';
+import type { ModelDocumentSelection, ModelElement, Model, ModelPosition, ModelSchema, ModelText, ViewUpcastWriter, ViewDocumentFragment } from 'ckeditor5/src/engine.js';
 import { type LocaleTranslate } from 'ckeditor5/src/utils.js';
 /**
  * Returns code block languages as defined in `config.codeBlock.languages` but processed:
@@ -17,6 +17,8 @@ import { type LocaleTranslate } from 'ckeditor5/src/utils.js';
  * 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>;
 /**
@@ -56,13 +58,17 @@ export declare function getNormalizedAndLocalizedLanguageDefinitions(editor: Edi
  * 	'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
  */
-export declare function getLeadingWhiteSpaces(textNode: Text): string;
+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:
@@ -85,8 +91,9 @@ export declare function getLeadingWhiteSpaces(textNode: Text): string;
  * ```
  *
  * @param text The raw code text to be converted.
+ * @internal
  */
-export declare function rawSnippetTextToViewDocumentFragment(writer: UpcastWriter, text: string): ViewDocumentFragment;
+export declare function rawSnippetTextToViewDocumentFragment(writer: ViewUpcastWriter, text: string): ViewDocumentFragment;
 /**
  * Returns an array of all model positions within the selection that represent code block lines.
  *
@@ -123,24 +130,31 @@ export declare function rawSnippetTextToViewDocumentFragment(writer: UpcastWrite
  * 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<Position>;
+export declare function getIndentOutdentPositions(model: Model): Array<ModelPosition>;
 /**
  * Checks if any of the blocks within the model selection is a code block.
+ *
+ * @internal
  */
-export declare function isModelSelectionInCodeBlock(selection: DocumentSelection): boolean;
+export declare function isModelSelectionInCodeBlock(selection: ModelDocumentSelection): boolean;
 /**
- * Checks if an {@link module:engine/model/element~Element Element} can become a code block.
+ * 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: Schema, element: Element): boolean;
+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: Element, direction: 'enter' | 'leave'): string;
+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).
@@ -173,5 +187,7 @@ export declare function getCodeBlockAriaAnnouncement(t: LocaleTranslate, languag
  * <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: Position, model: Model): Text | null;
+export declare function getTextNodeAtLineStart(position: ModelPosition, model: Model): ModelText | null;

package/src/utils.js

@@ -11,6 +11,8 @@ import { first } from 'ckeditor5/src/utils.js';
  * 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 function getNormalizedAndLocalizedLanguageDefinitions(editor) {
     const t = editor.t;
@@ -62,6 +64,8 @@ export function getNormalizedAndLocalizedLanguageDefinitions(editor) {
  * 	'javascript': 'JavaScript'
  * }
  * ```
+ *
+ * @internal
  */
 export function getPropertyAssociation(languageDefs, key, value) {
     const association = {};
@@ -80,6 +84,8 @@ export function getPropertyAssociation(languageDefs, key, value) {
 /**
  * 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 function getLeadingWhiteSpaces(textNode) {
     return textNode.data.match(/^(\s*)/)[0];
@@ -106,6 +112,7 @@ export function getLeadingWhiteSpaces(textNode) {
  * ```
  *
  * @param text The raw code text to be converted.
+ * @internal
  */
 export function rawSnippetTextToViewDocumentFragment(writer, text) {
     const fragment = writer.createDocumentFragment();
@@ -156,6 +163,8 @@ export function rawSnippetTextToViewDocumentFragment(writer, text) {
  * 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 function getIndentOutdentPositions(model) {
     const selection = model.document.selection;
@@ -195,17 +204,20 @@ export function getIndentOutdentPositions(model) {
 }
 /**
  * Checks if any of the blocks within the model selection is a code block.
+ *
+ * @internal
  */
 export function isModelSelectionInCodeBlock(selection) {
     const firstBlock = first(selection.getSelectedBlocks());
     return !!firstBlock && firstBlock.is('element', 'codeBlock');
 }
 /**
- * Checks if an {@link module:engine/model/element~Element Element} can become a code block.
+ * 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 function canBeCodeBlock(schema, element) {
     if (element.is('rootElement') || schema.isLimit(element)) {
@@ -215,6 +227,8 @@ export function canBeCodeBlock(schema, element) {
 }
 /**
  * Get the translated message read by the screen reader when you enter or exit an element with your cursor.
+ *
+ * @internal
  */
 export function getCodeBlockAriaAnnouncement(t, languageDefs, element, direction) {
     const languagesToLabels = getPropertyAssociation(languageDefs, 'language', 'label');
@@ -263,6 +277,8 @@ export function getCodeBlockAriaAnnouncement(t, languageDefs, element, direction
  * <codeBlock>foo<softBreak />bar<element />^</codeBlock>  ->   <codeBlock>foo<softBreak />[bar]<element /></codeBlock>
  * <codeBlock>foo<softBreak /><element />ba^r</codeBlock>  ->   null
  * ```
+ *
+ * @internal
  */
 export function getTextNodeAtLineStart(position, model) {
     // First, move position before a text node, if it is inside a text node.