@ckeditor/ckeditor5-restricted-editing 38.0.1 → 38.1.1

package/src/restrictededitingconfig.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/restrictededitingexceptioncommand.d.ts

@@ -1,30 +1,30 @@
-/**
- * @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 restricted-editing/restrictededitingexceptioncommand
- */
-import { Command } from 'ckeditor5/src/core';
-/**
- * The command that toggles exceptions from the restricted editing on text.
- */
-export default class RestrictedEditingExceptionCommand extends Command {
-    /**
-     * A flag indicating whether the command is active
-     *
-     * @readonly
-     */
-    value: boolean;
-    /**
-     * @inheritDoc
-     */
-    refresh(): void;
-    /**
-     * @inheritDoc
-     */
-    execute(options?: RestrictedEditingExceptionCommandParams): void;
-}
-export interface RestrictedEditingExceptionCommandParams {
-    forceValue?: unknown;
-}
+/**
+ * @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 restricted-editing/restrictededitingexceptioncommand
+ */
+import { Command } from 'ckeditor5/src/core';
+/**
+ * The command that toggles exceptions from the restricted editing on text.
+ */
+export default class RestrictedEditingExceptionCommand extends Command {
+    /**
+     * A flag indicating whether the command is active
+     *
+     * @readonly
+     */
+    value: boolean;
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * @inheritDoc
+     */
+    execute(options?: RestrictedEditingExceptionCommandParams): void;
+}
+export interface RestrictedEditingExceptionCommandParams {
+    forceValue?: unknown;
+}

package/src/restrictededitingexceptioncommand.js

@@ -1,61 +1,61 @@
-/**
- * @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 restricted-editing/restrictededitingexceptioncommand
- */
-import { Command } from 'ckeditor5/src/core';
-/**
- * The command that toggles exceptions from the restricted editing on text.
- */
-export default class RestrictedEditingExceptionCommand extends Command {
-    /**
-     * @inheritDoc
-     */
-    refresh() {
-        const model = this.editor.model;
-        const doc = model.document;
-        this.value = !!doc.selection.getAttribute('restrictedEditingException');
-        this.isEnabled = model.schema.checkAttributeInSelection(doc.selection, 'restrictedEditingException');
-    }
-    /**
-     * @inheritDoc
-     */
-    execute(options = {}) {
-        const model = this.editor.model;
-        const document = model.document;
-        const selection = document.selection;
-        const valueToSet = (options.forceValue === undefined) ? !this.value : options.forceValue;
-        model.change(writer => {
-            const ranges = model.schema.getValidRanges(selection.getRanges(), 'restrictedEditingException');
-            if (selection.isCollapsed) {
-                if (valueToSet) {
-                    writer.setSelectionAttribute('restrictedEditingException', valueToSet);
-                }
-                else {
-                    const isSameException = (value) => {
-                        return value.item.getAttribute('restrictedEditingException') === this.value;
-                    };
-                    const focus = selection.focus;
-                    const exceptionStart = focus.getLastMatchingPosition(isSameException, { direction: 'backward' });
-                    const exceptionEnd = focus.getLastMatchingPosition(isSameException);
-                    writer.removeSelectionAttribute('restrictedEditingException');
-                    if (!(focus.isEqual(exceptionStart) || focus.isEqual(exceptionEnd))) {
-                        writer.removeAttribute('restrictedEditingException', writer.createRange(exceptionStart, exceptionEnd));
-                    }
-                }
-            }
-            else {
-                for (const range of ranges) {
-                    if (valueToSet) {
-                        writer.setAttribute('restrictedEditingException', valueToSet, range);
-                    }
-                    else {
-                        writer.removeAttribute('restrictedEditingException', range);
-                    }
-                }
-            }
-        });
-    }
-}
+/**
+ * @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 restricted-editing/restrictededitingexceptioncommand
+ */
+import { Command } from 'ckeditor5/src/core';
+/**
+ * The command that toggles exceptions from the restricted editing on text.
+ */
+export default class RestrictedEditingExceptionCommand extends Command {
+    /**
+     * @inheritDoc
+     */
+    refresh() {
+        const model = this.editor.model;
+        const doc = model.document;
+        this.value = !!doc.selection.getAttribute('restrictedEditingException');
+        this.isEnabled = model.schema.checkAttributeInSelection(doc.selection, 'restrictedEditingException');
+    }
+    /**
+     * @inheritDoc
+     */
+    execute(options = {}) {
+        const model = this.editor.model;
+        const document = model.document;
+        const selection = document.selection;
+        const valueToSet = (options.forceValue === undefined) ? !this.value : options.forceValue;
+        model.change(writer => {
+            const ranges = model.schema.getValidRanges(selection.getRanges(), 'restrictedEditingException');
+            if (selection.isCollapsed) {
+                if (valueToSet) {
+                    writer.setSelectionAttribute('restrictedEditingException', valueToSet);
+                }
+                else {
+                    const isSameException = (value) => {
+                        return value.item.getAttribute('restrictedEditingException') === this.value;
+                    };
+                    const focus = selection.focus;
+                    const exceptionStart = focus.getLastMatchingPosition(isSameException, { direction: 'backward' });
+                    const exceptionEnd = focus.getLastMatchingPosition(isSameException);
+                    writer.removeSelectionAttribute('restrictedEditingException');
+                    if (!(focus.isEqual(exceptionStart) || focus.isEqual(exceptionEnd))) {
+                        writer.removeAttribute('restrictedEditingException', writer.createRange(exceptionStart, exceptionEnd));
+                    }
+                }
+            }
+            else {
+                for (const range of ranges) {
+                    if (valueToSet) {
+                        writer.setAttribute('restrictedEditingException', valueToSet, range);
+                    }
+                    else {
+                        writer.removeAttribute('restrictedEditingException', range);
+                    }
+                }
+            }
+        });
+    }
+}

