@ckeditor/ckeditor5-table 45.2.1 → 46.0.0-alpha.0

package/src/tablewalker.d.ts

@@ -5,7 +5,7 @@
 /**
  * @module table/tablewalker
  */
-import type { Element, Position } from 'ckeditor5/src/engine.js';
+import type { ModelElement, ModelPosition } from 'ckeditor5/src/engine.js';
 /**
  * An object with configuration for `TableWalker`.
  */
@@ -43,13 +43,13 @@ export interface TableWalkerOptions {
  * The table iterator class. It allows to iterate over table cells. For each cell the iterator yields
  * {@link module:table/tablewalker~TableSlot} with proper table cell attributes.
  */
-export default class TableWalker implements IterableIterator<TableSlot> {
+export declare class TableWalker implements IterableIterator<TableSlot> {
     /**
      * The walker's table element.
      *
      * @internal
      */
-    readonly _table: Element;
+    readonly _table: ModelElement;
     /**
      * A row index from which this iterator will start.
      */
@@ -187,7 +187,7 @@ export default class TableWalker implements IterableIterator<TableSlot> {
      * @param options.endColumn A column index at which this iterator should end. Can't be used together with `column`.
      * @param options.includeAllSlots Also return values for spanned cells. Default value is "false".
      */
-    constructor(table: Element, options?: TableWalkerOptions);
+    constructor(table: ModelElement, options?: TableWalkerOptions);
     /**
      * Iterable interface.
      */
@@ -292,7 +292,7 @@ declare class TableSlot {
     /**
      * The current table cell.
      */
-    readonly cell: Element;
+    readonly cell: ModelElement;
     /**
      * The row index of a table slot.
      */
@@ -329,7 +329,7 @@ declare class TableSlot {
      * @param anchorRow The row index of a cell anchor slot.
      * @param anchorColumn The column index of a cell anchor slot.
      */
-    constructor(tableWalker: TableWalker, cell: Element, anchorRow: number, anchorColumn: number);
+    constructor(tableWalker: TableWalker, cell: ModelElement, anchorRow: number, anchorColumn: number);
     /**
      * Whether the cell is anchored in the current slot.
      */
@@ -347,9 +347,9 @@ declare class TableSlot {
      */
     get rowIndex(): number;
     /**
-     * Returns the {@link module:engine/model/position~Position} before the table slot.
+     * Returns the {@link module:engine/model/position~ModelPosition} before the table slot.
      */
-    getPositionBefore(): Position;
+    getPositionBefore(): ModelPosition;
 }
 export type { TableSlot };
 /**

package/src/tablewalker.js

@@ -6,7 +6,7 @@
  * The table iterator class. It allows to iterate over table cells. For each cell the iterator yields
  * {@link module:table/tablewalker~TableSlot} with proper table cell attributes.
  */
-export default class TableWalker {
+export class TableWalker {
     /**
      * The walker's table element.
      *
@@ -466,7 +466,7 @@ class TableSlot {
         return this._rowIndex;
     }
     /**
-     * Returns the {@link module:engine/model/position~Position} before the table slot.
+     * Returns the {@link module:engine/model/position~ModelPosition} before the table slot.
      */
     getPositionBefore() {
         const model = this._table.root.document.model;

package/src/ui/colorinputview.d.ts

@@ -8,6 +8,11 @@
 import { View, InputTextView, FocusCycler, ViewCollection, type ColorDefinition, type DropdownView, type ColorPickerConfig, type FocusableView } from 'ckeditor5/src/ui.js';
 import { FocusTracker, KeystrokeHandler, type Locale } from 'ckeditor5/src/utils.js';
 import '../../theme/colorinput.css';
+/**
+ * The options for the color input view.
+ *
+ * @internal
+ */
 export type ColorInputViewOptions = {
     colorDefinitions: Array<ColorDefinition>;
     columns: number;
@@ -20,7 +25,7 @@ export type ColorInputViewOptions = {
  *
  * @internal
  */
-export default class ColorInputView extends View implements FocusableView {
+export declare class ColorInputView extends View implements FocusableView {
     /**
      * The value of the input.
      *

package/src/ui/colorinputview.js

@@ -14,7 +14,7 @@ import '../../theme/colorinput.css';
  *
  * @internal
  */
-export default class ColorInputView extends View {
+export class ColorInputView extends View {
     /**
      * A cached reference to the options passed to the constructor.
      */

package/src/ui/inserttableview.d.ts

@@ -12,8 +12,10 @@ import './../../theme/inserttable.css';
  * The table size view.
  *
  * It renders a 10x10 grid to choose the inserted table size.
+ *
+ * @internal
  */
-export default class InsertTableView extends View {
+export declare class InsertTableView extends View {
     /**
      * A collection of table size box items.
      */

package/src/ui/inserttableview.js

@@ -12,8 +12,10 @@ import './../../theme/inserttable.css';
  * The table size view.
  *
  * It renders a 10x10 grid to choose the inserted table size.
+ *
+ * @internal
  */
-export default class InsertTableView extends View {
+export class InsertTableView extends View {
     /**
      * A collection of table size box items.
      */

package/src/utils/common.d.ts

@@ -5,42 +5,51 @@
 /**
  * @module table/utils/common
  */
-import type { Conversion, Element, Item, Position, Schema, Writer, DocumentSelection } from 'ckeditor5/src/engine.js';
-import type TableUtils from '../tableutils.js';
+import type { Conversion, ModelElement, ModelItem, ModelPosition, ModelSchema, ModelWriter, ModelDocumentSelection } from 'ckeditor5/src/engine.js';
+import { type TableUtils } from '../tableutils.js';
 /**
  * A common method to update the numeric value. If a value is the default one, it will be unset.
  *
+ * @internal
  * @param key An attribute key.
  * @param value The new attribute value.
  * @param item A model item on which the attribute will be set.
  * @param defaultValue The default attribute value. If a value is lower or equal, it will be unset.
  */
-export declare function updateNumericAttribute(key: string, value: unknown, item: Item, writer: Writer, defaultValue?: unknown): void;
+export declare function updateNumericAttribute(key: string, value: unknown, item: ModelItem, writer: ModelWriter, defaultValue?: unknown): void;
 /**
  * A common method to create an empty table cell. It creates a proper model structure as a table cell must have at least one block inside.
  *
+ * @internal
  * @param writer The model writer.
  * @param insertPosition The position at which the table cell should be inserted.
  * @param attributes The element attributes.
  * @returns Created table cell.
  */
-export declare function createEmptyTableCell(writer: Writer, insertPosition: Position, attributes?: Record<string, unknown>): Element;
+export declare function createEmptyTableCell(writer: ModelWriter, insertPosition: ModelPosition, attributes?: Record<string, unknown>): ModelElement;
 /**
  * Checks if a table cell belongs to the heading column section.
+ *
+ * @internal
  */
-export declare function isHeadingColumnCell(tableUtils: TableUtils, tableCell: Element): boolean;
+export declare function isHeadingColumnCell(tableUtils: TableUtils, tableCell: ModelElement): boolean;
 /**
  * Enables conversion for an attribute for simple view-model mappings.
  *
+ * @internal
  * @param options.defaultValue The default value for the specified `modelAttribute`.
  */
-export declare function enableProperty(schema: Schema, conversion: Conversion, options: {
+export declare function enableProperty(schema: ModelSchema, conversion: Conversion, options: {
     modelAttribute: string;
     styleName: string;
+    attributeName?: string;
+    attributeType?: 'length' | 'color';
     defaultValue: string;
     reduceBoxSides?: boolean;
 }): void;
 /**
  * Depending on the position of the selection we either return the table under cursor or look for the table higher in the hierarchy.
+ *
+ * @internal
  */
-export declare function getSelectionAffectedTable(selection: DocumentSelection): Element;
+export declare function getSelectionAffectedTable(selection: ModelDocumentSelection): ModelElement;

package/src/utils/common.js

@@ -2,10 +2,11 @@
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
-import { downcastAttributeToStyle, upcastStyleToAttribute } from './../converters/tableproperties.js';
+import { downcastAttributeToStyle, upcastStyleToAttribute } from '../converters/tableproperties.js';
 /**
  * A common method to update the numeric value. If a value is the default one, it will be unset.
  *
+ * @internal
  * @param key An attribute key.
  * @param value The new attribute value.
  * @param item A model item on which the attribute will be set.
@@ -22,6 +23,7 @@ export function updateNumericAttribute(key, value, item, writer, defaultValue =
 /**
  * A common method to create an empty table cell. It creates a proper model structure as a table cell must have at least one block inside.
  *
+ * @internal
  * @param writer The model writer.
  * @param insertPosition The position at which the table cell should be inserted.
  * @param attributes The element attributes.
@@ -35,6 +37,8 @@ export function createEmptyTableCell(writer, insertPosition, attributes = {}) {
 }
 /**
  * Checks if a table cell belongs to the heading column section.
+ *
+ * @internal
  */
 export function isHeadingColumnCell(tableUtils, tableCell) {
     const table = tableCell.parent.parent;
@@ -45,6 +49,7 @@ export function isHeadingColumnCell(tableUtils, tableCell) {
 /**
  * Enables conversion for an attribute for simple view-model mappings.
  *
+ * @internal
  * @param options.defaultValue The default value for the specified `modelAttribute`.
  */
 export function enableProperty(schema, conversion, options) {
@@ -52,11 +57,14 @@ export function enableProperty(schema, conversion, options) {
     schema.extend('tableCell', {
         allowAttributes: [modelAttribute]
     });
+    schema.setAttributeProperties(modelAttribute, { isFormatting: true });
     upcastStyleToAttribute(conversion, { viewElement: /^(td|th)$/, ...options });
     downcastAttributeToStyle(conversion, { modelElement: 'tableCell', ...options });
 }
 /**
  * Depending on the position of the selection we either return the table under cursor or look for the table higher in the hierarchy.
+ *
+ * @internal
  */
 export function getSelectionAffectedTable(selection) {
     const selectedElement = selection.getSelectedElement();

package/src/utils/structure.d.ts

@@ -5,9 +5,9 @@
 /**
  * @module table/utils/structure
  */
-import type { Element, Writer } from 'ckeditor5/src/engine.js';
+import type { ModelElement, ModelWriter } from 'ckeditor5/src/engine.js';
 import { type TableSlot } from '../tablewalker.js';
-import type TableUtils from '../tableutils.js';
+import { type TableUtils } from '../tableutils.js';
 /**
  * Returns a cropped table according to given dimensions.
 
@@ -36,13 +36,15 @@ import type TableUtils from '../tableutils.js';
  *      ├───┼───┬───┤   ├───┤                  └───────┴───┘
  *   4  │ n │ o │ p │   │ q │
  *      └───┴───┴───┴───┴───┘
+ *
+ * @internal
  */
-export declare function cropTableToDimensions(sourceTable: Element, cropDimensions: {
+export declare function cropTableToDimensions(sourceTable: ModelElement, cropDimensions: {
     startRow: number;
     startColumn: number;
     endRow: number;
     endColumn: number;
-}, writer: Writer): Element;
+}, writer: ModelWriter): ModelElement;
 /**
  * Returns slot info of cells that starts above and overlaps a given row.
  *
@@ -62,17 +64,19 @@ export declare function cropTableToDimensions(sourceTable: Element, cropDimensio
  *
  * will return slot info for cells: "j", "f", "k".
  *
+ * @internal
  * @param table The table to check.
  * @param overlapRow The index of the row to check.
  * @param startRow row to start analysis. Use it when it is known that the cells above that row will not overlap. Default value is 0.
  */
-export declare function getVerticallyOverlappingCells(table: Element, overlapRow: number, startRow?: number): Array<TableSlot>;
+export declare function getVerticallyOverlappingCells(table: ModelElement, overlapRow: number, startRow?: number): Array<TableSlot>;
 /**
  * Splits the table cell horizontally.
  *
+ * @internal
  * @returns Created table cell, if any were created.
  */
-export declare function splitHorizontally(tableCell: Element, splitRow: number, writer: Writer): Element | null;
+export declare function splitHorizontally(tableCell: ModelElement, splitRow: number, writer: ModelWriter): ModelElement | null;
 /**
  * Returns slot info of cells that starts before and overlaps a given column.
  *
@@ -95,25 +99,29 @@ export declare function splitHorizontally(tableCell: Element, splitRow: number,
  *
  * will return slot info for cells: "b", "e", "i".
  *
+ * @internal
  * @param table The table to check.
  * @param overlapColumn The index of the column to check.
  */
-export declare function getHorizontallyOverlappingCells(table: Element, overlapColumn: number): Array<TableSlot>;
+export declare function getHorizontallyOverlappingCells(table: ModelElement, overlapColumn: number): Array<TableSlot>;
 /**
  * Splits the table cell vertically.
  *
+ * @internal
  * @param columnIndex The table cell column index.
  * @param splitColumn The index of column to split cell on.
  * @returns Created table cell.
  */
-export declare function splitVertically(tableCell: Element, columnIndex: number, splitColumn: number, writer: Writer): Element;
+export declare function splitVertically(tableCell: ModelElement, columnIndex: number, splitColumn: number, writer: ModelWriter): ModelElement;
 /**
  * Adjusts table cell dimensions to not exceed limit row and column.
  *
  * If table cell width (or height) covers a column (or row) that is after a limit column (or row)
  * this method will trim "colspan" (or "rowspan") attribute so the table cell will fit in a defined limits.
+ *
+ * @internal
  */
-export declare function trimTableCellIfNeeded(tableCell: Element, cellRow: number, cellColumn: number, limitRow: number, limitColumn: number, writer: Writer): void;
+export declare function trimTableCellIfNeeded(tableCell: ModelElement, cellRow: number, cellColumn: number, limitRow: number, limitColumn: number, writer: ModelWriter): void;
 /**
  * Removes columns that have no cells anchored.
  *
@@ -136,7 +144,7 @@ export declare function trimTableCellIfNeeded(tableCell: Element, cellRow: numbe
  * @internal
  * @returns True if removed some columns.
  */
-export declare function removeEmptyColumns(table: Element, tableUtils: TableUtils): boolean;
+export declare function removeEmptyColumns(table: ModelElement, tableUtils: TableUtils): boolean;
 /**
  * Removes rows that have no cells anchored.
  *
@@ -166,7 +174,7 @@ export declare function removeEmptyColumns(table: Element, tableUtils: TableUtil
  * @internal
  * @returns True if removed some rows.
  */
-export declare function removeEmptyRows(table: Element, tableUtils: TableUtils): boolean;
+export declare function removeEmptyRows(table: ModelElement, tableUtils: TableUtils): boolean;
 /**
  * Removes rows and columns that have no cells anchored.
  *
@@ -191,7 +199,7 @@ export declare function removeEmptyRows(table: Element, tableUtils: TableUtils):
  *
  * @internal
  */
-export declare function removeEmptyRowsColumns(table: Element, tableUtils: TableUtils): void;
+export declare function removeEmptyRowsColumns(table: ModelElement, tableUtils: TableUtils): void;
 /**
  * Returns adjusted last row index if selection covers part of a row with empty slots (spanned by other cells).
  * The `dimensions.lastRow` is equal to last row index but selection might be bigger.
@@ -208,9 +216,10 @@ export declare function removeEmptyRowsColumns(table: Element, tableUtils: Table
  *      3 |   |   |   |   |
  *        +---+---+---+---+
  *
+ * @internal
  * @returns Adjusted last row index.
  */
-export declare function adjustLastRowIndex(table: Element, dimensions: {
+export declare function adjustLastRowIndex(table: ModelElement, dimensions: {
     firstRow: number;
     firstColumn: number;
     lastRow: number;
@@ -235,9 +244,10 @@ export declare function adjustLastRowIndex(table: Element, dimensions: {
  *               ^
  *              last column, each cell has colspan = 2, so we need to return 3, not 2
  *
+ * @internal
  * @returns Adjusted last column index.
  */
-export declare function adjustLastColumnIndex(table: Element, dimensions: {
+export declare function adjustLastColumnIndex(table: ModelElement, dimensions: {
     firstRow: number;
     firstColumn: number;
     lastRow: number;

package/src/utils/structure.js

@@ -2,7 +2,7 @@
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
-import { default as TableWalker } from '../tablewalker.js';
+import { TableWalker } from '../tablewalker.js';
 import { createEmptyTableCell, updateNumericAttribute } from './common.js';
 /**
  * Returns a cropped table according to given dimensions.
@@ -32,6 +32,8 @@ import { createEmptyTableCell, updateNumericAttribute } from './common.js';
  *      ├───┼───┬───┤   ├───┤                  └───────┴───┘
  *   4  │ n │ o │ p │   │ q │
  *      └───┴───┴───┴───┴───┘
+ *
+ * @internal
  */
 export function cropTableToDimensions(sourceTable, cropDimensions, writer) {
     const { startRow, startColumn, endRow, endColumn } = cropDimensions;
@@ -93,6 +95,7 @@ export function cropTableToDimensions(sourceTable, cropDimensions, writer) {
  *
  * will return slot info for cells: "j", "f", "k".
  *
+ * @internal
  * @param table The table to check.
  * @param overlapRow The index of the row to check.
  * @param startRow row to start analysis. Use it when it is known that the cells above that row will not overlap. Default value is 0.
@@ -112,6 +115,7 @@ export function getVerticallyOverlappingCells(table, overlapRow, startRow = 0) {
 /**
  * Splits the table cell horizontally.
  *
+ * @internal
  * @returns Created table cell, if any were created.
  */
 export function splitHorizontally(tableCell, splitRow, writer) {
@@ -169,6 +173,7 @@ export function splitHorizontally(tableCell, splitRow, writer) {
  *
  * will return slot info for cells: "b", "e", "i".
  *
+ * @internal
  * @param table The table to check.
  * @param overlapColumn The index of the column to check.
  */
@@ -187,6 +192,7 @@ export function getHorizontallyOverlappingCells(table, overlapColumn) {
 /**
  * Splits the table cell vertically.
  *
+ * @internal
  * @param columnIndex The table cell column index.
  * @param splitColumn The index of column to split cell on.
  * @returns Created table cell.
@@ -213,6 +219,8 @@ export function splitVertically(tableCell, columnIndex, splitColumn, writer) {
  *
  * If table cell width (or height) covers a column (or row) that is after a limit column (or row)
  * this method will trim "colspan" (or "rowspan") attribute so the table cell will fit in a defined limits.
+ *
+ * @internal
  */
 export function trimTableCellIfNeeded(tableCell, cellRow, cellColumn, limitRow, limitColumn, writer) {
     const colspan = parseInt(tableCell.getAttribute('colspan') || '1');
@@ -377,6 +385,7 @@ export function removeEmptyRowsColumns(table, tableUtils) {
  *      3 |   |   |   |   |
  *        +---+---+---+---+
  *
+ * @internal
  * @returns Adjusted last row index.
  */
 export function adjustLastRowIndex(table, dimensions) {
@@ -413,6 +422,7 @@ export function adjustLastRowIndex(table, dimensions) {
  *               ^
  *              last column, each cell has colspan = 2, so we need to return 3, not 2
  *
+ * @internal
  * @returns Adjusted last column index.
  */
 export function adjustLastColumnIndex(table, dimensions) {

package/src/utils/table-properties.d.ts

@@ -5,7 +5,7 @@
 /**
  * @module table/utils/table-properties
  */
-import type { BoxSides } from 'ckeditor5/src/engine.js';
+import type { BoxStyleSides } from 'ckeditor5/src/engine.js';
 /**
  * Returns a string if all four values of box sides are equal.
  *
@@ -20,8 +20,10 @@ import type { BoxSides } from 'ckeditor5/src/engine.js';
  * getSingleValue( { top: 'foo', right: 'foo', bottom: 'bar', left: 'foo' } );
  * getSingleValue( { top: 'foo', right: 'foo' } );
  * ```
+ *
+ * @internal
  */
-export declare function getSingleValue(objectOrString: BoxSides | string | undefined): string | undefined;
+export declare function getSingleValue(objectOrString: BoxStyleSides | string | undefined): string | undefined;
 /**
  * Adds a unit to a value if the value is a number or a string representing a number.
  *
@@ -34,9 +36,15 @@ export declare function getSingleValue(objectOrString: BoxSides | string | undef
  * getSingleValue( 'foo', 'px' ); // 'foo'
  * ```
  *
+ * @internal
  * @param defaultUnit A default unit added to a numeric value.
  */
 export declare function addDefaultUnitToNumericValue(value: string | number | undefined, defaultUnit: string): string | number | undefined;
+/**
+ * Interface representing the normalized default properties for table and cell elements.
+ *
+ * @internal
+ */
 export interface NormalizedDefaultProperties {
     borderStyle: string;
     borderWidth: string;
@@ -51,6 +59,8 @@ export interface NormalizedDefaultProperties {
 }
 /**
  * Options used to determine which properties should be added to the normalized configuration.
+ *
+ * @internal
  */
 export type NormalizeTableDefaultPropertiesOptions = {
     /**
@@ -77,6 +87,7 @@ export type NormalizeTableDefaultPropertiesOptions = {
 /**
  * Returns the normalized configuration.
  *
+ * @internal
  * @param config The configuration to normalize.
  * @param options Options used to determine which properties should be added.
  */
@@ -84,6 +95,7 @@ export declare function getNormalizedDefaultProperties(config?: Partial<Normaliz
 /**
  * Returns the normalized default table properties.
  *
+ * @internal
  * @param config The configuration to normalize.
  * @param options Options used to determine which properties should be added.
  */
@@ -91,6 +103,7 @@ export declare function getNormalizedDefaultTableProperties(config?: Partial<Nor
 /**
  * Returns the normalized default cell properties.
  *
+ * @internal
  * @param config The configuration to normalize.
  * @param options Options used to determine which properties should be added.
  */

package/src/utils/table-properties.js

@@ -17,6 +17,8 @@ import { isObject } from 'es-toolkit/compat';
  * getSingleValue( { top: 'foo', right: 'foo', bottom: 'bar', left: 'foo' } );
  * getSingleValue( { top: 'foo', right: 'foo' } );
  * ```
+ *
+ * @internal
  */
 export function getSingleValue(objectOrString) {
     if (!objectOrString || !isObject(objectOrString)) {
@@ -39,6 +41,7 @@ export function getSingleValue(objectOrString) {
  * getSingleValue( 'foo', 'px' ); // 'foo'
  * ```
  *
+ * @internal
  * @param defaultUnit A default unit added to a numeric value.
  */
 export function addDefaultUnitToNumericValue(value, defaultUnit) {
@@ -54,6 +57,7 @@ export function addDefaultUnitToNumericValue(value, defaultUnit) {
 /**
  * Returns the normalized configuration.
  *
+ * @internal
  * @param config The configuration to normalize.
  * @param options Options used to determine which properties should be added.
  */
@@ -84,6 +88,7 @@ export function getNormalizedDefaultProperties(config, options = {}) {
 /**
  * Returns the normalized default table properties.
  *
+ * @internal
  * @param config The configuration to normalize.
  * @param options Options used to determine which properties should be added.
  */
@@ -100,6 +105,7 @@ export function getNormalizedDefaultTableProperties(config, options) {
 /**
  * Returns the normalized default cell properties.
  *
+ * @internal
  * @param config The configuration to normalize.
  * @param options Options used to determine which properties should be added.
  */

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

@@ -5,13 +5,14 @@
 /**
  * @module table/utils/ui/contextualballoon
  */
-import { type PositionOptions } from 'ckeditor5/src/utils.js';
+import { type DomOptimalPositionOptions } from 'ckeditor5/src/utils.js';
 import type { Editor } from 'ckeditor5/src/core.js';
 /**
  * A helper utility that positions the
  * {@link module:ui/panel/balloon/contextualballoon~ContextualBalloon contextual balloon} instance
  * with respect to the table in the editor content, if one is selected.
  *
+ * @internal
  * @param editor The editor instance.
  * @param target Either "cell" or "table". Determines the target the balloon will be attached to.
  */
@@ -23,7 +24,7 @@ export declare function repositionContextualBalloon(editor: Editor, target: stri
  *
  * @param editor The editor instance.
  */
-export declare function getBalloonTablePositionData(editor: Editor): Partial<PositionOptions>;
+export declare function getBalloonTablePositionData(editor: Editor): Partial<DomOptimalPositionOptions>;
 /**
  * Returns the positioning options that control the geometry of the
  * {@link module:ui/panel/balloon/contextualballoon~ContextualBalloon contextual balloon} with respect
@@ -31,4 +32,4 @@ export declare function getBalloonTablePositionData(editor: Editor): Partial<Pos
  *
  * @param editor The editor instance.
  */
-export declare function getBalloonCellPositionData(editor: Editor): Partial<PositionOptions>;
+export declare function getBalloonCellPositionData(editor: Editor): Partial<DomOptimalPositionOptions>;

package/src/utils/ui/contextualballoon.js

@@ -23,6 +23,7 @@ const BALLOON_POSITIONS = /* #__PURE__ */ (() => [
  * {@link module:ui/panel/balloon/contextualballoon~ContextualBalloon contextual balloon} instance
  * with respect to the table in the editor content, if one is selected.
  *
+ * @internal
  * @param editor The editor instance.
  * @param target Either "cell" or "table". Determines the target the balloon will be attached to.
  */