@ckeditor/ckeditor5-table 39.0.2 → 40.0.0

package/src/commands/setheadercolumncommand.js

@@ -1,71 +1,71 @@
-/**
- * @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/commands/setheadercolumncommand
- */
-import { Command } from 'ckeditor5/src/core';
-import { isHeadingColumnCell, updateNumericAttribute } from '../utils/common';
-import { getHorizontallyOverlappingCells, splitVertically } from '../utils/structure';
-/**
- * The header column command.
- *
- * The command is registered by {@link module:table/tableediting~TableEditing} as the `'setTableColumnHeader'` editor command.
- *
- * You can make the column containing the selected cell a [header](https://www.w3.org/TR/html50/tabular-data.html#the-th-element)
- * by executing:
- *
- * ```ts
- * editor.execute( 'setTableColumnHeader' );
- * ```
- *
- * **Note:** All preceding columns will also become headers. If the current column is already a header, executing this command
- * will make it a regular column back again (including the following columns).
- */
-export default class SetHeaderColumnCommand extends Command {
-    /**
-     * @inheritDoc
-     */
-    refresh() {
-        const model = this.editor.model;
-        const tableUtils = this.editor.plugins.get('TableUtils');
-        const selectedCells = tableUtils.getSelectionAffectedTableCells(model.document.selection);
-        const isInTable = selectedCells.length > 0;
-        this.isEnabled = isInTable;
-        this.value = isInTable && selectedCells.every(cell => isHeadingColumnCell(tableUtils, cell));
-    }
-    /**
-     * Executes the command.
-     *
-     * When the selection is in a non-header column, the command will set the `headingColumns` table attribute to cover that column.
-     *
-     * When the selection is already in a header column, it will set `headingColumns` so the heading section will end before that column.
-     *
-     * @fires execute
-     * @param options.forceValue If set, the command will set (`true`) or unset (`false`) the header columns according to
-     * the `forceValue` parameter instead of the current model state.
-     */
-    execute(options = {}) {
-        if (options.forceValue === this.value) {
-            return;
-        }
-        const tableUtils = this.editor.plugins.get('TableUtils');
-        const model = this.editor.model;
-        const selectedCells = tableUtils.getSelectionAffectedTableCells(model.document.selection);
-        const table = selectedCells[0].findAncestor('table');
-        const { first, last } = tableUtils.getColumnIndexes(selectedCells);
-        const headingColumnsToSet = this.value ? first : last + 1;
-        model.change(writer => {
-            if (headingColumnsToSet) {
-                // Changing heading columns requires to check if any of a heading cell is overlapping horizontally the table head.
-                // Any table cell that has a colspan attribute > 1 will not exceed the table head so we need to fix it in columns before.
-                const overlappingCells = getHorizontallyOverlappingCells(table, headingColumnsToSet);
-                for (const { cell, column } of overlappingCells) {
-                    splitVertically(cell, column, headingColumnsToSet, writer);
-                }
-            }
-            updateNumericAttribute('headingColumns', headingColumnsToSet, table, writer, 0);
-        });
-    }
-}
+/**
+ * @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/commands/setheadercolumncommand
+ */
+import { Command } from 'ckeditor5/src/core';
+import { isHeadingColumnCell, updateNumericAttribute } from '../utils/common';
+import { getHorizontallyOverlappingCells, splitVertically } from '../utils/structure';
+/**
+ * The header column command.
+ *
+ * The command is registered by {@link module:table/tableediting~TableEditing} as the `'setTableColumnHeader'` editor command.
+ *
+ * You can make the column containing the selected cell a [header](https://www.w3.org/TR/html50/tabular-data.html#the-th-element)
+ * by executing:
+ *
+ * ```ts
+ * editor.execute( 'setTableColumnHeader' );
+ * ```
+ *
+ * **Note:** All preceding columns will also become headers. If the current column is already a header, executing this command
+ * will make it a regular column back again (including the following columns).
+ */
+export default class SetHeaderColumnCommand extends Command {
+    /**
+     * @inheritDoc
+     */
+    refresh() {
+        const model = this.editor.model;
+        const tableUtils = this.editor.plugins.get('TableUtils');
+        const selectedCells = tableUtils.getSelectionAffectedTableCells(model.document.selection);
+        const isInTable = selectedCells.length > 0;
+        this.isEnabled = isInTable;
+        this.value = isInTable && selectedCells.every(cell => isHeadingColumnCell(tableUtils, cell));
+    }
+    /**
+     * Executes the command.
+     *
+     * When the selection is in a non-header column, the command will set the `headingColumns` table attribute to cover that column.
+     *
+     * When the selection is already in a header column, it will set `headingColumns` so the heading section will end before that column.
+     *
+     * @fires execute
+     * @param options.forceValue If set, the command will set (`true`) or unset (`false`) the header columns according to
+     * the `forceValue` parameter instead of the current model state.
+     */
+    execute(options = {}) {
+        if (options.forceValue === this.value) {
+            return;
+        }
+        const tableUtils = this.editor.plugins.get('TableUtils');
+        const model = this.editor.model;
+        const selectedCells = tableUtils.getSelectionAffectedTableCells(model.document.selection);
+        const table = selectedCells[0].findAncestor('table');
+        const { first, last } = tableUtils.getColumnIndexes(selectedCells);
+        const headingColumnsToSet = this.value ? first : last + 1;
+        model.change(writer => {
+            if (headingColumnsToSet) {
+                // Changing heading columns requires to check if any of a heading cell is overlapping horizontally the table head.
+                // Any table cell that has a colspan attribute > 1 will not exceed the table head so we need to fix it in columns before.
+                const overlappingCells = getHorizontallyOverlappingCells(table, headingColumnsToSet);
+                for (const { cell, column } of overlappingCells) {
+                    splitVertically(cell, column, headingColumnsToSet, writer);
+                }
+            }
+            updateNumericAttribute('headingColumns', headingColumnsToSet, table, writer, 0);
+        });
+    }
+}

