@ckeditor/ckeditor5-table 38.1.1 → 38.2.0-alpha.1

package/src/tablecellproperties.d.ts

@@ -1,30 +1,30 @@
-/**
- * @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
- */
-import { Plugin } from 'ckeditor5/src/core';
-import TableCellPropertiesUI from './tablecellproperties/tablecellpropertiesui';
-import TableCellPropertiesEditing from './tablecellproperties/tablecellpropertiesediting';
-/**
- * The table cell properties feature. Enables support for setting properties of table cells (size, border, background, etc.).
- *
- * Read more in the {@glink features/tables/tables-styling Table and cell styling tools} section.
- * See also the {@link module:table/tableproperties~TableProperties} plugin.
- *
- * This is a "glue" plugin that loads the
- * {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing table cell properties editing feature} and
- * the {@link module:table/tablecellproperties/tablecellpropertiesui~TableCellPropertiesUI table cell properties UI feature}.
- */
-export default class TableCellProperties extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "TableCellProperties";
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof TableCellPropertiesEditing, typeof TableCellPropertiesUI];
-}
+/**
+ * @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
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import TableCellPropertiesUI from './tablecellproperties/tablecellpropertiesui.js';
+import TableCellPropertiesEditing from './tablecellproperties/tablecellpropertiesediting.js';
+/**
+ * The table cell properties feature. Enables support for setting properties of table cells (size, border, background, etc.).
+ *
+ * Read more in the {@glink features/tables/tables-styling Table and cell styling tools} section.
+ * See also the {@link module:table/tableproperties~TableProperties} plugin.
+ *
+ * This is a "glue" plugin that loads the
+ * {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing table cell properties editing feature} and
+ * the {@link module:table/tablecellproperties/tablecellpropertiesui~TableCellPropertiesUI table cell properties UI feature}.
+ */
+export default class TableCellProperties extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "TableCellProperties";
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof TableCellPropertiesEditing, typeof TableCellPropertiesUI];
+}

package/src/tablecellproperties.js

@@ -1,34 +1,34 @@
-/**
- * @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
- */
-import { Plugin } from 'ckeditor5/src/core';
-import TableCellPropertiesUI from './tablecellproperties/tablecellpropertiesui';
-import TableCellPropertiesEditing from './tablecellproperties/tablecellpropertiesediting';
-/**
- * The table cell properties feature. Enables support for setting properties of table cells (size, border, background, etc.).
- *
- * Read more in the {@glink features/tables/tables-styling Table and cell styling tools} section.
- * See also the {@link module:table/tableproperties~TableProperties} plugin.
- *
- * This is a "glue" plugin that loads the
- * {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing table cell properties editing feature} and
- * the {@link module:table/tablecellproperties/tablecellpropertiesui~TableCellPropertiesUI table cell properties UI feature}.
- */
-export default class TableCellProperties extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName() {
-        return 'TableCellProperties';
-    }
-    /**
-     * @inheritDoc
-     */
-    static get requires() {
-        return [TableCellPropertiesEditing, TableCellPropertiesUI];
-    }
-}
+/**
+ * @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
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import TableCellPropertiesUI from './tablecellproperties/tablecellpropertiesui.js';
+import TableCellPropertiesEditing from './tablecellproperties/tablecellpropertiesediting.js';
+/**
+ * The table cell properties feature. Enables support for setting properties of table cells (size, border, background, etc.).
+ *
+ * Read more in the {@glink features/tables/tables-styling Table and cell styling tools} section.
+ * See also the {@link module:table/tableproperties~TableProperties} plugin.
+ *
+ * This is a "glue" plugin that loads the
+ * {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing table cell properties editing feature} and
+ * the {@link module:table/tablecellproperties/tablecellpropertiesui~TableCellPropertiesUI table cell properties UI feature}.
+ */
+export default class TableCellProperties extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'TableCellProperties';
+    }
+    /**
+     * @inheritDoc
+     */
+    static get requires() {
+        return [TableCellPropertiesEditing, TableCellPropertiesUI];
+    }
+}

package/src/tablecellwidth/commands/tablecellwidthcommand.d.ts

