@ckeditor/ckeditor5-table 36.0.0 → 37.0.0-alpha.0

package/src/tablecellproperties/commands/tablecellborderstylecommand.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/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;
+}
+declare module '@ckeditor/ckeditor5-core' {
+    interface CommandsMap {
+        tableCellBorderStyle: TableCellBorderStyleCommand;
+    }
+}

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,56 @@
+/**
+ * @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;
+}
+declare module '@ckeditor/ckeditor5-core' {
+    interface CommandsMap {
+        tableCellBorderWidth: TableCellBorderWidthCommand;
+    }
+}

package/src/tablecellproperties/commands/tablecellborderwidthcommand.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/tablecellborderwidthcommand
- */
-
 import TableCellPropertyCommand from './tablecellpropertycommand';
 import { addDefaultUnitToNumericValue, getSingleValue } from '../../utils/table-properties';
-
 /**
  * The table cell border width command.
  *
@@ -18,58 +12,53 @@ import { addDefaultUnitToNumericValue, getSingleValue } from '../../utils/table-
  *
  * To change the border width of selected cells, execute the command:
  *
- *		editor.execute( 'tableCellBorderWidth', {
- *			value: '5px'
- *		} );
+ * ```ts
+ * editor.execute( 'tableCellBorderWidth', {
+ *   value: '5px'
+ * } );
+ * ```
  *
  * **Note**: This command adds the default `'px'` unit to numeric values. Executing:
  *
- *		editor.execute( 'tableCellBorderWidth', {
- *			value: '5'
- *		} );
+ * ```ts
+ * editor.execute( 'tableCellBorderWidth', {
+ *   value: '5'
+ * } );
+ * ```
  *
  * will set the `borderWidth` attribute to `'5px'` in the model.
- *
- * @extends module:table/tablecellproperties/commands/tablecellpropertycommand~TableCellPropertyCommand
  */
 export default class TableCellBorderWidthCommand extends TableCellPropertyCommand {
-	/**
-	 * Creates a new `TableCellBorderWidthCommand` 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, 'tableCellBorderWidth', defaultValue );
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	_getAttribute( tableCell ) {
-		if ( !tableCell ) {
-			return;
-		}
-
-		const value = getSingleValue( tableCell.getAttribute( this.attributeName ) );
-
-		if ( value === this._defaultValue ) {
-			return;
-		}
-
-		return value;
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	_getValueToSet( value ) {
-		value = addDefaultUnitToNumericValue( value, 'px' );
-
-		if ( value === this._defaultValue ) {
-			return;
-		}
-
-		return value;
-	}
+    /**
+     * 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, defaultValue) {
+        super(editor, 'tableCellBorderWidth', defaultValue);
+    }
+    /**
+     * @inheritDoc
+     */
+    _getAttribute(tableCell) {
+        if (!tableCell) {
+            return;
+        }
+        const value = getSingleValue(tableCell.getAttribute(this.attributeName));
+        if (value === this._defaultValue) {
+            return;
+        }
+        return value;
+    }
+    /**
+     * @inheritDoc
+     */
+    _getValueToSet(value) {
+        const newValue = addDefaultUnitToNumericValue(value, 'px');
+        if (newValue === this._defaultValue) {
+            return;
+        }
+        return newValue;
+    }
 }