package/src/restrictededitingmode/converters.d.ts

@@ -1,39 +1,39 @@
-/**
- * @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 restricted-editing/restrictededitingmode/converters
- */
-import type { Editor } from 'ckeditor5/src/core';
-import { type MatcherPattern, type ModelPostFixer, type UpcastDispatcher } from 'ckeditor5/src/engine';
-/**
- * Adds a visual highlight style to a restricted editing exception that the selection is anchored to.
- *
- * The highlight is turned on by adding the `.restricted-editing-exception_selected` class to the
- * exception in the view:
- *
- * * The class is removed before the conversion starts, as callbacks added with the `'highest'` priority
- * to {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher} events.
- * * The class is added in the view post-fixer, after other changes in the model tree are converted to the view.
- *
- * This way, adding and removing the highlight does not interfere with conversion.
- */
-export declare function setupExceptionHighlighting(editor: Editor): void;
-/**
- * A post-fixer that prevents removing a collapsed marker from the document.
- */
-export declare function resurrectCollapsedMarkerPostFixer(editor: Editor): ModelPostFixer;
-/**
- * A post-fixer that extends a marker when the user types on its boundaries.
- */
-export declare function extendMarkerOnTypingPostFixer(editor: Editor): ModelPostFixer;
-/**
- * A view highlight-to-marker conversion helper.
- *
- * @param config Conversion configuration.
- */
-export declare function upcastHighlightToMarker(config: {
-    view: MatcherPattern;
-    model: () => string;
-}): (dispatcher: UpcastDispatcher) => 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 restricted-editing/restrictededitingmode/converters
+ */
+import type { Editor } from 'ckeditor5/src/core';
+import { type MatcherPattern, type ModelPostFixer, type UpcastDispatcher } from 'ckeditor5/src/engine';
+/**
+ * Adds a visual highlight style to a restricted editing exception that the selection is anchored to.
+ *
+ * The highlight is turned on by adding the `.restricted-editing-exception_selected` class to the
+ * exception in the view:
+ *
+ * * The class is removed before the conversion starts, as callbacks added with the `'highest'` priority
+ * to {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher} events.
+ * * The class is added in the view post-fixer, after other changes in the model tree are converted to the view.
+ *
+ * This way, adding and removing the highlight does not interfere with conversion.
+ */
+export declare function setupExceptionHighlighting(editor: Editor): void;
+/**
+ * A post-fixer that prevents removing a collapsed marker from the document.
+ */
+export declare function resurrectCollapsedMarkerPostFixer(editor: Editor): ModelPostFixer;
+/**
+ * A post-fixer that extends a marker when the user types on its boundaries.
+ */
+export declare function extendMarkerOnTypingPostFixer(editor: Editor): ModelPostFixer;
+/**
+ * A view highlight-to-marker conversion helper.
+ *
+ * @param config Conversion configuration.
+ */
+export declare function upcastHighlightToMarker(config: {
+    view: MatcherPattern;
+    model: () => string;
+}): (dispatcher: UpcastDispatcher) => void;

