# notwaldorf/emoji-translate architecture

> Architecture diagram of the GitHub repository notwaldorf/emoji-translate, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/notwaldorf/emoji-translate
- Repository: https://github.com/notwaldorf/emoji-translate

## Overview

emoji-translate is a JavaScript library for translating words and sentences into emoji, with a browser-facing API and a Chrome extension that translates page text. The library matches words against emojilib and offers both string and display-element results. The extension separately fetches its bundled emoji data, scans page text, and replaces translatable words. The excerpts establish these runtime paths; the demo page’s implementation was not sampled, so it is not expanded here.

Main entry points: [`extension/background.js`](https://github.com/notwaldorf/emoji-translate/blob/master/extension/background.js) (Click handler), [`extension/emoji-translate.js`](https://github.com/notwaldorf/emoji-translate/blob/master/extension/emoji-translate.js) (Page translator), [`emoji-translate.js`](https://github.com/notwaldorf/emoji-translate/blob/master/emoji-translate.js) (Emoji translation), [`public/index.js`](https://github.com/notwaldorf/emoji-translate/blob/master/public/index.js) (Window API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_library["Translation library"]
  node_core["Emoji translation<br/>[emoji-translate.js]"]
end

subgraph group_browser["Browser API"]
  node_browser_api["Window API<br/>[index.js]"]
end

subgraph group_extension["Chrome extension"]
  node_background["Click handler<br/>[background.js]"]
  node_content["Page translator<br/>[emoji-translate.js]"]
  node_emoji_data[("Emoji lookup data<br/>[emojis.json]")]
end

node_user(("Library caller"))
node_emojilib[("Emojilib data")]
node_extension_user(("Extension user"))
node_page["Web page"]
node_jquery["jQuery"]

node_user -->|"calls API"| node_core
node_core -->|"matches words"| node_emojilib
node_browser_api -->|"imports"| node_core
node_extension_user -->|"clicks action"| node_background
node_background -->|"injects script"| node_content
node_background -->|"injects script"| node_jquery
node_content -->|"fetches data"| node_emoji_data
node_content -->|"translates text"| node_page

click node_core "https://github.com/notwaldorf/emoji-translate/blob/master/emoji-translate.js"
click node_browser_api "https://github.com/notwaldorf/emoji-translate/blob/master/public/index.js"
click node_background "https://github.com/notwaldorf/emoji-translate/blob/master/extension/background.js"
click node_content "https://github.com/notwaldorf/emoji-translate/blob/master/extension/emoji-translate.js"
click node_emoji_data "https://github.com/notwaldorf/emoji-translate/blob/master/extension/emojis.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_core,node_extension_user toneBlue
class node_browser_api,node_emojilib toneAmber
class node_background,node_content,node_emoji_data toneMint
class node_user,node_page,node_jquery toneIndigo
```

## Components

### Translation library

- [Emoji translation](https://github.com/notwaldorf/emoji-translate/blob/master/emoji-translate.js): `emoji-translate.js`

### Browser API

- [Window API](https://github.com/notwaldorf/emoji-translate/blob/master/public/index.js): `public/index.js`

### Chrome extension

- [Click handler](https://github.com/notwaldorf/emoji-translate/blob/master/extension/background.js): `extension/background.js`
- [Page translator](https://github.com/notwaldorf/emoji-translate/blob/master/extension/emoji-translate.js): `extension/emoji-translate.js`
- [Emoji lookup data](https://github.com/notwaldorf/emoji-translate/blob/master/extension/emojis.json): `extension/emojis.json`

### Other components

- **Library caller**
- **Emojilib data**
- **Extension user**
- **Web page**
- **jQuery**

## Connections

- Library caller → Emoji translation: calls API (evidence: `README.md`)
- Emoji translation → Emojilib data: matches words (evidence: `README.md`)
- Window API → Emoji translation: imports (evidence: `public/index.js`)
- Extension user → Click handler: clicks action (evidence: `extension/background.js`)
- Click handler → Page translator: injects script (evidence: `extension/background.js`)
- Click handler → jQuery: injects script (evidence: `extension/background.js`)
- Page translator → Emoji lookup data: fetches data (evidence: `extension/emoji-translate.js`)
- Page translator → Web page: translates text (evidence: `extension/emoji-translate.js`)
