emoji-picker-react 4.22.0 → 4.22.2

package/dist/hooks/useActiveCategoryScrollDetection.d.ts

@@ -1,4 +1,11 @@
-export declare function useActiveCategoryScrollDetection({ setActiveCategory, setVisibleCategories, }: {
+import { CategoriesConfig } from '../config/categoryConfig';
+export declare function useActiveCategoryScrollDetection({ setActiveCategory, setVisibleCategories, categories, }: {
     setActiveCategory: (category: string) => void;
     setVisibleCategories: (categories: string[]) => void;
+    /**
+     * Effective category list. The merged array reference only changes when
+     * the configuration is re-merged, so the observer re-subscribes exactly
+     * when sections are added or removed — no serialization involved.
+     */
+    categories: CategoriesConfig;
 }): void;

package/llms.txt

@@ -236,6 +236,13 @@ automatically (after the standard categories), so grouped emojis always
 render somewhere. Omit `CUSTOM` from `categories` entirely to hide all
 customs — explicit `categories` stay an allowlist:
 
+### Updating groups at runtime
+
+`categories` and `customEmojis` are immutable inputs: replacing either
+array (even with a same-length array) rebuilds sections, tabs, search,
+and lookup. Mutating an array in place is not detected — always provide
+a new reference. Group strings are exact, case-sensitive identifiers.
+
 ```tsx
 import EmojiPicker, { Categories } from 'emoji-picker-react';
 

package/package.json

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

package/src/components/context/PickerConfigContext.tsx

@@ -39,7 +39,11 @@ export function useSetConfig(config: PickerConfig) {
     // not gonna...
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [
-    config.customEmojis?.length,
+    // New references rebuild merged categories and data even at equal
+    // length; compareConfig above still gates no-op updates so inline
+    // literals don't loop.
+    config.categories,
+    config.customEmojis,
     config.open,
     config.emojiVersion,
     config.reactionsDefaultOpen,

package/src/components/context/PickerDataContext.tsx

@@ -34,9 +34,9 @@ export interface PickerDataContextValue {
 const PickerDataContext = React.createContext<PickerDataContextValue>({
   emojiData: {} as EmojiData,
   allEmojis: [],
-  allEmojisByUnified: {},
-  searchIndex: {},
-  customGroups: {},
+  allEmojisByUnified: Object.create(null),
+  searchIndex: Object.create(null),
+  customGroups: Object.create(null),
   emojiByUnified,
   activeVariationFromUnified: () => null,
 });
@@ -54,7 +54,10 @@ export function PickerDataProvider({
     // Clone to avoid mutation of shared source
     const newData: EmojiData = JSON.parse(JSON.stringify(emojiData));
 
-    const customGroups: Record<string, DataEmojis> = {};
+    // Group names and emoji ids are user-controlled strings: use
+    // null-prototype dictionaries so names like `__proto__` behave as
+    // ordinary data instead of resolving Object.prototype members.
+    const customGroups: Record<string, DataEmojis> = Object.create(null);
 
     if (customEmojis && customEmojis.length > 0) {
       for (const emoji of customEmojis) {
@@ -75,8 +78,10 @@ export function PickerDataProvider({
     const allEmojis: DataEmojis = Object.values(emojis)
       .concat(Object.values(customGroups))
       .flat();
-    const allEmojisByUnified: Record<string, DataEmoji> = {};
-    const searchIndex: Record<string, Record<string, DataEmoji>> = {};
+    const allEmojisByUnified: Record<string, DataEmoji> =
+      Object.create(null);
+    const searchIndex: Record<string, Record<string, DataEmoji>> =
+      Object.create(null);
 
     allEmojis.forEach((emoji) => {
       const unified = emoji[Keys.unified];
@@ -96,7 +101,7 @@ export function PickerDataProvider({
         .split('');
 
       joinedNameString.forEach((char: string) => {
-        searchIndex[char] = searchIndex[char] ?? {};
+        searchIndex[char] = searchIndex[char] ?? Object.create(null);
         searchIndex[char][unified] = emoji;
       });
     });

package/src/components/navigation/CategoryNavigation.tsx

@@ -28,7 +28,6 @@ export function CategoryNavigation() {
   const [activeCategory, setActiveCategory] = useState<string | null>(null);
   const [, setVisibleCategories] = useVisibleCategoriesState();
   const scrollCategoryIntoView = useScrollCategoryIntoView();
-  useActiveCategoryScrollDetection({ setActiveCategory, setVisibleCategories });
   const isSearchMode = useIsSearchMode();
 
   const categoriesConfig = useCategoriesConfig();
@@ -37,6 +36,14 @@ export function CategoryNavigation() {
   const hideCustomCategory = useShouldHideCustomEmojis();
   const { customGroups, emojiData } = usePickerDataContext();
 
+  // The observer re-subscribes when the merged categories reference
+  // changes (sections added/removed); the reference is stable otherwise.
+  useActiveCategoryScrollDetection({
+    setActiveCategory,
+    setVisibleCategories,
+    categories: categoriesConfig,
+  });
+
   const visibleCategories = categoriesConfig.filter(categoryConfig => {
     if (isCustomCategory(categoryConfig) && hideCustomCategory) {
       return false;

package/src/config/compareConfig.ts

@@ -1,4 +1,8 @@
+import { Categories, CategoryConfig } from '../types/exposedTypes';
+
+import { UserCategoryConfig } from './categoryConfig';
 import { PickerConfig } from './config';
+import { CustomEmoji } from './customEmojiConfig';
 
 // eslint-disable-next-line complexity
 export function compareConfig(prev: PickerConfig, next: PickerConfig) {
@@ -25,6 +29,74 @@ export function compareConfig(prev: PickerConfig, next: PickerConfig) {
     prev.searchDisabled === next.searchDisabled &&
     prev.skinTonePickerLocation === next.skinTonePickerLocation &&
     prevCustomEmojis.length === nextCustomEmojis.length &&
+    customEmojisEqual(prevCustomEmojis, nextCustomEmojis) &&
+    categoriesEqual(prev.categories, next.categories) &&
     prev.emojiData === next.emojiData
   );
 }
+
+/**
+ * Structural content equality for custom emojis. Length alone misses
+ * regroups and swaps, which would leave merged categories, search, and
+ * sections stale. Fields are compared element-wise (never serialized
+ * with delimiters) so user-controlled values cannot collide.
+ */
+function customEmojisEqual(
+  prev: CustomEmoji[],
+  next: CustomEmoji[],
+): boolean {
+  if (prev.length !== next.length) {
+    return false;
+  }
+  return prev.every((emoji, index) => {
+    const other = next[index];
+    return (
+      emoji.id === other.id &&
+      (emoji.group ?? '') === (other.group ?? '') &&
+      emoji.imgUrl === other.imgUrl &&
+      emoji.names.length === other.names.length &&
+      emoji.names.every((name, nameIndex) => name === other.names[nameIndex])
+    );
+  });
+}
+
+/**
+ * Structural content equality for the categories input. Order, labels,
+ * group selection, and icon identity all flow into the merged
+ * configuration. Icons compare by reference: swapping one icon element
+ * for another must rebuild, while a stable reference stays cheap.
+ */
+function categoriesEqual(
+  prev: UserCategoryConfig | undefined,
+  next: UserCategoryConfig | undefined,
+): boolean {
+  const prevEntries = prev ?? [];
+  const nextEntries = next ?? [];
+  if (prevEntries.length !== nextEntries.length) {
+    return false;
+  }
+  return prevEntries.every((entry, index) =>
+    categoryEntriesEqual(entry, nextEntries[index]),
+  );
+}
+
+/**
+ * One categories entry compared structurally. Icons compare by reference:
+ * swapping one icon element for another rebuilds, a stable reference stays
+ * cheap. Delimited serialization is avoided so user-controlled values
+ * cannot collide.
+ */
+function categoryEntriesEqual(
+  entry: Categories | CategoryConfig,
+  other: Categories | CategoryConfig,
+): boolean {
+  if (typeof entry === 'string' || typeof other === 'string') {
+    return entry === other;
+  }
+  return (
+    entry.category === other.category &&
+    entry.name === other.name &&
+    (entry.group ?? '') === (other.group ?? '') &&
+    entry.icon === other.icon
+  );
+}

package/src/hooks/useActiveCategoryScrollDetection.ts

@@ -3,13 +3,21 @@ import { useEffect } from 'react';
 import { categoryNameFromDom } from '../DomUtils/categoryNameFromDom';
 import { asSelectors, ClassNames } from '../DomUtils/classNames';
 import { useBodyRef } from '../components/context/ElementRefContext';
+import { CategoriesConfig } from '../config/categoryConfig';
 
 export function useActiveCategoryScrollDetection({
   setActiveCategory,
   setVisibleCategories,
+  categories,
 }: {
   setActiveCategory: (category: string) => void;
   setVisibleCategories: (categories: string[]) => void;
+  /**
+   * Effective category list. The merged array reference only changes when
+   * the configuration is re-merged, so the observer re-subscribes exactly
+   * when sections are added or removed — no serialization involved.
+   */
+  categories: CategoriesConfig;
 }) {
   const BodyRef = useBodyRef();
 
@@ -67,5 +75,5 @@ export function useActiveCategoryScrollDetection({
     return () => {
       observer.disconnect();
     };
-  }, [BodyRef, setActiveCategory, setVisibleCategories]);
+  }, [BodyRef, categories, setActiveCategory, setVisibleCategories]);
 }