package/src/commands/setheaderrowcommand.d.ts

@@ -1,53 +1,53 @@
-/**
- * @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/commands/setheaderrowcommand
- */
-import { Command } from 'ckeditor5/src/core';
-/**
- * The header row command.
- *
- * The command is registered by {@link module:table/tableediting~TableEditing} as the `'setTableColumnHeader'` editor command.
- *
- * You can make the row containing the selected cell a [header](https://www.w3.org/TR/html50/tabular-data.html#the-th-element) by executing:
- *
- * ```ts
- * editor.execute( 'setTableRowHeader' );
- * ```
- *
- * **Note:** All preceding rows will also become headers. If the current row is already a header, executing this command
- * will make it a regular row back again (including the following rows).
- */
-export default class SetHeaderRowCommand extends Command {
-    /**
-     * Flag indicating whether the command is active. The command is active when the
-     * {@link module:engine/model/selection~Selection} is in a header row.
-     *
-     * @observable
-     */
-    value: boolean;
-    /**
-     * @inheritDoc
-     */
-    refresh(): void;
-    /**
-     * Executes the command.
-     *
-     * When the selection is in a non-header row, the command will set the `headingRows` table attribute to cover that row.
-     *
-     * When the selection is already in a header row, it will set `headingRows` so the heading section will end before that row.
-     *
-     * @fires execute
-     * @param options.forceValue If set, the command will set (`true`) or unset (`false`) the header rows according to
-     * the `forceValue` parameter instead of the current model state.
-     */
-    execute(options?: {
-        forceValue?: boolean;
-    }): void;
-    /**
-     * Checks if a table cell is in the heading section.
-     */
-    private _isInHeading;
-}
+/**
+ * @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/commands/setheaderrowcommand
+ */
+import { Command } from 'ckeditor5/src/core';
+/**
+ * The header row command.
+ *
+ * The command is registered by {@link module:table/tableediting~TableEditing} as the `'setTableColumnHeader'` editor command.
+ *
+ * You can make the row containing the selected cell a [header](https://www.w3.org/TR/html50/tabular-data.html#the-th-element) by executing:
+ *
+ * ```ts
+ * editor.execute( 'setTableRowHeader' );
+ * ```
+ *
+ * **Note:** All preceding rows will also become headers. If the current row is already a header, executing this command
+ * will make it a regular row back again (including the following rows).
+ */
+export default class SetHeaderRowCommand extends Command {
+    /**
+     * Flag indicating whether the command is active. The command is active when the
+     * {@link module:engine/model/selection~Selection} is in a header row.
+     *
+     * @observable
+     */
+    value: boolean;
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * Executes the command.
+     *
+     * When the selection is in a non-header row, the command will set the `headingRows` table attribute to cover that row.
+     *
+     * When the selection is already in a header row, it will set `headingRows` so the heading section will end before that row.
+     *
+     * @fires execute
+     * @param options.forceValue If set, the command will set (`true`) or unset (`false`) the header rows according to
+     * the `forceValue` parameter instead of the current model state.
+     */
+    execute(options?: {
+        forceValue?: boolean;
+    }): void;
+    /**
+     * Checks if a table cell is in the heading section.
+     */
+    private _isInHeading;
+}

