@ckeditor/ckeditor5-engine 48.0.1-alpha.1 → 48.1.0-alpha.0

package/dist/model/history.d.ts

@@ -2,10 +2,10 @@
  * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
-import { type Operation } from './operation/operation.js';
 /**
  * @module engine/model/history
  */
+import { type Operation } from './operation/operation.js';
 /**
  * `History` keeps the track of all the operations applied to the {@link module:engine/model/document~ModelDocument document}.
  */

package/dist/model/item.d.ts

@@ -2,11 +2,11 @@
  * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
-import { type ModelNode } from './node.js';
-import { type ModelTextProxy } from './textproxy.js';
 /**
  * @module engine/model/item
  */
+import { type ModelNode } from './node.js';
+import { type ModelTextProxy } from './textproxy.js';
 /**
  * Item is a {@link module:engine/model/node~ModelNode} or {@link module:engine/model/textproxy~ModelTextProxy}.
  */

package/dist/model/schema.d.ts

@@ -1332,8 +1332,29 @@ export interface ModelAttributeProperties {
      * @default true
      */
     copyFromObject?: boolean;
+    /**
+     * Defines the mapping of all possible block alignments for a specific model element.
+     * It is used by features that need to determine whether an element can be aligned,
+     * and apply the alignment if possible.
+     */
+    blockAlignment?: ModelBlockAlignmentAttributesMapping | ((element: ModelElement) => ModelBlockAlignmentAttributesMapping);
     [name: string]: unknown;
 }
+/**
+ * Defines the mapping of block alignment options for a model element attribute.
+ *
+ * Each key represents a logical alignment name (e.g. `'left'`, `'center'`, `'right'`, `'justify'`),
+ * and the corresponding value describes how that alignment is represented in the model — including
+ * the actual attribute value and whether it should be treated as the default alignment for the element.
+ *
+ * Used by features that need to determine whether a model element supports block alignment
+ * and how to apply it. Can be provided as a static object or as a function receiving the element
+ * and returning the mapping dynamically, via {@link ~ModelAttributeProperties#blockAlignment}.
+ */
+export type ModelBlockAlignmentAttributesMapping = Record<string, {
+    isDefault?: boolean;
+    value: string;
+}>;
 export type ModelSchemaAttributeCheckCallback = (context: ModelSchemaContext, attributeName: string) => boolean | undefined;
 export type ModelSchemaChildCheckCallback = (context: ModelSchemaContext, definition: ModelSchemaCompiledItemDefinition) => boolean | undefined;
 export {};

package/dist/model/utils/autoparagraphing.d.ts

@@ -2,13 +2,13 @@
  * @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 engine/model/utils/autoparagraphing
+ */
 import { type ModelNode } from '../node.js';
 import { type ModelPosition } from '../position.js';
 import { type ModelSchema } from '../schema.js';
 import { type ModelWriter } from '../writer.js';
-/**
- * @module engine/model/utils/autoparagraphing
- */
 /**
  * Fixes all empty roots.
  *

package/dist/model/utils/getselectedcontent.d.ts

@@ -2,13 +2,13 @@
  * @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 engine/model/utils/getselectedcontent
+ */
 import { type ModelDocumentFragment } from '../documentfragment.js';
 import { type ModelDocumentSelection } from '../documentselection.js';
 import { type Model } from '../model.js';
 import { type ModelSelection } from '../selection.js';
