@ckeditor/ckeditor5-special-characters 48.2.0-alpha.7 → 48.3.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,34 +1,34 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
- */
2
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
+ */
5
5
  /**
6
- * @module special-characters/specialcharacterstext
7
- */
8
- import { Plugin } from '@ckeditor/ckeditor5-core';
6
+ * @module special-characters/specialcharacterstext
7
+ */
8
+ import { Plugin } from "@ckeditor/ckeditor5-core";
9
9
  /**
10
- * A plugin that provides special characters for the "Text" category.
11
- *
12
- * ```ts
13
- * ClassicEditor
14
- * .create( {
15
- * plugins: [ ..., SpecialCharacters, SpecialCharactersText ],
16
- * } )
17
- * .then( ... )
18
- * .catch( ... );
19
- * ```
20
- */
10
+ * A plugin that provides special characters for the "Text" category.
11
+ *
12
+ * ```ts
13
+ * ClassicEditor
14
+ * .create( {
15
+ * plugins: [ ..., SpecialCharacters, SpecialCharactersText ],
16
+ * } )
17
+ * .then( ... )
18
+ * .catch( ... );
19
+ * ```
20
+ */
21
21
  export declare class SpecialCharactersText extends Plugin {
22
- /**
23
- * @inheritDoc
24
- */
25
- static get pluginName(): "SpecialCharactersText";
26
- /**
27
- * @inheritDoc
28
- */
29
- static get isOfficialPlugin(): true;
30
- /**
31
- * @inheritDoc
32
- */
33
- init(): void;
22
+ /**
23
+ * @inheritDoc
24
+ */
25
+ static get pluginName(): "SpecialCharactersText";
26
+ /**
27
+ * @inheritDoc
28
+ */
29
+ static override get isOfficialPlugin(): true;
30
+ /**
31
+ * @inheritDoc
32
+ */
33
+ init(): void;
34
34
  }
@@ -1,96 +1,96 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
- */
2
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
+ */
5
5
  /**
6
- * @module special-characters/ui/charactergridview
7
- */
8
- import { View, ButtonView, type ViewCollection } from '@ckeditor/ckeditor5-ui';
9
- import { KeystrokeHandler, FocusTracker, type Locale } from '@ckeditor/ckeditor5-utils';
10
- import '../../theme/charactergrid.css';
6
+ * @module special-characters/ui/charactergridview
7
+ */
8
+ import { View, ButtonView, type ViewCollection } from "@ckeditor/ckeditor5-ui";
9
+ import { KeystrokeHandler, FocusTracker, type Locale } from "@ckeditor/ckeditor5-utils";
10
+ import "../../theme/charactergrid.css";
11
11
  /**
12
- * A grid of character tiles. It allows browsing special characters and selecting the character to
13
- * be inserted into the content.
14
- *
15
- * @internal
16
- */
12
+ * A grid of character tiles. It allows browsing special characters and selecting the character to
13
+ * be inserted into the content.
14
+ *
15
+ * @internal
16
+ */
17
17
  export declare class CharacterGridView extends View<HTMLDivElement> {
18
- /**
19
- * A collection of the child tile views. Each tile represents a particular character.
20
- */
21
- readonly tiles: ViewCollection<ButtonView>;
22
- /**
23
- * Tracks information about the DOM focus in the grid.
24
- */
25
- readonly focusTracker: FocusTracker;
26
- /**
27
- * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
28
- */
29
- readonly keystrokes: KeystrokeHandler;
30
- /**
31
- * Creates an instance of a character grid containing tiles representing special characters.
32
- *
33
- * @param locale The localization services instance.
34
- */
35
- constructor(locale: Locale);
36
- /**
37
- * Creates a new tile for the grid.
38
- *
39
- * @param character A human-readable character displayed as the label (e.g. "ε").
40
- * @param name The name of the character (e.g. "greek small letter epsilon").
41
- */
42
- createTile(character: string, name: string): ButtonView;
43
- /**
44
- * @inheritDoc
45
- */
46
- render(): void;
47
- /**
48
- * @inheritDoc
49
- */
50
- destroy(): void;
51
- /**
52
- * Focuses the first focusable in {@link ~CharacterGridView#tiles}.
53
- */
54
- focus(): void;
18
+ /**
19
+ * A collection of the child tile views. Each tile represents a particular character.
20
+ */
21
+ readonly tiles: ViewCollection<ButtonView>;
22
+ /**
23
+ * Tracks information about the DOM focus in the grid.
24
+ */
25
+ readonly focusTracker: FocusTracker;
26
+ /**
27
+ * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
28
+ */
29
+ readonly keystrokes: KeystrokeHandler;
30
+ /**
31
+ * Creates an instance of a character grid containing tiles representing special characters.
32
+ *
33
+ * @param locale The localization services instance.
34
+ */
35
+ constructor(locale: Locale);
36
+ /**
37
+ * Creates a new tile for the grid.
38
+ *
39
+ * @param character A human-readable character displayed as the label (e.g. "ε").
40
+ * @param name The name of the character (e.g. "greek small letter epsilon").
41
+ */
42
+ createTile(character: string, name: string): ButtonView;
43
+ /**
44
+ * @inheritDoc
45
+ */
46
+ override render(): void;
47
+ /**
48
+ * @inheritDoc
49
+ */
50
+ override destroy(): void;
51
+ /**
52
+ * Focuses the first focusable in {@link ~CharacterGridView#tiles}.
53
+ */
54
+ focus(): void;
55
55
  }
