@ckeditor/ckeditor5-table 40.0.0 → 40.2.0

package/src/utils/ui/widget.d.ts

@@ -1,16 +1,20 @@
-/**
- * @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 table/utils/ui/widget
- */
-import type { ViewDocumentSelection, ViewElement } from 'ckeditor5/src/engine';
-/**
- * Returns a table widget editing view element if one is selected.
- */
-export declare function getSelectedTableWidget(selection: ViewDocumentSelection): ViewElement | null;
-/**
- * Returns a table widget editing view element if one is among the selection's ancestors.
- */
-export declare function getTableWidgetAncestor(selection: ViewDocumentSelection): ViewElement | null;
+/**
+ * @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 table/utils/ui/widget
+ */
+import type { ViewDocumentSelection, ViewElement } from 'ckeditor5/src/engine';
+/**
+ * Depending on the position of the selection either return the selected table or the table higher in the hierarchy.
+ */
+export declare function getSelectionAffectedTableWidget(selection: ViewDocumentSelection): ViewElement | null;
+/**
+ * Returns a table widget editing view element if one is selected.
+ */
+export declare function getSelectedTableWidget(selection: ViewDocumentSelection): ViewElement | null;
+/**
+ * Returns a table widget editing view element if one is among the selection's ancestors.
+ */
+export declare function getTableWidgetAncestor(selection: ViewDocumentSelection): ViewElement | null;

package/src/utils/ui/widget.js

@@ -1,38 +1,48 @@
-/**
- * @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 { isWidget } from 'ckeditor5/src/widget';
-/**
- * Returns a table widget editing view element if one is selected.
- */
-export function getSelectedTableWidget(selection) {
-    const viewElement = selection.getSelectedElement();
-    if (viewElement && isTableWidget(viewElement)) {
-        return viewElement;
-    }
-    return null;
-}
-/**
- * Returns a table widget editing view element if one is among the selection's ancestors.
- */
-export function getTableWidgetAncestor(selection) {
-    const selectionPosition = selection.getFirstPosition();
-    if (!selectionPosition) {
-        return null;
-    }
-    let parent = selectionPosition.parent;
-    while (parent) {
-        if (parent.is('element') && isTableWidget(parent)) {
-            return parent;
-        }
-        parent = parent.parent;
-    }
-    return null;
-}
-/**
- * Checks if a given view element is a table widget.
- */
-function isTableWidget(viewElement) {
-    return !!viewElement.getCustomProperty('table') && isWidget(viewElement);
-}
+/**
+ * @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 { isWidget } from 'ckeditor5/src/widget';
+/**
+ * Depending on the position of the selection either return the selected table or the table higher in the hierarchy.
+ */
+export function getSelectionAffectedTableWidget(selection) {
+    const selectedTable = getSelectedTableWidget(selection);
+    if (selectedTable) {
+        return selectedTable;
+    }
+    return getTableWidgetAncestor(selection);
+}
+/**
+ * Returns a table widget editing view element if one is selected.
+ */
+export function getSelectedTableWidget(selection) {
+    const viewElement = selection.getSelectedElement();
+    if (viewElement && isTableWidget(viewElement)) {
+        return viewElement;
+    }
+    return null;
+}
+/**
+ * Returns a table widget editing view element if one is among the selection's ancestors.
+ */
+export function getTableWidgetAncestor(selection) {
+    const selectionPosition = selection.getFirstPosition();
+    if (!selectionPosition) {
+        return null;
+    }
+    let parent = selectionPosition.parent;
+    while (parent) {
+        if (parent.is('element') && isTableWidget(parent)) {
+            return parent;
+        }
+        parent = parent.parent;
+    }
+    return null;
+}
+/**
+ * Checks if a given view element is a table widget.
+ */
+function isTableWidget(viewElement) {
+    return !!viewElement.getCustomProperty('table') && isWidget(viewElement);
+}