package/src/restrictededitingmode/converters.js

@@ -1,142 +1,142 @@
-/**
- * @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 { Matcher } from 'ckeditor5/src/engine';
-import { getMarkerAtPosition } from './utils';
-const HIGHLIGHT_CLASS = 'restricted-editing-exception_selected';
-/**
- * Adds a visual highlight style to a restricted editing exception that the selection is anchored to.
- *
- * The highlight is turned on by adding the `.restricted-editing-exception_selected` class to the
- * exception in the view:
- *
- * * The class is removed before the conversion starts, as callbacks added with the `'highest'` priority
- * to {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher} events.
- * * The class is added in the view post-fixer, after other changes in the model tree are converted to the view.
- *
- * This way, adding and removing the highlight does not interfere with conversion.
- */
-export function setupExceptionHighlighting(editor) {
-    const view = editor.editing.view;
-    const model = editor.model;
-    const highlightedMarkers = new Set();
-    // Adding the class.
-    view.document.registerPostFixer((writer) => {
-        const modelSelection = model.document.selection;
-        const marker = getMarkerAtPosition(editor, modelSelection.anchor);
-        if (!marker) {
-            return false;
-        }
-        for (const viewElement of editor.editing.mapper.markerNameToElements(marker.name)) {
-            writer.addClass(HIGHLIGHT_CLASS, viewElement);
-            highlightedMarkers.add(viewElement);
-        }
-        return false;
-    });
-    // Removing the class.
-    editor.conversion.for('editingDowncast').add(dispatcher => {
-        // Make sure the highlight is removed on every possible event, before conversion is started.
-        dispatcher.on('insert', removeHighlight, { priority: 'highest' });
-        dispatcher.on('remove', removeHighlight, { priority: 'highest' });
-        dispatcher.on('attribute', removeHighlight, { priority: 'highest' });
-        dispatcher.on('selection', removeHighlight, { priority: 'highest' });
-        function removeHighlight() {
-            view.change(writer => {
-                for (const item of highlightedMarkers.values()) {
-                    writer.removeClass(HIGHLIGHT_CLASS, item);
-                    highlightedMarkers.delete(item);
-                }
-            });
-        }
-    });
-}
-/**
- * A post-fixer that prevents removing a collapsed marker from the document.
- */
-export function resurrectCollapsedMarkerPostFixer(editor) {
-    // This post-fixer shouldn't be necessary after https://github.com/ckeditor/ckeditor5/issues/5778.
-    return writer => {
-        let changeApplied = false;
-        for (const { name, data } of editor.model.document.differ.getChangedMarkers()) {
-            if (name.startsWith('restrictedEditingException') && data.newRange && data.newRange.root.rootName == '$graveyard') {
-                writer.updateMarker(name, {
-                    range: writer.createRange(writer.createPositionAt(data.oldRange.start))
-                });
-                changeApplied = true;
-            }
-        }
-        return changeApplied;
-    };
-}
-/**
- * A post-fixer that extends a marker when the user types on its boundaries.
- */
-export function extendMarkerOnTypingPostFixer(editor) {
-    // This post-fixer shouldn't be necessary after https://github.com/ckeditor/ckeditor5/issues/5778.
-    return writer => {
-        let changeApplied = false;
-        for (const change of editor.model.document.differ.getChanges()) {
-            if (change.type == 'insert' && change.name == '$text') {
-                changeApplied = _tryExtendMarkerStart(editor, change.position, change.length, writer) || changeApplied;
-                changeApplied = _tryExtendMarkedEnd(editor, change.position, change.length, writer) || changeApplied;
-            }
-        }
-        return changeApplied;
-    };
-}
-/**
- * A view highlight-to-marker conversion helper.
- *
- * @param config Conversion configuration.
- */
-export function upcastHighlightToMarker(config) {
-    return (dispatcher) => dispatcher.on('element:span', (evt, data, conversionApi) => {
-        const { writer } = conversionApi;
-        const matcher = new Matcher(config.view);
-        const matcherResult = matcher.match(data.viewItem);
-        // If there is no match, this callback should not do anything.
-        if (!matcherResult) {
-            return;
-        }
-        const match = matcherResult.match;
-        // Force consuming element's name (taken from upcast helpers elementToElement converter).
-        match.name = true;
-        const { modelRange: convertedChildrenRange } = conversionApi.convertChildren(data.viewItem, data.modelCursor);
-        conversionApi.consumable.consume(data.viewItem, match);
-        const markerName = config.model();
-        const fakeMarkerStart = writer.createElement('$marker', { 'data-name': markerName });
-        const fakeMarkerEnd = writer.createElement('$marker', { 'data-name': markerName });
-        // Insert in reverse order to use converter content positions directly (without recalculating).
-        writer.insert(fakeMarkerEnd, convertedChildrenRange.end);
-        writer.insert(fakeMarkerStart, convertedChildrenRange.start);
-        data.modelRange = writer.createRange(writer.createPositionBefore(fakeMarkerStart), writer.createPositionAfter(fakeMarkerEnd));
-        data.modelCursor = data.modelRange.end;
-    });
-}
-/**
- * Extend marker if change detected on marker's start position.
- */
-function _tryExtendMarkerStart(editor, position, length, writer) {
-    const markerAtStart = getMarkerAtPosition(editor, position.getShiftedBy(length));
-    if (markerAtStart && markerAtStart.getStart().isEqual(position.getShiftedBy(length))) {
-        writer.updateMarker(markerAtStart, {
-            range: writer.createRange(markerAtStart.getStart().getShiftedBy(-length), markerAtStart.getEnd())
-        });
-        return true;
-    }
-    return false;
-}
-/**
- * Extend marker if change detected on marker's end position.
- */
-function _tryExtendMarkedEnd(editor, position, length, writer) {
-    const markerAtEnd = getMarkerAtPosition(editor, position);
-    if (markerAtEnd && markerAtEnd.getEnd().isEqual(position)) {
-        writer.updateMarker(markerAtEnd, {
-            range: writer.createRange(markerAtEnd.getStart(), markerAtEnd.getEnd().getShiftedBy(length))
-        });
-        return true;
-    }
-    return false;
-}
+/**
+ * @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 { Matcher } from 'ckeditor5/src/engine';
+import { getMarkerAtPosition } from './utils';
+const HIGHLIGHT_CLASS = 'restricted-editing-exception_selected';
+/**
+ * Adds a visual highlight style to a restricted editing exception that the selection is anchored to.
+ *
+ * The highlight is turned on by adding the `.restricted-editing-exception_selected` class to the
+ * exception in the view:
+ *
+ * * The class is removed before the conversion starts, as callbacks added with the `'highest'` priority
+ * to {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher} events.
+ * * The class is added in the view post-fixer, after other changes in the model tree are converted to the view.
+ *
+ * This way, adding and removing the highlight does not interfere with conversion.
+ */
+export function setupExceptionHighlighting(editor) {
+    const view = editor.editing.view;
+    const model = editor.model;
+    const highlightedMarkers = new Set();
+    // Adding the class.
+    view.document.registerPostFixer((writer) => {
+        const modelSelection = model.document.selection;
+        const marker = getMarkerAtPosition(editor, modelSelection.anchor);
+        if (!marker) {
+            return false;
+        }
+        for (const viewElement of editor.editing.mapper.markerNameToElements(marker.name)) {
+            writer.addClass(HIGHLIGHT_CLASS, viewElement);
+            highlightedMarkers.add(viewElement);
+        }
+        return false;
+    });
+    // Removing the class.
+    editor.conversion.for('editingDowncast').add(dispatcher => {
+        // Make sure the highlight is removed on every possible event, before conversion is started.
+        dispatcher.on('insert', removeHighlight, { priority: 'highest' });
+        dispatcher.on('remove', removeHighlight, { priority: 'highest' });
+        dispatcher.on('attribute', removeHighlight, { priority: 'highest' });
+        dispatcher.on('selection', removeHighlight, { priority: 'highest' });
+        function removeHighlight() {
+            view.change(writer => {
+                for (const item of highlightedMarkers.values()) {
+                    writer.removeClass(HIGHLIGHT_CLASS, item);
+                    highlightedMarkers.delete(item);
+                }
+            });
+        }
+    });
+}
+/**
+ * A post-fixer that prevents removing a collapsed marker from the document.
+ */
+export function resurrectCollapsedMarkerPostFixer(editor) {
+    // This post-fixer shouldn't be necessary after https://github.com/ckeditor/ckeditor5/issues/5778.
+    return writer => {
+        let changeApplied = false;
+        for (const { name, data } of editor.model.document.differ.getChangedMarkers()) {
+            if (name.startsWith('restrictedEditingException') && data.newRange && data.newRange.root.rootName == '$graveyard') {
+                writer.updateMarker(name, {
+                    range: writer.createRange(writer.createPositionAt(data.oldRange.start))
+                });
+                changeApplied = true;
+            }
+        }
+        return changeApplied;
+    };
+}
+/**
+ * A post-fixer that extends a marker when the user types on its boundaries.
+ */
+export function extendMarkerOnTypingPostFixer(editor) {
+    // This post-fixer shouldn't be necessary after https://github.com/ckeditor/ckeditor5/issues/5778.
+    return writer => {
+        let changeApplied = false;
+        for (const change of editor.model.document.differ.getChanges()) {
+            if (change.type == 'insert' && change.name == '$text') {
+                changeApplied = _tryExtendMarkerStart(editor, change.position, change.length, writer) || changeApplied;
+                changeApplied = _tryExtendMarkedEnd(editor, change.position, change.length, writer) || changeApplied;
+            }
+        }
+        return changeApplied;
+    };
+}
+/**
+ * A view highlight-to-marker conversion helper.
+ *
+ * @param config Conversion configuration.
+ */
+export function upcastHighlightToMarker(config) {
+    return (dispatcher) => dispatcher.on('element:span', (evt, data, conversionApi) => {
+        const { writer } = conversionApi;
+        const matcher = new Matcher(config.view);
+        const matcherResult = matcher.match(data.viewItem);
+        // If there is no match, this callback should not do anything.
+        if (!matcherResult) {
+            return;
+        }
+        const match = matcherResult.match;
+        // Force consuming element's name (taken from upcast helpers elementToElement converter).
+        match.name = true;
+        const { modelRange: convertedChildrenRange } = conversionApi.convertChildren(data.viewItem, data.modelCursor);
+        conversionApi.consumable.consume(data.viewItem, match);
+        const markerName = config.model();
+        const fakeMarkerStart = writer.createElement('$marker', { 'data-name': markerName });
+        const fakeMarkerEnd = writer.createElement('$marker', { 'data-name': markerName });
+        // Insert in reverse order to use converter content positions directly (without recalculating).
+        writer.insert(fakeMarkerEnd, convertedChildrenRange.end);
+        writer.insert(fakeMarkerStart, convertedChildrenRange.start);
+        data.modelRange = writer.createRange(writer.createPositionBefore(fakeMarkerStart), writer.createPositionAfter(fakeMarkerEnd));
+        data.modelCursor = data.modelRange.end;
+    });
+}
+/**
+ * Extend marker if change detected on marker's start position.
+ */
+function _tryExtendMarkerStart(editor, position, length, writer) {
+    const markerAtStart = getMarkerAtPosition(editor, position.getShiftedBy(length));
+    if (markerAtStart && markerAtStart.getStart().isEqual(position.getShiftedBy(length))) {
+        writer.updateMarker(markerAtStart, {
+            range: writer.createRange(markerAtStart.getStart().getShiftedBy(-length), markerAtStart.getEnd())
+        });
+        return true;
+    }
+    return false;
+}
+/**
+ * Extend marker if change detected on marker's end position.
+ */
+function _tryExtendMarkedEnd(editor, position, length, writer) {
+    const markerAtEnd = getMarkerAtPosition(editor, position);
+    if (markerAtEnd && markerAtEnd.getEnd().isEqual(position)) {
+        writer.updateMarker(markerAtEnd, {
+            range: writer.createRange(markerAtEnd.getStart(), markerAtEnd.getEnd().getShiftedBy(length))
+        });
+        return true;
+    }
+    return false;
+}