56
56
  /**
57
- * Fired when any of {@link ~CharacterGridView#tiles grid tiles} is clicked.
58
- *
59
- * @eventName ~CharacterGridView#execute
60
- * @param data Additional information about the event.
61
- */
57
+ * Fired when any of {@link ~CharacterGridView#tiles grid tiles} is clicked.
58
+ *
59
+ * @eventName ~CharacterGridView#execute
60
+ * @param data Additional information about the event.
61
+ */
62
62
  export type SpecialCharactersGridViewExecuteEvent = {
63
- name: 'execute';
64
- args: [data: SpecialCharactersGridViewEventData];
63
+ name: "execute";
64
+ args: [data: SpecialCharactersGridViewEventData];
65
65
  };
66
66
  /**
67
- * Fired when a mouse or another pointing device caused the cursor to move onto any {@link ~CharacterGridView#tiles grid tile}
68
- * (similar to the native `mouseover` DOM event).
69
- *
70
- * @eventName ~CharacterGridView#tileHover
71
- * @param data Additional information about the event.
72
- */
67
+ * Fired when a mouse or another pointing device caused the cursor to move onto any {@link ~CharacterGridView#tiles grid tile}
68
+ * (similar to the native `mouseover` DOM event).
69
+ *
70
+ * @eventName ~CharacterGridView#tileHover
71
+ * @param data Additional information about the event.
72
+ */
73
73
  export type SpecialCharactersGridViewTileHoverEvent = {
74
- name: 'tileHover';
75
- args: [data: SpecialCharactersGridViewEventData];
74
+ name: "tileHover";
75
+ args: [data: SpecialCharactersGridViewEventData];
76
76
  };
77
77
  /**
78
- * Fired when {@link ~CharacterGridView#tiles grid tile} is focused (e.g. by navigating with arrow keys).
79
- *
80
- * @eventName ~CharacterGridView#tileFocus
81
- * @param data Additional information about the event.
82
- */
78
+ * Fired when {@link ~CharacterGridView#tiles grid tile} is focused (e.g. by navigating with arrow keys).
79
+ *
80
+ * @eventName ~CharacterGridView#tileFocus
81
+ * @param data Additional information about the event.
82
+ */
83
83
  export type SpecialCharactersGridViewTileFocusEvent = {
84
- name: 'tileFocus';
85
- args: [data: SpecialCharactersGridViewEventData];
84
+ name: "tileFocus";
85
+ args: [data: SpecialCharactersGridViewEventData];
86
86
  };
87
87
  export interface SpecialCharactersGridViewEventData {
88
- /**
89
- * The name of the tile that caused the event (e.g. "greek small letter epsilon").
90
- */
91
- name: string;
92
- /**
93
- * A human-readable character displayed as the label (e.g. "ε").
94
- */
95
- character: string;
88
+ /**
89
+ * The name of the tile that caused the event (e.g. "greek small letter epsilon").
90
+ */
91
+ name: string;
92
+ /**
93
+ * A human-readable character displayed as the label (e.g. "ε").
94
+ */
95
+ character: string;
96
96
  }
@@ -1,37 +1,37 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
- */
2
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
+ */
5
5
  /**
6
- * @module special-characters/ui/characterinfoview
7
- */
8
- import type { Locale } from '@ckeditor/ckeditor5-utils';
9
- import { View } from '@ckeditor/ckeditor5-ui';
10
- import '../../theme/characterinfo.css';
6
+ * @module special-characters/ui/characterinfoview
7
+ */
8
+ import type { Locale } from "@ckeditor/ckeditor5-utils";
9
+ import { View } from "@ckeditor/ckeditor5-ui";
10
+ import "../../theme/characterinfo.css";
11
11
  /**
12
- * The view displaying detailed information about a special character glyph, e.g. upon
13
- * hovering it with a mouse.
14
- *
15
- * @internal
16
- */
12
+ * The view displaying detailed information about a special character glyph, e.g. upon
13
+ * hovering it with a mouse.
14
+ *
15
+ * @internal
16
+ */
17
17
  export declare class CharacterInfoView extends View<HTMLDivElement> {
18
- /**
19
- * The character whose information is displayed by the view. For instance, "∑" or "¿".
20
- *
21
- * @observable
22
- */
23
- character: string | null;
24
- /**
25
- * The name of the {@link #character}. For instance, "N-ary summation" or "Inverted question mark".
26
- *
27
- * @observable
28
- */
29
- name: string | null;
30
- /**
31
- * The "Unicode string" of the {@link #character}. For instance "U+0061".
32
- *
33
- * @observable
34
- */
35
- readonly code: string;
36
- constructor(locale: Locale);
18
+ /**
19
+ * The character whose information is displayed by the view. For instance, "∑" or "¿".
20
+ *
21
+ * @observable
22
+ */
23
+ character: string | null;
24
+ /**
25
+ * The name of the {@link #character}. For instance, "N-ary summation" or "Inverted question mark".
26
+ *
27
+ * @observable
28
+ */
29
+ name: string | null;
30
+ /**
31
+ * The "Unicode string" of the {@link #character}. For instance "U+0061".
32
+ *
33
+ * @observable
34
+ */
35
+ readonly code: string;
36
+ constructor(locale: Locale);
37
37
  }
@@ -1,43 +1,43 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
- */
2
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
+ */
5
5
  /**
6
- * @module special-characters/ui/specialcharacterscategoriesview
7
- */
8
- import { type Locale } from '@ckeditor/ckeditor5-utils';
9
- import { View } from '@ckeditor/ckeditor5-ui';
6
+ * @module special-characters/ui/specialcharacterscategoriesview
7
+ */
8
+ import { type Locale } from "@ckeditor/ckeditor5-utils";
9
+ import { View } from "@ckeditor/ckeditor5-ui";
10
10
  /**
11
- * A class representing the navigation part of the special characters UI. It is responsible
12
- * for describing the feature and allowing the user to select a particular character group.
13
- *
14
- * @internal
15
- */
11
+ * A class representing the navigation part of the special characters UI. It is responsible
12
+ * for describing the feature and allowing the user to select a particular character group.
13
+ *
14
+ * @internal
15
+ */
16
16
  export declare class SpecialCharactersCategoriesView extends View {
17
- /**
18
- * Currently selected special characters group's name.
19
- */
20
- currentGroupName: string;
21
- private _groupNames;
22
- private _dropdownView;
23
- /**
24
- * Creates an instance of the {@link module:special-characters/ui/specialcharacterscategoriesview~SpecialCharactersCategoriesView}
25
- * class.
26
- *
27
- * @param locale The localization services instance.
28
- * @param groupNames The names of the character groups.
29
- */
30
- constructor(locale: Locale, groupNames: Map<string, string>);
31
- /**
32
- * @inheritDoc
33
- */
34
- render(): void;
35
- /**
36
- * @inheritDoc
37
- */
38
- focus(): void;
39
- /**
40
- * Creates dropdown item list, sets up bindings and fills properties.
41
- */
42
- private _setupDropdown;
17
+ /**
18
+ * Currently selected special characters group's name.
19
+ */
20
+ currentGroupName: string;
21
+ private _groupNames;
22
+ private _dropdownView;
23
+ /**
24
+ * Creates an instance of the {@link module:special-characters/ui/specialcharacterscategoriesview~SpecialCharactersCategoriesView}
25
+ * class.
26
+ *
27
+ * @param locale The localization services instance.
28
+ * @param groupNames The names of the character groups.
29
+ */
30
+ constructor(locale: Locale, groupNames: Map<string, string>);
31
+ /**
32
+ * @inheritDoc
33
+ */
34
+ override render(): void;
35
+ /**
36
+ * @inheritDoc
37
+ */
38
+ focus(): void;
39
+ /**
40
+ * Creates dropdown item list, sets up bindings and fills properties.
41
+ */
42
+ private _setupDropdown;
43
43
  }
@@ -1,67 +1,67 @@
1
1
  /**
2
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
- */
2
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
3
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
4
+ */
5
5
  /**
6
- * @module special-characters/ui/specialcharactersview
7
- */
8
- import { View, FocusCycler, type ViewCollection, type FocusableView } from '@ckeditor/ckeditor5-ui';
9
- import { FocusTracker, KeystrokeHandler, type Locale } from '@ckeditor/ckeditor5-utils';
10
- import { type CharacterGridView } from './charactergridview.js';
11
- import { type CharacterInfoView } from './characterinfoview.js';
12
- import { type SpecialCharactersCategoriesView } from './specialcharacterscategoriesview.js';
6
+ * @module special-characters/ui/specialcharactersview
7
+ */
8
+ import { View, FocusCycler, type ViewCollection, type FocusableView } from "@ckeditor/ckeditor5-ui";
9
+ import { FocusTracker, KeystrokeHandler, type Locale } from "@ckeditor/ckeditor5-utils";
10
+ import { type CharacterGridView } from "./charactergridview.js";
11
+ import { type CharacterInfoView } from "./characterinfoview.js";
12
+ import { type SpecialCharactersCategoriesView } from "./specialcharacterscategoriesview.js";
13
13
  /**
14
- * A view that glues pieces of the special characters dropdown panel together:
15
- *
16
- * * the navigation view (allows selecting the category),
17
- * * the grid view (displays characters as a grid),
18
- * * and the info view (displays detailed info about a specific character).
19
- *
20
- * @internal
21
- */
14
+ * A view that glues pieces of the special characters dropdown panel together:
15
+ *
16
+ * * the navigation view (allows selecting the category),
17
+ * * the grid view (displays characters as a grid),
18
+ * * and the info view (displays detailed info about a specific character).
19
+ *
20
+ * @internal
21
+ */
22
22
  export declare class SpecialCharactersView extends View<HTMLDivElement> {
23
- /**
24
- * A collection of the focusable children of the view.
25
- */
26
- readonly items: ViewCollection<FocusableView>;
27
- /**
28
- * Tracks information about the DOM focus in the view.
29
- */
30
- readonly focusTracker: FocusTracker;
31
- /**
32
- * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
33
- */
34
- readonly keystrokes: KeystrokeHandler;
35
- /**
36
- * Helps cycling over focusable {@link #items} in the view.
37
- */
38
- protected readonly _focusCycler: FocusCycler;
39
- /**
40
- * An instance of the `SpecialCharactersCategoriesView`.
41
- */
42
- categoriesView: SpecialCharactersCategoriesView;
43
- /**
44
- * An instance of the `CharacterGridView`.
45
- */
46
- gridView: CharacterGridView;
47
- /**
48
- * An instance of the `CharacterInfoView`.
49
- */
50
- infoView: CharacterInfoView;
51
- /**
52
- * Creates an instance of the `SpecialCharactersView`.
53
- */
54
- constructor(locale: Locale, categoriesView: SpecialCharactersCategoriesView, gridView: CharacterGridView, infoView: CharacterInfoView);
55
- /**
56
- * @inheritDoc
57
- */
58
- render(): void;
59
- /**
60
- * @inheritDoc
61
- */
62
- destroy(): void;
63
- /**
64
- * Focuses the first focusable in {@link #items}.
65
- */
66
- focus(): void;
23
+ /**
24
+ * A collection of the focusable children of the view.
25
+ */
26
+ readonly items: ViewCollection<FocusableView>;
27
+ /**
28
+ * Tracks information about the DOM focus in the view.
29
+ */
30
+ readonly focusTracker: FocusTracker;
31
+ /**
32
+ * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
33
+ */
34
+ readonly keystrokes: KeystrokeHandler;
35
+ /**
36
+ * Helps cycling over focusable {@link #items} in the view.
37
+ */
38
+ protected readonly _focusCycler: FocusCycler;
39
+ /**
40
+ * An instance of the `SpecialCharactersCategoriesView`.
41
+ */
42
+ categoriesView: SpecialCharactersCategoriesView;
43
+ /**
44
+ * An instance of the `CharacterGridView`.
45
+ */
46
+ gridView: CharacterGridView;
47
+ /**
48
+ * An instance of the `CharacterInfoView`.
49
+ */
50
+ infoView: CharacterInfoView;
51
+ /**
52
+ * Creates an instance of the `SpecialCharactersView`.
53
+ */
54
+ constructor(locale: Locale, categoriesView: SpecialCharactersCategoriesView, gridView: CharacterGridView, infoView: CharacterInfoView);
55
+ /**
56
+ * @inheritDoc
57
+ */
58
+ override render(): void;
59
+ /**
60
+ * @inheritDoc
61
+ */
62
+ override destroy(): void;
63
+ /**
64
+ * Focuses the first focusable in {@link #items}.
65
+ */
66
+ focus(): void;
67
67
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ckeditor/ckeditor5-special-characters",
3
- "version": "48.2.0-alpha.7",
3
+ "version": "48.3.0-alpha.0",
4
4
  "description": "Special characters feature for CKEditor 5.",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "author": "CKSource (http://cksource.com/)",
@@ -26,11 +26,11 @@
26
26
  "./package.json": "./package.json"
27
27
  },
28
28
  "dependencies": {
29
- "@ckeditor/ckeditor5-core": "48.2.0-alpha.7",
30
- "@ckeditor/ckeditor5-icons": "48.2.0-alpha.7",
31
- "@ckeditor/ckeditor5-typing": "48.2.0-alpha.7",
32
- "@ckeditor/ckeditor5-ui": "48.2.0-alpha.7",
33
- "@ckeditor/ckeditor5-utils": "48.2.0-alpha.7"
29
+ "@ckeditor/ckeditor5-core": "48.3.0-alpha.0",
30
+ "@ckeditor/ckeditor5-icons": "48.3.0-alpha.0",
31
+ "@ckeditor/ckeditor5-typing": "48.3.0-alpha.0",
32
+ "@ckeditor/ckeditor5-ui": "48.3.0-alpha.0",
33
+ "@ckeditor/ckeditor5-utils": "48.3.0-alpha.0"
34
34
  },
35
35
  "files": [
36
36
  "dist",