@ckeditor/ckeditor5-emoji 48.2.0 → 48.3.0-alpha.1

package/dist/ui/emojipickerview.d.ts

@@ -1,91 +1,95 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module emoji/ui/emojipickerview
- */
-import { FocusCycler, SearchInfoView, View, type FocusableView, type ViewCollection } from '@ckeditor/ckeditor5-ui';
-import { FocusTracker, KeystrokeHandler, type Locale } from '@ckeditor/ckeditor5-utils';
-import { EmojiGridView, type EmojiSearchQueryCallback } from './emojigridview.js';
-import { EmojiCategoriesView } from './emojicategoriesview.js';
-import { EmojiSearchView } from './emojisearchview.js';
-import { EmojiToneView } from './emojitoneview.js';
-import type { EmojiSkinToneId } from '../emojiconfig.js';
-import type { EmojiCategory, EmojiSkinTone } from '../emojirepository.js';
+* @module emoji/ui/emojipickerview
+*/
+import { FocusCycler, SearchInfoView, View, type FocusableView, type ViewCollection } from "@ckeditor/ckeditor5-ui";
+import { FocusTracker, KeystrokeHandler, type Locale } from "@ckeditor/ckeditor5-utils";
+import { EmojiGridView, type EmojiSearchQueryCallback } from "./emojigridview.js";
+import { EmojiCategoriesView } from "./emojicategoriesview.js";
+import { EmojiSearchView } from "./emojisearchview.js";
+import { EmojiToneView } from "./emojitoneview.js";
+import type { EmojiSkinToneId } from "../emojiconfig.js";
+import type { EmojiCategory, EmojiSkinTone } from "../emojirepository.js";
 /**
- * A view that glues pieces of the emoji panel together.
- */
+* A view that glues pieces of the emoji panel together.
+*/
 export declare class EmojiPickerView extends View<HTMLDivElement> {
-    /**
-     * A collection of the focusable children of the view.
-     */
-    readonly items: ViewCollection<FocusableView>;
-    /**
-     * Tracks information about the DOM focus in the view.
-     */
-    readonly focusTracker: FocusTracker;
-    /**
-     * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
-     */
-    readonly keystrokes: KeystrokeHandler;
-    /**
-     * Helps cycling over focusable {@link #items} in the view.
-     */
-    readonly focusCycler: FocusCycler;
-    /**
-     * An instance of the `EmojiSearchView`.
-     */
-    readonly searchView: EmojiSearchView;
-    /**
-     * An instance of the `EmojiToneView`.
-     */
-    readonly toneView: EmojiToneView;
-    /**
-     * An instance of the `EmojiCategoriesView`.
-     */
-    readonly categoriesView: EmojiCategoriesView;
-    /**
-     * An instance of the `EmojiGridView`.
-     */
-    readonly gridView: EmojiGridView;
-    /**
-     * An instance of the `EmojiGridView`.
-     */
-    readonly infoView: SearchInfoView;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale, { emojiCategories, getEmojiByQuery, skinTone, skinTones }: {
-        emojiCategories: Array<EmojiCategory>;
-        getEmojiByQuery: EmojiSearchQueryCallback;
-        skinTone: EmojiSkinToneId;
-        skinTones: Array<EmojiSkinTone>;
-    });
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Focuses the search input.
-     */
-    focus(): void;
-    /**
-     * Initializes interactions between sub-views.
-     */
-    private _setupEventListeners;
+	/**
+	* A collection of the focusable children of the view.
+	*/
+	readonly items: ViewCollection<FocusableView>;
+	/**
+	* Tracks information about the DOM focus in the view.
+	*/
+	readonly focusTracker: FocusTracker;
+	/**
+	* An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
+	*/
+	readonly keystrokes: KeystrokeHandler;
+	/**
+	* Helps cycling over focusable {@link #items} in the view.
+	*/
+	readonly focusCycler: FocusCycler;
+	/**
+	* An instance of the `EmojiSearchView`.
+	*/
+	readonly searchView: EmojiSearchView;
+	/**
+	* An instance of the `EmojiToneView`.
+	*/
+	readonly toneView: EmojiToneView;
+	/**
+	* An instance of the `EmojiCategoriesView`.
+	*/
+	readonly categoriesView: EmojiCategoriesView;
+	/**
+	* An instance of the `EmojiGridView`.
+	*/
+	readonly gridView: EmojiGridView;
+	/**
+	* An instance of the `EmojiGridView`.
+	*/
+	readonly infoView: SearchInfoView;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, { emojiCategories, getEmojiByQuery, skinTone, skinTones }: {
+		emojiCategories: Array<EmojiCategory>;
+		getEmojiByQuery: EmojiSearchQueryCallback;
+		skinTone: EmojiSkinToneId;
+		skinTones: Array<EmojiSkinTone>;
+	});
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* Focuses the search input.
+	*/
+	focus(): void;
+	/**
+	* Sets certain list of categories in categories view and performs search.
+	*/
+	setCategories(categories: Array<EmojiCategory>): void;
+	/**
+	* Initializes interactions between sub-views.
+	*/
+	private _setupEventListeners;
 }
 /**
- * Fired when the  {@link module:emoji/ui/emojipickerview~EmojiPickerView} layout is changed, either by filtering emoji tiles or
- * showing a hint to a user regarding the provided query.
- *
- * @eventName ~EmojiPickerView#update
- */
+* Fired when the  {@link module:emoji/ui/emojipickerview~EmojiPickerView} layout is changed, either by filtering emoji tiles or
+* showing a hint to a user regarding the provided query.
+*
+* @eventName ~EmojiPickerView#update
+*/
 export type EmojiPickerViewUpdateEvent = {
-    name: 'update';
-    args: [];
+	name: "update";
+	args: [];
 };

