@ckeditor/ckeditor5-alignment 41.3.1 → 41.4.0

package/dist/types/alignmentui.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module alignment/alignmentui
+ */
+import { Plugin } from 'ckeditor5/src/core.js';
+import type { SupportedOption } from './alignmentconfig.js';
+/**
+ * The default alignment UI plugin.
+ *
+ * It introduces the `'alignment:left'`, `'alignment:right'`, `'alignment:center'` and `'alignment:justify'` buttons
+ * and the `'alignment'` dropdown.
+ */
+export default class AlignmentUI extends Plugin {
+    /**
+     * Returns the localized option titles provided by the plugin.
+     *
+     * The following localized titles corresponding with
+     * {@link module:alignment/alignmentconfig~AlignmentConfig#options} are available:
+     *
+     * * `'left'`,
+     * * `'right'`,
+     * * `'center'`,
+     * * `'justify'`.
+     *
+     * @readonly
+     */
+    get localizedOptionTitles(): Record<SupportedOption, string>;
+    /**
+     * @inheritDoc
+     */
+    static get pluginName(): "AlignmentUI";
+    /**
+     * @inheritDoc
+     */
+    init(): void;
+    /**
+     * Helper method for initializing the button and linking it with an appropriate command.
+     *
+     * @param option The name of the alignment option for which the button is added.
+     */
+    private _addButton;
+    /**
+     * Helper method for creating the button view element.
+     *
+     * @param locale Editor locale.
+     * @param option The name of the alignment option for which the button is added.
+     * @param buttonAttrs Optional parameters passed to button view instance.
+     */
+    private _createButton;
+    /**
+     * Helper method for initializing the toolnar dropdown and linking it with an appropriate command.
+     *
+     * @param option The name of the alignment option for which the button is added.
+     */
+    private _addToolbarDropdown;
+    /**
+     * Creates a menu for all alignment options to use either in menu bar.
+     *
+     * @param options Normalized alignment options from config.
+     */
+    private _addMenuBarMenu;
+}

package/dist/types/augmentation.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import type { Alignment, AlignmentEditing, AlignmentUI, AlignmentCommand, AlignmentConfig } from './index.js';
+declare module '@ckeditor/ckeditor5-core' {
+    interface EditorConfig {
+        /**
+         * The configuration of the {@link module:alignment/alignment~Alignment alignment feature}.
+         *
+         * Read more in {@link module:alignment/alignmentconfig~AlignmentConfig}.
+         */
+        alignment?: AlignmentConfig;
+    }
+    interface PluginsMap {
+        [Alignment.pluginName]: Alignment;
+        [AlignmentUI.pluginName]: AlignmentUI;
+        [AlignmentEditing.pluginName]: AlignmentEditing;
+    }
+    interface CommandsMap {
+        alignment: AlignmentCommand;
+    }
+}

package/dist/types/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module alignment
+ */
+export { default as Alignment } from './alignment.js';
+export { default as AlignmentEditing } from './alignmentediting.js';
+export { default as AlignmentUI } from './alignmentui.js';
+export type { default as AlignmentCommand } from './alignmentcommand.js';
+export type { AlignmentConfig } from './alignmentconfig.js';
+import './augmentation.js';

package/dist/types/utils.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import { type Locale } from 'ckeditor5/src/utils.js';
+import type { AlignmentFormat, SupportedOption } from './alignmentconfig.js';
+/**
+ * @module alignment/utils
+ */
+/**
+ * The list of supported alignment options:
+ *
+ * * `'left'`,
+ * * `'right'`,
+ * * `'center'`,
+ * * `'justify'`
+ */
+export declare const supportedOptions: ReadonlyArray<SupportedOption>;
+/**
+ * Checks whether the passed option is supported by {@link module:alignment/alignmentediting~AlignmentEditing}.
+ *
+ * @param option The option value to check.
+ */
+export declare function isSupported(option: string): boolean;
+/**
+ * Checks whether alignment is the default one considering the direction
+ * of the editor content.
+ *
+ * @param alignment The name of the alignment to check.
+ * @param locale The {@link module:core/editor/editor~Editor#locale} instance.
+ */
+export declare function isDefault(alignment: string, locale: Locale): boolean;
+/**
+ * Brings the configuration to the common form, an array of objects.
+ *
+ * @param configuredOptions Alignment plugin configuration.
+ * @returns Normalized object holding the configuration.
+ */
+export declare function normalizeAlignmentOptions(configuredOptions: Array<string | AlignmentFormat>): Array<AlignmentFormat>;

package/lang/translations/ti.po

@@ -0,0 +1,42 @@
+# Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+#
+#                                     !!! IMPORTANT !!!
+#
+#         Before you edit this file, please keep in mind that contributing to the project
+#                translations is possible ONLY via the Transifex online service.
+#
+#         To submit your translations, visit https://www.transifex.com/ckeditor/ckeditor5.
+#
+#                   To learn more, check out the official contributor's guide:
+#     https://ckeditor.com/docs/ckeditor5/latest/framework/guides/contributing/contributing.html
+#
+msgid ""
+msgstr ""
+"Language-Team: Tigrinya (https://app.transifex.com/ckeditor/teams/11143/ti/)\n"
+"Language: ti\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+
+msgctxt "Toolbar button tooltip for aligning the text to the left."
+msgid "Align left"
+msgstr "ንጸጋም ኣመዓራርይ"
+
+msgctxt "Toolbar button tooltip for aligning the text to the right."
+msgid "Align right"
+msgstr "ንየማን ኣመዓራርይ"
+
+msgctxt "Toolbar button tooltip for aligning the text to center."
+msgid "Align center"
+msgstr "ናብ ማእኸል ኣመዓራርይ"
+
+msgctxt "Toolbar button tooltip for making the text justified."
+msgid "Justify"
+msgstr "ብማዕረ መጠን ናብ ኩሉ ኣንፈት ኣመዓራርይ"
+
+msgctxt "Dropdown button tooltip for the text alignment feature."
+msgid "Text alignment"
+msgstr "ምዕረያ ጽሑፍ"
+
+msgctxt "Label used by assistive technologies describing the text alignment feature toolbar."
+msgid "Text alignment toolbar"
+msgstr "መካወኒ ምዕረያ ጽሑፍ"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-alignment",
-  "version": "41.3.1",
+  "version": "41.4.0",
   "description": "Text alignment feature for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -13,7 +13,7 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "ckeditor5": "41.3.1"
+    "ckeditor5": "41.4.0"
   },
   "author": "CKSource (http://cksource.com/)",
   "license": "GPL-2.0-or-later",
@@ -25,6 +25,7 @@
     "directory": "packages/ckeditor5-alignment"
   },
   "files": [
+    "dist",
     "lang",
     "src/**/*.js",
     "src/**/*.d.ts",