@@ -1,46 +1,46 @@
-/**
- * @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/tablecellwidth/commands/tablecellwidthcommand
- */
-import type { Editor } from 'ckeditor5/src/core';
-import TableCellPropertyCommand from '../../tablecellproperties/commands/tablecellpropertycommand';
-/**
- * The table cell width command.
- *
- * The command is registered by the {@link module:table/tablecellwidth/tablecellwidthediting~TableCellWidthEditing} as
- * the `'tableCellWidth'` editor command.
- *
- * To change the width of selected cells, execute the command:
- *
- * ```ts
- * editor.execute( 'tableCellWidth', {
- *   value: '50px'
- * } );
- * ```
- *
- * **Note**: This command adds a default `'px'` unit to numeric values. Executing:
- *
- * ```ts
- * editor.execute( 'tableCellWidth', {
- *   value: '50'
- * } );
- * ```
- *
- * will set the `width` attribute to `'50px'` in the model.
- */
-export default class TableCellWidthCommand extends TableCellPropertyCommand {
-    /**
-     * Creates a new `TableCellWidthCommand` 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
-     */
-    _getValueToSet(value: string | number | undefined): unknown;
-}
+/**
+ * @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/tablecellwidth/commands/tablecellwidthcommand
+ */
+import type { Editor } from 'ckeditor5/src/core.js';
+import TableCellPropertyCommand from '../../tablecellproperties/commands/tablecellpropertycommand.js';
+/**
+ * The table cell width command.
+ *
+ * The command is registered by the {@link module:table/tablecellwidth/tablecellwidthediting~TableCellWidthEditing} as
+ * the `'tableCellWidth'` editor command.
+ *
+ * To change the width of selected cells, execute the command:
+ *
+ * ```ts
+ * editor.execute( 'tableCellWidth', {
+ *   value: '50px'
+ * } );
+ * ```
+ *
+ * **Note**: This command adds a default `'px'` unit to numeric values. Executing:
+ *
+ * ```ts
+ * editor.execute( 'tableCellWidth', {
+ *   value: '50'
+ * } );
+ * ```
+ *
+ * will set the `width` attribute to `'50px'` in the model.
+ */
+export default class TableCellWidthCommand extends TableCellPropertyCommand {
+    /**
+     * Creates a new `TableCellWidthCommand` 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
+     */
+    _getValueToSet(value: string | number | undefined): unknown;
+}

package/src/tablecellwidth/commands/tablecellwidthcommand.js

@@ -1,51 +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
- */
-import TableCellPropertyCommand from '../../tablecellproperties/commands/tablecellpropertycommand';
-import { addDefaultUnitToNumericValue } from '../../utils/table-properties';
-/**
- * The table cell width command.
- *
- * The command is registered by the {@link module:table/tablecellwidth/tablecellwidthediting~TableCellWidthEditing} as
- * the `'tableCellWidth'` editor command.
- *
- * To change the width of selected cells, execute the command:
- *
- * ```ts
- * editor.execute( 'tableCellWidth', {
- *   value: '50px'
- * } );
- * ```
- *
- * **Note**: This command adds a default `'px'` unit to numeric values. Executing:
- *
- * ```ts
- * editor.execute( 'tableCellWidth', {
- *   value: '50'
- * } );
- * ```
- *
- * will set the `width` attribute to `'50px'` in the model.
- */
-export default class TableCellWidthCommand extends TableCellPropertyCommand {
-    /**
-     * Creates a new `TableCellWidthCommand` 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, 'tableCellWidth', defaultValue);
-    }
-    /**
-     * @inheritDoc
-     */
-    _getValueToSet(value) {
-        value = addDefaultUnitToNumericValue(value, 'px');
-        if (value === this._defaultValue) {
-            return;
-        }
-        return value;
-    }
-}
+/**
+ * @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 TableCellPropertyCommand from '../../tablecellproperties/commands/tablecellpropertycommand.js';
+import { addDefaultUnitToNumericValue } from '../../utils/table-properties.js';
+/**
+ * The table cell width command.
+ *
+ * The command is registered by the {@link module:table/tablecellwidth/tablecellwidthediting~TableCellWidthEditing} as
+ * the `'tableCellWidth'` editor command.
+ *
+ * To change the width of selected cells, execute the command:
+ *
+ * ```ts
+ * editor.execute( 'tableCellWidth', {
+ *   value: '50px'
+ * } );
+ * ```
+ *
+ * **Note**: This command adds a default `'px'` unit to numeric values. Executing:
+ *
+ * ```ts
+ * editor.execute( 'tableCellWidth', {
+ *   value: '50'
+ * } );
+ * ```
+ *
+ * will set the `width` attribute to `'50px'` in the model.
+ */
+export default class TableCellWidthCommand extends TableCellPropertyCommand {
+    /**
+     * Creates a new `TableCellWidthCommand` 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, 'tableCellWidth', defaultValue);
+    }
+    /**
+     * @inheritDoc
+     */
+    _getValueToSet(value) {
+        value = addDefaultUnitToNumericValue(value, 'px');
+        if (value === this._defaultValue) {
+            return;
+        }
+        return value;
+    }
+}