package/src/restrictededitingmode/utils.d.ts

@@ -1,30 +1,30 @@
-/**
- * @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 { Editor } from 'ckeditor5/src/core';
-import type { DocumentSelection, Marker, Position, Range } from 'ckeditor5/src/engine';
-/**
- * @module restricted-editing/restrictededitingmode/utils
- */
-/**
- * Returns a single "restricted-editing-exception" marker at a given position. Contrary to
- * {@link module:engine/model/markercollection~MarkerCollection#getMarkersAtPosition}, it returnd a marker also when the postion is
- * equal to one of the marker's start or end positions.
- */
-export declare function getMarkerAtPosition(editor: Editor, position: Position): Marker | undefined;
-/**
- * Checks if the position is fully contained in the range. Positions equal to range start or end are considered "in".
- */
-export declare function isPositionInRangeBoundaries(range: Range, position: Position): boolean;
-/**
- * Checks if the selection is fully contained in the marker. Positions on marker boundaries are considered "in".
- *
- * ```xml
- * <marker>[]foo</marker> -> true
- * <marker>f[oo]</marker> -> true
- * <marker>f[oo</marker> ba]r -> false
- * <marker>foo</marker> []bar -> false
- * ```
- */
-export declare function isSelectionInMarker(selection: DocumentSelection, marker?: Marker): 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
+ */
+import type { Editor } from 'ckeditor5/src/core';
+import type { DocumentSelection, Marker, Position, Range } from 'ckeditor5/src/engine';
+/**
+ * @module restricted-editing/restrictededitingmode/utils
+ */
+/**
+ * Returns a single "restricted-editing-exception" marker at a given position. Contrary to
+ * {@link module:engine/model/markercollection~MarkerCollection#getMarkersAtPosition}, it returnd a marker also when the postion is
+ * equal to one of the marker's start or end positions.
+ */
+export declare function getMarkerAtPosition(editor: Editor, position: Position): Marker | undefined;
+/**
+ * Checks if the position is fully contained in the range. Positions equal to range start or end are considered "in".
+ */
+export declare function isPositionInRangeBoundaries(range: Range, position: Position): boolean;
+/**
+ * Checks if the selection is fully contained in the marker. Positions on marker boundaries are considered "in".
+ *
+ * ```xml
+ * <marker>[]foo</marker> -> true
+ * <marker>f[oo]</marker> -> true
+ * <marker>f[oo</marker> ba]r -> false
+ * <marker>foo</marker> []bar -> false
+ * ```
+ */
+export declare function isSelectionInMarker(selection: DocumentSelection, marker?: Marker): boolean;