package/src/tablecellproperties/commands/tablecellheightcommand.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/tablecellheightcommand
+ */
+import type { Editor } from 'ckeditor5/src/core';
+import TableCellPropertyCommand from './tablecellpropertycommand';
+/**
+ * The table cell height command.
+ *
+ * The command is registered by the {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing} as
+ * the `'tableCellHeight'` editor command.
+ *
+ * To change the height of selected cells, execute the command:
+ *
+ * ```ts
+ * editor.execute( 'tableCellHeight', {
+ *   value: '50px'
+ * } );
+ * ```
+ *
+ * **Note**: This command adds the default `'px'` unit to numeric values. Executing:
+ *
+ * ```ts
+ * editor.execute( 'tableCellHeight', {
+ *   value: '50'
+ * } );
+ * ```
+ *
+ * will set the `height` attribute to `'50px'` in the model.
+ */
+export default class TableCellHeightCommand extends TableCellPropertyCommand {
+    /**
+     * Creates a new `TableCellHeightCommand` 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 _getValueToSet(value: string | number | undefined): unknown;
+}
+declare module '@ckeditor/ckeditor5-core' {
+    interface CommandsMap {
+        tableCellHeight: TableCellHeightCommand;
+    }
+}

package/src/tablecellproperties/commands/tablecellheightcommand.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/tablecellheightcommand
- */
-
 import TableCellPropertyCommand from './tablecellpropertycommand';
 import { addDefaultUnitToNumericValue } from '../../utils/table-properties';
-
 /**
  * The table cell height command.
  *
@@ -18,41 +12,40 @@ import { addDefaultUnitToNumericValue } from '../../utils/table-properties';
  *
  * To change the height of selected cells, execute the command:
  *
- *		editor.execute( 'tableCellHeight', {
- *			value: '50px'
- *		} );
+ * ```ts
+ * editor.execute( 'tableCellHeight', {
+ *   value: '50px'
+ * } );
+ * ```
  *
  * **Note**: This command adds the default `'px'` unit to numeric values. Executing:
  *
- *		editor.execute( 'tableCellHeight', {
- *			value: '50'
- *		} );
+ * ```ts
+ * editor.execute( 'tableCellHeight', {
+ *   value: '50'
+ * } );
+ * ```
  *
  * will set the `height` attribute to `'50px'` in the model.
- *
- * @extends module:table/tablecellproperties/commands/tablecellpropertycommand~TableCellPropertyCommand
  */
 export default class TableCellHeightCommand extends TableCellPropertyCommand {
-	/**
-	 * Creates a new `TableCellHeightCommand` 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, 'tableCellHeight', defaultValue );
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	_getValueToSet( value ) {
-		value = addDefaultUnitToNumericValue( value, 'px' );
-
-		if ( value === this._defaultValue ) {
-			return null;
-		}
-
-		return value;
-	}
+    /**
+     * Creates a new `TableCellHeightCommand` 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, 'tableCellHeight', defaultValue);
+    }
+    /**
+     * @inheritDoc
+     */
+    _getValueToSet(value) {
+        const newValue = addDefaultUnitToNumericValue(value, 'px');
+        if (newValue === this._defaultValue) {
+            return;
+        }
+        return newValue;
+    }
 }

package/src/tablecellproperties/commands/tablecellhorizontalalignmentcommand.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/tablecellhorizontalalignmentcommand
+ */
+import type { Editor } from 'ckeditor5/src/core';
+import TableCellPropertyCommand from './tablecellpropertycommand';
+/**
+ * The table cell horizontal alignment command.
+ *
+ * The command is registered by the {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing} as
+ * the `'tableCellHorizontalAlignment'` editor command.
+ *
+ * To change the horizontal text alignment of selected cells, execute the command:
+ *
+ * ```ts
+ * editor.execute( 'tableCellHorizontalAlignment', {
+ *  value: 'right'
+ * } );
+ * ```
+ */
+export default class TableCellHorizontalAlignmentCommand extends TableCellPropertyCommand {
+    /**
+     * Creates a new `TableCellHorizontalAlignmentCommand` instance.
+     *
+     * @param editor An editor in which this command will be used.
+     * @param defaultValue The default value for the "alignment" attribute.
+     */
+    constructor(editor: Editor, defaultValue: string);
+}
+declare module '@ckeditor/ckeditor5-core' {
+    interface CommandsMap {
+        tableCellHorizontalAlignment: TableCellHorizontalAlignmentCommand;
+    }
+}

package/src/tablecellproperties/commands/tablecellhorizontalalignmentcommand.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/tablecellhorizontalalignmentcommand
- */
-
 import TableCellPropertyCommand from './tablecellpropertycommand';
-
 /**
  * The table cell horizontal alignment command.
  *
@@ -17,20 +11,20 @@ import TableCellPropertyCommand from './tablecellpropertycommand';
  *
  * To change the horizontal text alignment of selected cells, execute the command:
  *
- *		editor.execute( 'tableCellHorizontalAlignment', {
- *			value: 'right'
- *		} );
- *
- * @extends module:table/tablecellproperties/commands/tablecellpropertycommand~TableCellPropertyCommand
+ * ```ts
+ * editor.execute( 'tableCellHorizontalAlignment', {
+ *  value: 'right'
+ * } );
+ * ```
  */
 export default class TableCellHorizontalAlignmentCommand extends TableCellPropertyCommand {
-	/**
-	 * Creates a new `TableCellHorizontalAlignmentCommand` instance.
-	 *
-	 * @param {module:core/editor/editor~Editor} editor An editor in which this command will be used.
-	 * @param {String} defaultValue The default value for the "alignment" attribute.
-	 */
-	constructor( editor, defaultValue ) {
-		super( editor, 'tableCellHorizontalAlignment', defaultValue );
-	}
+    /**
+     * Creates a new `TableCellHorizontalAlignmentCommand` instance.
+     *
+     * @param editor An editor in which this command will be used.
+     * @param defaultValue The default value for the "alignment" attribute.
+     */
+    constructor(editor, defaultValue) {
+        super(editor, 'tableCellHorizontalAlignment', defaultValue);
+    }
 }

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

@@ -0,0 +1,56 @@
+/**
+ * @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/tablecellpaddingcommand
+ */
+import type { Editor } from 'ckeditor5/src/core';
+import type { Element } from 'ckeditor5/src/engine';
+import TableCellPropertyCommand from './tablecellpropertycommand';
+/**
+ * The table cell padding command.
+ *
+ * The command is registered by the {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing} as
+ * the `'tableCellPadding'` editor command.
+ *
+ * To change the padding of selected cells, execute the command:
+ *
+ * ```ts
+ * editor.execute( 'tableCellPadding', {
+ *   value: '5px'
+ * } );
+ * ```
+ *
+ * **Note**: This command adds the default `'px'` unit to numeric values. Executing:
+ *
+ * ```ts
+ * editor.execute( 'tableCellPadding', {
+ *   value: '5'
+ * } );
+ * ```
+ *
+ * will set the `padding` attribute to `'5px'` in the model.
+ */
+export default class TableCellPaddingCommand extends TableCellPropertyCommand {
+    /**
+     * Creates a new `TableCellPaddingCommand` 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;
+}
+declare module '@ckeditor/ckeditor5-core' {
+    interface CommandsMap {
+        tableCellPadding: TableCellPaddingCommand;
+    }
+}