package/src/tablecellwidth/tablecellwidthediting.d.ts

@@ -1,29 +1,29 @@
-/**
- * @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/tablecellwidth/tablecellwidthediting
- */
-import { Plugin } from 'ckeditor5/src/core';
-import TableEditing from './../tableediting';
-/**
- * The table cell width editing feature.
- *
- * Introduces `tableCellWidth` table cell model attribute alongside with its converters
- * and a command.
- */
-export default class TableCellWidthEditing extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "TableCellWidthEditing";
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof TableEditing];
-    /**
-     * @inheritDoc
-     */
-    init(): 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/tablecellwidth/tablecellwidthediting
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import TableEditing from './../tableediting.js';
+/**
+ * The table cell width editing feature.
+ *
+ * Introduces `tableCellWidth` table cell model attribute alongside with its converters
+ * and a command.
+ */
+export default class TableCellWidthEditing extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "TableCellWidthEditing";
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof TableEditing];
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+}

package/src/tablecellwidth/tablecellwidthediting.js

@@ -1,45 +1,45 @@
-/**
- * @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/tablecellwidth/tablecellwidthediting
- */
-import { Plugin } from 'ckeditor5/src/core';
-import TableEditing from './../tableediting';
-import TableCellWidthCommand from './commands/tablecellwidthcommand';
-import { getNormalizedDefaultProperties } from '../utils/table-properties';
-import { enableProperty } from '../utils/common';
-/**
- * The table cell width editing feature.
- *
- * Introduces `tableCellWidth` table cell model attribute alongside with its converters
- * and a command.
- */
-export default class TableCellWidthEditing extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName() {
-        return 'TableCellWidthEditing';
-    }
-    /**
-     * @inheritDoc
-     */
-    static get requires() {
-        return [TableEditing];
-    }
-    /**
-     * @inheritDoc
-     */
-    init() {
-        const editor = this.editor;
-        const defaultTableCellProperties = getNormalizedDefaultProperties(editor.config.get('table.tableCellProperties.defaultProperties'));
-        enableProperty(editor.model.schema, editor.conversion, {
-            modelAttribute: 'tableCellWidth',
-            styleName: 'width',
-            defaultValue: defaultTableCellProperties.width
-        });
-        editor.commands.add('tableCellWidth', new TableCellWidthCommand(editor, defaultTableCellProperties.width));
-    }
-}
+/**
+ * @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/tablecellwidth/tablecellwidthediting
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import TableEditing from './../tableediting.js';
+import TableCellWidthCommand from './commands/tablecellwidthcommand.js';
+import { getNormalizedDefaultProperties } from '../utils/table-properties.js';
+import { enableProperty } from '../utils/common.js';
+/**
+ * The table cell width editing feature.
+ *
+ * Introduces `tableCellWidth` table cell model attribute alongside with its converters
+ * and a command.
+ */
+export default class TableCellWidthEditing extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName() {
+        return 'TableCellWidthEditing';
+    }
+    /**
+     * @inheritDoc
+     */
+    static get requires() {
+        return [TableEditing];
+    }
+    /**
+     * @inheritDoc
+     */
+    init() {
+        const editor = this.editor;
+        const defaultTableCellProperties = getNormalizedDefaultProperties(editor.config.get('table.tableCellProperties.defaultProperties'));
+        enableProperty(editor.model.schema, editor.conversion, {
+            modelAttribute: 'tableCellWidth',
+            styleName: 'width',
+            defaultValue: defaultTableCellProperties.width
+        });
+        editor.commands.add('tableCellWidth', new TableCellWidthCommand(editor, defaultTableCellProperties.width));
+    }
+}