package/src/commands/setheaderrowcommand.js

@@ -1,79 +1,79 @@
-/**
- * @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/commands/setheaderrowcommand
- */
-import { Command } from 'ckeditor5/src/core';
-import { updateNumericAttribute } from '../utils/common';
-import { getVerticallyOverlappingCells, splitHorizontally } from '../utils/structure';
-/**
- * The header row command.
- *
- * The command is registered by {@link module:table/tableediting~TableEditing} as the `'setTableColumnHeader'` editor command.
- *
- * You can make the row containing the selected cell a [header](https://www.w3.org/TR/html50/tabular-data.html#the-th-element) by executing:
- *
- * ```ts
- * editor.execute( 'setTableRowHeader' );
- * ```
- *
- * **Note:** All preceding rows will also become headers. If the current row is already a header, executing this command
- * will make it a regular row back again (including the following rows).
- */
-export default class SetHeaderRowCommand extends Command {
-    /**
-     * @inheritDoc
-     */
-    refresh() {
-        const tableUtils = this.editor.plugins.get('TableUtils');
-        const model = this.editor.model;
-        const selectedCells = tableUtils.getSelectionAffectedTableCells(model.document.selection);
-        const isInTable = selectedCells.length > 0;
-        this.isEnabled = isInTable;
-        this.value = isInTable && selectedCells.every(cell => this._isInHeading(cell, cell.parent.parent));
-    }
-    /**
-     * Executes the command.
-     *
-     * When the selection is in a non-header row, the command will set the `headingRows` table attribute to cover that row.
-     *
-     * When the selection is already in a header row, it will set `headingRows` so the heading section will end before that row.
-     *
-     * @fires execute
-     * @param options.forceValue If set, the command will set (`true`) or unset (`false`) the header rows according to
-     * the `forceValue` parameter instead of the current model state.
-     */
-    execute(options = {}) {
-        if (options.forceValue === this.value) {
-            return;
-        }
-        const tableUtils = this.editor.plugins.get('TableUtils');
-        const model = this.editor.model;
-        const selectedCells = tableUtils.getSelectionAffectedTableCells(model.document.selection);
-        const table = selectedCells[0].findAncestor('table');
-        const { first, last } = tableUtils.getRowIndexes(selectedCells);
-        const headingRowsToSet = this.value ? first : last + 1;
-        const currentHeadingRows = table.getAttribute('headingRows') || 0;
-        model.change(writer => {
-            if (headingRowsToSet) {
-                // Changing heading rows requires to check if any of a heading cell is overlapping vertically the table head.
-                // Any table cell that has a rowspan attribute > 1 will not exceed the table head so we need to fix it in rows below.
-                const startRow = headingRowsToSet > currentHeadingRows ? currentHeadingRows : 0;
-                const overlappingCells = getVerticallyOverlappingCells(table, headingRowsToSet, startRow);
-                for (const { cell } of overlappingCells) {
-                    splitHorizontally(cell, headingRowsToSet, writer);
-                }
-            }
-            updateNumericAttribute('headingRows', headingRowsToSet, table, writer, 0);
-        });
-    }
-    /**
-     * Checks if a table cell is in the heading section.
-     */
-    _isInHeading(tableCell, table) {
-        const headingRows = parseInt(table.getAttribute('headingRows') || '0');
-        return !!headingRows && tableCell.parent.index < headingRows;
-    }
-}
+/**
+ * @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/commands/setheaderrowcommand
+ */
+import { Command } from 'ckeditor5/src/core';
+import { updateNumericAttribute } from '../utils/common';
+import { getVerticallyOverlappingCells, splitHorizontally } from '../utils/structure';
+/**
+ * The header row command.
+ *
+ * The command is registered by {@link module:table/tableediting~TableEditing} as the `'setTableColumnHeader'` editor command.
+ *
+ * You can make the row containing the selected cell a [header](https://www.w3.org/TR/html50/tabular-data.html#the-th-element) by executing:
+ *
+ * ```ts
+ * editor.execute( 'setTableRowHeader' );
+ * ```
+ *
+ * **Note:** All preceding rows will also become headers. If the current row is already a header, executing this command
+ * will make it a regular row back again (including the following rows).
+ */
+export default class SetHeaderRowCommand extends Command {
+    /**
+     * @inheritDoc
+     */
+    refresh() {
+        const tableUtils = this.editor.plugins.get('TableUtils');
+        const model = this.editor.model;
+        const selectedCells = tableUtils.getSelectionAffectedTableCells(model.document.selection);
+        const isInTable = selectedCells.length > 0;
+        this.isEnabled = isInTable;
+        this.value = isInTable && selectedCells.every(cell => this._isInHeading(cell, cell.parent.parent));
+    }
+    /**
+     * Executes the command.
+     *
+     * When the selection is in a non-header row, the command will set the `headingRows` table attribute to cover that row.
+     *
+     * When the selection is already in a header row, it will set `headingRows` so the heading section will end before that row.
+     *
+     * @fires execute
+     * @param options.forceValue If set, the command will set (`true`) or unset (`false`) the header rows according to
+     * the `forceValue` parameter instead of the current model state.
+     */
+    execute(options = {}) {
+        if (options.forceValue === this.value) {
+            return;
+        }
+        const tableUtils = this.editor.plugins.get('TableUtils');
+        const model = this.editor.model;
+        const selectedCells = tableUtils.getSelectionAffectedTableCells(model.document.selection);
+        const table = selectedCells[0].findAncestor('table');
+        const { first, last } = tableUtils.getRowIndexes(selectedCells);
+        const headingRowsToSet = this.value ? first : last + 1;
+        const currentHeadingRows = table.getAttribute('headingRows') || 0;
+        model.change(writer => {
+            if (headingRowsToSet) {
+                // Changing heading rows requires to check if any of a heading cell is overlapping vertically the table head.
+                // Any table cell that has a rowspan attribute > 1 will not exceed the table head so we need to fix it in rows below.
+                const startRow = headingRowsToSet > currentHeadingRows ? currentHeadingRows : 0;
+                const overlappingCells = getVerticallyOverlappingCells(table, headingRowsToSet, startRow);
+                for (const { cell } of overlappingCells) {
+                    splitHorizontally(cell, headingRowsToSet, writer);
+                }
+            }
+            updateNumericAttribute('headingRows', headingRowsToSet, table, writer, 0);
+        });
+    }
+    /**
+     * Checks if a table cell is in the heading section.
+     */
+    _isInHeading(tableCell, table) {
+        const headingRows = parseInt(table.getAttribute('headingRows') || '0');
+        return !!headingRows && tableCell.parent.index < headingRows;
+    }
+}

