expo-native-sheet-emojis 1.0.0 → 1.0.2

package/README.md

@@ -1,5 +1,7 @@
 # expo-native-sheet-emojis
 
+[![npm version](https://img.shields.io/npm/v/expo-native-sheet-emojis.svg)](https://www.npmjs.com/package/expo-native-sheet-emojis)
+
 A fully native emoji picker bottom sheet for React Native. Built entirely in Swift (iOS) and Kotlin (Android) -- every interaction runs at 60+ FPS with zero bridge overhead.
 
 ## Highlights
@@ -30,7 +32,7 @@ npx expo install expo-native-sheet-emojis
 
 For bare workflow projects, run `npx expo prebuild` after installation.
 
-For bare React Native projects using `expo-modules-core`:
+For bare React Native projects, you must ensure that you have [installed and configured the `expo` package](https://docs.expo.dev/bare/installing-expo-modules/) before continuing.
 
 ```bash
 yarn add expo-native-sheet-emojis
@@ -100,9 +102,72 @@ await EmojiSheetModule.present({
 });
 ```
 
+## Custom Hook Pattern
+
+For apps that use the emoji picker in multiple places, extract a reusable hook to centralize theme, translations, and configuration:
+
+```typescript
+import { EmojiSheetModule } from 'expo-native-sheet-emojis';
+import type { EmojiSheetPresentOptions, EmojiSheetResult } from 'expo-native-sheet-emojis';
+
+export function useEmojiPicker() {
+  // Pull your theme colors and i18n strings from your app's providers
+  const theme = useAppTheme();
+  const { t } = useTranslation();
+
+  const present = async (
+    overrides?: Partial<EmojiSheetPresentOptions>
+  ): Promise<EmojiSheetResult> => {
+    return EmojiSheetModule.present({
+      theme: {
+        accentColor: theme.colors.primary,
+        backgroundColor: theme.colors.background,
+        searchBarBackgroundColor: theme.colors.surface,
+        textColor: theme.colors.text,
+        textSecondaryColor: theme.colors.textSecondary,
+        dividerColor: theme.colors.border,
+      },
+      translations: {
+        searchPlaceholder: t('Search emoji'),
+        noResultsText: t('No emojis found'),
+        categoryNames: {
+          frequently_used: t('Frequently Used'),
+          smileys_emotion: t('Smileys & Emotion'),
+          people_body: t('People & Body'),
+          animals_nature: t('Animals & Nature'),
+          food_drink: t('Food & Drink'),
+          travel_places: t('Travel & Places'),
+          activities: t('Activities'),
+          objects: t('Objects'),
+          symbols: t('Symbols'),
+          flags: t('Flags'),
+        },
+      },
+      excludeEmojis: ['pile_of_poo'],
+      ...overrides,
+    });
+  };
+
+  return { present };
+}
+```
+
+Then use it anywhere with a single line:
+
+```typescript
+const emojiPicker = useEmojiPicker();
+
+const result = await emojiPicker.present();
+if (!result.cancelled) {
+  console.log(result.emoji);
+}
+```
+
 ## Multilingual Search
 
-English search keywords are always included (built into `emojis.json`). To enable search in additional languages, you need to bundle the corresponding locale files.
+English search keywords are always included (built into `emojis.json`). No additional setup is needed for English-only apps.
+
+To enable search in additional languages, use the Expo config plugin to select which locale files to bundle. **Nothing is bundled by default** -- you opt in to the locales you need.
 
 ### Expo (managed or prebuild)
 
@@ -116,35 +181,49 @@ Configure the plugin in your `app.json` or `app.config.js`:
 }
 ```
 
-The config plugin copies only the selected locale files into your native bundles at prebuild time.
+Then run `npx expo prebuild --clean`. The plugin copies only the selected locale files into your native bundles.
 
-### Bare React Native (without Expo config plugins)
+### Bare React Native
 
-Manually copy the locale files you need from the package's `translations/` directory into your native projects:
+**Android** requires no setup -- the module's Gradle build automatically copies all translation files at build time.
 
-**iOS:** Copy the desired `.json` files into your Xcode project, placing them alongside the module's `emojis.json`. The native code loads all `.json` files found in the `translations/` bundle directory.
+**iOS** requires a `pre_install` hook in your `Podfile`. This copies locale files into the module's bundle during `pod install`:
 
-```bash
-# From your project root
-cp node_modules/expo-native-sheet-emojis/translations/es.json ios/translations/
-cp node_modules/expo-native-sheet-emojis/translations/fr.json ios/translations/
+**All locales:**
+```ruby
+pre_install do |installer|
+  emoji_sheet_pod = File.join(__dir__, '..', 'node_modules', 'expo-native-sheet-emojis')
+  source = File.join(emoji_sheet_pod, 'translations')
+  target = File.join(emoji_sheet_pod, 'ios', 'translations')
+  if File.directory?(source)
+    FileUtils.mkdir_p(target)
+    FileUtils.cp(Dir.glob(File.join(source, '*.json')), target)
+  end
+end
 ```
 
-Make sure the `translations/` folder is added to your Xcode project as a folder reference and included in the "Copy Bundle Resources" build phase.
-
-**Android:** Copy the files into your app's assets:
-
-```bash
-mkdir -p android/app/src/main/assets/translations
-cp node_modules/expo-native-sheet-emojis/translations/es.json android/app/src/main/assets/translations/
-cp node_modules/expo-native-sheet-emojis/translations/fr.json android/app/src/main/assets/translations/
+**Selected locales only:**
+```ruby
+pre_install do |installer|
+  emoji_locales = ['es', 'fr', 'de', 'ja']
+  emoji_sheet_pod = File.join(__dir__, '..', 'node_modules', 'expo-native-sheet-emojis')
+  source = File.join(emoji_sheet_pod, 'translations')
+  target = File.join(emoji_sheet_pod, 'ios', 'translations')
+  if File.directory?(source)
+    FileUtils.mkdir_p(target)
+    files = emoji_locales.map { |l| File.join(source, "#{l}.json") }.select { |f| File.exist?(f) }
+    FileUtils.cp(files, target)
+  end
+end
 ```
 
+If you already have a `pre_install` block, add the emoji translation snippet inside it. Run `pod install` after updating.
+
 ### Supported Locales
 
 `ca`, `cs`, `de`, `el`, `en`, `es`, `fi`, `fr`, `hi`, `hu`, `it`, `ja`, `ko`, `nl`, `pl`, `pt`, `ru`, `sv`, `tr`, `uk`, `zh`
 
-Each locale file adds roughly 60-190KB to your app bundle depending on the language.
+**Bundle size impact:** The base emoji data (`emojis.json`) adds ~300KB to your app. Each locale file adds 64-185KB depending on the language (all 21 locales total ~2.3MB). Only bundle the locales your app actually needs.
 
 ### Custom Translations
 

package/android/build.gradle

@@ -29,6 +29,14 @@ android {
         versionName "1.0.0"
     }
 
+    // Copy translation files from package root into module assets at build time.
+    // This means Android consumers get all translations automatically — no manual setup.
+    task copyTranslations(type: Copy) {
+        from "${projectDir}/../translations"
+        into "${projectDir}/src/main/assets/translations"
+    }
+    preBuild.dependsOn copyTranslations
+
     lintOptions {
         abortOnError false
     }

package/ios/EmojiSheetModule.podspec

@@ -1,10 +1,10 @@
 Pod::Spec.new do |s|
   s.name           = 'EmojiSheetModule'
-  s.version        = '1.0.0'
+  s.version        = '1.0.2'
   s.summary        = 'Native emoji picker bottom sheet for React Native'
   s.description    = 'A fully native iOS/Android emoji picker presented in a bottom sheet with search, skin tones, and theming support.'
   s.author         = ''
-  s.homepage       = 'https://github.com/user/expo-native-sheet-emojis'
+  s.homepage       = 'https://github.com/efstathiosntonas/expo-native-sheet-emojis'
   s.license        = { type: 'MIT' }
   s.platforms      = { ios: '15.1' }
   s.source         = { git: '' }

package/ios/EmojiSheetUIView.swift

@@ -327,41 +327,49 @@ class EmojiSheetUIView: UIView,
         let bundle = Bundle(for: EmojiSheetUIView.self)
         var merged: [String: [String]] = [:]
 
-        // Try translations directory (per-locale files from config plugin)
-        if let translationsURL = bundle.url(forResource: "translations", withExtension: nil) ??
-           bundle.urls(forResourcesWithExtension: "json", subdirectory: "translations")?.first.map({ $0.deletingLastPathComponent() }) {
-            // Load all .json files in translations/
+        // Translation files are copied into ios/translations/ by the config plugin.
+        // The podspec bundles translations/*.json into the module's resource bundle.
+        // CocoaPods may copy them flat (root level) or preserve the subdirectory.
+        // We check both locations.
+
+        // 1. Check translations/ subdirectory
+        if let translationsURL = bundle.url(forResource: "translations", withExtension: nil) {
             if let urls = try? FileManager.default.contentsOfDirectory(at: translationsURL, includingPropertiesForKeys: nil)
                 .filter({ $0.pathExtension == "json" }) {
                 for url in urls {
-                    if let data = try? Data(contentsOf: url),
-                       let dict = try? JSONSerialization.jsonObject(with: data) as? [String: [String]] {
-                        for (key, value) in dict {
-                            if var existing = merged[key] {
-                                existing.append(contentsOf: value)
-                                merged[key] = existing
-                            } else {
-                                merged[key] = value
-                            }
-                        }
-                    }
+                    Self.mergeKeywords(from: url, into: &merged)
                 }
             }
         }
 
-        // Fallback: try flat "all.json" (legacy format)
+        // 2. Fallback: check flat bundle root for known locale files
         if merged.isEmpty {
-            let url = bundle.url(forResource: "all", withExtension: "json")
-                ?? bundle.url(forResource: "all", withExtension: "json", subdirectory: "translations")
-            if let url, let data = try? Data(contentsOf: url),
-               let dict = try? JSONSerialization.jsonObject(with: data) as? [String: [String]] {
-                return dict
+            let locales = ["ca", "cs", "de", "el", "en", "es", "fi", "fr", "hi", "hu",
+                           "it", "ja", "ko", "nl", "pl", "pt", "ru", "sv", "tr", "uk", "zh"]
+            for locale in locales {
+                if let url = bundle.url(forResource: locale, withExtension: "json") {
+                    Self.mergeKeywords(from: url, into: &merged)
+                }
             }
         }
 
         return merged
     }
 
+    private static func mergeKeywords(from url: URL, into merged: inout [String: [String]]) {
+        guard let data = try? Data(contentsOf: url),
+              let dict = try? JSONSerialization.jsonObject(with: data) as? [String: [String]]
+        else { return }
+        for (key, value) in dict {
+            if var existing = merged[key] {
+                existing.append(contentsOf: value)
+                merged[key] = existing
+            } else {
+                merged[key] = value
+            }
+        }
+    }
+
     func loadDataAsync() {
         let cached = Self.cacheQueue.sync { (Self.cachedSections, Self.cachedKeywords) }
         if let sections = cached.0, let keywords = cached.1 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-native-sheet-emojis",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "A fully native emoji picker bottom sheet for React Native. Built with Swift and Kotlin for maximum performance. Features search with multilingual keywords, skin tones, frequently used tracking, theming, and configurable layout.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -16,7 +16,8 @@
     "typecheck": "tsc --noEmit",
     "prepare": "lefthook install && bob build && tsc --project plugin/tsconfig.json",
     "prepublishOnly": "bob build && tsc --project plugin/tsconfig.json",
-    "build:plugin": "tsc --project plugin/tsconfig.json"
+    "build:plugin": "tsc --project plugin/tsconfig.json",
+    "release": "release-it"
   },
   "keywords": [
     "expo",
@@ -46,6 +47,7 @@
     "react-native": ">=0.81.0"
   },
   "devDependencies": {
+    "@release-it/conventional-changelog": "^10.0.6",
     "@types/react": "~19.2.14",
     "del-cli": "6.0.0",
     "eslint": "9.0.0",
@@ -57,13 +59,15 @@
     "react": "19.2.4",
     "react-native": "0.83.3",
     "react-native-builder-bob": "0.40.0",
+    "release-it": "^19.2.4",
     "typescript": "~5.9.3"
   },
   "files": [
     "lib/",
     "src/",
     "ios/",
-    "android/",
+    "android/src/",
+    "android/build.gradle",
     "translations/",
     "app.plugin.js",
     "plugin/build/",

package/android/build/.transforms/5729d3188aa52ad4699e57ce2c5c9358/results.bin

@@ -1 +0,0 @@
-o/classes

package/android/build/.transforms/9d5669b57046f2ddfd01bd236a2701f2/results.bin

@@ -1 +0,0 @@
-o/bundleLibRuntimeToDirDebug

package/android/build/generated/source/buildConfig/debug/expo/community/modules/emojisheet/BuildConfig.java

@@ -1,10 +0,0 @@
-/**
- * Automatically generated file. DO NOT MODIFY
- */
-package expo.community.modules.emojisheet;
-
-public final class BuildConfig {
-  public static final boolean DEBUG = Boolean.parseBoolean("true");
-  public static final String LIBRARY_PACKAGE_NAME = "expo.community.modules.emojisheet";
-  public static final String BUILD_TYPE = "debug";
-}

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/processDebugManifest/aapt/AndroidManifest.xml

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-    package="expo.community.modules.emojisheet" >
-
-    <uses-sdk android:minSdkVersion="24" />
-
-</manifest>

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/processDebugManifest/aapt/output-metadata.json

@@ -1,18 +0,0 @@
-{
-  "version": 3,
-  "artifactType": {
-    "type": "AAPT_FRIENDLY_MERGED_MANIFESTS",
-    "kind": "Directory"
-  },
-  "applicationId": "expo.community.modules.emojisheet",
-  "variantName": "debug",
-  "elements": [
-    {
-      "type": "SINGLE",
-      "filters": [],
-      "attributes": [],
-      "outputFile": "AndroidManifest.xml"
-    }
-  ],
-  "elementType": "File"
-}

package/android/build/intermediates/aar_metadata/debug/writeDebugAarMetadata/aar-metadata.properties

@@ -1,6 +0,0 @@
-aarFormatVersion=1.0
-aarMetadataVersion=1.0
-minCompileSdk=1
-minCompileSdkExtension=0
-minAndroidGradlePluginVersion=1.0.0
-coreLibraryDesugaringEnabled=false

package/android/build/intermediates/annotation_processor_list/debug/javaPreCompileDebug/annotationProcessors.json

@@ -1 +0,0 @@
-{}