package/src/tableclipboard.d.ts

@@ -1,65 +1,65 @@
-/**
- * @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 { Plugin } from 'ckeditor5/src/core';
-import type { DocumentFragment, Element, Item, Model, Position, Writer } from 'ckeditor5/src/engine';
-import TableSelection from './tableselection';
-import { type TableSlot } from './tablewalker';
-import TableUtils from './tableutils';
-/**
- * This plugin adds support for copying/cutting/pasting fragments of tables.
- * It is loaded automatically by the {@link module:table/table~Table} plugin.
- */
-export default class TableClipboard extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "TableClipboard";
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof TableSelection, typeof TableUtils];
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * Copies table content to a clipboard on "copy" & "cut" events.
-     *
-     * @param evt An object containing information about the handled event.
-     * @param data Clipboard event data.
-     */
-    private _onCopyCut;
-    /**
-     * Overrides default {@link module:engine/model/model~Model#insertContent `model.insertContent()`} method to handle pasting table inside
-     * selected table fragment.
-     *
-     * Depending on selected table fragment:
-     * - If a selected table fragment is smaller than paste table it will crop pasted table to match dimensions.
-     * - If dimensions are equal it will replace selected table fragment with a pasted table contents.
-     *
-     * @param content The content to insert.
-     * @param selectable The selection into which the content should be inserted.
-     * If not provided the current model document selection will be used.
-     */
-    private _onInsertContent;
-    /**
-     * Replaces the part of selectedTable with pastedTable.
-     */
-    private _replaceSelectedCellsWithPasted;
-    /**
-     * Replaces a single table slot.
-     *
-     * @returns Inserted table cell or null if slot should remain empty.
-     * @private
-     */
-    _replaceTableSlotCell(tableSlot: TableSlot, cellToInsert: Element | null, insertPosition: Position, writer: Writer): Element | null;
-    /**
-     * Extracts the table for pasting into a table.
-     *
-     * @param content The content to insert.
-     * @param model The editor model.
-     */
-    getTableIfOnlyTableInContent(content: DocumentFragment | Item, model: Model): Element | 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
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import type { DocumentFragment, Element, Item, Model, Position, Writer } from 'ckeditor5/src/engine.js';
+import TableSelection from './tableselection.js';
+import { type TableSlot } from './tablewalker.js';
+import TableUtils from './tableutils.js';
+/**
+ * This plugin adds support for copying/cutting/pasting fragments of tables.
+ * It is loaded automatically by the {@link module:table/table~Table} plugin.
+ */
+export default class TableClipboard extends Plugin {
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "TableClipboard";
+    /**
+     * @inheritDoc
+     */
+    static get requires(): readonly [typeof TableSelection, typeof TableUtils];
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+    /**
+     * Copies table content to a clipboard on "copy" & "cut" events.
+     *
+     * @param evt An object containing information about the handled event.
+     * @param data Clipboard event data.
+     */
+    private _onCopyCut;
+    /**
+     * Overrides default {@link module:engine/model/model~Model#insertContent `model.insertContent()`} method to handle pasting table inside
+     * selected table fragment.
+     *
+     * Depending on selected table fragment:
+     * - If a selected table fragment is smaller than paste table it will crop pasted table to match dimensions.
+     * - If dimensions are equal it will replace selected table fragment with a pasted table contents.
+     *
+     * @param content The content to insert.
+     * @param selectable The selection into which the content should be inserted.
+     * If not provided the current model document selection will be used.
+     */
+    private _onInsertContent;
+    /**
+     * Replaces the part of selectedTable with pastedTable.
+     */
+    private _replaceSelectedCellsWithPasted;
+    /**
+     * Replaces a single table slot.
+     *
+     * @returns Inserted table cell or null if slot should remain empty.
+     * @private
+     */
+    _replaceTableSlotCell(tableSlot: TableSlot, cellToInsert: Element | null, insertPosition: Position, writer: Writer): Element | null;
+    /**
+     * Extracts the table for pasting into a table.
+     *
+     * @param content The content to insert.
+     * @param model The editor model.
+     */
+    getTableIfOnlyTableInContent(content: DocumentFragment | Item, model: Model): Element | null;
+}