package/src/commands/splitcellcommand.d.ts

@@ -1,43 +1,43 @@
-/**
- * @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/commands/splitcellcommand
- */
-import { Command, type Editor } from 'ckeditor5/src/core';
-/**
- * The split cell command.
- *
- * The command is registered by {@link module:table/tableediting~TableEditing} as the `'splitTableCellVertically'`
- * and `'splitTableCellHorizontally'`  editor commands.
- *
- * You can split any cell vertically or horizontally by executing this command. For example, to split the selected table cell vertically:
- *
- * ```ts
- * editor.execute( 'splitTableCellVertically' );
- * ```
- */
-export default class SplitCellCommand extends Command {
-    /**
-     * The direction that indicates which cell will be split.
-     */
-    readonly direction: 'horizontally' | 'vertically';
-    /**
-     * Creates a new `SplitCellCommand` instance.
-     *
-     * @param editor The editor on which this command will be used.
-     * @param options.direction Indicates whether the command should split cells `'horizontally'` or `'vertically'`.
-     */
-    constructor(editor: Editor, options?: {
-        direction?: 'horizontally' | 'vertically';
-    });
-    /**
-     * @inheritDoc
-     */
-    refresh(): void;
-    /**
-     * @inheritDoc
-     */
-    execute(): void;
-}
+/**
+ * @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/commands/splitcellcommand
+ */
+import { Command, type Editor } from 'ckeditor5/src/core';
+/**
+ * The split cell command.
+ *
+ * The command is registered by {@link module:table/tableediting~TableEditing} as the `'splitTableCellVertically'`
+ * and `'splitTableCellHorizontally'`  editor commands.
+ *
+ * You can split any cell vertically or horizontally by executing this command. For example, to split the selected table cell vertically:
+ *
+ * ```ts
+ * editor.execute( 'splitTableCellVertically' );
+ * ```
+ */
+export default class SplitCellCommand extends Command {
+    /**
+     * The direction that indicates which cell will be split.
+     */
+    readonly direction: 'horizontally' | 'vertically';
+    /**
+     * Creates a new `SplitCellCommand` instance.
+     *
+     * @param editor The editor on which this command will be used.
+     * @param options.direction Indicates whether the command should split cells `'horizontally'` or `'vertically'`.
+     */
+    constructor(editor: Editor, options?: {
+        direction?: 'horizontally' | 'vertically';
+    });
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * @inheritDoc
+     */
+    execute(): void;
+}

