@ckeditor/ckeditor5-table 36.0.1 → 37.0.0-alpha.1

package/src/tablecaption/utils.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @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/tablecaption/utils
+ */
+import type { DocumentFragment, DocumentSelection, Element, ViewElement } from 'ckeditor5/src/engine';
+/**
+ * Checks if the provided model element is a `table`.
+ *
+ * @param modelElement Element to check if it is a table.
+ */
+export declare function isTable(modelElement: Element | DocumentFragment | null): boolean;
+/**
+ * Returns the caption model element from a given table element. Returns `null` if no caption is found.
+ *
+ * @param tableModelElement Table element in which we will try to find a caption element.
+ */
+export declare function getCaptionFromTableModelElement(tableModelElement: Element): Element | null;
+/**
+ * Returns the caption model element for a model selection. Returns `null` if the selection has no caption element ancestor.
+ *
+ * @param selection The selection checked for caption presence.
+ */
+export declare function getCaptionFromModelSelection(selection: DocumentSelection): Element | null;
+/**
+ * {@link module:engine/view/matcher~Matcher} pattern. Checks if a given element is a caption.
+ *
+ * There are two possible forms of the valid caption:
+ *  - A `<figcaption>` element inside a `<figure class="table">` element.
+ *  - A `<caption>` inside a <table>.
+ *
+ * @returns Returns the object accepted by {@link module:engine/view/matcher~Matcher} or `null` if the element cannot be matched.
+ */
+export declare function matchTableCaptionViewElement(element: ViewElement): {
+    name: true;
+} | null;
+/**
+ * Depending on the position of the selection we either return the table under cursor or look for the table higher in the hierarchy.
+ */
+export declare function getSelectionAffectedTable(selection: DocumentSelection): Element;

package/src/tablecaption/utils.js

@@ -2,54 +2,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 table/tablecaption/utils
- */
-
 /**
  * Checks if the provided model element is a `table`.
  *
- * @param {module:engine/model/element~Element} modelElement Element to check if it is a table.
- * @returns {Boolean}
+ * @param modelElement Element to check if it is a table.
  */