package/dist/ui/emojisearchview.d.ts

@@ -1,51 +1,51 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-import { SearchTextView, View, type SearchInfoView } from '@ckeditor/ckeditor5-ui';
-import type { Locale } from '@ckeditor/ckeditor5-utils';
-import { type EmojiGridView } from './emojigridview.js';
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+import { SearchTextView, View, type SearchInfoView } from "@ckeditor/ckeditor5-ui";
+import type { Locale } from "@ckeditor/ckeditor5-utils";
+import { type EmojiGridView } from "./emojigridview.js";
 /**
- * A view responsible for providing an input element that allows filtering emoji by the provided query.
- */
+* A view responsible for providing an input element that allows filtering emoji by the provided query.
+*/
 export declare class EmojiSearchView extends View {
-    /**
-     * The find in text input view that stores the searched string.
-     */
-    readonly inputView: SearchTextView;
-    /**
-     * An instance of the `EmojiGridView`.
-     */
-    readonly gridView: EmojiGridView;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale, { gridView, resultsView }: {
-        gridView: EmojiGridView;
-        resultsView: SearchInfoView;
-    });
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Searches the {@link #gridView} for the given query.
-     *
-     * @param query The search query string.
-     */
-    search(query: string): void;
-    /**
-     * Allows defining the default value in the search text field.
-     *
-     * @param value The new value.
-     */
-    setInputValue(value: string): void;
-    /**
-     * Returns an input provided by a user in the search text field.
-     */
-    getInputValue(): string;
-    /**
-     * @inheritDoc
-     */
-    focus(): void;
+	/**
+	* The find in text input view that stores the searched string.
+	*/
+	readonly inputView: SearchTextView;
+	/**
+	* An instance of the `EmojiGridView`.
+	*/
+	readonly gridView: EmojiGridView;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, { gridView, resultsView }: {
+		gridView: EmojiGridView;
+		resultsView: SearchInfoView;
+	});
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* Searches the {@link #gridView} for the given query.
+	*
+	* @param query The search query string.
+	*/
+	search(query: string): void;
+	/**
+	* Allows defining the default value in the search text field.
+	*
+	* @param value The new value.
+	*/
+	setInputValue(value: string): void;
+	/**
+	* Returns an input provided by a user in the search text field.
+	*/
+	getInputValue(): string;
+	/**
+	* @inheritDoc
+	*/
+	focus(): void;
 }

package/dist/ui/emojitoneview.d.ts

@@ -1,46 +1,46 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module emoji/ui/emojitoneview
- */
-import { View, type DropdownView } from '@ckeditor/ckeditor5-ui';
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import type { EmojiSkinToneId } from '../emojiconfig.js';
-import type { EmojiSkinTone } from '../emojirepository.js';
-import '../../theme/emojitone.css';
+* @module emoji/ui/emojitoneview
+*/
+import { View, type DropdownView } from "@ckeditor/ckeditor5-ui";
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import type { EmojiSkinToneId } from "../emojiconfig.js";
+import type { EmojiSkinTone } from "../emojirepository.js";
+import "../../theme/emojitone.css";
 /**
- * A view responsible for selecting a skin tone for an emoji.
- */
+* A view responsible for selecting a skin tone for an emoji.
+*/
 export declare class EmojiToneView extends View {
-    /**
-     * Active skin tone.
-     *
-     * @observable
-     */
-    skinTone: EmojiSkinToneId;
-    /**
-     * A dropdown element for selecting an active skin tone.
-     */
-    readonly dropdownView: DropdownView;
-    /**
-     * An array of available skin tones.
-     */
-    private readonly _skinTones;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale, { skinTone, skinTones }: {
-        skinTone: EmojiSkinToneId;
-        skinTones: Array<EmojiSkinTone>;
-    });
-    /**
-     * @inheritDoc
-     */
-    focus(): void;
-    /**
-     * Helper method for receiving an object describing the active skin tone.
-     */
-    private _getSkinTone;
+	/**
+	* Active skin tone.
+	*
+	* @observable
+	*/
+	skinTone: EmojiSkinToneId;
+	/**
+	* A dropdown element for selecting an active skin tone.
+	*/
+	readonly dropdownView: DropdownView;
+	/**
+	* An array of available skin tones.
+	*/
+	private readonly _skinTones;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, { skinTone, skinTones }: {
+		skinTone: EmojiSkinToneId;
+		skinTones: Array<EmojiSkinTone>;
+	});
+	/**
+	* @inheritDoc
+	*/
+	focus(): void;
+	/**
+	* Helper method for receiving an object describing the active skin tone.
+	*/
+	private _getSkinTone;
 }