-/**
- * @module engine/model/utils/getselectedcontent
- */
 /**
  * Gets a clone of the selected content.
  *

package/dist/view/document.d.ts

@@ -92,6 +92,10 @@ export declare class ViewDocument extends /* #__PURE__ */ ViewDocument_base {
      * @returns The view root element with the specified name or null when there is no root of given name.
      */
     getRoot(name?: string): ViewRootEditableElement | null;
+    /**
+     * Returns an array with all roots added to the document.
+     */
+    getRoots(): Array<ViewRootEditableElement>;
     /**
      * Allows registering post-fixer callbacks. A post-fixers mechanism allows to update the view tree just before it is rendered
      * to the DOM.

package/dist/view/filler.d.ts

@@ -3,34 +3,6 @@
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import { type EditingView } from './view.js';
-/**
- * Set of utilities related to handling block and inline fillers.
- *
- * Browsers do not allow to put caret in elements which does not have height. Because of it, we need to fill all
- * empty elements which should be selectable with elements or characters called "fillers". Unfortunately there is no one
- * universal filler, this is why two types are uses:
- *
- * * Block filler is an element which fill block elements, like `<p>`. CKEditor uses `<br>` as a block filler during the editing,
- * as browsers do natively. So instead of an empty `<p>` there will be `<p><br></p>`. The advantage of block filler is that
- * it is transparent for the selection, so when the caret is before the `<br>` and user presses right arrow he will be
- * moved to the next paragraph, not after the `<br>`. The disadvantage is that it breaks a block, so it cannot be used
- * in the middle of a line of text. The {@link module:engine/view/filler~BR_FILLER `<br>` filler} can be replaced with any other
- * character in the data output, for instance {@link module:engine/view/filler~NBSP_FILLER non-breaking space} or
- * {@link module:engine/view/filler~MARKED_NBSP_FILLER marked non-breaking space}.
- *
- * * Inline filler is a filler which does not break a line of text, so it can be used inside the text, for instance in the empty
- * `<b>` surrendered by text: `foo<b></b>bar`, if we want to put the caret there. CKEditor uses a sequence of the zero-width
- * spaces as an {@link module:engine/view/filler~INLINE_FILLER inline filler} having the predetermined
- * {@link module:engine/view/filler~INLINE_FILLER_LENGTH length}. A sequence is used, instead of a single character to
- * avoid treating random zero-width spaces as the inline filler. Disadvantage of the inline filler is that it is not
- * transparent for the selection. The arrow key moves the caret between zero-width spaces characters, so the additional
- * code is needed to handle the caret.
- *
- * Both inline and block fillers are handled by the {@link module:engine/view/renderer~ViewRenderer renderer} and are not present in the
- * view.
- *
- * @module engine/view/filler
- */
 /**
  * Non-breaking space filler creator. This function creates the `&nbsp;` text node.
  * It defines how the filler is created.

package/dist/view/item.d.ts

@@ -2,11 +2,11 @@
  * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
-import { type ViewNode } from './node.js';
-import { type ViewTextProxy } from './textproxy.js';
 /**
  * @module engine/view/item
  */
+import { type ViewNode } from './node.js';
+import { type ViewTextProxy } from './textproxy.js';
 /**
  * Item is a {@link module:engine/view/node~ViewNode Node} or {@link module:engine/view/textproxy~ViewTextProxy ViewTextProxy}.
  */

package/dist/view/typecheckable.d.ts

@@ -2,6 +2,9 @@
  * @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 engine/view/typecheckable
+ */
 import { type ViewAttributeElement } from './attributeelement.js';
 import { type ViewContainerElement } from './containerelement.js';
 import { type ViewDocumentFragment } from './documentfragment.js';
@@ -18,9 +21,6 @@ import { type ViewSelection } from './selection.js';
 import { type ViewText } from './text.js';
 import { type ViewTextProxy } from './textproxy.js';
 import { type ViewUIElement } from './uielement.js';
-/**
- * @module engine/view/typecheckable
- */
 export declare abstract class ViewTypeCheckable {
     /**
      * Checks whether this object is of type {@link module:engine/view/node~ViewNode} or its subclass.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-engine",
-  "version": "48.0.1-alpha.1",
+  "version": "48.1.0-alpha.0",
   "description": "The editing engine of CKEditor 5 – the best browser-based rich text editor.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "CKSource (http://cksource.com/)",
@@ -37,7 +37,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@ckeditor/ckeditor5-utils": "48.0.1-alpha.1",
+    "@ckeditor/ckeditor5-utils": "48.1.0-alpha.0",
     "es-toolkit": "1.45.1"
   },
   "files": [