package/src/commands/splitcellcommand.js

@@ -1,54 +1,54 @@
-/**
- * @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/commands/splitcellcommand
- */
-import { Command } from 'ckeditor5/src/core';
-/**
- * The split cell command.
- *
- * The command is registered by {@link module:table/tableediting~TableEditing} as the `'splitTableCellVertically'`
- * and `'splitTableCellHorizontally'`  editor commands.
- *
- * You can split any cell vertically or horizontally by executing this command. For example, to split the selected table cell vertically:
- *
- * ```ts
- * editor.execute( 'splitTableCellVertically' );
- * ```
- */
-export default class SplitCellCommand extends Command {
-    /**
-     * Creates a new `SplitCellCommand` instance.
-     *
-     * @param editor The editor on which this command will be used.
-     * @param options.direction Indicates whether the command should split cells `'horizontally'` or `'vertically'`.
-     */
-    constructor(editor, options = {}) {
-        super(editor);
-        this.direction = options.direction || 'horizontally';
-    }
-    /**
-     * @inheritDoc
-     */
-    refresh() {
-        const tableUtils = this.editor.plugins.get('TableUtils');
-        const selectedCells = tableUtils.getSelectionAffectedTableCells(this.editor.model.document.selection);
-        this.isEnabled = selectedCells.length === 1;
-    }
-    /**
-     * @inheritDoc
-     */
-    execute() {
-        const tableUtils = this.editor.plugins.get('TableUtils');
-        const tableCell = tableUtils.getSelectionAffectedTableCells(this.editor.model.document.selection)[0];
-        const isHorizontal = this.direction === 'horizontally';
-        if (isHorizontal) {
-            tableUtils.splitCellHorizontally(tableCell, 2);
-        }
-        else {
-            tableUtils.splitCellVertically(tableCell, 2);
-        }
-    }
-}
+/**
+ * @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/commands/splitcellcommand
+ */
+import { Command } from 'ckeditor5/src/core';
+/**
+ * The split cell command.
+ *
+ * The command is registered by {@link module:table/tableediting~TableEditing} as the `'splitTableCellVertically'`
+ * and `'splitTableCellHorizontally'`  editor commands.
+ *
+ * You can split any cell vertically or horizontally by executing this command. For example, to split the selected table cell vertically:
+ *
+ * ```ts
+ * editor.execute( 'splitTableCellVertically' );
+ * ```
+ */
+export default class SplitCellCommand extends Command {
+    /**
+     * Creates a new `SplitCellCommand` instance.
+     *
+     * @param editor The editor on which this command will be used.
+     * @param options.direction Indicates whether the command should split cells `'horizontally'` or `'vertically'`.
+     */
+    constructor(editor, options = {}) {
+        super(editor);
+        this.direction = options.direction || 'horizontally';
+    }
+    /**
+     * @inheritDoc
+     */
+    refresh() {
+        const tableUtils = this.editor.plugins.get('TableUtils');
+        const selectedCells = tableUtils.getSelectionAffectedTableCells(this.editor.model.document.selection);
+        this.isEnabled = selectedCells.length === 1;
+    }
+    /**
+     * @inheritDoc
+     */
+    execute() {
+        const tableUtils = this.editor.plugins.get('TableUtils');
+        const tableCell = tableUtils.getSelectionAffectedTableCells(this.editor.model.document.selection)[0];
+        const isHorizontal = this.direction === 'horizontally';
+        if (isHorizontal) {
+            tableUtils.splitCellHorizontally(tableCell, 2);
+        }
+        else {
+            tableUtils.splitCellVertically(tableCell, 2);
+        }
+    }
+}