package/dist/utils/emojirepositorycache.d.ts

@@ -0,0 +1,48 @@
+/**
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+/**
+* @module emoji/utils/emojirepositorycache
+*/
+import type { EmojiCdnResource, EmojiEntry } from "../emojirepository.js";
+/**
+* Cache for emoji repository data.
+*
+* @internal
+*/
+export declare class EmojiRepositoryCache {
+	/**
+	* Fetch-and-transform promises, keyed by composite key.
+	*/
+	private _cache;
+	/**
+	* Fetches emoji data for `url`, runs it through `transform`, and caches the result.
+	* At most one HTTP request is issued per unique `[url, ...cacheKeys]` combination.
+	* Returns `[]` on network or HTTP failure.
+	*
+	* @param params Fetch parameters.
+	* @param params.url URL of the emoji repository JSON file.
+	* @param params.cacheKeys Extra segments that differentiate results for the same URL.
+	*   The URL itself is always the first segment of the composite key.
+	* @param params.transform Converts raw CDN resources into `EmojiEntry` objects.
+	*/
+	fetch({ url, cacheKeys, transform }: FetchParams): Promise<Array<EmojiEntry>>;
+	/**
+	* Synchronously returns the already-transformed array for the given `url` + `cacheKeys`,
+	* or `null` if the result is not yet available.
+	*/
+	getSync({ url, cacheKeys }: CacheKeyParams): Array<EmojiEntry> | null;
+	/**
+	* Clears the cache.
+	*/
+	clear(): void;
+}
+type CacheKeyParams = {
+	url: string;
+	cacheKeys: Array<string>;
+};
+type FetchParams = CacheKeyParams & {
+	transform: (raw: Array<EmojiCdnResource>) => Array<EmojiEntry>;
+};
+export {};

package/dist/utils/isemojisupported.d.ts

@@ -1,13 +1,13 @@
 /**
- * @license Copyright (c) 2023, Koala Interactive SAS
- * For licensing, see https://github.com/koala-interactive/is-emoji-supported/blob/master/LICENSE.md
- */
+* @license Copyright (c) 2023, Koala Interactive SAS
+* For licensing, see https://github.com/koala-interactive/is-emoji-supported/blob/master/LICENSE.md
+*/
 /**
- * @module emoji/utils/isemojisupported
- */
+* @module emoji/utils/isemojisupported
+*/
 /**
- * Checks if the two pixels parts are the same using canvas.
- *
- * @internal
- */
+* Checks if the two pixels parts are the same using canvas.
+*
+* @internal
+*/
 export declare function isEmojiSupported(unicode: string): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-emoji",
-  "version": "48.2.0",
+  "version": "48.3.0-alpha.1",
   "description": "Emoji feature for CKEditor 5.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "CKSource (http://cksource.com/)",
@@ -30,12 +30,12 @@
     "dist/translations/*.umd.js"
   ],
   "dependencies": {
-    "@ckeditor/ckeditor5-core": "48.2.0",
-    "@ckeditor/ckeditor5-icons": "48.2.0",
-    "@ckeditor/ckeditor5-mention": "48.2.0",
-    "@ckeditor/ckeditor5-typing": "48.2.0",
-    "@ckeditor/ckeditor5-ui": "48.2.0",
-    "@ckeditor/ckeditor5-utils": "48.2.0",
+    "@ckeditor/ckeditor5-core": "48.3.0-alpha.1",
+    "@ckeditor/ckeditor5-icons": "48.3.0-alpha.1",
+    "@ckeditor/ckeditor5-mention": "48.3.0-alpha.1",
+    "@ckeditor/ckeditor5-typing": "48.3.0-alpha.1",
+    "@ckeditor/ckeditor5-ui": "48.3.0-alpha.1",
+    "@ckeditor/ckeditor5-utils": "48.3.0-alpha.1",
     "fuzzysort": "3.1.0",
     "es-toolkit": "1.45.1"
   },