@ckeditor/ckeditor5-engine 47.6.1 → 48.0.0-alpha.1

package/{src → dist}/model/model.d.ts

@@ -537,8 +537,7 @@ export declare class Model extends /* #__PURE__ */ Model_base {
      */
     getSelectedContent(selection: ModelSelection | ModelDocumentSelection): ModelDocumentFragment;
     /**
-     * Checks whether the given {@link module:engine/model/range~ModelRange range} or
-     * {@link module:engine/model/element~ModelElement element} has any meaningful content.
+     * Checks whether given `subject` has any meaningful content.
      *
      * Meaningful content is:
      *
@@ -552,14 +551,21 @@ export declare class Model extends /* #__PURE__ */ Model_base {
      * However, a range containing an `<imageBlock></imageBlock>` (which would normally be marked in the schema as an object element)
      * is considered non-empty.
      *
-     * @param rangeOrElement Range or element to check.
+     * @param subject Subject to check if includes meaningful content. Could be a model range, an element, a document fragment, or a
+     * selection.
      * @param options.ignoreWhitespaces Whether text node with whitespaces only should be considered empty.
      * @param options.ignoreMarkers Whether markers should be ignored.
      */
-    hasContent(rangeOrElement: ModelRange | ModelElement | ModelDocumentFragment, options?: {
+    hasContent(subject: ModelRange | ModelElement | ModelDocumentFragment | ModelSelection | ModelDocumentSelection, options?: {
         ignoreWhitespaces?: boolean;
         ignoreMarkers?: boolean;
     }): boolean;
+    /**
+     * Checks whether given range has any meaningful content.
+     *
+     * Helper method for {@link #hasContent}.
+     */
+    private _rangeHasContent;
     /**
      * Check whether given selectable is at a place in the model where it can be edited (returns `true`) or not (returns `false`).
      *

package/{src → dist}/model/selection.d.ts

@@ -226,7 +226,7 @@ export declare class ModelSelection extends /* #__PURE__ */ ModelSelection_base
      * selection.setTo( paragraph, 'on' );
      * ```
      *
-     * `Selection#setTo()`' method allow passing additional options (`backward`) as the last argument.
+     * `Selection#setTo()` method allows passing additional options (`backward`) as the last argument.
      *
      * ```ts
      * // Sets backward selection.

package/{src → dist}/view/downcastwriter.d.ts

@@ -23,6 +23,7 @@ import type { ViewElement, ViewElementAttributes } from './element.js';
 import { type ViewDomConverter } from './domconverter.js';
 import { type ViewItem } from './item.js';
 import type { DowncastSlotFilter } from '../conversion/downcasthelpers.js';
+import type { StyleValue } from './stylesmap.js';
 type DomDocument = globalThis.Document;
 type DomElement = globalThis.HTMLElement;
 /**
@@ -462,7 +463,7 @@ export declare class ViewDowncastWriter {
      * @param value Value to set.
      * @param element Element to set styles on.
      */
-    setStyle(property: string, value: string, element: ViewElement): void;
+    setStyle(property: string, value: StyleValue, element: ViewElement): void;
     /**
      * Adds many styles to the element.
      *
@@ -481,7 +482,7 @@ export declare class ViewDowncastWriter {
      * @param property Object with key - value pairs.
      * @param element Element to set styles on.
      */
-    setStyle(property: Record<string, string>, element: ViewElement): void;
+    setStyle(property: Record<string, StyleValue>, element: ViewElement): void;
     /**
      * Removes specified style from the element.
      *

package/{src → dist}/view/element.d.ts

@@ -414,7 +414,7 @@ export declare class ViewElement extends ViewNode {
      * @param value Value to set.
      * @fires change
      */
-    _setStyle(property: string, value: string): void;
+    _setStyle(property: string, value: StyleValue): void;
     /**
      * Adds style to the element.
      *
@@ -435,7 +435,7 @@ export declare class ViewElement extends ViewNode {
      * @param properties Object with key - value pairs.
      * @fires change
      */
-    _setStyle(properties: Record<string, string>): void;
+    _setStyle(properties: Record<string, StyleValue>): void;
     /**
      * Removes specified style.
      *

package/{src → dist}/view/matcher.d.ts

@@ -472,7 +472,8 @@ export type NormalizedPropertyPattern = [
  * }
  * ```
  *
- * Refer to the {@glink updating/guides/update-to-29##update-to-ckeditor-5-v2910 Migration to v29.1.0} guide
+ * Refer to the `#update-to-ckeditor-5-v2910` section in the `Update to v29.x` section in the
+ * {@glink updating/guides/updating-from-older-versions updating from older versions} guide
  * and {@link module:engine/view/matcher~MatcherPattern} documentation.
  *
  * @param pattern Pattern with missing properties.
@@ -503,7 +504,8 @@ export type NormalizedPropertyPattern = [
  * }
  * ```
  *
- * Refer to the {@glink updating/guides/update-to-29##update-to-ckeditor-5-v2910 Migration to v29.1.0} guide
+ * Refer to the `#update-to-ckeditor-5-v2910` paragraph in the Update to v29.x guide in the
+ * {@glink updating/guides/updating-from-older-versions updating from older versions} guide
  * and the {@link module:engine/view/matcher~MatcherPattern} documentation.
  *
  * @param pattern Pattern with missing properties.

package/dist/view/styles/background.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @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 { StylesProcessor } from '../stylesmap.js';
+/**
+ * Adds background CSS styles processing rules to the given `StylesProcessor`.
+ *
+ * Registers normalizers for the `background` shorthand and its longhand properties,
+ * reducers that serialize them back to CSS strings, and the relation mapping between them.
+ *
+ * ```ts
+ * editor.data.addStyleProcessorRules( addBackgroundStylesRules );
+ * ```
+ *
+ * @param stylesProcessor The styles processor instance to register rules on.
+ */
+export declare function addBackgroundStylesRules(stylesProcessor: StylesProcessor): void;

package/{src → dist}/view/styles/border.d.ts

@@ -27,17 +27,5 @@ import type { StylesProcessor } from '../stylesmap.js';
  * and all corresponding longhand forms (like `border-top-color`, `border-top-style`, etc).
  *
  * It does not handle other shorthands (like `border-radius` or `border-image`).
- *
- * The normalized model stores border values as:
- *
- * ```ts
- * const styles = {
- * 	border: {
- * 		color: { top, right, bottom, left },
- * 		style: { top, right, bottom, left },
- * 		width: { top, right, bottom, left },
- * 	}
- * };
- * ```
  */
 export declare function addBorderStylesRules(stylesProcessor: StylesProcessor): void;

package/{src → dist}/view/styles/margin.d.ts

@@ -12,18 +12,5 @@ import type { StylesProcessor } from '../stylesmap.js';
  * ```ts
  * editor.data.addStyleProcessorRules( addMarginStylesRules );
  * ```
- *
- * The normalized value is stored as:
- *
- * ```ts
- * const styles = {
- * 	margin: {
- * 		top,
- * 		right,
- * 		bottom,
- * 		left
- * 	}
- * };
- * ```
  */
 export declare function addMarginStylesRules(stylesProcessor: StylesProcessor): void;

package/{src → dist}/view/styles/padding.d.ts

@@ -12,18 +12,5 @@ import type { StylesProcessor } from '../stylesmap.js';
  * ```ts
  * editor.data.addStyleProcessorRules( addPaddingStylesRules );
  * ```
- *
- * The normalized value is stored as:
- *
- * ```ts
- * const styles = {
- * 	padding: {
- * 		top,
- * 		right,
- * 		bottom,
- * 		left
- * 	}
- * };
- * ```
  */
 export declare function addPaddingStylesRules(stylesProcessor: StylesProcessor): void;

package/{src → dist}/view/styles/utils.d.ts

@@ -32,6 +32,10 @@ export declare function isLengthStyleValue(string: string): boolean;
  * Checks if string contains [percentage](https://developer.mozilla.org/en-US/docs/Web/CSS/percentage) CSS value.
  */
 export declare function isPercentageStyleValue(string: string): boolean;
+/**
+ * Checks if a string is a valid CSS `background-size` value token.
+ */
+export declare function isSizeStyleValue(value: string): boolean;
 /**
  * Checks if string contains [background repeat](https://developer.mozilla.org/en-US/docs/Web/CSS/background-repeat) CSS value.
  */
@@ -44,6 +48,14 @@ export declare function isPositionStyleValue(string: string): boolean;
  * Checks if string contains [background attachment](https://developer.mozilla.org/en-US/docs/Web/CSS/background-attachment) CSS value.
  */
 export declare function isAttachmentStyleValue(string: string): boolean;
+/**
+ * Checks if string contains [background origin](https://developer.mozilla.org/en-US/docs/Web/CSS/background-origin) CSS value.
+ */
+export declare function isOriginStyleValue(string: string): boolean;
+/**
+ * Checks if string contains [background clip](https://developer.mozilla.org/en-US/docs/Web/CSS/background-clip) CSS value.
+ */
+export declare function isClipStyleValue(string: string): boolean;
 /**
  * Checks if string contains [URL](https://developer.mozilla.org/en-US/docs/Web/CSS/url) CSS value.
  */

package/package.json

@@ -1,7 +1,16 @@
 {
   "name": "@ckeditor/ckeditor5-engine",
-  "version": "47.6.1",
+  "version": "48.0.0-alpha.1",
   "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/)",
+  "homepage": "https://ckeditor.com/ckeditor-5",
+  "bugs": "https://github.com/ckeditor/ckeditor5/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ckeditor/ckeditor5.git",
+    "directory": "packages/ckeditor5-engine"
+  },
   "keywords": [
     "wysiwyg",
     "rich text",
@@ -18,50 +27,22 @@
     "ckeditor",
     "ckeditor5",
     "ckeditor 5",
-    "ckeditor5-lib",
-    "ckeditor5-dll"
+    "ckeditor5-lib"
   ],
   "type": "module",
-  "main": "src/index.js",
-  "dependencies": {
-    "@ckeditor/ckeditor5-utils": "47.6.1",
-    "es-toolkit": "1.39.5"
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./dist/*": "./dist/*",
+    "./package.json": "./package.json"
   },
-  "author": "CKSource (http://cksource.com/)",
-  "license": "SEE LICENSE IN LICENSE.md",
-  "homepage": "https://ckeditor.com/ckeditor-5",
-  "bugs": "https://github.com/ckeditor/ckeditor5/issues",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ckeditor/ckeditor5.git",
-    "directory": "packages/ckeditor5-engine"
+  "dependencies": {
+    "@ckeditor/ckeditor5-utils": "48.0.0-alpha.1",
+    "es-toolkit": "1.45.1"
   },
   "files": [
     "dist",
-    "lang",
-    "src/**/*.js",
-    "src/**/*.d.ts",
-    "theme",
     "CHANGELOG.md"
   ],
-  "types": "src/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./src/index.d.ts",
-      "import": "./src/index.js",
-      "default": "./src/index.js"
-    },
-    "./dist/*": {
-      "types": "./src/index.d.ts",
-      "import": "./dist/*",
-      "default": "./dist/*"
-    },
-    "./src/*": {
-      "types": "./src/*.d.ts",
-      "import": "./src/*",
-      "default": "./src/*"
-    },
-    "./theme/*": "./theme/*",
-    "./package.json": "./package.json"
-  }
+  "types": "./dist/index.d.ts"
 }