@ckeditor/ckeditor5-style 41.1.0 → 41.3.0-alpha.0

package/dist/types/ui/stylegroupview.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @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 style/ui/stylegroupview
+ */
+import { LabelView, View } from 'ckeditor5/src/ui.js';
+import type { Locale } from 'ckeditor5/src/utils.js';
+import StyleGridView from './stylegridview.js';
+import type { NormalizedStyleDefinition } from '../styleutils.js';
+import '../../theme/stylegroup.css';
+/**
+ * A class representing a group of styles (e.g. "block" or "inline").
+ *
+ * Renders a {@link module:style/ui/stylegridview~StyleGridView style grid} and a label.
+ */
+export default class StyleGroupView extends View<HTMLDivElement> {
+    /**
+     * The styles grid of the group.
+     */
+    readonly gridView: StyleGridView;
+    /**
+     * The label of the group.
+     */
+    readonly labelView: LabelView;
+    /**
+     * Creates an instance of the {@link module:style/ui/stylegroupview~StyleGroupView} class.
+     *
+     * @param locale The localization services instance.
+     * @param label The localized label of the group.
+     * @param styleDefinitions Definitions of the styles in the group.
+     */
+    constructor(locale: Locale, label: string, styleDefinitions: Array<NormalizedStyleDefinition>);
+}

package/dist/types/ui/stylepanelview.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @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 style/ui/stylepanelview
+ */
+import { FocusCycler, View, ViewCollection } from 'ckeditor5/src/ui.js';
+import { FocusTracker, KeystrokeHandler, type Locale } from 'ckeditor5/src/utils.js';
+import StyleGroupView from './stylegroupview.js';
+import type StyleGridView from './stylegridview.js';
+import type { NormalizedStyleDefinitions } from '../styleutils.js';
+import '../../theme/stylepanel.css';
+/**
+ * A class representing a panel with available content styles. It renders styles in button grids, grouped
+ * in categories.
+ */
+export default class StylePanelView extends View<HTMLDivElement> {
+    /**
+     * Tracks information about DOM focus in the panel.
+     */
+    readonly focusTracker: FocusTracker;
+    /**
+     * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
+     */
+    readonly keystrokes: KeystrokeHandler;
+    /**
+     * A collection of panel children.
+     */
+    readonly children: ViewCollection<StyleGroupView>;
+    /**
+     * A view representing block styles group.
+     */
+    readonly blockStylesGroupView: StyleGroupView;
+    /**
+     * A view representing inline styles group
+     */
+    readonly inlineStylesGroupView: StyleGroupView;
+    /**
+     * Array of active style names. They must correspond to the names of styles from
+     * definitions passed to the {@link #constructor}.
+     *
+     * @observable
+     */
+    readonly activeStyles: Array<string>;
+    /**
+     * Array of enabled style names. They must correspond to the names of styles from
+     * definitions passed to the {@link #constructor}.
+     *
+     * @observable
+     */
+    readonly enabledStyles: Array<string>;
+    /**
+     * A collection of views that can be focused in the panel.
+     */
+    protected readonly _focusables: ViewCollection<StyleGridView>;
+    /**
+     * Helps cycling over {@link #_focusables} in the panel.
+     */
+    protected readonly _focusCycler: FocusCycler;
+    /**
+     * Creates an instance of the {@link module:style/ui/stylegroupview~StyleGroupView} class.
+     *
+     * @param locale The localization services instance.
+     * @param styleDefinitions Normalized definitions of the styles.
+     */
+    constructor(locale: Locale, styleDefinitions: NormalizedStyleDefinitions);
+    /**
+     * @inheritDoc
+     */
+    render(): void;
+    /**
+     * Focuses the first focusable element in the panel.
+     */
+    focus(): void;
+    /**
+     * Focuses the last focusable element in the panel.
+     */
+    focusLast(): void;
+}
+/**
+ * Fired when a style was selected (clicked) by the user.
+ *
+ * @eventName ~StylePanelView#execute
+ */
+export type StylePanelViewExecuteEvent = {
+    name: 'execute';
+    args: [];
+};

package/lang/translations/he.po

@@ -14,7 +14,7 @@ msgid ""
 msgstr ""
 "Language-Team: Hebrew (https://app.transifex.com/ckeditor/teams/11143/he/)\n"
 "Language: he\n"
-"Plural-Forms: nplurals=4; plural=(n == 1 && n % 1 == 0) ? 0 : (n == 2 && n % 1 == 0) ? 1: (n % 10 == 0 && n % 1 == 0 && n > 10) ? 2 : 3;\n"
+"Plural-Forms: nplurals=3; plural=(n == 1 && n % 1 == 0) ? 0 : (n == 2 && n % 1 == 0) ? 1: 2;\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 
 msgctxt "The label of the styles dropdown button in the toolbar displayed when no style is currently active."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-style",
-  "version": "41.1.0",
+  "version": "41.3.0-alpha.0",
   "description": "Style feature for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -13,7 +13,7 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "ckeditor5": "41.1.0",
+    "ckeditor5": "41.3.0-alpha.0",
     "lodash-es": "4.17.21"
   },
   "author": "CKSource (http://cksource.com/)",
@@ -26,6 +26,7 @@
     "directory": "packages/ckeditor5-style"
   },
   "files": [
+    "dist",
     "lang",
     "src/**/*.js",
     "src/**/*.d.ts",