-export function isTable( modelElement ) {
-	return !!modelElement && modelElement.is( 'element', 'table' );
+export function isTable(modelElement) {
+    return !!modelElement && modelElement.is('element', 'table');
 }
-
 /**
  * Returns the caption model element from a given table element. Returns `null` if no caption is found.
  *
- * @param {module:engine/model/element~Element} tableModelElement Table element in which we will try to find a caption element.
- * @returns {module:engine/model/element~Element|null}
+ * @param tableModelElement Table element in which we will try to find a caption element.
  */
-export function getCaptionFromTableModelElement( tableModelElement ) {
-	for ( const node of tableModelElement.getChildren() ) {
-		if ( node.is( 'element', 'caption' ) ) {
-			return node;
-		}
-	}
-
-	return null;
+export function getCaptionFromTableModelElement(tableModelElement) {
+    for (const node of tableModelElement.getChildren()) {
+        if (node.is('element', 'caption')) {
+            return node;
+        }
+    }
+    return null;
 }
-
 /**
  * Returns the caption model element for a model selection. Returns `null` if the selection has no caption element ancestor.
  *
- * @param {module:engine/model/selection~Selection|module:engine/model/documentselection~DocumentSelection} selection
- * The selection checked for caption presence.
- * @returns {module:engine/model/element~Element|null}
+ * @param selection The selection checked for caption presence.
  */
-export function getCaptionFromModelSelection( selection ) {
-	const tableElement = getSelectionAffectedTable( selection );
-
-	if ( !tableElement ) {
-		return null;
-	}
-
-	return getCaptionFromTableModelElement( tableElement );
+export function getCaptionFromModelSelection(selection) {
+    const tableElement = getSelectionAffectedTable(selection);
+    if (!tableElement) {
+        return null;
+    }
+    return getCaptionFromTableModelElement(tableElement);
 }
-
 /**
  * {@link module:engine/view/matcher~Matcher} pattern. Checks if a given element is a caption.
  *
@@ -57,37 +42,26 @@ export function getCaptionFromModelSelection( selection ) {
  *  - A `<figcaption>` element inside a `<figure class="table">` element.
  *  - A `<caption>` inside a <table>.
  *
- * @param {module:engine/view/element~Element} element
- * @returns {Object|null} Returns the object accepted by {@link module:engine/view/matcher~Matcher} or `null` if the element
- * cannot be matched.
+ * @returns Returns the object accepted by {@link module:engine/view/matcher~Matcher} or `null` if the element cannot be matched.
  */
-export function matchTableCaptionViewElement( element ) {
-	const parent = element.parent;
-
-	if ( element.name == 'figcaption' && parent && parent.name == 'figure' && parent.hasClass( 'table' ) ) {
-		return { name: true };
-	}
-
-	if ( element.name == 'caption' && parent && parent.name == 'table' ) {
-		return { name: true };
-	}
-
-	return null;
+export function matchTableCaptionViewElement(element) {
+    const parent = element.parent;
+    if (element.name == 'figcaption' && parent && parent.is('element', 'figure') && parent.hasClass('table')) {
+        return { name: true };
+    }
+    if (element.name == 'caption' && parent && parent.is('element', 'table')) {
+        return { name: true };
+    }
+    return null;
 }
-
 /**
  * Depending on the position of the selection we either return the table under cursor or look for the table higher in the hierarchy.
- *
- * @param {module:engine/model/position~Position} position
- * @returns {module:engine/model/element~Element}
  */
-export function getSelectionAffectedTable( selection ) {
-	const selectedElement = selection.getSelectedElement();
-
-	// Is the command triggered from the `tableToolbar`?
-	if ( selectedElement && selectedElement.is( 'element', 'table' ) ) {
-		return selectedElement;
-	}
-
-	return selection.getFirstPosition().findAncestor( 'table' );
+export function getSelectionAffectedTable(selection) {
+    const selectedElement = selection.getSelectedElement();
+    // Is the command triggered from the `tableToolbar`?
+    if (selectedElement && selectedElement.is('element', 'table')) {
+        return selectedElement;
+    }
+    return selection.getFirstPosition().findAncestor('table');
 }

package/src/tablecaption.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @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/tablecaption
+ */
+import { Plugin, type PluginDependencies } from 'ckeditor5/src/core';
+import '../theme/tablecaption.css';
+/**
+ * The table caption plugin.
+ */
+export default class TableCaption extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): 'TableCaption';
+    /**
+     * @inheritDoc
+     */
+    static get requires(): PluginDependencies;
+}

package/src/tablecaption.js

@@ -2,34 +2,27 @@
  * @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/tablecaption
  */
-
 import { Plugin } from 'ckeditor5/src/core';
 import TableCaptionEditing from './tablecaption/tablecaptionediting';
 import TableCaptionUI from './tablecaption/tablecaptionui';
-
 import '../theme/tablecaption.css';
-
 /**
  * The table caption plugin.
- *
- * @extends module:core/plugin~Plugin
  */
 export default class TableCaption extends Plugin {
-	/**
-	 * @inheritDoc
-	 */
-	static get pluginName() {
-		return 'TableCaption';
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	static get requires() {
-		return [ TableCaptionEditing, TableCaptionUI ];
-	}
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'TableCaption';
+    }
+    /**
+     * @inheritDoc
+     */
+    static get requires() {
+        return [TableCaptionEditing, TableCaptionUI];
+    }
 }

package/src/tablecellproperties/commands/tablecellbackgroundcolorcommand.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @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/tablecellproperties/commands/tablecellbackgroundcolorcommand
+ */
+import type { Editor } from 'ckeditor5/src/core';
+import TableCellPropertyCommand from './tablecellpropertycommand';
+/**
+ * The table cell background color command.
+ *
+ * The command is registered by the {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing} as
+ * the `'tableCellBackgroundColor'` editor command.
+ *
+ * To change the background color of selected cells, execute the command:
+ *
+ * ```ts
+ * editor.execute( 'tableCellBackgroundColor', {
+ *   value: '#f00'
+ * } );
+ * ```
+ */
+export default class TableCellBackgroundColorCommand extends TableCellPropertyCommand {
+    /**
+     * Creates a new `TableCellBackgroundColorCommand` instance.
+     *
+     * @param editor An editor in which this command will be used.
+     * @param defaultValue The default value of the attribute.
+     */
+    constructor(editor: Editor, defaultValue: string);
+}

package/src/tablecellproperties/commands/tablecellbackgroundcolorcommand.js

@@ -2,13 +2,7 @@
  * @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/tablecellproperties/commands/tablecellbackgroundcolorcommand
- */
-
 import TableCellPropertyCommand from './tablecellpropertycommand';
-
 /**
  * The table cell background color command.
  *
@@ -17,20 +11,20 @@ import TableCellPropertyCommand from './tablecellpropertycommand';
  *
  * To change the background color of selected cells, execute the command:
  *
- *		editor.execute( 'tableCellBackgroundColor', {
- *			value: '#f00'
- *		} );
- *
- * @extends module:table/tablecellproperties/commands/tablecellpropertycommand~TableCellPropertyCommand
+ * ```ts
+ * editor.execute( 'tableCellBackgroundColor', {
+ *   value: '#f00'
+ * } );
+ * ```
  */
 export default class TableCellBackgroundColorCommand extends TableCellPropertyCommand {
-	/**
-	 * Creates a new `TableCellBackgroundColorCommand` instance.
-	 *
-	 * @param {module:core/editor/editor~Editor} editor An editor in which this command will be used.
-	 * @param {String} defaultValue The default value of the attribute.
-	 */
-	constructor( editor, defaultValue ) {
-		super( editor, 'tableCellBackgroundColor', defaultValue );
-	}
+    /**
+     * Creates a new `TableCellBackgroundColorCommand` instance.
+     *
+     * @param editor An editor in which this command will be used.
+     * @param defaultValue The default value of the attribute.
+     */
+    constructor(editor, defaultValue) {
+        super(editor, 'tableCellBackgroundColor', defaultValue);
+    }
 }

package/src/tablecellproperties/commands/tablecellbordercolorcommand.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @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/tablecellproperties/commands/tablecellbordercolorcommand
+ */
+import type { Element } from 'ckeditor5/src/engine';
+import type { Editor } from 'ckeditor5/src/core';
+import TableCellPropertyCommand from './tablecellpropertycommand';
+/**
+ * The table cell border color command.
+ *
+ * The command is registered by the {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing} as
+ * the `'tableCellBorderColor'` editor command.
+ *
+ * To change the border color of selected cells, execute the command:
+ *
+ * ```ts
+ * editor.execute( 'tableCellBorderColor', {
+ *   value: '#f00'
+ * } );
+ * ```
+ */
+export default class TableCellBorderColorCommand extends TableCellPropertyCommand {
+    /**
+     * Creates a new `TableCellBorderColorCommand` instance.
+     *
+     * @param editor An editor in which this command will be used.
+     * @param defaultValue The default value of the attribute.
+     */
+    constructor(editor: Editor, defaultValue: string);
+    /**
+     * @inheritDoc
+     */
+    protected _getAttribute(tableCell: Element): unknown;
+}

package/src/tablecellproperties/commands/tablecellbordercolorcommand.js

@@ -2,14 +2,8 @@
  * @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/tablecellproperties/commands/tablecellbordercolorcommand
- */
-
 import TableCellPropertyCommand from './tablecellpropertycommand';
 import { getSingleValue } from '../../utils/table-properties';
-
 /**
  * The table cell border color command.
  *
@@ -18,37 +12,33 @@ import { getSingleValue } from '../../utils/table-properties';
  *
  * To change the border color of selected cells, execute the command:
  *
- *		editor.execute( 'tableCellBorderColor', {
- *			value: '#f00'
- *		} );
- *
- * @extends module:table/tablecellproperties/commands/tablecellpropertycommand~TableCellPropertyCommand
+ * ```ts
+ * editor.execute( 'tableCellBorderColor', {
+ *   value: '#f00'
+ * } );
+ * ```
  */
 export default class TableCellBorderColorCommand extends TableCellPropertyCommand {
-	/**
-	 * Creates a new `TableCellBorderColorCommand` instance.
-	 *
-	 * @param {module:core/editor/editor~Editor} editor An editor in which this command will be used.
-	 * @param {String} defaultValue The default value of the attribute.
-	 */
-	constructor( editor, defaultValue ) {
-		super( editor, 'tableCellBorderColor', defaultValue );
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	_getAttribute( tableCell ) {
-		if ( !tableCell ) {
-			return;
-		}
-
-		const value = getSingleValue( tableCell.getAttribute( this.attributeName ) );
-
-		if ( value === this._defaultValue ) {
-			return;
-		}
-
-		return value;
-	}
+    /**
+     * Creates a new `TableCellBorderColorCommand` instance.
+     *
+     * @param editor An editor in which this command will be used.
+     * @param defaultValue The default value of the attribute.
+     */
+    constructor(editor, defaultValue) {
+        super(editor, 'tableCellBorderColor', defaultValue);
+    }
+    /**
+     * @inheritDoc
+     */
+    _getAttribute(tableCell) {
+        if (!tableCell) {
+            return;
+        }
+        const value = getSingleValue(tableCell.getAttribute(this.attributeName));
+        if (value === this._defaultValue) {
+            return;
+        }
+        return value;
+    }
 }

package/src/tablecellproperties/commands/tablecellborderstylecommand.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @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/tablecellproperties/commands/tablecellborderstylecommand
+ */
+import type { Editor } from 'ckeditor5/src/core';
+import type { Element } from 'ckeditor5/src/engine';
+import TableCellPropertyCommand from './tablecellpropertycommand';
+/**
+ * The table cell border style command.
+ *
+ * The command is registered by the {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing} as
+ * the `'tableCellBorderStyle'` editor command.
+ *
+ * To change the border style of selected cells, execute the command:
+ *
+ * ```ts
+ * editor.execute( 'tableCellBorderStyle', {
+ *   value: 'dashed'
+ * } );
+ * ```
+ */
+export default class TableCellBorderStyleCommand extends TableCellPropertyCommand {
+    /**
+     * Creates a new `TableCellBorderStyleCommand` instance.
+     *
+     * @param editor An editor in which this command will be used.
+     * @param defaultValue The default value of the attribute.
+     */
+    constructor(editor: Editor, defaultValue: string);
+    /**
+     * @inheritDoc
+     */
+    protected _getAttribute(tableCell: Element): unknown;
+}

package/src/tablecellproperties/commands/tablecellborderstylecommand.js

@@ -2,14 +2,8 @@
  * @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/tablecellproperties/commands/tablecellborderstylecommand
- */
-
 import TableCellPropertyCommand from './tablecellpropertycommand';
 import { getSingleValue } from '../../utils/table-properties';
-
 /**
  * The table cell border style command.
  *
@@ -18,37 +12,33 @@ import { getSingleValue } from '../../utils/table-properties';
  *
  * To change the border style of selected cells, execute the command:
  *
- *		editor.execute( 'tableCellBorderStyle', {
- *			value: 'dashed'
- *		} );
- *
- * @extends module:table/tablecellproperties/commands/tablecellpropertycommand~TableCellPropertyCommand
+ * ```ts
+ * editor.execute( 'tableCellBorderStyle', {
+ *   value: 'dashed'
+ * } );
+ * ```
  */
 export default class TableCellBorderStyleCommand extends TableCellPropertyCommand {
-	/**
-	 * Creates a new `TableCellBorderStyleCommand` instance.
-	 *
-	 * @param {module:core/editor/editor~Editor} editor An editor in which this command will be used.
-	 * @param {String} defaultValue The default value of the attribute.
-	 */
-	constructor( editor, defaultValue ) {
-		super( editor, 'tableCellBorderStyle', defaultValue );
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	_getAttribute( tableCell ) {
-		if ( !tableCell ) {
-			return;
-		}
-
-		const value = getSingleValue( tableCell.getAttribute( this.attributeName ) );
-
-		if ( value === this._defaultValue ) {
-			return;
-		}
-
-		return value;
-	}
+    /**
+     * Creates a new `TableCellBorderStyleCommand` instance.
+     *
+     * @param editor An editor in which this command will be used.
+     * @param defaultValue The default value of the attribute.
+     */
+    constructor(editor, defaultValue) {
+        super(editor, 'tableCellBorderStyle', defaultValue);
+    }
+    /**
+     * @inheritDoc
+     */
+    _getAttribute(tableCell) {
+        if (!tableCell) {
+            return;
+        }
+        const value = getSingleValue(tableCell.getAttribute(this.attributeName));
+        if (value === this._defaultValue) {
+            return;
+        }
+        return value;
+    }
 }

package/src/tablecellproperties/commands/tablecellborderwidthcommand.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @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/tablecellproperties/commands/tablecellborderwidthcommand
+ */
+import type { Editor } from 'ckeditor5/src/core';
+import type { Element } from 'ckeditor5/src/engine';
+import TableCellPropertyCommand from './tablecellpropertycommand';
+/**
+ * The table cell border width command.
+ *
+ * The command is registered by the {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing} as
+ * the `'tableCellBorderWidth'` editor command.
+ *
+ * To change the border width of selected cells, execute the command:
+ *
+ * ```ts
+ * editor.execute( 'tableCellBorderWidth', {
+ *   value: '5px'
+ * } );
+ * ```
+ *
+ * **Note**: This command adds the default `'px'` unit to numeric values. Executing:
+ *
+ * ```ts
+ * editor.execute( 'tableCellBorderWidth', {
+ *   value: '5'
+ * } );
+ * ```
+ *
+ * will set the `borderWidth` attribute to `'5px'` in the model.
+ */
+export default class TableCellBorderWidthCommand extends TableCellPropertyCommand {
+    /**
+     * Creates a new `TableCellBorderWidthCommand` instance.
+     *
+     * @param editor An editor in which this command will be used.
+     * @param defaultValue The default value of the attribute.
+     */
+    constructor(editor: Editor, defaultValue: string);
+    /**
+     * @inheritDoc
+     */
+    protected _getAttribute(tableCell: Element): unknown;
+    /**
+     * @inheritDoc
+     */
+    protected _getValueToSet(value: string | number | undefined): unknown;
+}