ckeditor5-elements-interaction 0.0.0-stage → 49.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ivan Kildyushov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,49 @@
-# Temporary Holding Version
+# ckeditor5-elements-interaction
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Element interaction for CKEditor 5 Elements, for the elements that match a model name or a filter function, without
+CKEditor's widgets:
+
+- `ElementSelectable` selects an element as a whole, by a click or by the arrow keys. It does what widgets do for
+  selecting, without changing the view of the element and without the `Widget` plugin.
+- `ElementClickable` calls a function, with the model element, when an element is clicked or double-clicked.
+
+## Installation
+
+This package is part of `ckeditor5-elements`. Install the whole package to use it:
+
+```sh
+npm install ckeditor5 ckeditor5-elements
+```
+
+Import the stylesheet of the package (`ckeditor5-elements/index.css` has the styles of all the features).
+
+## Usage
+
+```ts
+import { ElementClickable, ElementSelectable } from 'ckeditor5-elements';
+
+// In the editor config:
+plugins: [..., ElementSelectable, ElementClickable],
+elementSelectable: ['callout', 'divider', element => element.hasAttribute('card')],
+elementClickable: [
+	// By name. The default event is `click`.
+	{ element: 'imageBlock', callback: (element, editor) => console.log(element.getAttribute('src')) },
+	// By a filter, on double click.
+	{ element: element => element.name.startsWith('heading'), event: 'dblclick', callback: (element, editor) => {} }
+]
+```
+
+Selecting:
+
+- A click on an element selects it; a container is selected by a click on the element itself, and a click in its text puts
+  the cursor there.
+- At the end of the text, the right arrow key selects the next selectable element (the left key, at the start, the
+  previous one). With an element selected, the arrow keys move the cursor out of it.
+- Esc selects the closest selectable element around the cursor.
+
+See the [Selectable elements](https://ivankild.github.io/ckeditor5-elements/guide/selectable) and
+[Clickable elements](https://ivankild.github.io/ckeditor5-elements/guide/clickable) guides of the documentation.
+
+## License
+
+MIT

package/dist/augmentation.d.ts

@@ -0,0 +1,19 @@
+import type { ElementClickable, ElementClickableDefinition, ElementSelectable, ElementSelectableMatcher } from './index.js';
+declare module 'ckeditor5' {
+    interface PluginsMap {
+        [ElementSelectable.pluginName]: ElementSelectable;
+        [ElementClickable.pluginName]: ElementClickable;
+    }
+    interface EditorConfig {
+        /**
+         * The elements that can be selected as a whole: names of model elements, or filter functions. See
+         * {@link ElementSelectable}.
+         */
+        elementSelectable?: ElementSelectableMatcher[];
+        /**
+         * The elements that react to clicks and double clicks. See {@link ElementClickable}.
+         */
+        elementClickable?: ElementClickableDefinition[];
+    }
+}
+//# sourceMappingURL=augmentation.d.ts.map

package/dist/augmentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"augmentation.d.ts","sourceRoot":"","sources":["../src/augmentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAChB,0BAA0B,EAC1B,iBAAiB,EACjB,wBAAwB,EACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,QAAQ,WAAW,CAAC;IAC1B,UAAU,UAAU;QACnB,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;QAClD,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;KAChD;IAED,UAAU,YAAY;QACrB;;;WAGG;QACH,iBAAiB,CAAC,EAAE,wBAAwB,EAAE,CAAC;QAE/C;;WAEG;QACH,gBAAgB,CAAC,EAAE,0BAA0B,EAAE,CAAC;KAChD;CACD"}

package/dist/augmentation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=augmentation.js.map

package/dist/augmentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"augmentation.js","sourceRoot":"","sources":["../src/augmentation.ts"],"names":[],"mappings":""}

package/dist/doubleClickObserver.d.ts

@@ -0,0 +1,20 @@
+import { DomEventObserver, type ViewDocumentDomEventData } from 'ckeditor5';
+/**
+ * Fires `dblclick` on the view document when the user double-clicks in the editing view. (CKEditor has an observer for
+ * `click`, but not for `dblclick`.)
+ */
+export default class DoubleClickObserver extends DomEventObserver<'dblclick'> {
+    get domEventType(): 'dblclick';
+    /**
+     * Fires `dblclick` on the view document for the DOM event.
+     */
+    onDomEvent(domEvent: MouseEvent): void;
+}
+/**
+ * Fired on the view document by the {@link DoubleClickObserver}.
+ */
+export interface ViewDocumentDoubleClickEvent {
+    name: 'dblclick';
+    args: [data: ViewDocumentDomEventData<MouseEvent>];
+}
+//# sourceMappingURL=doubleClickObserver.d.ts.map

package/dist/doubleClickObserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doubleClickObserver.d.ts","sourceRoot":"","sources":["../src/doubleClickObserver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAE5E;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,gBAAgB,CAAC,UAAU,CAAC;IAG5E,IAAW,YAAY,IAAI,UAAU,CAEpC;IAED;;OAEG;IACI,UAAU,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;CAG7C;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC5C,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,CAAC,IAAI,EAAE,wBAAwB,CAAC,UAAU,CAAC,CAAC,CAAC;CACnD"}

package/dist/doubleClickObserver.js

@@ -0,0 +1,19 @@
+import { DomEventObserver } from 'ckeditor5';
+/**
+ * Fires `dblclick` on the view document when the user double-clicks in the editing view. (CKEditor has an observer for
+ * `click`, but not for `dblclick`.)
+ */
+export default class DoubleClickObserver extends DomEventObserver {
+    // The base class declares it as an accessor, so it cannot be a field here.
+    // eslint-disable-next-line @typescript-eslint/class-literal-property-style
+    get domEventType() {
+        return 'dblclick';
+    }
+    /**
+     * Fires `dblclick` on the view document for the DOM event.
+     */
+    onDomEvent(domEvent) {
+        this.fire(domEvent.type, domEvent);
+    }
+}
+//# sourceMappingURL=doubleClickObserver.js.map

package/dist/doubleClickObserver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doubleClickObserver.js","sourceRoot":"","sources":["../src/doubleClickObserver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAiC,MAAM,WAAW,CAAC;AAE5E;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,gBAA4B;IAC5E,2EAA2E;IAC3E,2EAA2E;IAC3E,IAAW,YAAY;QACtB,OAAO,UAAU,CAAC;IACnB,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,QAAoB;QACrC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;CACD"}

package/dist/elementClickable.d.ts

@@ -0,0 +1,57 @@
+import { Plugin, type Editor, type ModelElement, type ViewElement } from 'ckeditor5';
+import { type ElementMatcher } from 'ckeditor5-elements-core';
+/**
+ * The mouse events an element can be made clickable with.
+ */
+export type ElementClickableEvent = 'click' | 'dblclick';
+/**
+ * Makes the elements that match `element` react to clicks.
+ */
+export interface ElementClickableDefinition {
+    /**
+     * The elements the definition is for: the name of a model element (e.g. `'imageBlock'`), or a function that returns
+     * whether it is for the given element (e.g. `element => element.hasAttribute('linkHref')`).
+     */
+    element: ElementMatcher;
+    /**
+     * The mouse event: `'click'` (the default) or `'dblclick'`.
+     */
+    event?: ElementClickableEvent;
+    /**
+     * Called with the element that was clicked, the editor, and the DOM event.
+     */
+    callback: (element: ModelElement, editor: Editor, domEvent: MouseEvent) => void;
+}
+/**
+ * Calls a function when an element is clicked or double-clicked, with the model element. Elements are matched by name or
+ * by a filter function, and the definitions are the `elementClickable` editor config option (see
+ * {@link ElementClickableDefinition}):
+ *
+ * ```ts
+ * elementClickable: [
+ * 	{ element: 'imageBlock', callback: (element, editor) => console.log(element.getAttribute('src')) },
+ * 	{ element: element => element.name.startsWith('heading'), event: 'dblclick', callback: edit }
+ * ];
+ * ```
+ *
+ * The click is matched against the element that was clicked and its ancestors, the innermost first: the first element
+ * that matches a definition for the event calls its callback, and the event goes no further. For two definitions that
+ * match the same element, the first one in the config wins.
+ *
+ * It works in read-only mode too. The click still does what it does in the editor, e.g. selects an image: the plugin
+ * only reports it, before the other plugins handle it (some of them stop the event), and does not stop it.
+ */
+export default class ElementClickable extends Plugin {
+    static get pluginName(): 'ElementClickable';
+    init(): void;
+    /**
+     * Returns the definition and the element that a click on the view element is for: the innermost element, among the
+     * view element and its ancestors, that matches a definition for the event. `null` when there is none.
+     */
+    find(viewElement: ViewElement, event?: ElementClickableEvent): {
+        element: ModelElement;
+        definition: ElementClickableDefinition;
+    } | null;
+    private _handle;
+}
+//# sourceMappingURL=elementClickable.d.ts.map

package/dist/elementClickable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementClickable.d.ts","sourceRoot":"","sources":["../src/elementClickable.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,MAAM,EACN,KAAK,MAAM,EACX,KAAK,YAAY,EAEjB,KAAK,WAAW,EAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAqC,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGjG;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,UAAU,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAC1C;;;OAGG;IACH,OAAO,EAAE,cAAc,CAAC;IAExB;;OAEG;IACH,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAE9B;;OAEG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,KAAK,IAAI,CAAC;CAChF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,MAAM;IACnD,WAAkB,UAAU,IAAI,kBAAkB,CAEjD;IAEM,IAAI,IAAI,IAAI;IA0BnB;;;OAGG;IACI,IAAI,CACV,WAAW,EAAE,WAAW,EACxB,KAAK,GAAE,qBAA+B,GACpC;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,UAAU,EAAE,0BAA0B,CAAA;KAAE,GAAG,IAAI;IAiB3E,OAAO,CAAC,OAAO;CAKf"}

package/dist/elementClickable.js

@@ -0,0 +1,60 @@
+import { ClickObserver, Plugin } from 'ckeditor5';
+import { getElementsAround, matchesElement } from 'ckeditor5-elements-core';
+import DoubleClickObserver, {} from './doubleClickObserver.js';
+/**
+ * Calls a function when an element is clicked or double-clicked, with the model element. Elements are matched by name or
+ * by a filter function, and the definitions are the `elementClickable` editor config option (see
+ * {@link ElementClickableDefinition}):
+ *
+ * ```ts
+ * elementClickable: [
+ * 	{ element: 'imageBlock', callback: (element, editor) => console.log(element.getAttribute('src')) },
+ * 	{ element: element => element.name.startsWith('heading'), event: 'dblclick', callback: edit }
+ * ];
+ * ```
+ *
+ * The click is matched against the element that was clicked and its ancestors, the innermost first: the first element
+ * that matches a definition for the event calls its callback, and the event goes no further. For two definitions that
+ * match the same element, the first one in the config wins.
+ *
+ * It works in read-only mode too. The click still does what it does in the editor, e.g. selects an image: the plugin
+ * only reports it, before the other plugins handle it (some of them stop the event), and does not stop it.
+ */
+export default class ElementClickable extends Plugin {
+    static get pluginName() {
+        return 'ElementClickable';
+    }
+    init() {
+        const view = this.editor.editing.view;
+        view.addObserver(ClickObserver);
+        view.addObserver(DoubleClickObserver);
+        // With the highest priority, before other plugins: some stop the click, e.g. CKEditor's link handling stops the
+        // click on a link, with a high priority. The plugin reports the click and does not stop it.
+        this.listenTo(view.document, 'click', (evt, data) => {
+            this._handle('click', data.target, data.domEvent);
+        }, { priority: 'highest' });
+        this.listenTo(view.document, 'dblclick', (evt, data) => {
+            this._handle('dblclick', data.target, data.domEvent);
+        }, { priority: 'highest' });
+    }
+    /**
+     * Returns the definition and the element that a click on the view element is for: the innermost element, among the
+     * view element and its ancestors, that matches a definition for the event. `null` when there is none.
+     */
+    find(viewElement, event = 'click') {
+        const mapper = this.editor.editing.mapper;
+        const definitions = (this.editor.config.get('elementClickable') ?? []).filter(definition => (definition.event ?? 'click') === event);
+        for (const { element } of getElementsAround(mapper, viewElement)) {
+            const definition = definitions.find(({ element: matcher }) => matchesElement(matcher, element));
+            if (definition) {
+                return { element, definition };
+            }
+        }
+        return null;
+    }
+    _handle(event, target, domEvent) {
+        const found = this.isEnabled ? this.find(target, event) : null;
+        found?.definition.callback(found.element, this.editor, domEvent);
+    }
+}
+//# sourceMappingURL=elementClickable.js.map

package/dist/elementClickable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementClickable.js","sourceRoot":"","sources":["../src/elementClickable.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,aAAa,EACb,MAAM,EAKN,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAuB,MAAM,yBAAyB,CAAC;AACjG,OAAO,mBAAmB,EAAE,EAAqC,MAAM,0BAA0B,CAAC;AA4BlG;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,MAAM;IAC5C,MAAM,KAAK,UAAU;QAC3B,OAAO,kBAA2B,CAAC;IACpC,CAAC;IAEM,IAAI;QACV,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QAEtC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAChC,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;QAEtC,gHAAgH;QAChH,4FAA4F;QAC5F,IAAI,CAAC,QAAQ,CACZ,IAAI,CAAC,QAAQ,EACb,OAAO,EACP,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACb,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,CAAC,EACD,EAAE,QAAQ,EAAE,SAAS,EAAE,CACvB,CAAC;QACF,IAAI,CAAC,QAAQ,CACZ,IAAI,CAAC,QAAQ,EACb,UAAU,EACV,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACb,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC,EACD,EAAE,QAAQ,EAAE,SAAS,EAAE,CACvB,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,IAAI,CACV,WAAwB,EACxB,QAA+B,OAAO;QAEtC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAC1C,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAC5E,UAAU,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,KAAK,CACrD,CAAC;QAEF,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC;YAClE,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YAEhG,IAAI,UAAU,EAAE,CAAC;gBAChB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;YAChC,CAAC;QACF,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAEO,OAAO,CAAC,KAA4B,EAAE,MAAmB,EAAE,QAAoB;QACtF,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAE/D,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;CACD"}

package/dist/elementSelectable.d.ts

@@ -0,0 +1,77 @@
+import { Plugin, type ModelElement } from 'ckeditor5';
+import { type ElementMatcher } from 'ckeditor5-elements-core';
+/**
+ * Matches the elements that can be selected: the name of a model element (e.g. `'callout'`), or a function that returns
+ * whether it is for the given element (e.g. `element => element.hasAttribute('card')`).
+ */
+export type ElementSelectableMatcher = ElementMatcher;
+/**
+ * Makes elements selectable as a whole, which is what CKEditor's widgets do, without them: it does not change the view
+ * of the element, and does not need the `Widget` plugin. The elements are matched by name or by a filter function, and
+ * they are the `elementSelectable` editor config option:
+ *
+ * ```ts
+ * elementSelectable: ['callout', 'divider', element => element.hasAttribute('card')];
+ * ```
+ *
+ * An element is selected (the model selection is *on* it, and the view has a fake selection and the
+ * `ck-elements-selected` class):
+ *
+ * * **By a click** on the element. An element that has content, e.g. a container, is selected by a click on the element
+ *   itself, not on its content: a click in its text puts the cursor there, as it does without the plugin. An element
+ *   with no content (an object) is selected by a click anywhere in it.
+ * * **By the left and right arrow keys**: when the next step of the cursor enters or passes a selectable element (at the
+ *   end of a block, or before an inline element), the key selects it instead. With an element selected, the arrow keys
+ *   move the cursor to the content after (right, down) or before (left, up) it, or select the next selectable element,
+ *   if it is just there.
+ * * **By the Esc key**: with the cursor in an element, it selects the closest selectable one around the cursor, unless
+ *   something else handles Esc first, e.g. closes a balloon.
+ *
+ * A selected element is deleted, replaced by typing and copied, as any selected content.
+ *
+ * Names are made selectable in the model schema (`isSelectable`), so the selection on them is kept: a filter cannot,
+ * so the elements it matches must be selectable already (e.g. objects). Features can add elements with
+ * {@link ElementSelectable#add}.
+ */
+export default class ElementSelectable extends Plugin {
+    private readonly _matchers;
+    private _selected;
+    static get pluginName(): 'ElementSelectable';
+    init(): void;
+    afterInit(): void;
+    /**
+     * Makes more elements selectable, as the `elementSelectable` option does: a name of a model element, or a filter.
+     * Used by features that add elements, e.g. the element schema.
+     */
+    add(...matchers: ElementSelectableMatcher[]): void;
+    /**
+     * Returns whether the element can be selected by this plugin: it matches a name or a filter.
+     */
+    isSelectable(element: ModelElement): boolean;
+    /**
+     * Selects the element as a whole.
+     */
+    private _select;
+    /**
+     * Makes the model elements named in the matchers selectable in the schema, for the ones that are registered.
+     */
+    private _makeSelectable;
+    /**
+     * Returns the element a mouse down on the view element selects: the closest selectable element around it (or it), if
+     * the click is on the element itself, or the element has no content.
+     */
+    private _findToSelect;
+    /**
+     * Handles an arrow key. Returns whether the key moved the selection, and the browser must not.
+     */
+    private _handleArrowKey;
+    /**
+     * Returns the closest selectable element around the selection, not the selected one.
+     */
+    private _findAround;
+    /**
+     * Marks the selected view element with the class, and unmarks the one that was selected.
+     */
+    private _mark;
+}
+//# sourceMappingURL=elementSelectable.d.ts.map

package/dist/elementSelectable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementSelectable.d.ts","sourceRoot":"","sources":["../src/elementSelectable.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,MAAM,EAKN,KAAK,YAAY,EAKjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAyD,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGrH;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,cAAc,CAAC;AAOtD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,MAAM;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,SAAS,CAA4B;IAE7C,WAAkB,UAAU,IAAI,mBAAmB,CAElD;IAEM,IAAI,IAAI,IAAI;IAoFZ,SAAS,IAAI,IAAI;IAaxB;;;OAGG;IACI,GAAG,CAAC,GAAG,QAAQ,EAAE,wBAAwB,EAAE,GAAG,IAAI;IAKzD;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAInD;;OAEG;IACH,OAAO,CAAC,OAAO;IAMf;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,KAAK;CAeb"}

package/dist/elementSelectable.js

@@ -0,0 +1,198 @@
+import { MouseObserver, Plugin, keyCodes, isArrowKeyCode, isForwardArrowKeyCode } from 'ckeditor5';
+import { getElementsAround, keyboardPriorities, matchesElement } from 'ckeditor5-elements-core';
+import { findLeaveTarget, findSelectableAfterStep, findSelectableAround } from './navigation.js';
+/**
+ * The class of the selected element in the editing view.
+ */
+const SELECTED_CLASS = 'ck-elements-selected';
+/**
+ * Makes elements selectable as a whole, which is what CKEditor's widgets do, without them: it does not change the view
+ * of the element, and does not need the `Widget` plugin. The elements are matched by name or by a filter function, and
+ * they are the `elementSelectable` editor config option:
+ *
+ * ```ts
+ * elementSelectable: ['callout', 'divider', element => element.hasAttribute('card')];
+ * ```
+ *
+ * An element is selected (the model selection is *on* it, and the view has a fake selection and the
+ * `ck-elements-selected` class):
+ *
+ * * **By a click** on the element. An element that has content, e.g. a container, is selected by a click on the element
+ *   itself, not on its content: a click in its text puts the cursor there, as it does without the plugin. An element
+ *   with no content (an object) is selected by a click anywhere in it.
+ * * **By the left and right arrow keys**: when the next step of the cursor enters or passes a selectable element (at the
+ *   end of a block, or before an inline element), the key selects it instead. With an element selected, the arrow keys
+ *   move the cursor to the content after (right, down) or before (left, up) it, or select the next selectable element,
+ *   if it is just there.
+ * * **By the Esc key**: with the cursor in an element, it selects the closest selectable one around the cursor, unless
+ *   something else handles Esc first, e.g. closes a balloon.
+ *
+ * A selected element is deleted, replaced by typing and copied, as any selected content.
+ *
+ * Names are made selectable in the model schema (`isSelectable`), so the selection on them is kept: a filter cannot,
+ * so the elements it matches must be selectable already (e.g. objects). Features can add elements with
+ * {@link ElementSelectable#add}.
+ */
+export default class ElementSelectable extends Plugin {
+    _matchers = [];
+    _selected = null;
+    static get pluginName() {
+        return 'ElementSelectable';
+    }
+    init() {
+        const editor = this.editor;
+        const view = editor.editing.view;
+        const viewDocument = view.document;
+        this._matchers.push(...(editor.config.get('elementSelectable') ?? []));
+        // The selection of an element is a fake one, as for widgets: the browser does not draw the selection on its own.
+        editor.editing.downcastDispatcher.on('selection', (evt, data, conversionApi) => {
+            const element = data.selection.getSelectedElement();
+            const viewElement = element && this.isSelectable(element) ? editor.editing.mapper.toViewElement(element) : null;
+            if (element && viewElement && conversionApi.consumable.consume(data.selection, 'selection')) {
+                conversionApi.writer.setSelection(conversionApi.writer.createRangeOn(viewElement), {
+                    fake: true,
+                    label: `<${element.name}>`
+                });
+            }
+        });
+        editor.editing.downcastDispatcher.on('selection', (evt, data, conversionApi) => {
+            this._mark(conversionApi.writer, viewDocument.selection.getSelectedElement());
+        }, { priority: 'low' });
+        view.addObserver(MouseObserver);
+        this.listenTo(viewDocument, 'mousedown', (evt, data) => {
+            const element = this.isEnabled ? this._findToSelect(data.target) : null;
+            if (element) {
+                // The browser would put the cursor where the click is, and move the focus.
+                data.preventDefault();
+                view.focus();
+                this._select(element);
+            }
+        });
+        // The arrow keys are handled on `keydown`, before CKEditor's widgets, and not as the `arrowKey` event: that one
+        // bubbles from the selection, and CKEditor's widgets (loaded by other features, e.g. the clipboard) handle it for
+        // every object, in a context that is reached before this plugin could.
+        this.listenTo(viewDocument, 'keydown', (evt, data) => {
+            const isPlain = !data.shiftKey && !data.ctrlKey && !data.altKey && !data.metaKey;
+            if (this.isEnabled &&
+                isPlain &&
+                isArrowKeyCode(data.keyCode) &&
+                this._handleArrowKey(data.keyCode, isForwardArrowKeyCode(data.keyCode, editor.locale.contentLanguageDirection))) {
+                data.preventDefault();
+                evt.stop();
+            }
+        }, { priority: keyboardPriorities.selectable });
+        // Esc goes after what else uses it, e.g. closing a balloon. Editor keystrokes (`cancel()`)
+        // do not stop this event, they prevent the default action of the DOM event: then Esc is handled already.
+        this.listenTo(viewDocument, 'keydown', (evt, data) => {
+            const isFree = data.keystroke === keyCodes.esc && !data.domEvent.defaultPrevented;
+            const element = this.isEnabled && isFree ? this._findAround() : null;
+            if (element) {
+                this._select(element);
+                data.preventDefault();
+                evt.stop();
+            }
+        }, { priority: keyboardPriorities.selectableEsc });
+    }
+    afterInit() {
+        // Before the data is loaded, once all the elements are registered: also the ones that other plugins register in
+        // `afterInit()`, e.g. the element schema, whichever plugin comes first.
+        this.listenTo(this.editor.data, 'init', () => {
+            this._makeSelectable(this._matchers);
+        }, { priority: 'high' });
+    }
+    /**
+     * Makes more elements selectable, as the `elementSelectable` option does: a name of a model element, or a filter.
+     * Used by features that add elements, e.g. the element schema.
+     */
+    add(...matchers) {
+        this._matchers.push(...matchers);
+        this._makeSelectable(matchers);
+    }
+    /**
+     * Returns whether the element can be selected by this plugin: it matches a name or a filter.
+     */
+    isSelectable(element) {
+        return !element.is('rootElement') && this._matchers.some(matcher => matchesElement(matcher, element));
+    }
+    /**
+     * Selects the element as a whole.
+     */
+    _select(element) {
+        this.editor.model.change(writer => {
+            writer.setSelection(element, 'on');
+        });
+    }
+    /**
+     * Makes the model elements named in the matchers selectable in the schema, for the ones that are registered.
+     */
+    _makeSelectable(matchers) {
+        const schema = this.editor.model.schema;
+        for (const matcher of matchers) {
+            if (typeof matcher === 'string' && schema.isRegistered(matcher) && !schema.isSelectable(matcher)) {
+                schema.extend(matcher, { isSelectable: true });
+            }
+        }
+    }
+    /**
+     * Returns the element a mouse down on the view element selects: the closest selectable element around it (or it), if
+     * the click is on the element itself, or the element has no content.
+     */
+    _findToSelect(target) {
+        for (const { element, viewElement } of getElementsAround(this.editor.editing.mapper, target)) {
+            if (this.isSelectable(element) && (viewElement === target || element.isEmpty)) {
+                return element;
+            }
+        }
+        return null;
+    }
+    /**
+     * Handles an arrow key. Returns whether the key moved the selection, and the browser must not.
+     */
+    _handleArrowKey(keyCode, isForward) {
+        const model = this.editor.model;
+        const selection = model.document.selection;
+        const selected = selection.getSelectedElement();
+        const isSelectable = (element) => this.isSelectable(element);
+        if (selected && this.isSelectable(selected)) {
+            const target = findLeaveTarget(model, selected, isForward, isSelectable);
+            if (target) {
+                model.change(writer => {
+                    writer.setSelection(target);
+                });
+            }
+            // Also when there is nowhere to go: the browser would move the cursor into the fake selection.
+            return true;
+        }
+        // The up and down keys move in the lines of the text: only the browser knows where.
+        const isHorizontal = keyCode === keyCodes.arrowleft || keyCode === keyCodes.arrowright;
+        const next = isHorizontal && selection.isCollapsed
+            ? findSelectableAfterStep(model, selection, isForward, isSelectable)
+            : null;
+        if (next) {
+            this._select(next);
+        }
+        return !!next;
+    }
+    /**
+     * Returns the closest selectable element around the selection, not the selected one.
+     */
+    _findAround() {
+        return findSelectableAround(this.editor.model.document.selection, element => this.isSelectable(element));
+    }
+    /**
+     * Marks the selected view element with the class, and unmarks the one that was selected.
+     */
+    _mark(writer, selected) {
+        const mapper = this.editor.editing.mapper;
+        const element = selected && mapper.toModelElement(selected);
+        const marked = element && this.isSelectable(element) ? selected : null;
+        if (this._selected && this._selected !== marked) {
+            writer.removeClass(SELECTED_CLASS, this._selected);
+        }
+        if (marked) {
+            writer.addClass(SELECTED_CLASS, marked);
+        }
+        this._selected = marked;
+    }
+}
+//# sourceMappingURL=elementSelectable.js.map

package/dist/elementSelectable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementSelectable.js","sourceRoot":"","sources":["../src/elementSelectable.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Element interaction, without CKEditor's widgets: select an element as a whole by a click or by the arrow keys, and call
+ * a function, with the model element, when an element that matches a name or a filter is clicked or double-clicked.
+ *
+ * @module ckeditor5-elements-interaction
+ */
+export { default as ElementSelectable, type ElementSelectableMatcher } from './elementSelectable.js';
+export { default as ElementClickable, type ElementClickableDefinition, type ElementClickableEvent } from './elementClickable.js';
+export { default as DoubleClickObserver, type ViewDocumentDoubleClickEvent } from './doubleClickObserver.js';
+import './augmentation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACrG,OAAO,EACN,OAAO,IAAI,gBAAgB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,KAAK,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAE7G,OAAO,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * Element interaction, without CKEditor's widgets: select an element as a whole by a click or by the arrow keys, and call
+ * a function, with the model element, when an element that matches a name or a filter is clicked or double-clicked.
+ *
+ * @module ckeditor5-elements-interaction
+ */
+// Plugins.
+export { default as ElementSelectable } from './elementSelectable.js';
+export { default as ElementClickable } from './elementClickable.js';
+// Observers.
+export { default as DoubleClickObserver } from './doubleClickObserver.js';
+import './augmentation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,WAAW;AACX,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAiC,MAAM,wBAAwB,CAAC;AACrG,OAAO,EACN,OAAO,IAAI,gBAAgB,EAG3B,MAAM,uBAAuB,CAAC;AAE/B,aAAa;AACb,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAqC,MAAM,0BAA0B,CAAC;AAE7G,OAAO,mBAAmB,CAAC"}

package/dist/navigation.d.ts

@@ -0,0 +1,22 @@
+import type { Model, ModelDocumentSelection, ModelElement, ModelRange, ModelSelection } from 'ckeditor5';
+/**
+ * Whether an element can be selected as a whole.
+ */
+export type IsSelectable = (element: ModelElement) => boolean;
+/**
+ * Returns the selectable element that the cursor reaches with one step in the direction, as the arrow key moves it, or
+ * `null`: the next element is not selectable, or the step stays in the text. The step is CKEditor's: a character in the
+ * text, and the boundary between blocks, an inline object or an element at the end of a block. The first selectable
+ * element the step enters or passes is the one: the outermost, when it enters nested ones.
+ */
+export declare function findSelectableAfterStep(model: Model, selection: ModelSelection | ModelDocumentSelection, isForward: boolean, isSelectable: IsSelectable): ModelElement | null;
+/**
+ * Returns the range the selection goes to from the selected element in the direction: the next selectable element
+ * (selected as a whole) when it is just there, otherwise the nearest place of the content, or `null` when there is none.
+ */
+export declare function findLeaveTarget(model: Model, element: ModelElement, isForward: boolean, isSelectable: IsSelectable): ModelRange | null;
+/**
+ * Returns the closest selectable element around the selection, not the selected one, or `null`.
+ */
+export declare function findSelectableAround(selection: ModelSelection | ModelDocumentSelection, isSelectable: IsSelectable): ModelElement | null;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGzG;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,cAAc,GAAG,sBAAsB,EAClD,SAAS,EAAE,OAAO,EAClB,YAAY,EAAE,YAAY,GACxB,YAAY,GAAG,IAAI,CAuBrB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,OAAO,EAClB,YAAY,EAAE,YAAY,GACxB,UAAU,GAAG,IAAI,CAOnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,cAAc,GAAG,sBAAsB,EAClD,YAAY,EAAE,YAAY,GACxB,YAAY,GAAG,IAAI,CAUrB"}