emoji-picker-react 5.1.0 → 5.1.1

package/dist/virtualization/virtualizationHelpers.d.ts

@@ -1,3 +1,5 @@
+export declare const OVERSCAN_ROWS = 2;
+export declare function isJustBelowViewport(top: number, bottom: number, size: number): boolean;
 export declare function shouldVirtualize({ scrollTop, clientHeight, topOffset, style, dimensions, }: {
     scrollTop: number;
     clientHeight: number;

package/llms-full.txt

@@ -53,23 +53,24 @@ Contents:
 1. Agent integration guide (docs/v5/AGENT_GUIDE.md): installed-version discovery, batteries included/BYOD, typed input/cell contracts, localization and verification
 2. Copyable integration prompts (docs/v5/PROMPTS.md): setup, brand styling, design-library composition, recipe adoption and v4-to-v5 migration
 3. README (README.md): overview, quick start, choosing a path, styling with any solution, common tasks
-4. Props reference (PROPS.md): every prop of the default <EmojiPicker />
-5. CSS variables (CSS_VARIABLES.md): every --epr-* design token
-6. Customization (CUSTOMIZATION.md): custom emojis and groups, category icons, preview, CSP nonce
-7. Internationalization (INTERNATIONALIZATION.md): locale datasets and labels
-8. Adoption (docs/v5/ADOPTION.md): native input, loading recovery, registry installation and source downloads
-9. v5 API (docs/v5/API.md): all v5 additions with examples
-10. Primitives (docs/v5/PRIMITIVES.md): composable parts, hooks, custom cells, grammar
-11. Styling (docs/v5/STYLING.md): tokens, parts, cascade, structural rules
-12. Styling recipes by library (docs/v5/STYLING_RECIPES.md): theme, unstyled and composed snippets for plain CSS, CSS Modules, Tailwind, shadcn/ui, Emotion, styled-components and MUI
-13. Data API (docs/v5/DATA_API.md): framework-free search and lookup
-14. Migrating from v4 (docs/v5/MIGRATION.md): what changed and how to upgrade
-15. Migrating from emoji-mart (docs/v5/MIGRATING_FROM_EMOJI_MART.md): prop and payload mapping, size comparison, CSP
-16. Website examples (website/README.md): typed customization, locale loading and composition
-17. Design recipes (stories/recipes/README.md): 25 designs, each in seven styling stacks
-18. Styling integrations (stories/integrations/README.md): shadcn/ui, Tailwind, Emotion, styled-components, CSS Modules, CSS, MUI
-19. Example app (example/README.md): Vite + React 19 app running the batteries-included, unstyled, composed and data-API paths
-20. Worked example: team chat picker composition (stories/recipes/team-chat/picker.tsx; picker only, demo app chrome excluded)
+4. Emoji picker comparison (docs/v5/COMPARISON.md): v5 versus Emoji Mart, Frimousse and emoji-picker-element: capabilities, v5 APIs and audited sources
+5. Props reference (PROPS.md): every prop of the default <EmojiPicker />
+6. CSS variables (CSS_VARIABLES.md): every --epr-* design token
+7. Customization (CUSTOMIZATION.md): custom emojis and groups, category icons, preview, CSP nonce
+8. Internationalization (INTERNATIONALIZATION.md): locale datasets and labels
+9. Adoption (docs/v5/ADOPTION.md): native input, loading recovery, registry installation and source downloads
+10. v5 API (docs/v5/API.md): all v5 additions with examples
+11. Primitives (docs/v5/PRIMITIVES.md): composable parts, hooks, custom cells, grammar
+12. Styling (docs/v5/STYLING.md): tokens, parts, cascade, structural rules
+13. Styling recipes by library (docs/v5/STYLING_RECIPES.md): theme, unstyled and composed snippets for plain CSS, CSS Modules, Tailwind, shadcn/ui, Emotion, styled-components and MUI
+14. Data API (docs/v5/DATA_API.md): framework-free search and lookup
+15. Migrating from v4 (docs/v5/MIGRATION.md): what changed and how to upgrade
+16. Migrating from emoji-mart (docs/v5/MIGRATING_FROM_EMOJI_MART.md): prop and payload mapping, size comparison, CSP
+17. Website examples (website/README.md): typed customization, locale loading and composition
+18. Design recipes (stories/recipes/README.md): 25 designs, each in seven styling stacks
+19. Styling integrations (stories/integrations/README.md): shadcn/ui, Tailwind, Emotion, styled-components, CSS Modules, CSS, MUI
+20. Example app (example/README.md): Vite + React 19 app running the batteries-included, unstyled, composed and data-API paths
+21. Worked example: team chat picker composition (stories/recipes/team-chat/picker.tsx; picker only, demo app chrome excluded)
 
 <!-- source: docs/v5/AGENT_GUIDE.md -->
 
@@ -463,7 +464,7 @@ One emoji-picker engine, with two ways to build your UI: use the complete picker
 
 [![npm downloads](https://img.shields.io/npm/dm/emoji-picker-react.svg)](https://www.npmjs.com/package/emoji-picker-react)
 
-**[Live demo](https://ealush.com/emoji-picker-react)** · **[Quick start](#quick-start)** · **[Props](PROPS.md)** · **[BYOD](#byod-bring-your-own-design)** · **[Common tasks](#common-tasks)** · **[For AI assistants](#for-ai-assistants)** · **[Report a bug](https://github.com/ealush/emoji-picker-react/issues)** · **[Sponsor](https://github.com/sponsors/ealush)**
+**[Live demo](https://ealush.com/emoji-picker-react)** · **[Quick start](#quick-start)** · **[Props](PROPS.md)** · **[Compare pickers](#compare-emoji-pickers)** · **[BYOD](#byod-bring-your-own-design)** · **[Common tasks](#common-tasks)** · **[For AI assistants](#for-ai-assistants)** · **[Report a bug](https://github.com/ealush/emoji-picker-react/issues)** · **[Sponsor](https://github.com/sponsors/ealush)**
 
 ![image](https://github.com/ealush/emoji-picker-react/assets/11255103/48901306-e7fd-49cd-8f1e-9b214083a61d)
 
@@ -524,6 +525,34 @@ See [PROPS.md](PROPS.md) for every prop.
 
 > **Upgrading from v4?** Most code works unchanged; the default emoji style is now native, and markup, styling and package boundaries have changed. See [Migrating from v4](docs/v5/MIGRATION.md). The APIs on this page need `emoji-picker-react@5` or later.
 
+## Compare emoji pickers
+
+v5 supports both a complete styled picker and unstyled React composition,
+with custom image emoji, recents, category navigation and reactions built in.
+
+| Capability | emoji-picker-react v5 | Emoji Mart + React wrapper | Frimousse | emoji-picker-element |
+| --- | --- | --- | --- | --- |
+| Complete styled picker | Built in | Built in | Compose/style parts or use shadcn starter | Built in |
+| Unstyled React primitives | Built in | No React primitives API | Built in | Web component |
+| Keyboard navigation, search and skin tones | Built in | Built in | Built in | Built in |
+| Localized search and UI | Built in | Built in | Built in | Built in |
+| Native glyph support filtering | Built in | Built in | Built in for default data resolver | Built in |
+| Custom image emoji and named groups | Built in | Built in | Custom data and cell rendering | Built in |
+| Recent/frequent emoji | Built in | Built in | App-owned | Built-in favorites |
+| Category navigation controls | Built in | Built in | App-owned | Built in |
+| Compact reactions bar with expansion | Built in | App-owned | App-owned | App-owned |
+| Standalone emoji search API | Framework-free `/data` entry | `SearchIndex` | Metadata lookup only | Browser `Database` API |
+| Persistent dataset cache | Remote cache policy is app-owned | Remote cache policy is app-owned | Built-in localStorage cache | Built-in IndexedDB cache |
+
+“App-owned” means the application implements the feature. Custom renderers and
+data resolvers can extend the supplied behavior. Bundled data in
+emoji-picker-react and Emoji Mart can be used offline without a remote cache.
+
+Audited October 20, 2026 against Emoji Mart 5.6.0 / React wrapper 1.1.1,
+Frimousse 0.4.0 and emoji-picker-element 1.29.1. See the
+[full comparison and sources](docs/v5/COMPARISON.md) for API details,
+v5 capabilities, native-detection limits and data-loading APIs.
+
 ## Copyable integration prompts
 
 Use the [setup, customization, recipe adoption and v5 migration prompts](docs/v5/PROMPTS.md)
@@ -878,6 +907,132 @@ Contributions are welcome — see the [Contributing Guide](https://github.com/ea
 
 Design inspiration by [Pavel Bolo](https://pavelbolo.com).
 
+<!-- source: docs/v5/COMPARISON.md -->
+
+<!-- Emoji picker comparison -->
+
+# Comparing emoji pickers
+
+**Audited October 20, 2026.** This comparison covers **emoji-picker-react v5**
+in this repository, Emoji Mart (`emoji-mart` 5.6.0 with `@emoji-mart/react`
+1.1.1), Frimousse 0.4.0 and emoji-picker-element 1.29.1. Competitor sources
+below are pinned to their published release commits. Earlier comparisons of
+emoji-picker-react v4 do not describe v5's unstyled mode, primitives, custom
+components, controlled state or data loaders.
+
+Emoji Mart is an established complete picker with a React wrapper; Frimousse
+is a direct comparison for unstyled React composition; emoji-picker-element
+provides a framework-independent web-component alternative. PicMo is excluded
+from the table because its [repository was archived in September 2023](https://github.com/joeattardi/picmo).
+
+## Capability comparison
+
+**Built in** means a supported public API. **App-owned** means the application
+supplies that feature; it is not a built-in picker API in the audited version.
+Custom renderers and data resolvers can extend a library beyond its defaults.
+The table compares capabilities, not identical prop names or component trees.
+
+| Capability | emoji-picker-react v5 | [Emoji Mart][mart-readme] + React wrapper | [Frimousse][frimousse-api] | [emoji-picker-element][element-readme] |
+| --- | --- | --- | --- | --- |
+| Complete styled picker | Built in: `<EmojiPicker />`, no CSS import | Built in | Compose and style parts; shadcn starter available | Built in: `<emoji-picker>` |
+| Unstyled React primitives and custom layout | Built in: `/primitives`; `unstyled` also keeps the supplied layout | No React primitives API; configurable web component | Built in | No React primitives API; web component |
+| Custom input, emoji cells and category headers | `SearchInput as`, `components`, `List components` | Configurable icons and appearance; no React input/cell slots | Native Search props; List component replacements | CSS/custom shadow styles; no React input/cell slots |
+| Styling with Tailwind, CSS Modules or CSS-in-JS | Classes, styles, parts, tokens, optional cascade layer | CSS variables and shadow-root styles | Classes, styles and part attributes | CSS variables and shadow-root styles |
+| Keyboard navigation and accessible semantics | Built in | Built in | Built in | Built in |
+| List rendering strategy | Virtualized rows | Visibility-based row rendering | Virtualized rows | Category panels; custom-category rendering containment |
+| Controlled search from application state | `searchValue` / `onSearchChange`; search actions hook | No documented controlled-search prop | Controlled Search `value` / `onChange` | No documented controlled-search prop |
+| Hovered/focused emoji preview | `Preview` or `useActiveEmoji()` | Built-in preview with position options | `ActiveEmoji` or `useActiveEmoji()` | App-owned preview |
+| Skin tones and custom tone controls | `SkinTone`, controlled state, `useSkinTone()` | Built-in selector and `skin` option | `SkinToneSelector`, `SkinTone`, `useSkinTone()` | Built-in selector, change event and database preference API |
+| Localized emoji search and UI | 28 packaged datasets; `labels` and category/preview configuration | `locale`, `i18n` and supplied data | 28 default locales; native props, custom content and data resolver | `locale`, `i18n` and localized `dataSource` |
+| Hide unsupported native glyphs | Version/flag probes plus checks of visible sequences and variants | Native version/flag detection | Default resolver detects version/flag support | Native support detection, including ZWJ checks |
+| Category navigation controls | `CategoryNav`, custom buttons, navigation hook | Built-in navigation and icon options | App-owned; no built-in category navigation API | Built-in category tabs |
+| Recent/frequent emoji | Built in; also accepts supplied suggestions | Built-in frequent category | App-owned | Built-in favorites |
+| Custom image emoji and named groups | Built in: `customEmojis` | Built in: `custom` categories | Custom data/cell rendering; no built-in image-emoji API | Built in: `customEmoji` categories |
+| Native and vendor image sets | Native, Apple, Google, Facebook, Twitter; URL override | Native, Apple, Google, Facebook, Twitter; spritesheet override | Native; other rendering through custom cells | Native/custom font; custom image emoji |
+| Compact reactions bar that expands to the picker | Built in; also composable with `Reactions` / `Panel` | App-owned | App-owned | App-owned |
+| Bundled or self-hosted data | Packaged datasets, object input or async loader | Separate data package, object input or async loader | Default CDN; alternate URL or sync/async resolver | Fetch from configurable `dataSource` |
+| Custom loading and empty states | `Loading`, `Empty` | App-owned loading UI; configurable no-results appearance | `Loading`, `Empty` | Built-in loading/error messages via `i18n` |
+| Recoverable data-error UI | `LoadError`, retry hook, abortable loader | App-owned | App-owned | Built-in error message; no documented retry control |
+| Persistent emoji-dataset cache | Bundled data works offline; remote cache policy is app-owned | Bundled data works offline; remote cache policy is app-owned | Built-in localStorage cache/revalidation; `createEmojiDataCache` for custom data | Built-in IndexedDB cache/revalidation; IndexedDB required |
+| Search/metadata outside the picker | Framework-free `/data`: search and unified-code lookup | `SearchIndex` and native-emoji lookup after `init` | `getEmojiDetails` / `useEmojiDetails`; no standalone search API | Separate browser `Database`: search and lookup |
+| React compatibility | React 16.8–19 | Wrapper declares React 16.8, 17 and 18 | React 18 and 19 | Framework-independent; integrate as a custom element |
+| License | MIT | MIT | MIT | Apache-2.0 |
+
+All four provide keyboard behavior and accessibility support. This audit
+reviews APIs and source; it does not rank screen-reader quality or certify
+accessibility. v5's [browser accessibility tests](../../playwright/a11y-reactions-focus.spec.ts)
+exercise keyboard focus and axe checks.
+Native-glyph detection is heuristic in every picker; see v5's
+[detection limits](./API.md#5c-native-emoji-support-detection).
+
+## Capabilities in v5
+
+v5 provides a complete styled picker and composable primitives backed by the
+same engine. Choose the supplied layout, remove its appearance with `unstyled`,
+or compose your own controls and layout. Search, virtualization, keyboard
+navigation and localization stay built in across these paths.
+
+| Capability | emoji-picker-react v5 API |
+| --- | --- |
+| Complete styled picker | Render `<EmojiPicker />`; theme it with `colorScheme` and `--epr-*` tokens |
+| Custom layout | Compose `Root`, `SearchInput` (or `Search`), `Viewport` and `List` from `/primitives` |
+| Design-system styling | Use classes, styles and `[data-epr-part]` selectors, or install the [shadcn registry component](./ADOPTION.md#shadcn-registry) |
+| Custom input, emoji cells and headers | Use `SearchInput as={Input}`, Root `components` or `List components`; preserve managed props, refs and geometry |
+| Controlled search | Use Root's `searchValue` / `onSearchChange`, or `useSearchActions()` for custom controls |
+| Active-emoji previews | Compose `Preview` or build a custom preview with `useActiveEmoji()` |
+| Skin-tone controls | Compose `SkinTone`, control `skinTone` / `onSkinToneChange`, or use `useSkinTone()` |
+| Localized and asynchronous data | Supply an `emojiData` object or abortable loader; translate remaining strings through `labels` |
+| Loading, empty and error states | Compose `Loading`, `Empty` and `LoadError`; access loading state and retry through `useEmojiDataState()` |
+| Custom image emoji and groups | Supply `customEmojis` with image URLs and optional named groups |
+| Recent/frequent emoji and supplied suggestions | Configure `suggestedEmojisMode`, or supply `suggestedEmojis` |
+| Category navigation | Compose `CategoryNav` or build controls with `useCategoryNavigation()` |
+| Compact reactions with expansion | Use reactions mode on `<EmojiPicker />`, or compose `Reactions` and `Panel` with `usePickerMode()` |
+| Search and metadata outside React | Use `searchEmojis` and `getEmojiByUnified` from `/data`, passing a localized dataset when needed |
+
+See the [primitives contract](./PRIMITIVES.md), [input adapters and data
+recovery](./ADOPTION.md), [styling recipes](./STYLING_RECIPES.md) and
+[data API](./DATA_API.md) for implementation patterns.
+
+## Audit sources and maintenance
+
+The emoji-picker-react column was checked against this checkout's
+[public props](../../PROPS.md), [primitive types](../../src/primitives/types.ts),
+[component replacement types](../../src/primitives/components.tsx),
+[data API](./DATA_API.md) and [localization guide](../../INTERNATIONALIZATION.md).
+Competitor versions were verified against npm's `latest` metadata on the audit
+date, then their release sources were inspected:
+
+- **Emoji Mart:** [5.6.0 README][mart-readme], [actual picker options][mart-props],
+  [row rendering][mart-rendering], [native filtering][mart-native] and
+  [React wrapper 1.1.1 peer dependencies][mart-react]. The separate
+  `@emoji-mart/data` package was 1.2.1. Where the README and runtime defaults
+  differ, the table follows the source.
+- **Frimousse:** [0.4.0 README][frimousse-readme], [public types][frimousse-api],
+  [exports][frimousse-exports], [data resolver][frimousse-data],
+  [persistent cache][frimousse-cache] and [metadata lookup][frimousse-details].
+- **emoji-picker-element:** [1.29.1 README and database API][element-readme],
+  [picker behavior][element-picker] and [rendering styles][element-styles].
+
+Recheck these versions and public contracts when updating the table. A missing
+first-class API is not evidence that a capability is impossible to implement.
+No competitor browser benchmark or manual assistive-technology comparison was
+performed for this documentation audit.
+
+[mart-readme]: https://github.com/missive/emoji-mart/blob/8af68308851a0585c5224fb16f574ca92f4f578c/README.md
+[mart-props]: https://github.com/missive/emoji-mart/blob/8af68308851a0585c5224fb16f574ca92f4f578c/packages/emoji-mart/src/components/Picker/PickerProps.ts
+[mart-rendering]: https://github.com/missive/emoji-mart/blob/8af68308851a0585c5224fb16f574ca92f4f578c/packages/emoji-mart/src/components/Picker/Picker.tsx
+[mart-native]: https://github.com/missive/emoji-mart/blob/8af68308851a0585c5224fb16f574ca92f4f578c/packages/emoji-mart/src/helpers/native-support.ts
+[mart-react]: https://github.com/missive/emoji-mart/blob/465eec076b23d55b6606b6a81fe3a4fd7b2375a4/packages/emoji-mart-react/package.json
+[frimousse-readme]: https://github.com/liveblocks/frimousse/blob/868aebea0b441be44005e67c90ab6e082756a906/README.md
+[frimousse-api]: https://github.com/liveblocks/frimousse/blob/868aebea0b441be44005e67c90ab6e082756a906/src/types.ts
+[frimousse-exports]: https://github.com/liveblocks/frimousse/blob/868aebea0b441be44005e67c90ab6e082756a906/src/index.ts
+[frimousse-data]: https://github.com/liveblocks/frimousse/blob/868aebea0b441be44005e67c90ab6e082756a906/src/data/emoji.ts
+[frimousse-cache]: https://github.com/liveblocks/frimousse/blob/868aebea0b441be44005e67c90ab6e082756a906/src/data/emoji-data-cache.ts
+[frimousse-details]: https://github.com/liveblocks/frimousse/blob/868aebea0b441be44005e67c90ab6e082756a906/src/data/get-emoji-details.ts
+[element-readme]: https://github.com/nolanlawson/emoji-picker-element/blob/ded142e5c820c3fe6803ae372dd2b77ed7fbcf9d/README.md
+[element-picker]: https://github.com/nolanlawson/emoji-picker-element/blob/ded142e5c820c3fe6803ae372dd2b77ed7fbcf9d/src/picker/components/Picker/Picker.js
+[element-styles]: https://github.com/nolanlawson/emoji-picker-element/blob/ded142e5c820c3fe6803ae372dd2b77ed7fbcf9d/src/picker/styles/picker.scss
+
 <!-- source: PROPS.md -->
 
 <!-- Props reference -->
@@ -1570,12 +1725,14 @@ By default, the arrow key toward the grid moves focus from the search input into
 ```
 
 - The arrow toward the grid highlights the first emoji in view (the first result while searching): ArrowDown when the grid is below the input, ArrowUp when it is above, and Left or Right when it is beside the input (with the caret at that end of the text). The arrow keys then move the highlight through the grid, including rows that are not rendered yet. Otherwise Left and Right edit the text until an emoji is highlighted; from then on they move the highlight, and Escape gives them back to the text. With Shift, Ctrl, Alt or Meta, arrows always stay with the input (selecting text, moving by word), with or without a highlight. Left and Right follow the reading direction in RTL.
-- Enter selects the highlighted emoji, or the first result when nothing is highlighted, even if the results are scrolled. Focus stays in the input.
-- Once started, the highlight follows the results: when the search changes, it moves to the first result.
+- Enter selects the highlighted emoji, or the first result when nothing is highlighted, even if the results are scrolled. Focus stays in the input. While filtering is pending, Enter queues one selection for the matching results after they commit. Editing the query, pressing another key, or leaving the input cancels that queued selection.
+- Once started, the highlight follows the results: when the applied search, dataset or `suggestedEmojis` changes, it moves to the first result and updates Preview.
 - Moving past the grid edge that faces the input (ArrowUp from the first row when the input is above, Left from the first column when it is on the left), Escape, or leaving the input removes the highlight, and cancels a move that has not landed yet. Escape ends only the highlight, even one whose emoji is scrolled out and unmounted; with nothing highlighted, it clears the search as usual.
 - Hovering an emoji previews it without taking focus from the input (true in both modes: hover never takes focus from the search input). The highlight stays where it is, and Enter still selects it; once the pointer leaves the emoji, the preview shows the highlighted one again.
 - Space types a space, so it does not open skin tone variations in this mode.
 
+An Escape consumed by the picker stops propagation in window capture, before document-capture and bubbling host dismissal handlers. With nothing left to undo, Escape is left untouched for the host.
+
 The input becomes an ARIA combobox with a grid popup: `aria-controls` names the grid while both are mounted, and `aria-activedescendant` names the highlighted cell (it is empty while virtualization has the highlighted cell scrolled out). That cell carries `data-epr-highlighted` and is the active emoji for Preview, `useActiveEmoji()` and `emoji.isActive`. The default appearance styles it like keyboard focus; with `unstyled` or custom cells, style `[data-epr-highlighted]` as well.
 
 Primitive compositions pass the same prop to `Root`.
@@ -1686,7 +1843,7 @@ For standard emoji IDs:
 - a valid variation remains that exact variation for rendering rather than collapsing to the neutral base emoji;
 - duplicates are removed by canonical normalized ID, first occurrence wins.
 
-Custom emoji IDs use the same case-insensitive rule — `customEmojis` are already lowercased when indexed, so there is no separate exact-match pass.
+Custom emoji IDs use the same case-insensitive rule: IDs are lowercased when indexed. Custom display names retain the supplied capitalization; search still matches them case-insensitively.
 
 Entries may be unified IDs, custom emoji IDs, or the emoji characters themselves (`'🧠'`, `'❤️'`), so recents stored as inserted text can be passed through unchanged; unknown entries are ignored.
 
@@ -1978,6 +2135,8 @@ Styling is opt-in in both directions:
 
 `columns` sets the emojis per row on EmojiPicker and Root. The picker's width then fits those columns plus a stable scrollbar gutter, unless the consumer sets a width (`width`, `style` or any class). A container narrower than the columns renders fewer columns instead of clipping. Without `columns`, the width decides the column count, as in v4.
 
+The intrinsic grid width remains present during an empty search, data loading or a load error.
+
 ## 12. Data API
 
 The data entry point is defined in [DATA_API.md](./DATA_API.md):
@@ -2451,6 +2610,7 @@ The following variables are already documented public customization surface and
 - `--epr-preview-text-color`
 
 ### Native emoji font
+- `--epr-font-family` — font for picker text (`sans-serif` by default). Set it to `inherit` on the picker to use the surrounding application's font. Native emoji glyphs keep their separate font stack.
 - `--epr-emoji-font-family` (v5) — font stack for native emojis, e.g. a country-flag polyfill font; native support detection measures this same font.
 
 ### Skin tone

package/llms.txt

@@ -51,6 +51,7 @@ searchEmojis('party'); getEmojiByUnified('1f389'); // { emoji: '🎉', name: 'pa
 - [Agent integration guide](https://raw.githubusercontent.com/ealush/emoji-picker-react/master/docs/v5/AGENT_GUIDE.md): installed-version discovery, batteries included/BYOD, typed input/cell contracts, localization and verification
 - [Copyable integration prompts](https://raw.githubusercontent.com/ealush/emoji-picker-react/master/docs/v5/PROMPTS.md): setup, brand styling, design-library composition, recipe adoption and v4-to-v5 migration
 - [README](https://raw.githubusercontent.com/ealush/emoji-picker-react/master/README.md): overview, quick start, choosing a path, styling with any solution, common tasks
+- [Emoji picker comparison](https://raw.githubusercontent.com/ealush/emoji-picker-react/master/docs/v5/COMPARISON.md): v5 versus Emoji Mart, Frimousse and emoji-picker-element: capabilities, v5 APIs and audited sources
 - [Props reference](https://raw.githubusercontent.com/ealush/emoji-picker-react/master/PROPS.md): every prop of the default <EmojiPicker />
 - [CSS variables](https://raw.githubusercontent.com/ealush/emoji-picker-react/master/CSS_VARIABLES.md): every --epr-* design token
 - [Customization](https://raw.githubusercontent.com/ealush/emoji-picker-react/master/CUSTOMIZATION.md): custom emojis and groups, category icons, preview, CSP nonce

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.1.0",
+  "version": "5.1.1",
   "license": "MIT",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",

package/dist/esm/chunks/chunk-3NQHPTFV.mjs

@@ -1,9 +0,0 @@
-import {
-  registerDefaultEmojiData
-} from "./chunk-FJVAS6PR.mjs";
-import {
-  emojis_default
-} from "./chunk-ZOAKI5M6.mjs";
-
-// src/data/registerDefaultEmojiData.ts
-registerDefaultEmojiData(emojis_default);

package/dist/esm/chunks/chunk-FJVAS6PR.mjs

@@ -1,214 +0,0 @@
-// src/data/defaultEmojiData.ts
-var registered = null;
-function registerDefaultEmojiData(data) {
-  registered = data;
-}
-function getRegisteredDefaultEmojiData() {
-  return registered;
-}
-var EMPTY_EMOJI_DATA = Object.freeze({
-  categories: {},
-  emojis: {}
-});
-function defaultEmojiDataOrEmpty() {
-  return registered ?? EMPTY_EMOJI_DATA;
-}
-var pending = null;
-function loadDefaultEmojiData() {
-  if (registered) {
-    return Promise.resolve(registered);
-  }
-  if (!pending) {
-    pending = import("./emojis-VTEL5M5C.mjs").then((module) => {
-      const data = module.default ?? module;
-      registered = registered ?? data;
-      return registered;
-    }).catch((error) => {
-      pending = null;
-      throw error;
-    });
-  }
-  return pending;
-}
-
-// src/dataUtils/parseNativeEmoji.ts
-function parseNativeEmoji(unified) {
-  return unified.split("-").map((hex) => String.fromCodePoint(parseInt(hex, 16))).join("");
-}
-
-// src/data-core/prepare.ts
-var coreCache = /* @__PURE__ */ new WeakMap();
-var prepareCount = 0;
-function normalizeUnified(input) {
-  return input.trim().toLowerCase();
-}
-function normalizeQuery(input) {
-  if (!input || typeof input !== "string") {
-    return "";
-  }
-  return input.trim().toLowerCase();
-}
-function toEmojiInfo(unified, names, variations, addedIn) {
-  return Object.freeze({
-    unified,
-    emoji: parseNativeEmoji(unified),
-    name: names[names.length - 1] || "",
-    names: Object.freeze([...names]),
-    variations: Object.freeze([...variations ?? []]),
-    addedIn
-  });
-}
-function readStringArray(raw) {
-  if (!Array.isArray(raw)) {
-    return [];
-  }
-  return raw.filter((n) => typeof n === "string").map(
-    (n) => n.toLowerCase()
-  );
-}
-function appendEntry(byUnified, byCharMutable, records, entry) {
-  const rawUnified = entry.u;
-  if (typeof rawUnified !== "string" || rawUnified.length === 0) {
-    return;
-  }
-  const unified = rawUnified.toLowerCase();
-  if (byUnified.has(unified)) {
-    return;
-  }
-  const names = readStringArray(entry.n);
-  const variations = readStringArray(entry.v);
-  const rawAddedIn = entry.a;
-  const addedIn = typeof rawAddedIn === "string" ? rawAddedIn : String(rawAddedIn ?? "");
-  const info = toEmojiInfo(unified, names, variations, addedIn);
-  records.push(info);
-  byUnified.set(unified, info);
-  for (const variation of info.variations) {
-    if (!byUnified.has(variation)) {
-      byUnified.set(variation, info);
-    }
-  }
-  indexCharBucket(byCharMutable, names, info);
-}
-function indexCharBucket(byCharMutable, names, info) {
-  const distinctChars = Array.from(new Set(names.join("")));
-  for (const char of distinctChars) {
-    const bucket = byCharMutable.get(char);
-    if (bucket) {
-      bucket.push(info);
-    } else {
-      byCharMutable.set(char, [info]);
-    }
-  }
-}
-function getPreparedCore(emojiData) {
-  const source = emojiData ?? defaultEmojiDataOrEmpty();
-  const cached = coreCache.get(source);
-  if (cached) {
-    return cached;
-  }
-  prepareCount += 1;
-  const byUnified = /* @__PURE__ */ new Map();
-  const byCharMutable = /* @__PURE__ */ new Map();
-  const records = [];
-  const groups = source.emojis ?? {};
-  for (const key of Object.keys(groups)) {
-    const list = groups[key] ?? [];
-    for (const entry of list) {
-      appendEntry(byUnified, byCharMutable, records, entry);
-    }
-  }
-  const byChar = /* @__PURE__ */ new Map();
-  byCharMutable.forEach((bucket, char) => {
-    byChar.set(char, Object.freeze(bucket));
-  });
-  const core = {
-    records,
-    byUnified,
-    byChar,
-    queryMemo: /* @__PURE__ */ new Map()
-  };
-  coreCache.set(source, core);
-  return core;
-}
-
-// src/data-core/search.ts
-var EMPTY_RESULTS = Object.freeze([]);
-var MAX_QUERY_MEMO_SIZE = 500;
-function memoizeQuery(core, normalized, results) {
-  const memo = core.queryMemo;
-  if (memo.has(normalized)) {
-    memo.delete(normalized);
-  } else if (memo.size >= MAX_QUERY_MEMO_SIZE) {
-    const oldest = memo.keys().next();
-    if (!oldest.done) {
-      memo.delete(oldest.value);
-    }
-  }
-  memo.set(normalized, results);
-}
-function smallestCandidateBucket(core, normalized) {
-  let smallest = core.records;
-  for (const char of Array.from(normalized)) {
-    const bucket = core.byChar.get(char);
-    if (!bucket) {
-      return EMPTY_RESULTS;
-    }
-    if (bucket.length < smallest.length) {
-      smallest = bucket;
-    }
-  }
-  return smallest;
-}
-function getEmojiByUnified(unified, options) {
-  if (!unified || typeof unified !== "string") {
-    return void 0;
-  }
-  const normalized = normalizeUnified(unified);
-  if (!normalized) {
-    return void 0;
-  }
-  const core = getPreparedCore(options?.emojiData);
-  return core.byUnified.get(normalized);
-}
-function searchEmojis(query, options) {
-  const normalized = normalizeQuery(query);
-  if (!normalized) {
-    return EMPTY_RESULTS;
-  }
-  const core = getPreparedCore(options?.emojiData);
-  const memoized = core.queryMemo.get(normalized);
-  if (memoized) {
-    memoizeQuery(core, normalized, memoized);
-    return Object.freeze([...memoized]);
-  }
-  if (normalized.length === 1) {
-    const bucket = core.byChar.get(normalized) ?? EMPTY_RESULTS;
-    memoizeQuery(core, normalized, bucket);
-    return Object.freeze([...bucket]);
-  }
-  const matches = [];
-  for (const record of smallestCandidateBucket(core, normalized)) {
-    const names = record.names;
-    for (let i = 0; i < names.length; i += 1) {
-      if (names[i].includes(normalized)) {
-        matches.push(record);
-        break;
-      }
-    }
-  }
-  memoizeQuery(core, normalized, matches);
-  return Object.freeze([...matches]);
-}
-
-export {
-  registerDefaultEmojiData,
-  getRegisteredDefaultEmojiData,
-  EMPTY_EMOJI_DATA,
-  defaultEmojiDataOrEmpty,
-  loadDefaultEmojiData,
-  parseNativeEmoji,
-  normalizeQuery,
-  getPreparedCore,
-  getEmojiByUnified,
-  searchEmojis
-};